將新 API 抽象化

假設您要使用動作列分頁做為應用程式頂層導覽的主要形式。很抱歉，ActionBar API 僅適用於 Android 3.0 以上版本 (API 級別 11 以上)。因此，如果您要將應用程式發行到執行舊版平台的裝置，就必須提供支援新版 API 的實作，同時提供使用舊版 API 的備用機制。

在這個類別中，您將建構分頁式使用者介面 (UI) 元件，使用具有版本專屬實作的抽象類別，以提供向後相容性。本課程將說明如何為新的分頁 API 建立抽象層，做為建構分頁元件的第一步。

準備抽象化

Java 程式設計語言中的「抽象」包含建立一或多個介面或抽象類別，以隱藏實作詳細資料。針對較新的 Android API，您可以使用抽象化來建構版本感知元件，在較新的裝置上使用目前的 API，並在舊版裝置上改用相容性較高的舊版 API。

使用這種方法時，您必須先決定要以向下相容的方式使用哪些較新的類別，然後根據較新類別的公開介面建立抽象類別。定義抽象介面時，請盡可能建立較新的 API 的鏡像。這麼做可盡可能提高向前相容性，並在日後不再需要抽象層時，更輕鬆地移除抽象層。

為新的 API 建立抽象類別後，即可在執行階段建立及選擇任意數量的實作項目。為了回溯相容，這些實作方式可能因所需的 API 級別而異。因此，某個實作項目可能會使用最近發布的 API，而其他實作項目則可使用舊版 API。

建立抽象分頁介面

如要建立可向下相容的分頁版，請先確定應用程式需要哪些功能和特定 API。針對頂層版面分頁，假設您符合下列功能需求：

1. 分頁指標應顯示文字和圖示。
2. 分頁可與片段執行個體建立關聯。
3. 活動應能監聽分頁變更。

預先備妥這些需求後，您就能控管抽象層的範圍。這表示您能省下建立多個抽象層的實作時間，更快開始使用新的回溯相容實作。

分頁的主要 API 位於 ActionBar 和 ActionBar.Tab 中。這些 API 會抽象化，讓分頁更容易辨識您的分頁。本範例專案的需求要求返回 Eclair (API 級別 5)，同時利用 Honeycomb (API 級別 11) 的新分頁功能。以下顯示支援這兩種實作及其抽象基礎類別 (或介面) 的類別結構圖表。

圖 1. 抽象基礎類別以及特定版本實作的類別圖表。

抽象動作列.Tab

如要開始建構分頁抽象層，請建立代表分頁的抽象類別，以鏡像 ActionBar.Tab 介面：

sealed class CompatTab(val tag: String) {
    ...
    abstract fun getText(): CharSequence
    abstract fun getIcon(): Drawable
    abstract fun getCallback(): CompatTabListener
    abstract fun getFragment(): Fragment

    abstract fun setText(text: String): CompatTab
    abstract fun setIcon(icon: Drawable): CompatTab
    abstract fun setCallback(callback: CompatTabListener): CompatTab
    abstract fun setFragment(fragment: Fragment): CompatTab
    ...
}

public abstract class CompatTab {
    ...
    public abstract CompatTab setText(int resId);
    public abstract CompatTab setIcon(int resId);
    public abstract CompatTab setTabListener(
            CompatTabListener callback);
    public abstract CompatTab setFragment(Fragment fragment);

    public abstract CharSequence getText();
    public abstract Drawable getIcon();
    public abstract CompatTabListener getCallback();
    public abstract Fragment getFragment();
    ...
}

您可以使用抽象類別 (而非介面) 來簡化常用功能的實作程序，例如分頁物件與活動的關聯 (不會顯示在程式碼片段中)。

抽象的 ActionBar 分頁方法

接下來，請定義抽象類別，讓您建立並新增分頁至活動，例如 ActionBar.newTab() 和 ActionBar.addTab()：

sealed class TabHelper(protected val activity: FragmentActivity) {
    ...

    abstract fun setUp()

    fun newTab(tag: String): CompatTab {
        // This method is implemented in a later lesson.
    }

    abstract fun addTab(tab: CompatTab)

    ...
}

public abstract class TabHelper {
    ...

    public CompatTab newTab(String tag) {
        // This method is implemented in a later lesson.
    }

    public abstract void addTab(CompatTab tab);

    ...
}

在後續課程中，您將建立 TabHelper 和 CompatTab 的實作方式，適用於舊版和新版平台。

另請參閱

• 動作列
• 動作列分頁