Auf die neuen APIs umstellen

In dieser Lektion erfahren Sie, wie Sie die abstrakten Klassen CompatTab und TabHelper ableiten und neue APIs verwenden. Ihre App kann diese Implementierung auf Geräten verwenden, auf denen eine Plattformversion ausgeführt wird, die diese unterstützt.

Tabs mithilfe neuer APIs implementieren

Die konkreten Klassen für CompatTab und TabHelper, die neuere APIs verwenden, sind eine Proxy-Implementierung. Da die in der vorherigen Lektion definierten abstrakten Klassen den neuen APIs (Klassenstruktur, Methodensignaturen usw.) entsprechen, stellen die konkreten Klassen, die diese neueren APIs verwenden, Methodenaufrufe und deren Ergebnisse einfach weiter.

Sie können neuere APIs direkt in diesen konkreten Klassen verwenden und nicht auf früheren Geräten abstürzen, da Lazy Class Loading verwendet. Klassen werden beim ersten Zugriff geladen und initialisiert, wodurch die Klasse instanziiert oder auf eines ihrer statischen Felder oder Methoden zum ersten Mal zugegriffen wird. Solange Sie also nicht die Honeycomb-spezifischen Implementierungen auf Geräten vor Honeycomb instanziieren, löst die Dalvik-VM keine VerifyError-Ausnahmen aus.

Eine gute Benennungskonvention für diese Implementierung besteht darin, den Codenamen für die API-Ebene oder Plattformversion anzufügen, der den APIs entspricht, die für die konkreten Klassen erforderlich sind. Die native Tab-Implementierung kann beispielsweise über die Klassen CompatTabHoneycomb und TabHelperHoneycomb bereitgestellt werden, da diese auf APIs basieren, die ab Android 3.0 (API-Level 11) verfügbar sind.

Abbildung 1: Klassendiagramm für die Honeycomb-Implementierung von Tabs.

CompatTabHoneycomb implementieren

CompatTabHoneycomb ist die Implementierung der abstrakten Klasse CompatTab, mit der in TabHelperHoneycomb auf einzelne Tabs verwiesen wird. CompatTabHoneycomb leitet einfach alle Methodenaufrufe an das enthaltene ActionBar.Tab-Objekt weiter.

Implementieren Sie CompatTabHoneycomb mithilfe der neuen ActionBar.Tab APIs:

Kotlin

class CompatTabHoneycomb internal constructor(val activity: Activity, tag: String) :
        CompatTab(tag) {
    ...
    // The native tab object that this CompatTab acts as a proxy for.
    private var mTab: ActionBar.Tab =
            // Proxy to new ActionBar.newTab API
            activity.actionBar.newTab()

    override fun setText(@StringRes textId: Int): CompatTab {
        // Proxy to new ActionBar.Tab.setText API
        mTab.setText(textId)
        return this
    }

    ...
    // Do the same for other properties (icon, callback, etc.)
}

Java

public class CompatTabHoneycomb extends CompatTab {
    // The native tab object that this CompatTab acts as a proxy for.
    ActionBar.Tab mTab;
    ...

    protected CompatTabHoneycomb(FragmentActivity activity, String tag) {
        ...
        // Proxy to new ActionBar.newTab API
        mTab = activity.getActionBar().newTab();
    }

    public CompatTab setText(int resId) {
        // Proxy to new ActionBar.Tab.setText API
        mTab.setText(resId);
        return this;
    }

    ...
    // Do the same for other properties (icon, callback, etc.)
}

TabHelperHoneycomb implementieren

TabHelperHoneycomb ist die Implementierung der abstrakten Klasse TabHelper, die Methodenaufrufe an eine tatsächliche ActionBar weiterleitet, die aus der enthaltenen Activity abgerufen wurde.

Implementieren Sie TabHelperHoneycomb, Proxy-Methodenaufrufe an die ActionBar API:

Kotlin

class TabHelperHoneycomb internal constructor(activity: FragmentActivity) : TabHelper(activity) {

    private var mActionBar: ActionBar? = null

    override fun setUp() {
        mActionBar = mActionBar ?: mActivity.actionBar.apply {
            navigationMode = ActionBar.NAVIGATION_MODE_TABS
        }
    }

    override fun addTab(tab: CompatTab) {
        // Tab is a CompatTabHoneycomb instance, so its
        // native tab object is an ActionBar.Tab.
        mActionBar?.addTab(tab.getTab() as ActionBar.Tab)
    }
}

Java

public class TabHelperHoneycomb extends TabHelper {
    ActionBar actionBar;
    ...

    protected void setUp() {
        if (actionBar == null) {
            actionBar = activity.getActionBar();
            actionBar.setNavigationMode(
                    ActionBar.NAVIGATION_MODE_TABS);
        }
    }

    public void addTab(CompatTab tab) {
        ...
        // Tab is a CompatTabHoneycomb instance, so its
        // native tab object is an ActionBar.Tab.
        actionBar.addTab((ActionBar.Tab) tab.getTab());
    }

    // The other important method, newTab() is part of
    // the base implementation.
}

Weitere Informationen

• Aktionsleiste
• Aktionsleisten-Tabs