Skip to content

Commit 2188469

Browse files
author
Mikael Kindborg
committed
Updated Cordova guides and added Evothings dwonload info.
1 parent 9c16170 commit 2188469

10 files changed

+99
-181
lines changed

build/build-overview.html

+3-34
Original file line numberDiff line numberDiff line change
@@ -21,16 +21,16 @@
2121
<div class="evo-box evo-content-index">
2222
<div class="evo-box">
2323
<a href="#Introduction">Build and publish your app</a><br/>
24-
<a href="share-apps.html" class="evo-content-index-subitem">Share your app</a><br/>
24+
<a href="share-apps.html" class="evo-content-index-subitem">Sharing your app</a><br/>
2525
<a href="cordova-guide.html" class="evo-content-index-subitem">Cordova Guide</a><br/>
2626
<a href="#Install">Installing Cordova</a><br/>
2727
<a href="cordova-install-osx.html" class="evo-content-index-subitem">Install on OS X</a><br/>
2828
<a href="cordova-install-windows.html" class="evo-content-index-subitem">Install on Windows</a><br/>
2929
<a href="cordova-install-linux.html" class="evo-content-index-subitem">Install on Linux</a><br/>
3030
<a href="#Build">Building a native app</a><br/>
3131
<a href="#Publish">Publishing your app</a><br/>
32-
<a href="publish-ios.html" class="evo-content-index-subitem">Publish on Apple AppStore</a><br/>
33-
<a href="publish-android.html" class="evo-content-index-subitem">Publish on Google Play</a><br/>
32+
<a href="publish-ios.html" class="evo-content-index-subitem">Apple AppStore</a><br/>
33+
<a href="publish-android.html" class="evo-content-index-subitem">Google Play</a><br/>
3434
<a href="#SupportedPlatforms">Supported platforms</a><br/>
3535
</div>
3636
</div>
@@ -108,34 +108,3 @@ <h2>Supported platforms</h2>
108108

109109
</body>
110110
</html>
111-
112-
113-
<!-- TODO: This is old text kept as a reference. Delete this in the future.
114-
Building a native app with Apache Cordova:
115-
116-
<li><p>Install the mobile development kit(s) you want to build for (e.g.
117-
Android, iOS, Windows Phone).</p></li>
118-
<li><p>For iOS you need a Mac with Xcode and an Apple developer
119-
membership to install apps on devices.</p></li>
120-
<li><p>For Android you need the Android SDK.</p></li>
121-
<li><p>Install Apache Cordova and create a template app by following the
122-
instructions in this tutorial:
123-
http://cordova.apache.org/docs/en/3.6.0/guide_cli_index.md.html#The%20Command-Line%20Interface</p></li>
124-
<li><p>The above step can take some time and effort to complete!</p></li>
125-
<li><p>Copy your HTML, CSS, JavaScript and media files to the www folder in
126-
the Cordova project.</p></li>
127-
<li><p>Now build and test your app. The output depends on the platform. For
128-
iOS you get an Xcode project you can open and run, for Android you get
129-
and apk-file you can install on your device.</p></li>
130-
<li><p>Note that it works perfectly fine to develop the Cordova app in
131-
Evothings Studio. Just drag and drop index.html in project list in the
132-
Workbench window. Then run the app using Evothings Viewer, or ...</p></li>
133-
<li><p>Enter the connect url in place of index.html in config.xml. When you
134-
start the app it will connect to the Workbench, just click run to
135-
launch your app.</p></li>
136-
<li><p>You can now build your app and deploy it to the app stores.</p></li>
137-
<li><p>Drawback: The build process can be complex and you must have the
138-
SDKs installed and the right app store memberships. But this is on the
139-
other hand true of any app you wish to publish.</p></li>
140-
141-
-->

build/cordova-guide.html

+9-2
Original file line numberDiff line numberDiff line change
@@ -26,10 +26,11 @@
2626
<a href="#BuildingForIOS">Building for iOS</a><br/>
2727
<a href="#BuildingForAndroid">Building for Android</a><br/>
2828
<a href="#AddingPlugins">Adding plugins</a><br/>
29-
<a href="#CordovaDirectoryStructure">Cordova directory structure</a><br/>
29+
<a href="#CordovaDirectoryStructure">Cordova file structure</a><br/>
3030
<a href="#Workflow">Workflow speedup</a><br/>
3131
<a href="#CustomiseEvothingsViewer">Customise Evothings Viewer</a><br/>
3232
<a href="#SetupCordovaForEvothings">Setup a Cordova project with Evothings</a><br/>
33+
<a href="#EvothingsCordova">Use Evothings Studio</a><br/>
3334
</div>
3435
</div>
3536

@@ -156,7 +157,7 @@ <h2>Adding plugins</h2>
156157
</div>
157158

158159
<div id="CordovaDirectoryStructure" class="evo-box">
159-
<h2>Cordova directory structure</h2>
160+
<h2>Cordova file structure</h2>
160161
<p>This is the directory layout of a generated Cordova project. Put your HTML/CSS/JS in folder <b>www</b>. Edit <b>config.xml</b> to include the relevant settings for your project. Build output is found in the <b>platforms</b> folder.</p>
161162
<pre>config.xml
162163
hooks
@@ -234,6 +235,12 @@ <h2>Setup a Cordova project with Evothings</h2>
234235
<p>You can run your app on multiple devices/platforms at the same time, for instance an Android tablet and an iPad. When you save your code, the app will be reloaded on all connected devices.</p>
235236
</div>
236237

238+
<div id="EvothingsCordova" class="evo-box">
239+
<h2>Use Evothings Studio for Cordova app development</h2>
240+
<p>Evothings Studio makes it easy to develop Cordova apps. Check out how to use your Cordova project with the <a href="cordova-guide.html#SetupCordovaForEvothings">fast Evothings workflow</a>.</p>
241+
<p>It is easy and fun to get started with Evothings Studio. <a href="http://evothings.com/download/" target="_blank">Download now</a> and be up and running in 5 minutes!</p>
242+
</div>
243+
237244
<script src="../js/include-page-footer.js"></script>
238245
</div><!-- evo-page-content -->
239246
</div><!-- evo-page -->

build/cordova-install-linux.html

+22-16
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44
File: build-cordova-install-linux.html
55
Description: How to install Cordova on Linux
66
Author: Mikael Kindborg
7-
Copyright (c) 2013-2014 Evothings AB
7+
Copyright (c) 2013-2016 Evothings AB
88
-->
99
<head>
1010
<meta charset="utf-8">
@@ -20,21 +20,21 @@
2020

2121
<div class="evo-box evo-content-index">
2222
<div class="evo-box">
23-
<a href="#Introduction">Installing Cordova on Linux</a><br/>
23+
<a href="#Introduction">Install Cordova on Linux</a><br/>
2424
<a href="#InstallCordova">Install Cordova</a><br/>
2525
<a href="#InstallJava">Install Java</a><br/>
2626
<a href="#InstallAnt">Install Ant</a><br/>
2727
<a href="#InstallAndroidSDKTools">Install Android SDK Tools</a><br/>
28-
<a href="#IfYouGetStuck">If You Get Stuck</a><br/>
29-
<a href="#NextStep">The Fun Begins</a><br/>
28+
<a href="#IfYouGetStuck">If you get stuck</a><br/>
29+
<a href="#NextStep">The fun begins</a><br/>
30+
<a href="#EvothingsCordova">Use Evothings Studio</a><br/>
3031
</div>
3132
</div>
3233

3334
<div id="Introduction" class="evo-box">
34-
<h1>Installing Cordova on Linux</h1>
35+
<h1>Install Cordova on Linux</h1>
3536
<p>This document describes how to install Apache Cordova and the Android SDK on a Linux machine. Instructions below are tested on Ubuntu 14.04, on a 32-bit installation. For other versions and Linux distributions, the procedure may differ. </p>
36-
<p>Please provide your feedback so that we can keep this documentation up to date. You are welcome to ask for help at the <a href="http://forum.evothings.com/">Evothings Forum</a>.</p>
37-
37+
<p>Please provide your feedback so that we can keep this documentation up to date. You are welcome to ask for help at the <a href="http://forum.evothings.com/" target="_blank">Evothings Forum</a>.</p>
3838
</div>
3939

4040
<div id="InstallCordova" class="evo-box">
@@ -58,7 +58,7 @@ <h2>Install Cordova</h2>
5858
<li><p>If Git is not installed, install with:</p>
5959
<p><pre>sudo apt-get install git</pre></p></li>
6060
<li><p><b>Install Cordova.</b> Cordova is installed using the Node Package Manager (npm). Type the following to install:</p>
61-
<p><pre>sudo npm install -g cordova@3.6.3-0.2.13</pre></p></li>
61+
<p><pre>sudo npm install -g cordova</pre></p></li>
6262
<li><p>Test the Cordova install by typing:</p>
6363
<p><pre>cordova --version</pre></p>
6464
<p>If you see the version number, you have successfully installed Apache Cordova!</p></li>
@@ -71,7 +71,7 @@ <h2>Install Java</h2>
7171
<p><pre>java -version
7272
javac -version</pre></p>
7373
<p>If version info is displayed, you have Java installed, but you may want to use the Oracle JDK, rather than the OpenJDK that comes with many Linux distributions. The Oracle JDK is needed for signing Android apps.</p>
74-
<p>If you wish to install the Oracle JDK, proceed as follows (the steps below are based on a <a href="http://www.wikihow.com/Install-Oracle-Java-JDK-on-Ubuntu-Linux">guide from wikiHow</a>):</p>
74+
<p>If you wish to install the Oracle JDK, proceed as follows (the steps below are based on a <a href="http://www.wikihow.com/Install-Oracle-Java-JDK-on-Ubuntu-Linux" target="_blank">guide from wikiHow</a>):</p>
7575
<ol>
7676
<li><p>Start by removing the OpenJDK:</p>
7777
<p><pre>sudo apt-get purge openjdk-\*
@@ -80,7 +80,7 @@ <h2>Install Java</h2>
8080
<p><pre>file /sbin/init</pre></p></li>
8181
<p>If you run 64-bit Linux, you should install 32-bit libraries (Android SDK will need this):</p>
8282
<p><pre>sudo apt-get install ia32-libs</pre></p></li>
83-
<li><p>Download the <a href="http://www.oracle.com/technetwork/java/javase/downloads/index.html">JDK (Java SE Development Kit)</a>. The download file ends with <b>.tar.gz</b>. For 32-bit systems get the "Linux x86" download, for 64-bit systems get the "Linux x64" download.</p></li>
83+
<li><p>Download the <a href="http://www.oracle.com/technetwork/java/javase/downloads/index.html" target="_blank">JDK (Java SE Development Kit)</a>. The download file ends with <b>.tar.gz</b>. For 32-bit systems get the "Linux x86" download, for 64-bit systems get the "Linux x64" download.</p></li>
8484
<li><p>The downloaded file is typically saved to the folder "Download" in your home directory. The following steps create an installation directory and unpack the JDK files there. You can pick any directory for the install, we will use the directory "java" in the home folder. Replace "jdk-8u11-linux-i586.tar.gz" with the name of the file you just downloaded.</p>
8585
<p><pre>mkdir -p ~/java
8686
cd ~/Downloads
@@ -113,9 +113,9 @@ <h2>Install Java</h2>
113113

114114
<div id="InstallAnt" class="evo-box">
115115
<h2>Install Ant</h2>
116-
<p><a href="http://ant.apache.org/">Apache Ant</a> is a build system for Java, which is used by Cordova and the Android SDK. To install Ant, follow these steps:</p>
116+
<p><a href="http://ant.apache.org/" target="_blank">Apache Ant</a> is a build system for Java, which is used by Cordova and the Android SDK. To install Ant, follow these steps:</p>
117117
<ol>
118-
<li><p>Download Ant from here: <a href="http://ant.apache.org/bindownload.cgi">ant.apache.org/bindownload.cgi</a>. Get the zip download available at the page. Click the zip-file link for the most recent release, e.g. <b>apache-ant-1.9.4-bin.zip</b>, and save the file to your machine.</p></li>
118+
<li><p>Download Ant from here: <a href="http://ant.apache.org/bindownload.cgi" target="_blank">ant.apache.org/bindownload.cgi</a>. Get the zip download available at the page. Click the zip-file link for the most recent release, e.g. <b>apache-ant-1.9.4-bin.zip</b>, and save the file to your machine.</p></li>
119119
<li><p>Unpack the zip file to the directory on your machine where you want Ant to be installed. You can pick any directory for the install, we will use the directory "ant" in the home folder. Here are the commands (make sure you use the actual name of the downloaded zip file):</p>
120120
<p><pre>mkdir -p ~/ant
121121
cd ~/ant
@@ -142,7 +142,7 @@ <h2>Install Ant</h2>
142142
<h2>Install the Android SDK Tools</h2>
143143
<p>The SDK Tools for Android are used by Cordova to build Android apps. Follow these steps to install the SDK Tools:</p>
144144
<ol>
145-
<li><p>Go to the page <a href="http://developer.android.com/sdk">developer.android.com/sdk</a> scroll down the page and click "VIEW ALL DOWNLOADS AND SIZES". Under "SDK Tools Only", click the windows installer file for Linux and download it (this file is named e.g. <b>android-sdk_r23.0.2-linux.tgz</b>).</p></li>
145+
<li><p>Go to the page <a href="http://developer.android.com/sdk" target="_blank">developer.android.com/sdk</a> scroll down the page and click "VIEW ALL DOWNLOADS AND SIZES". Under "SDK Tools Only", click the windows installer file for Linux and download it (this file is named e.g. <b>android-sdk_r23.0.2-linux.tgz</b>).</p></li>
146146
<li><p>When downloaded, unpack the files. Here are commands for unpacking the Android SDK folder into your home directory:</p>
147147
<p><pre>cd
148148
mv ~/Downloads/android-sdk_r23.0.2-linux.tgz .
@@ -174,8 +174,8 @@ <h2>Install the Android SDK Tools</h2>
174174
</div>
175175

176176
<div id="IfYouGetStuck" class="evo-box">
177-
<h2>If You Get Stuck</h2>
178-
<p>If you get stuck, consult the documentation at the respective web sites for Cordova, Java, Ant, and Android. The Cordova documentation specific for Android is found here: <a href="http://cordova.apache.org/docs/en/3.6.0/guide_platforms_android_index.md.html">cordova.apache.org/docs/en/3.6.0/guide_platforms_android_index.md.html</a>. You are also welcome to ask for help at the <a href="http://forum.evothings.com/">Evothings Forum</a>.</p>
177+
<h2>If you get stuck</h2>
178+
<p>If you get stuck, consult the documentation at the respective web sites for Cordova, Java, Ant, and Android. The Cordova documentation has a <a href="https://cordova.apache.org/docs/en/latest/guide/platforms/android/index.html" target="_blank">platform guide for Android</a>. You are also welcome to ask for help at the <a href="http://forum.evothings.com/" target="_blank">Evothings Forum</a>.</p>
179179
<p>One thing to do is to inspect all the environment variables. You can do this from a command window (note that you have to open a new command window after updating environment variables for updated values to be available). This displays the system PATH:</p>
180180
<p><pre>echo $PATH</pre></p>
181181
<p>Here is how to inspect the values of JAVA_HOME and ANT_HOME:</p>
@@ -184,10 +184,16 @@ <h2>If You Get Stuck</h2>
184184
</div>
185185

186186
<div id="NextStep" class="evo-box">
187-
<h2>The Fun Begins</h2>
187+
<h2>The fun begins</h2>
188188
<p>Next step is to create and build a Cordova project. Go to the <a href="cordova-guide.html">Cordova Guide</a> to learn more.</p>
189189
</div>
190190

191+
<div id="EvothingsCordova" class="evo-box">
192+
<h2>Use Evothings Studio for Cordova app development</h2>
193+
<p>Evothings Studio makes it easy to develop Cordova apps. Check out how to use your Cordova project with the <a href="cordova-guide.html#SetupCordovaForEvothings">fast Evothings workflow</a>.</p>
194+
<p>It is easy and fun to get started with Evothings Studio. <a href="http://evothings.com/download/" target="_blank">Download now</a> and be up and running in 5 minutes!</p>
195+
</div>
196+
191197
<script src="../js/include-page-footer.js"></script>
192198
</div><!-- evo-page-content -->
193199
</div><!-- evo-page -->

0 commit comments

Comments
 (0)