使用旧版 API 创建实现

本课程讨论如何创建镜像更新 API 但同时支持旧版设备的实现。

确定替代方案

以向后兼容的方式使用更新的 UI 功能最具挑战性的任务是确定和实现旧版平台版本的旧版（回退）解决方案。在许多情况下，可以使用旧版 UI 框架功能来实现这些更新的 UI 组件的目的。例如

可以使用包含图像按钮的水平LinearLayout来实现操作栏，作为自定义标题栏或活动布局中的视图。溢出操作可以在设备菜单按钮下显示。
可以使用包含按钮的水平LinearLayout或使用TabWidget UI 元素来实现操作栏选项卡。
NumberPicker和Switch部件分别可以使用Spinner和ToggleButton部件来实现。
ListPopupWindow和PopupMenu部件可以使用PopupWindow部件来实现。

通常没有适用于将更新的 UI 组件向后移植到旧版设备的万能解决方案。请注意用户体验：在旧版设备上，用户可能不熟悉更新的设计模式和 UI 组件。考虑一下如何使用熟悉的元素来提供相同的功能。在许多情况下，这不太令人担忧——如果更新的 UI 组件在应用程序生态系统中很突出（例如操作栏），或者交互模型非常简单直观（例如使用ViewPager的滑动视图）。

使用旧版 API 实现选项卡

要创建操作栏选项卡的旧版实现，可以使用TabWidget和TabHost（尽管也可以使用水平布局的Button部件）。将其实现到名为TabHelperEclair和CompatTabEclair的类中，因为此实现使用的是在 Android 2.0（Eclair）或之后引入的 API。

Class diagram for the Eclair implementation of tabs.

图 1. 选项卡的 Eclair 实现的类图。

CompatTabEclair实现将选项卡属性（例如选项卡文本和图标）存储在实例变量中，因为没有可用于处理此存储的ActionBar.Tab对象。

Kotlin

class CompatTabEclair internal constructor(val activity: FragmentActivity, tag: String) :
        CompatTab(tag) {

    // Store these properties in the instance,
    // as there is no ActionBar.Tab object.
    private var text: CharSequence? = null
    ...

    override fun setText(resId: Int): CompatTab {
        // Our older implementation simply stores this
        // information in the object instance.
        text = activity.resources.getText(resId)
        return this
    }

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

Java

public class CompatTabEclair extends CompatTab {
    // Store these properties in the instance,
    // as there is no ActionBar.Tab object.
    private CharSequence text;
    ...

    public CompatTab setText(int resId) {
        // Our older implementation simply stores this
        // information in the object instance.
        text = activity.getResources().getText(resId);
        return this;
    }

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

TabHelperEclair实现利用TabHost部件上的方法来创建TabHost.TabSpec对象和选项卡指示器。

Kotlin

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

    private var tabHost: TabHost? = null
    ...

    override fun setUp() {
        // Our activity layout for pre-Honeycomb devices
        // must contain a TabHost.
        tabHost = tabHost ?: mActivity.findViewById<TabHost>(android.R.id.tabhost).apply {
            setup()
        }
    }

    override fun addTab(tab: CompatTab) {
        ...
        tabHost?.newTabSpec(tab.tag)?.run {
            setIndicator(tab.getText()) // And optional icon
            ...
            tabHost?.addTab(this)
        }
    }
    // The other important method, newTab() is part of
    // the base implementation.
}

Java

public class TabHelperEclair extends TabHelper {
    private TabHost tabHost;
    ...

    protected void setUp() {
        if (tabHost == null) {
            // Our activity layout for pre-Honeycomb devices
            // must contain a TabHost.
            tabHost = (TabHost) mActivity.findViewById(
                    android.R.id.tabhost);
            tabHost.setup();
        }
    }

    public void addTab(CompatTab tab) {
        ...
        TabSpec spec = tabHost
                .newTabSpec(tag)
                .setIndicator(tab.getText()); // And optional icon
        ...
        tabHost.addTab(spec);
    }

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

您现在有两个CompatTab和TabHelper实现：一个在运行 Android 3.0 或更高版本的设备上运行并使用新的 API，另一个在运行 Android 2.0 或更高版本的设备上运行并使用旧版 API。下一课将讨论如何在您的应用程序中使用这些实现。

代理到更新的 API

使用版本感知组件