Kategorien
Android Computer / Informatik

Backward Compatible Android Programming

Hey everybody,

i just wanted to share my way of making Android apps backwards compatible with older Android versions.

In my case i have the „App Update Notifier“ app. Basically it checks your installed apps for available updates. Therefore it queries the Android Market (via Android Market API). To be able to do this one has to provide a valid google account login. On Android 2.x devices there is the AccountManager class that you can query for the phone’s account information and use this information. This way the user doesn’t have to provide his login details again for your app. He just needs to accept once that your app might use his login details. But this feature is not available on Android 1.x. So the user has to provide valid google login details in the settings of my app. Because of that there were two versions of „App Update Notifier“ in the Android Market at the beginning. „App Update Notifier (for 1.x)“ and „App Update Notifier (for 2.x)“.

But then i thought of a way to make both functionalities available in one app. So i had to think of a way to check whether AccountManager is available on the current device or not. So i came up with using Java Reflection. I wrote this simple function:
[sourcecode language=“java“]
public static boolean classAvailable(String name) {
try {
Class.forName(name);
return true;
} catch (ClassNotFoundException e) {
return false;
}
}
[/sourcecode]

It just tries to get the Class information for the given class and returns true if it exists and false if it’s not present in the current Android version.
This way it is easy to destinguish between the two versions. For example in my settings activity i have two possible layouts – the one where the user needs to enter his login details and the one where he doesn’t because they are provided through the AccountManager.

[sourcecode language=“java“]
if (classAvailable(„android.accounts.AccountManager“)) {
addPreferencesFromResource(R.xml.settingsscreen_2x);
} else {
addPreferencesFromResource(R.xml.settingsscreen_1x);
}
[/sourcecode]

This way you can check if a class you want to use is available on the device. But now you have a problem. The compiled DEX file contains stuff that might not exist on the current device. Android will then throw a VerifyException when it’s loading the DEX file. Now you have two options: use Reflection only to call your stuff (which is ok when only have to call a single method or so) or you need to seperate the code for different Android versions. So you only have supported references in you invoked dex file. For example i have a class with the AccountManager implementation called Helper2x and a class with the old way called Helper1x. This way on an Android 1.x device, the Helper2x DEX file will never be loaded and therefore will not throw an exception.

Hope that helps many of you to make their app better backwards compatible.
Gr33tz Goddchen
[ad]