שרת proxy לממשקי ה-API החדשים

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

הטמעת כרטיסיות באמצעות ממשקי API חדשים

המחלקות הממשיות של CompatTab ו-TabHelper שמשתמשות בממשקי API חדשים יותר הן הטמעה של שרת proxy. השיעורים המופשטים שהוגדרו בשיעור הקודם משקפים את ממשקי ה-API החדשים (מבנה המחלקה, חתימות השיטה וכו'), ולכן המחלקות הקורנטיות שמשתמשות בממשקי ה-API החדשים האלה פשוט קריאות לשיטות שרת proxy והתוצאות שלהן.

בגלל טעינה מדורגת של כיתות, אפשר להשתמש ישירות בממשקי API חדשים יותר במחלקות הבטון האלו, ולא לקרוס במכשירים קודמים. הכיתות נטענות ומופעלות בגישה הראשונה — להפעיל את הכיתה או לגשת לאחד מהשדות הסטטיים או מהשיטות שלה בפעם הראשונה. לכן, כל עוד לא יוצרים מופע של הטמעות ספציפיות ל-Honeycomb במכשירים לפני Honeycomb, ל-VM של Dalvik לא יוצגו חריגות מסוג VerifyError.

מומלץ להוסיף לשם של ההטמעה הזו את שם קוד הגרסה של הרמה או הפלטפורמה של ה-API שתואם לממשקי ה-API הנדרשים לכיתות הספציפיות. לדוגמה, אפשר להשתמש בכיתות CompatTabHoneycomb ו-TabHelperHoneycomb כדי להטמיע כרטיסיות מקוריות, כי הן מסתמכות על ממשקי API שזמינים ב-Android 3.0 (רמת API‏ 11) ואילך.

איור 1. תרשים של הכיתה להטמעת הכרטיסיות ב-Honeycomb.

הטמעת CompatTabHoneycomb

CompatTabHoneycomb היא ההטמעה של הכיתה המופשטת CompatTab שבה TabHelperHoneycomb משתמש כדי להפנות לכרטיסיות ספציפיות. CompatTabHoneycomb פשוט מעביר את כל הקריאות לשיטות לאובייקט ActionBar.Tab שהוא מכיל.

מתחילים להטמיע את CompatTabHoneycomb באמצעות ממשקי ה-API החדשים של ActionBar.Tab:

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.)
}

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

TabHelperHoneycomb הוא היישום של המחלקה המופשטת TabHelper ש-methods מקריאה ל-method ActionBar בפועל, שמתקבלת מה-Activity הכלול בה.

הטמעת TabHelperHoneycomb, קריאות לשיטות שרת proxy ל-API של ActionBar:

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)
    }
}

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.
}

כדאי גם לקרוא

• סרגל הפעולות
• כרטיסיות בסרגל הפעולות