- install android and ionic
- build a To-Do App using ionic
Cordova, used by ionic, allows you to build a web app into a a mobile app that can run on any platform.
In ionic the most common platforms you may target are, ios, android, and browser. To build for ios you will need a Mac. The ionic guide assumes you are a Mac user. accordingly if you're an Ubuntu user you can only target the browser and android platforms.
You don't really need to install these platforms to test, you can signup on ionic.io and upload your apps there for testing and sharing with other people.
In practice you will probably not want to upload your app every-time during development (this is only a valid work-flow in case you don't have a platform like ubuntu not having ios). Therefor we recommend you install the platforms on your device, however you should know that an alternative exists.
You can follow along the tutorial while you wait for things to download (it will take a while)
For Mac users to install ios you will need x-code.
For completeness to build for ios if you don't have a mac you can follow these instructions for windows
The guide references in the middle though not clear this link for installing android on your system.
To run android you will need to install java and the android sdk. (Estimated size 500MB for both in total)
At the time of writing android requires jdk 1.8 you could install the Oracle version by downloading it from here. You can also do it using the command line by through open-jdk by following this guide
Google has a nice summary on how to install android with android studio. Make sure you select instructions for your operating system.
Don't forget in case of Ubuntu
$ sudo apt-get install lib32z1 lib32ncurses5 lib32bz2-1.0 lib32stdc++6
Android has an SDK for each version of android
Ionic currently uses the android-23, you should install it
- Open android studio
- Using the the configure dropdown selecting SDK Manager
- Select API level 23 also known as android marshmallow
- Hit Apply
The first time you build java will downoad gradle from maven (java's npm) so you may need to wait a bit
We generally recommend you test your ionic apps directly from your phone directly using ionic run android
however the guide follows emulation and in practice it may be easier
To use ionic emulate android
you will need to create a virtual machine, you can do that with the Android Virtual Device Manager AVD.
On macs the Tools menu is only accessible if you create a project so create a simple project and then navigate to Tools > Android > AVD Manager
Make sure you close and restart Android Studio after you have installed the SDK
If after you reopen the project you don't see Android in your Tools section yet then you may need to enable AVD integration close the app, open the SDK Manager from the configure dropdown, search for AVD and you should see Enable AVD Integration double click.
Once you have the Virtual Devices window open add a device (say Nexsus 5) and download it's image.
If are following along with the ionic guide you should notice that they also recommend running from an actual device or emulating using Genymotion instead of the built in avd
Now you should be capable of running ionic emulate android
We recommend you use your laptop and have everything pre-installed to follow the guide normally.
- You will need to run android apps so install the android sdk, for ios apps you will need x-code see pre-tutorial section.
- while you're waiting for android and ios to download you can try to simply follow the getting started guide but only use the browser platform.
- Follow this guild to get started with a To-do app, remember to modify it as instructed bellow.
http://ionicframework.com/docs/guide/preface.html
- The guide assumes you have a blank page website, so it will give you all the code you need even though some of it may seem there, make sure your index.html for example matches the guide
- Read the links to other parts of the documentation, investing the time in learning a bit more about each part will make your development easier.
- In the Testing your app part, do only browser serve if you still don't have android or the other platforms.
- For ios when you build it may ask you to npm install additional packages.
- The red buttons open useful notes that may be relevant read them.
- You don't need to release your app though that would be cool
Generally for developing using ionic across platforms you could install the Intel XDK platform https://software.intel.com/en-us/intel-xdk
Which allows you to create a clean ionic project, features a GUI editor, as well offer a way of emulating across devices without having to install anything extra (for teams with no Mac user).