Nokia X services SDK installer user guide
The Nokia X services SDK installer is an alternative to individually installing the Nokia X packages through Android SDK Manager. The Nokia X services SDK consists of a set of libraries and tools that you can use to develop or port new or existing apps respectively onto the Nokia X software platform. The SDK includes Nokia X services APIs, Nokia X emulator and Nokia X IDE extensions.
Before starting installation make sure you have downloaded the latest Android Developer Tools (ADT) Bundle including the Android SDK from http://developer.android.com/sdk/index.html.
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.
Once downloaded, launch eclipse and select Window->Android SDK Manager.
Install the following packages:
Android API version 4.1.2 API 16 and API version 4.3 API 18
- SDK Platform
- ARM EABI v7a System Image (emulator prerequisite for ARM system images)
- Intel x86 Atom System Image (emulator prerequisite for x86 system images)
- Android SDK Tools*
- Android SDK Platform-tools*
- Intel x86 Emulator Accelerator (emulator prerequisite for x86 system images)
*Latest version of these tools are recommended.
- Android API version 4.1.2 API 16 and API version 4.3 API 18
Installing Nokia X services SDK
Click the link provided to download SDK installer for Windows, Linux or Mac.
Unzip the folder and launch
Nokia X services SDK.exe.
For Linux (Ubuntu 11.10) 32-bit and 64-bit:
Unzip the folder and in the command terminal type
sudo ./Nokia_X_services_SDK.runto launch the installer.
Once the installation is complete the following folders appear locked and cannot be accessed:
To unlock type the command
sudo chown –R username:username <adt-root-path>.
NOTE: Run the installer with admin priveleges.
For Mac (OS X Lion 10.7.5) 64-bit:
Unzip the folder and extract the
Nokia X services SDK.dmg.
Nokia X services SDK.app.
NOTE: Depending on your security settings, when you attempt to launch the installer, you might get an error message displaying "Nokia X services SDK cannot be opened because it is from unindentified developer". If this happens, go to System Preferences->Security & Privacy and under Allow applications downloaded from, select Anywhere. Then launch the installer again.
Click Next in the Nokia X services SDK Setup wizard to start the installation process.
Select the path where the ADT root directory folder exists and click Next. This location must be the root folder of the ADT bundle that you downloaded earlier.
Optionally, you can select the ADT eclipse root folder to install the Eclipse plugins.
The Nokia X services SDK components are selected by default. A brief description of the components can be viewed upon selecting the components. Click Next.
Important: The Nokia X IDE extensions components get installed in the folder
<android-sdk-install>\eclipse\dropins\eclipse, if you have selected eclipse folder in the plugin path in the above mentioned step.
Nokia X IDE extensions is a set of plugins to enable ready to use code samples and Nokia X analyser, a code scanner tool that helps port your apps to Nokia X software platform.
Accept the license agreement and click Next.
Click Install to proceed with the installation.
Once the installation is complete click Finish to close the setup wizard.
The following packages are installed:
- Nokia X software platform 2.0 (API 18)
- Nokia X software platform 1.1 (API 16)
Nokia X services
- Nokia X Device Definitions
- Nokia X services SDK APIs and libs
- Nokia X USB Driver (not applicable for Linux and Mac)
- Nokia X IDE extensions
In addition, once the installation is complete the following gets installed:
http://tools.nokia.com/nokia-x/repository/addon.xmlis installed. To view open Android SDK Manager, click Tools->Manage Addon Sites and then click User Defined Sites tab. In case the URL is not visible follow the steps mentioned below to update.
Updating Nokia X services SDK
To ensure that you get the latest updates to the Nokia X services SDK, perform the following steps:
Open Android SDK Manager.
From the Tools menu, select Manage Add-on Sites.
In the User Defined Sites tab, click New. The Add Add-on Site URL dialog appears.
In the Add Add-on Site URL dialog, specify the following update URL as shown below and click OK.
From here on, any new updates to the Nokia X services SDK will be automatically displayed in Android SDK Manager.