שימוש ברכיב לניהול גרסאות

עכשיו, אחרי שיש לך שתי הטמעות של TabHelper ו-CompatTab – אחת ל-Android 3.0 ואילך ואחת לגרסאות קודמות של הפלטפורמה – הגיע הזמן ליישם אותן בהטמעות האלה. במדריך הזה נסביר איך יוצרים את הלוגיקה למעבר בין ההטמעות האלה, איך יוצרים פריסות שמותאמות לגרסאות שונות, ובסוף איך משתמשים ברכיב ממשק המשתמש התואם לאחור.

הוספת הלוגיקה של המעבר

הכיתה המצומצמת TabHelper פועלת כמפעל ליצירת מכונות TabHelper ו-CompatTab בהתאם לגרסה, על סמך גרסת הפלטפורמה הנוכחית של המכשיר:

sealed class TabHelper(protected val mActivity: FragmentActivity, protected val tag: String) {

    abstract fun setUp()

    abstract fun addTab(tab: CompatTab)

    // Usage is tabHelper.newTab("tag")
    fun newTab(tag: String): CompatTab =
            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.HONEYCOMB) {
                CompatTabHoneycomb(mActivity, tag)
            } else {
                CompatTabEclair(mActivity, tag)
            }

    companion object {
        // Usage is TabHelper.createInstance(activity)
        fun createInstance(activity: FragmentActivity): TabHelper =
                if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.HONEYCOMB) {
                    TabHelperHoneycomb(activity)
                } else {
                    TabHelperEclair(activity)
                }
    }
}

public abstract class TabHelper {
    ...
    // Usage is TabHelper.createInstance(activity)
    public static TabHelper createInstance(FragmentActivity activity) {
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.HONEYCOMB) {
            return new TabHelperHoneycomb(activity);
        } else {
            return new TabHelperEclair(activity);
        }
    }

    // Usage is tabHelper.newTab("tag")
    public CompatTab newTab(String tag) {
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.HONEYCOMB) {
            return new CompatTabHoneycomb(mActivity, tag);
        } else {
            return new CompatTabEclair(mActivity, tag);
        }
    }
    ...
}

יצירת פריסה של פעילות מבוססת-גרסאות

השלב הבא הוא לספק פריסות לפעילות שלכם שיכולות לתמוך בשתי הטמעות הכרטיסיות. בהטמעה הישנה יותר (TabHelperEclair), צריך לוודא שפריסת הפעילות מכילה רכיבים מסוג TabWidget ו-TabHost, יחד עם מאגר לתוכן הכרטיסיות:

res/layout/main.xml:

<!-- This layout is for API level 5-10 only. -->
<TabHost xmlns:android="http://schemas.android.com/apk/res/android"
    android:id="@android:id/tabhost"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <LinearLayout
        android:orientation="vertical"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:padding="5dp">

        <TabWidget
            android:id="@android:id/tabs"
            android:layout_width="match_parent"
            android:layout_height="wrap_content" />

        <FrameLayout
            android:id="@android:id/tabcontent"
            android:layout_width="match_parent"
            android:layout_height="0dp"
            android:layout_weight="1" />

    </LinearLayout>
</TabHost>

בהטמעה של TabHelperHoneycomb, כל מה שצריך הוא FrameLayout שיכיל את תוכן הכרטיסייה, כי מחווני הכרטיסיות מסופקים על ידי ActionBar:

res/layout-v11/main.xml:

<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:id="@android:id/tabcontent"
    android:layout_width="match_parent"
    android:layout_height="match_parent" />

זמן ריצה, מערכת Android תחליט איזו גרסה של הפריסה main.xml להנפיח, בהתאם לגרסת הפלטפורמה. זו הלוגיקה שהוצגה בקטע הקודם כדי לקבוע באיזו הטמעה של TabHelper להשתמש.

איך להשתמש ב-TabHelper בפעילות

בשיטה onCreate() של הפעילות, אפשר לקבל אובייקט TabHelper ולהוסיף כרטיסיות באמצעות הקוד הבא:

override fun onCreate(savedInstanceState: Bundle?) {
    ...
    setContentView(R.layout.main)

    TabHelper.createInstance(this).apply {
        setUp()

        newTab("photos")
                .setText(R.string.tab_photos)
                .also { photosTab ->
                    addTab(photosTab)
                }

        newTab("videos")
                .setText(R.string.tab_videos)
                .also { videosTab ->
                    addTab(videosTab)
                }
    }
}

@Override
public void onCreate(Bundle savedInstanceState) {
    setContentView(R.layout.main);

    TabHelper tabHelper = TabHelper.createInstance(this);
    tabHelper.setUp();

    CompatTab photosTab = tabHelper
            .newTab("photos")
            .setText(R.string.tab_photos);
    tabHelper.addTab(photosTab);

    CompatTab videosTab = tabHelper
            .newTab("videos")
            .setText(R.string.tab_videos);
    tabHelper.addTab(videosTab);
}

כשמריצים את האפליקציה, הקוד הזה מנפח את הפריסה הנכונה של הפעילות ויוצר מופע של אובייקט TabHelperHoneycomb או TabHelperEclair. הכיתה הקונקרטית שבה נעשה שימוש בפועל היא אטומה לפעילות, כי הן חולקות את הממשק המשותף TabHelper.

בהמשך מופיעים שני צילומי מסך של ההטמעה הזו שפועלת במכשיר Android 2.3 ובמכשיר Android 4.0.

איור 1. דוגמאות לצילומי מסך של כרטיסיות עם תאימות לאחור שפועלות במכשיר Android 2.3 (באמצעות TabHelperEclair) ובמכשיר Android 4.0 (באמצעות TabHelperHoneycomb).