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

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();

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