Android 應用程式向低版本相容的問題
可以設定minSdkVersion:
-
<manifest>
-
<uses-sdk android:minSdkVersion="3" />
- </manifest>
使用反射
假設你想使用android.os.Debug.dumpHprofData(String filename)這個新的方法。Debug這個類自從Android 1.0的時候就已經存在了,但這個方法在Android 1.5(API等級3)中才新增的。如果你想直接呼叫它,那麼,在Android 1.1或更早的裝置上,你的app將執行失敗。
最簡單的方式是通過反射的方式來呼叫這個方法。這需要做一次查詢並在Method物件上進行快取。呼叫這個方法實質上是在呼叫Method.invoke,並對結果進行拆箱。參考以下內容:
-
public class Reflect {
-
private static Method mDebug_dumpHprofData;
-
static {
-
initCompatibility();
-
};
-
private static void initCompatibility() {
-
try {
-
mDebug_dumpHprofData = Debug.class.getMethod(
-
"dumpHprofData", new Class[] { String.class } );
-
/* success, this is a newer device */
-
} catch (NoSuchMethodException nsme) {
-
/* failure, must be older device */
-
}
-
}
-
private static void dumpHprofData(String fileName) throws IOException {
-
try {
-
mDebug_dumpHprofData.invoke(null, fileName);
-
} catch (InvocationTargetException ite) {
-
/* unpack original exception when possible */
-
Throwable cause = ite.getCause();
-
if (cause instanceof IOException) {
-
throw (IOException) cause;
-
} else if (cause instanceof RuntimeException) {
-
throw (RuntimeException) cause;
-
} else if (cause instanceof Error) {
-
throw (Error) cause;
-
} else {
-
/* unexpected checked exception; wrap and re-throw */
-
throw new RuntimeException(ite);
-
}
-
} catch (IllegalAccessException ie) {
-
System.err.println("unexpected " + ie);
-
}
-
}
-
public void fiddle() {
-
if (mDebug_dumpHprofData != null) {
-
/* feature is supported */
-
try {
-
dumpHprofData("/sdcard/dump.hprof");
-
} catch (IOException ie) {
-
System.err.println("dump failed!");
-
}
-
} else {
-
/* feature not supported, do something else */
-
System.out.println("dump not supported");
-
}
-
}
- }
使用靜態初始化方法來呼叫initCompatibility,進行方法的查詢。如果查詢成功的話,使用一個私有的方法(與原始的函式簽名一致——引數,返回值、異常檢查)來替換方法的呼叫。返回值(如果有的話)和異常都如同原始的方法一樣進行返回。fiddle方法演示了程式的選擇邏輯,是呼叫新的API還是在新API無效的情況下作其它的事情。
對於每個你想呼叫的方法,你可能要新增一個額外的私有Method欄位,欄位初始化方法,和對呼叫的包裝方法。
如果想呼叫一個之前未定義的類的方法的話,就比較複雜了。並且,呼叫Method.invoke()比直接呼叫這個方法要慢很多。這種情況可以通過一個包裝類來緩和一下。
使用包裝類
想法是建立一個新的類,來包裝新的或已經存在的類暴露出來的所有的新API。包裝類中的每個方法只是呼叫相應的真實方法並返回相同的結果。
如果目標類和方法存在的話,能得到與直接呼叫相同的行為,並有少量的效能損失。如果目標類或方法不存在的話,包裝類的初始化會失敗,並且你的應用程式知道必須避免使用這些新的方法。
假設這個類是新增的:
-
public class NewClass {
-
private static int mDiv = 1;
-
private int mMult;
-
public static void setGlobalDiv(int div) {
-
mDiv = div;
-
}
-
public NewClass(int mult) {
-
mMult = mult;
-
}
-
public int doStuff(int val) {
-
return (val * mMult) / mDiv;
-
}
- }
我們可能這樣建立一個包裝類:
-
class WrapNewClass {
-
private NewClass mInstance;
-
/* class initialization fails when this throws an exception */
-
static {
-
try {
-
Class.forName("NewClass");
-
} catch (Exception ex) {
-
throw new RuntimeException(ex);
-
}
-
}
-
/* calling here forces class initialization */
-
public static void checkAvailable() {}
-
public static void setGlobalDiv(int div) {
-
NewClass.setGlobalDiv(div);
-
}
-
public WrapNewClass(int mult) {
-
mInstance = new NewClass(mult);
-
}
-
public int doStuff(int val) {
-
return mInstance.doStuff(val);
-
}
- }
包裝類擁有和原始類一模一樣的方法和建構函式,加上一個靜態的初始化方法和測試方法來檢查新類是否存在。如果新類不可獲得的話,WrapNewClass的初始化會失敗,因此,要確保包裝類在這種情況下不要被使用。checkAvailable方法是一種強制類進行初始化的簡單方法。我們可以像這樣來使用:
-
public class MyApp {
-
private static boolean mNewClassAvailable;
-
/* establish whether the "new" class is available to us */
-
static {
-
try {
-
WrapNewClass.checkAvailable();
-
mNewClassAvailable = true;
-
} catch (Throwable t) {
-
mNewClassAvailable = false;
-
}
-
}
-
public void diddle() {
-
if (mNewClassAvailable) {
-
WrapNewClass.setGlobalDiv(4);
-
WrapNewClass wnc = new WrapNewClass(40);
-
System.out.println("newer API is available - " + wnc.doStuff(10));
-
} else {
-
System.out.println("newer API not available");
-
}
-
}
- }
如果呼叫checkAvailable成功,我們知道新的類是系統的一部分。如果它失敗了,我們知道新的類不存在,並作相應的調整。應該指出的是,由於位元組碼校驗不支援對一個不存在的類的引用,因此,在呼叫checkAvailable之前就有可能失敗。像例項程式碼那樣構建,結果是一樣的,可能位元組碼校驗丟擲異常或者Class.forName的呼叫丟擲異常。
當包裝一個有新方法的已存類時,你只需要在包裝類中新增新的方法。老的方法直接呼叫。新的方法需要在WrapNewClass的靜態初始化方法中作一次反射檢查。
測試是關鍵
你必須測試任何想支援的Android框架版本。一般來說,應用程式在不同的版本上行為不同。記住一條法則:如果你不嘗試,它就不能工作。
你可以在老版本平臺的模擬器上執行應用程式來測試程式的後向相容性。由於可以建立不同API等級的“虛擬裝置”,因此,你可以很容易地進行測試。一旦你建立了AVD,你就可以在新老版本系統上進行程式測試,也許你還可以一邊測試一邊觀察它們的不同點。