Android Development FAQs

General Android FAQs

What are minimum requirements to run Mobile SDK?

The following are minimum hardware and software requirements to run an application based on Mobile SDK:

• Android 2.2 (API Level 8)
• Open GLES 2.0
• ARMv7 supported processor
• Camera

Where can I find documentation of the Java classes?

The documentation (javadocs) of the Java classes are included in the JAR file (as_unifeyesdlmobile.jar).

Example application closes with java.lang.ClassNotFoundException

An application that uses Mobile SDK must be build using at least Android API Level 9 (2.3.1), other wise some of the classes will not be included in the final APK.

Note that you can still run the application on minimum target API Level 8 (Android 2.2), by setting appropriate flags in the AndroidManifest .

What is best place to load tracking data, 3D models and billboards?

The best place to load contents into Mobile SDK is in onSurfaceCreated callback of UnifeyeGLSurfaceView . However, if contents are to be changed dynamically, they have to be loaded inside the context of OpenGL thread, otherwise the behavior may be unexpected and may lead to crash.

The following code snipper shows how to execute anything within OpenGL thread:

mUnifeyeSurfaceView.queueEvent(new Runnable() 
{
    @Override
    public void run() {
        // any code here will be executed in OpenGL thread
        // always load tracking data, 3D models or billboards here, but never perform any heavy processing or update GUI elements
    }
});

Android Projects FAQs

The following are answers to some FAQs if you are doing a project with metaio based on Mobile SDK on Android.

How much size does Mobile SDK adds to my project?

The Mobile SDK adds roughly 7MB to your final application without contents.

How to install an APK package?

If you have received (or downloaded) an APK on your PC, here are steps to install it on your device:

1. Enable Settings->Applications->Unknown Sources on your device

Connect the device to the PC and mount the SD card (some devices such as tablets can automatically mounts external storage).

Copy the APK on the device, and disconnect it with the PC after unmounting sd card (or external storage)

Install ASTRO File Manager on your device. Its freely available on Android Market.

Open ASTRO and go to File Manager. Browse for the APK you just copied (on the sdcard). Click on the APK and select "Open App Manager" from the popup.

If there an existing version already installed, please uninstall it first. Then click Install to install the application:

I cannot install a provided APK from metaio. What can I do?

1. Unifeye SDK is only supported on devices with ARMv7 instruction set. Please check if your device supports ARMv7. Download <a href="https://market.android.com/details?id=com.electricsheep.asi&feature=search_result" title="Android System Info">Android System Info</a>, go to System tab and then expand CPU.
2. First check if the option under Settings->Applications->Unknown Sources is still disabled, enable it and try installing the application.
3. Do have a previous version of application installed? Uninstall it first and than reinstall the application!
4. Do you have a SD card installed and can your phone access it? If your phone cannot access a SD card the application will most likely not work at all, because all of our applications need a SD card.
5. In the case you are downloading the application over a provided link with your phone, be sure the download process finished completely.
6. If you cannot download the application, try to download it with your computer and follow the steps described in "How to install an APK package?"

In the case that none of the previous steps have helped, just contact us and tell us the following things to the best of our knowledge:

• What is the exact name of your android phone?
• What android version do you use? Settings->About phone->Android version
• What part of the installation didn't work?
• What steps have you already taken to install the application? Over the Internet or an SD card or maybe the Android Market?
• Have you got an error message? Can you tell us the complete message?

How to submit a crash report on Android?

The crash log can be captured on Android using a free utility called aLogCat.

When the application crashes, please run this utility and send the crash report directly by email if you have configured an acount on the device. Alternatively, you may also save it on SD card and send it later.

The following additional information be will helpfull:

• Device model number (e.g. HTC Desire, Samsung Galaxy), operating system (firmware) version (e.g. Android 2.2.1). You can retrieve this information in Settings-->About Phone
• Unifeye SDK version
• Steps to reproduce the crash

Submission process for Google Play

To submit an application to Google Play (previously known as Android Market), the following steps are needed:

• Register as a developer on the Android Market
  • http://market.android.com/publish/signup
  • 25$ one-time registration fee
• Upload the application file and fill out the upload form
• Helpful links: http://www.google.com/support/androidmarket/developer/ , e.g. for questions regarding age rating ( http://www.google.com/support/androidmarket/developer/bin/answer.py?&answer=188189)
  or http://help.appmakr.com/entries/332047-publishing-android-app-apk-to-android-market

The required information for submission is as follows:

• Language
• Title (max 30 characters)
• Description (max 4000 characters)
• Recent changes (add notes in case of an update)
• Price
• Promo text (max 80 characters, accompanies promotional graphic)
• App-Type ("Applications" or "Games")
• Category (see here for a list of categories: http://www.google.com/support/androidmarket/developer/bin/answer.py?&&answer=113475)
• Copy protection
• Submission countries
• At least 2 screenshots of the application (resolution either 320x480, 480x800, 480x854 or 1280x800, 24-bit-png or jpg, no alpha)
• High resolution application icon (512x512 32-bit png or jpg)
• Contact information (website, Email or phone number)
• Optional: Promotional graphic (180x120 24-bit png or jpg, no alpha)
• Optional: Feature graphic (1024x500 24-bit png or jpg, no alpha)
• Optional: Promotional video (Youtube URL)