Nokia X FAQ and Known Issues

SDK

Q: Are IDE (development tool) and simulator only available on Windows? Due to Java performance issues, we prefer developing on Ubuntu or OS X rather than Windows.
A: You use normal Android SDK and just add our add-on on top of it. This has been verified to work on Windows, Ubuntu and Mac.

Q: ADB doesn’t recognize my device! What is wrong?
A: Make sure that the ADB is configured properly and that the USB debugging (in device settings) is enabled. For more information, see Device setup page in Nokia X Developer’s Library.

Q: Our application is built using IntelliJ IDEA. Is that supported?
A: The SDK has been verified to work with IntelliJ IDEA.

Device

Q: I am using APK expansion to download large media assets for my game. How do I port this?
A: Download the media files from predefined location, instead of relying on License Verification Library. Since the disk space is limited (total size reserved for /sdcard partition is 2GB), we recommend using external SD card, if it has been inserted.

Q: Is Open GL supported?
A: Yes, Open GL ES 2.0 is supported.

Q: How much memory do I have available for application data?
A: The RAM available depends on the variant; Nokia X2 has 1 GB of RAM. Nokia X is in-line with other 512 MB devices. Nokia X+ and Nokia XL have 768 MB of RAM. Internal disk size is 4 GB on all devices and there is support for Micro SD card up to 32 GB size.

Q: How many and what kind of sensors and relevant APIs are supported in Nokia X devices?
A: Normal AOSP sensor APIs, normal sensors apart from Gyroscope. Proximity and light sensor, 3D accelerometer, GPS/A-GPS. No magnetometer or NFC.

Q: What are the user agents of Nokia X devices?
Nokia X2:

Mozilla/5.0 (Linux; Android 4.3; Nokia_X2 Build/JLS36C) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/34.0.1847.116 Mobile Safari/537.36 OPR/21.0.1437.75439


Nokia X Dual SIM:

Mozilla/5.0 (Linux; U; Android 4.1.2; zh-cn; Nokia_X Build/JZO54K) AppleWebKit/534.30 (KHTML, like Gecko) Version/4.0 Mobile Safari/534.30


Nokia X+ Dual SIM:

Mozilla/5.0 (Linux; U; Android 4.1.2; zh-cn; Nokia_X+ Build/JZO54K) AppleWebKit/534.30 (KHTML, like Gecko) Version/4.0 Mobile Safari/534.30


Nokia XL Dual SIM:

Mozilla/5.0 (Linux; U; Android 4.1.2; zh-cn; Nokia_XL Build/JZO54K) AppleWebKit/534.30 (KHTML, like Gecko) Version/4.0 Mobile Safari/534.30


User interface

Q: My application uses Holo theme. Can I keep on using that?
A: Yes. Holo theme is supported as-is.

Q: What is the hardware button layout and functionality?
A: Nokia X2 has two hardware buttons: Back and Home. On Nokia X/X+/XL there is only one hardware button, Back, and the Home button is emulated by long pressing the Back button. The options key, for apps that were build for Android 2.x target, is replaced by swipe-to-options gesture (swipe up from bottom edge).

Q: How do you exit an application to the home screen?
A: On Nokia X2 tap the Home button. On Nokia X/X+/XL long-press the Back button. Swipe-to-exit gesture works only on Nokia X/X+/XL and only with system applications and is not enabled by default. Swipe-to-exit can be enabled and disabled in phone settings.

Q: Is there support for WebP or WebM?
A: No. If you are serving WebP e.g. based on Android 4.1.2 User Agent, you should detect Nokia X device specifically and serve jpg/png instead.

Known Issues

Nokia X software platform 2.0

Not supported features:

Magnetometer sensor
Gyroscope sensor
NFC
Libwvm (Widevine DRM lib)
Flash player
Live Wallpaper
Speech recognition service
WMV Codec
VP8 video coded
WebP image coded
APK expansion files
Saving bookmarks to web browser from 3rd party apps
SpellCheckerService does not exist
com.android.future.usb API is not supported
Google Play services

Nokia X software platform 1.1

The values for xdpi and ydpi in the DisplayMetrics object, which should return the exact DPI of the device, return incorrect values.

Not supported features:

Magnetometer sensor
Gyroscope sensor
NFC
Libwvm (Widevine DRM lib)
Flash player
Live Wallpaper
Front camera (Not available on Nokia X / Nokia X+ - available on Nokia XL)
Camera autofocus (Not available on Nokia X / Nokia X+ - available on Nokia XL)
Speech recognition service
WMV Codec
VP8 video coded
WebP image coded
3rd party launcher support is limited. Notifications will not be shown for user if 3rd party launcher is active
Scrolling within homescreen widgets and resizing widgets
APK expansion files
Saving bookmarks to web browser from 3rd party apps
SpellCheckerService does not exist
There is no default handler for android.provider.MediaStore.RECORD_SOUND intent
Google Play services

SDK and emulator

Mac installer is not properly signed. To be able to install, you need to change Mac security settings to allow installation from any sources.
Video mode does not work in emulator camera.
Changed IMEI and MCC/MNC values reset to default values on restart of the emulator, unless Snapshot is selected in AVD emulation options.
People and Messaging apps may fail to respond occasionally.