الاستعداد والجلب المسبق: استخدام "خدمة علامات التبويب المخصَّصة"

Sebastian Benz

يركّز الجزء الثالث من هذا الدليل على "خدمة علامات التبويب المخصّصة" والغرض من استخدامها في تطبيقك لتحسين تجربة المستخدم:

• فتح المحتوى الخارجي على الفور: يؤدي استخدام الرمز warmup() إلى بدء عملية المتصفّح في الخلفية حتى قبل أن ينقر المستخدم على رابط، ويمكن أن يوفر ذلك ما يصل إلى 700 ملي ثانية عند فتح رابط. يجلب mayLaunchUrl() الصفحات مسبقًا. يتيح استخدام كلتا واجهات برمجة التطبيقات معًا تحميل الصفحات على الفور، ما يُحسِّن بشكل كبير تجربة المستخدم في عملية دمج علامات التبويب المخصّصة.
• معالجة أفضل لعلامات التبويب المخصَّصة التي تم تصغيرها: من خلال الاتصال بخدمة "علامات التبويب المخصَّصة" واستخدام CustomTabSession نفسها عند إطلاق "علامة التبويب المخصَّصة"، سيتمكّن Chrome من إزالة علامات التبويب المخصَّصة التي تم تصغيرها سابقًا قبل إطلاق علامة تبويب جديدة، ما يقدّم تجربة أكثر اتساقًا للمستخدم.

في ما يلي الخطوات المطلوبة:

1. تأكَّد ممّا إذا كان المتصفّح التلقائي متوافقًا مع علامات التبويب المخصّصة باستخدام CustomTabsClient.getPackageName(...). إذا كانت الإجابة "نعم"، اربطها بخدمة CustomTabsService باستخدام CustomTabsClient.bindCustomTabsService().

2. بعد الاتصال بخدمة CustomTabsService، عليك تنفيذ ما يلي في دالة الاستدعاء CustomTabsServiceConnection.onCustomTabsServiceConnected():

   أ. ابدأ عملية المتصفّح باستخدام CustomTabsClient.warmup(). ب- أنشئ CustomTabsSession جديدًا باستخدام CustomTabsClient.newSession().

3. يمكنك اختياريًا تحميل صفحات الويب التي يُرجّح أن يزورها المستخدم مسبقًا باستخدام CustomTabsSession.mayLaunchUrl().

4. عند تشغيل علامة تبويب مخصّصة جديدة، نقْل CustomTabsSession إلى CustomTabsIntent.Builder باستخدام الدالة الإنشائية new CustomTabsIntent.Builder(session).

إذا كان تطبيقك يستهدف المستوى 30 لواجهة برمجة تطبيقات Android، تشترط CustomTabsClient.getPackageName(...) إضافة قسم طلبات البحث إلى بيان Android مع التعريف عن فلتر أهداف يتطابق مع المتصفّحات المتوافقة مع "علامات التبويب المخصّصة".

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools">
  …
   <queries>
        <intent>
            <action android:name="android.support.customtabs.action.CustomTabsService" />
        </intent>
    </queries>
</manifest>

في ما يلي مثال كامل على كيفية الاتصال بخدمة علامات التبويب المخصّصة:

private CustomTabsClient mClient;
private CustomTabsSession mSession;

private CustomTabsServiceConnection mConnection = new CustomTabsServiceConnection() {
    @Override
    public void onCustomTabsServiceConnected(
            @NonNull ComponentName name,
            @NonNull CustomTabsClient client
    ) {
        mClient = client;
        // Warm up the browser process
        mClient.warmup(0 /* placeholder for future use */);
        // Create a new browser session
        mSession = mClient.newSession(new CustomTabsCallback());
        // Pre-render pages the user is likely to visit
        // you can do this any time while the service is connected
        mSession.mayLaunchUrl(Uri.parse("https://developers.android.com"), null, null);
    }

    @Override
    public void onServiceDisconnected(ComponentName name) {
        mClient = null;
        mSession = null;
    }
};

private void bindCustomTabService(Context context) {
    // Check for an existing connection
    if (mClient != null) {
        // Do nothing if there is an existing service connection
        return;
    }

    // Get the default browser package name, this will be null if
    // the default browser does not provide a CustomTabsService
    String packageName = CustomTabsClient.getPackageName(context, null);
    if (packageName == null) {
        // Do nothing as service connection is not supported
        return;
    }
    CustomTabsClient.bindCustomTabsService(context, packageName, mConnection);
}

@Override
protected void onCreate(Bundle savedInstanceState) {
…
    bindCustomTabService(this);
    findViewById(R.id.button).setOnClickListener(new View.OnClickListener() {
        @Override
        public void onClick(View view) {
            String url = "https://developers.android.com";
            CustomTabsIntent intent = new CustomTabsIntent.Builder(mSession)
                    .build();
            intent.launchUrl(MainActivity.this, Uri.parse(url));
        }
    });
}

تحذير: قد يتعذّر الاتصال بخدمة علامات التبويب المخصّصة أثناء تشغيل نشاطك. إذا كان تطبيقك يتطلّب اتصالاً نشطًا بالخدمة، هناك استراتيجيتان لضمان اتصال الخدمة:

1. عند الاتصال بـ CustomTabsService بشكلٍ مُلحّ أثناء onCreate()، عليك إعادة الاتصال بالخدمة إذا انقطع الاتصال بنشاطك وتمّ استدعاء دالة الاستدعاء onServiceDisconnected().
2. انتظر حتى يشغّل المستخدم علامة تبويب مخصصة، ثم أنشئ اتصال الخدمة وشغِّل علامة التبويب المخصصة.

فتح الروابط في تطبيقات Android

على أجهزة Android، يمكن لتطبيقات Android معالجة عناوين URL. على سبيل المثال، إذا كان تطبيق Facebook مثبّتًا لدى المستخدم ونقر على رابط يؤدي إلى مشاركة في Facebook، فإنّه عادةً ما يفضّل فتح الرابط في تطبيق Facebook بدلاً من فتح الرابط.

تفتح علامات التبويب المخصَّصة تلقائيًا الروابط في تطبيق Android المعنيّ في حال تثبيتها. ومع ذلك، بعد إنشاء CustomTabsServiceConnection، يتوقف هذا السلوك عن العمل ويتم فتح جميع عناوين URL في علامات تبويب مخصّصة بدلاً من ذلك. لتحسين تجربة المستخدم، ننصحك بإعادة تفعيل هذا السلوك باستخدام الرمز البرمجي التالي:

CustomTabsIntent customTabsIntent = new CustomTabsIntent.Builder()
    .setSendToExternalDefaultHandlerEnabled(true)
    .build();

المقالة التالية: التعرّف على كيفية تغيير حجم تجربة "علامات التبويب المخصّصة"