Download the latest Android Developer Tools (ADT) Bundle including the Android SDK from http://developer.android.com/sdk/index.html. Install the software by following the instructions at http://developer.android.com/sdk/installing/bundle.html. Note that the website automatically detects your OS and provides the appropriate installation package.
Note that Eclipse IDE, which is included in the ADT Bundle, requires JDK to work (JRE alone is not sufficient). Make sure that the bit version of the bundle matches the JDK, i.e., both need to be either 32-bit or 64-bit. Having different versions will result in an error. The general recommendation is to install the latest JDK version, but depending on the host platform some compatibility problems may arise. The supported JDK versions of each Eclipse IDE are listed in the Eclipse project release notes, which can be found at www.eclipse.org.
Launch the Android SDK Manager. The manager application can be launched from the IDE or the command line. Launching the manager from the command line:
<Android SDK installation path>\SDK Manager.exe
Linux and Mac
<Android SDK installation path>/tools/android sdk
Tip: If you prefer using the command line tools, add the paths to the executable tools into environment variables so that you don't have to explicitly define the path when using a tool. A guide demonstrating how to do this for each host platform can be found here.
To launch the Android SDK Manager in IDE: first, launch Eclipse. Then, in Windows and Linux, select Window -> Android SDK Manager (figure 1). In Mac, locate the Android SDK Manager icon from menu on the top of the IDE window (tooltips are provided) and click the icon to open (figure 2).
Install the following packages:
*) Installed by default, but update to the latest version is recommended. You may run into problems with the environment with outdated packages.
In addition, for Nokia X2 install the packages for Android 4.3 API 18:
For Nokia X/X+/XL install the packages for Android 4.1.2 API 16:
The packages above are required by the Nokia X software platform development environment. Note that there is no need to uninstall any packages that are installed by default.
Video: Installing standard Android SDK
You can install the Nokia X specific packages with the SDK Manager by providing a new add-on site URL. Alternatively, you can use an installer to install the packages. The instructions for using the installer are provided in the download package.
The steps for installing the Nokia X packages with the SDK Manager are the following:
Enter the following URL to the Add Add-on Site URL dialog:
Click the Close button to close the Add-on Sites window
You should now see the following packages available for install in the SDK Manager. The system image is different depending on whether you are developing for Nokia X2 or Nokia X/X+/XL. For the aforementioned you should have:
And for Nokia X/X+/XL:
The extras packages are the same for both:
In case the Nokia X add-on fails to load (SDK Manager displays error message: "Addon failed to load: Unable to find base platform with API level '16'"), you probably missed the instructions to install the correct Android API packages as described in step 2. If this was the case, install the missing packages and restart the SDK Manager.
Video: Installing Nokia X packages
To set up the emulator, we need to create a new Android Virtual Device (AVD). Like installing packages, this can also be done either from the Eclipse IDE, or by command. From Eclipse: in Windows and Linux, select Window -> Android Virtual Device Manager (figure 1). In Mac, locate the Android Virtual Device Manager icon from the menu and click the icon to launch the manager (figure 2). If the menu is not visible, go to Window -> Show Toolbar. Launching the AVD manager from the command line can be done with command:
<Android SDK installation path>\tools\android avd
Linux and Mac
<Android SDK installation path>/tools/android avd
Open the Device Definition tab, select Nokia X by Nokia or Nokia X2 by Nokia from the list of devices and click Create AVD button (see figure 5).
Provide a name for the AVD, for example "AVD_for_Nokia_X" or "AVD_for_Nokia_X2". Also, ensure that the target of the AVD is:
It is recommended to set a SD card and check Use Host GPU since those are required to run HERE applications, change the IMEI and MCC/MNC number of the emulator, and to run Xpress Browser (figures 6 and 7). Select the desired AVD from the CPU/ABI drop-down and select the Skin option as Skin with dynamic hardware controls. Once you are happy with the settings click OK to create the virtual device. Note that you can change the settings of the AVD later.
To verify that the emulator works, you can launch it by going back to Android Virtual Devices tab in Android Virtual Device Manager, selecting the created AVD and clicking the Start button (figures 7 and 8). You can also launch the AVD from the command line:
<Android SDK installation path>\tools\emulator -avd AVD_for_Nokia_X2
Linux and Mac
<Android SDK installation path>/tools/emulator -avd AVD_for_Nokia_X2
(Syntax: emulator -avd <the name of the AVD to launch>)
Note: While launching the Intel Atom x86 AVD, if you get the following error message, it means that the Intel HAXM executable is not installed. Refer to step 2 to install the executable. However, this does not affect the working of the AVD in any manner.
Video: Setting up the emulators
Using the Snapshot feature
Using the snapshot feature allows the emulator state to be persistent between emulator executions. This will also make the emulator start up faster. Unfortunately, GPU emulation cannot be used together with this feature and thus, you cannot work with HERE Maps, if this feature is enabled. However, if you don't need GPU emulation, you can use the feature with no problems.
To enable and test the Snapshot feature, do the following:
Last updated 25 June 2014