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.
Dank der verzögerten Klassenladefunktion können Sie in diesen konkreten Klassen direkt neuere APIs verwenden, ohne dass es auf älteren Geräten zu Abstürzen kommt. 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 Namen der API-Ebene oder des Plattformversionscodes an die APIs anzuhängen, die von den jeweiligen Klassen benötigt werden. 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 alle Methodenaufrufe einfach an das enthaltene ActionBar.Tab-Objekt weiter.
Implementiere CompatTabHoneycomb mit den 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.
Implementiere TabHelperHoneycomb, um Methodeaufrufe an die ActionBar API zu proxyen:
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.
}