Android各版本間API的差別 - ActionBar

概述

ActionBar是在Android 3.0 (API LEVEL 11) 中添加進來的, 向下版本到2.1, 則須要使用support-v7. 而2.1如下版本則須要自行實現了.

差別

Android 3.0+請參考官方文檔. Android 2.1+使用時則須要注意如下幾點: 

1. 引用support-v7

2. Activity 必須繼承 android.support.v7.app.ActionBarActivity

3. 定義菜單: menu.xml中, 須要使用自定義xml-namespace, 並在設置部分Item屬性時使用該namespace, 如 showAsAction 屬性

4. 設置樣式: themes.xml中, 設置style的item的name屬性時, 不須要 android: 前綴

除了上述差別外, 在定義Up Navigation特性時, 也須要注意, 若調用了以下代碼,: 

getActionBar().setDisplayHomeAsUpEnabled(true);
/* or
 * getSupportActionBar().setDisplayHomeAsUpEnabled(true);
 */

則須要在AndroidManifest.xml中設置Activity的屬性, 以下:

<activity
    android:name="com.example.app.ChildActivity"
    android:label="@string/title_child_activity"
    android:parentActivityName="com.example.app.MainActivity" >
    <!-- Parent activity meta-data to support API level 4+ -->
    <meta-data
        android:name="android.support.PARENT_ACTIVITY"
        android:value="com.example.app.MainActivity" />
</activity>

須要注意的是, API Level 16 在AndroidManifest.xml中, 新增了Activity的新屬性android:parentActivityName, 來替代向下版本的meta-data.

參考資料

http://developer.android.com/training/basics/actionbar/index.html