التعامل مع "روابط تطبيقات Android"

تتعامل الروابط لصفحات معيّنة مع معرّفات الموارد المنتظمة للمحتوى. وتتعامل روابط الويب مع مخطّطات HTTP وHTTPS. تتعامل ميزة Android App Links مع سمة autoVerify.
الشكل 1. إمكانات الروابط لصفحات في التطبيق وروابط الويب و روابط Android App Links

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

قبل تنفيذ "روابط تطبيقات Android"، من المهم فهم الأنواع المختلفة من الروابط التي يمكنك إنشاؤها في تطبيق Android: الروابط لصفحات في التطبيق والروابط على الويب وروابط تطبيقات Android. يوضّح الشكل 1 العلاقة بين هذه الأنواع من الروابط، وتوضّح الأقسام التالية كل نوع من الروابط بمزيد من التفصيل.

الروابط لصفحات في التطبيق هي معرّفات موارد منتظمة (URI) لأي مخطّط تنقل المستخدمين مباشرةً إلى جزء معيّن من تطبيقك. لإنشاء روابط لصفحات في التطبيق، أضِف فلاتر الأهداف لتوجيه المستخدمين إلى النشاط المناسب في تطبيقك، كما هو موضّح في مقتطف الرمز البرمجي التالي:

<activity
    android:name=".MyMapActivity"
    android:exported="true"
    ...>
    <intent-filter>
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />
        <data android:scheme="geo" />
    </intent-filter>
</activity>

عندما ينقر المستخدم على رابط لصفحة في التطبيق، قد يظهر مربّع حوار لإزالة الالتباس. يسمح مربع الحوار هذا للمستخدم باختيار واحد من التطبيقات المتعددة، بما في ذلك تطبيقك، التي يمكنها التعامل مع الرابط لموضع معين معين. يعرض الشكل 2 مربّع الحوار الذي يظهر بعد أن ينقر المستخدم على رابط خريطة، ويسأله ما إذا كان يريد فتح الرابط في "خرائط Google" أو Chrome.

الشكل 2: مربّع حوار توضيح المعنى

روابط الويب هي روابط لصفحات في التطبيق تستخدم مخطّطَي HTTP وHTTPS. في الإصدار Android 12 والإصدارات الأحدث، يؤدي النقر على رابط ويب (ليس رابط تطبيق Android) إلى عرض المحتوى دائمًا في متصفّح ويب. على الأجهزة التي تعمل بإصدارات سابقة من Android، إذا كان تطبيقك أو تطبيقات أخرى مثبَّتة على جهاز المستخدم يمكنها أيضًا معالجة رابط الويب، قد لا ينتقل المستخدمون مباشرةً إلى المتصفّح. بدلاً من ذلك، سيظهر لهم مربّع حوار لإزالة الالتباس مشابهًا لما يظهر في الشكل 2.

يعرض المقتطف التالي من الرمز البرمجي مثالاً على فلتر روابط الويب:

<intent-filter>
    <action android:name="android.intent.action.VIEW" />
    <category android:name="android.intent.category.DEFAULT" />
    <category android:name="android.intent.category.BROWSABLE" />

    <data android:scheme="http" />
    <data android:host="myownpersonaldomain.com" />
</intent-filter>

روابط تطبيقات Android، المتوفّرة على الإصدار 6.0 من نظام التشغيل Android (المستوى 23 من واجهة برمجة التطبيقات) والإصدارات الأحدث، هي روابط على الويب تستخدم مخطّطَي HTTP وHTTPS وتتضمّن السمة autoVerify. تسمح هذه السمة لتطبيقك بتحديد نفسه كمعالج تلقائي لنوع معيّن من الروابط. وبالتالي، عندما ينقر المستخدم على رابط تطبيق Android، يفتح تطبيقك على الفور إذا كان مثبّتًا، ولا يظهر مربّع الحوار لإزالة الالتباس.

إذا لم يرغب المستخدم في أن يكون تطبيقك هو المعالج التلقائي، يمكنه إلغاء هذا السلوك من إعدادات التطبيق.

يعرض مقتطف الرمز البرمجي التالي مثالاً على فلتر رابط تطبيق Android:

<intent-filter android:autoVerify="true">
    <action android:name="android.intent.action.VIEW" />
    <category android:name="android.intent.category.DEFAULT" />
    <category android:name="android.intent.category.BROWSABLE" />

    <!-- Do not include other schemes. -->
    <data android:scheme="http" />
    <data android:scheme="https" />

    <data android:host="myownpersonaldomain.com" />
</intent-filter>

توفّر "روابط التطبيقات" لنظام التشغيل Android المزايا التالية:

  • آمن ومحدد: تستخدم ميزة Android App Links عناوين URL التي تستخدم HTTP والتي تؤدي إلى نطاق موقع إلكتروني تملكه، حتى لا يتمكّن أي تطبيق آخر من استخدام الروابط. أحد متطلبات ميزة "روابط التطبيقات" في Android هو إثبات ملكية نطاقك من خلال إحدى طرق ربط المواقع الإلكترونية.
  • تجربة سلسة للمستخدم: بما أنّ ميزة Android App Links تستخدم عنوان URL واحدًا لبروتوكول HTTP لكل المحتوى نفسه على موقعك الإلكتروني وفي تطبيقك، يمكن للمستخدمين الذين لم يثبِّتوا التطبيق الانتقال إلى موقعك الإلكتروني بدلاً من التطبيق، بدون أخطاء 404 وبدون أخطاء.
  • توافق مع ميزة "التطبيقات الفورية" من Android: تتيح ميزة "التطبيقات الفورية" من Android للمستخدمين تشغيل تطبيق Android بدون تثبيته. لإضافة ميزة "التطبيقات الفورية" إلى تطبيق Android، عليك إعداد روابط تطبيقات Android والانتقال إلى g.co/InstantApps.
  • التفاعل مع المستخدمين من "بحث Google": يفتح المستخدمون محتوى معيّنًا مباشرةً في تطبيقك من خلال النقر على عنوان URL من Google في متصفّح متوافق مع الأجهزة الجوّالة أو في تطبيق "بحث Google" أو في البحث على الشاشة على Android أو من خلال "مساعد Google".

في ما يلي الخطوات العامة لإنشاء روابط Android App Links:

  1. إنشاء روابط لصفحات في تطبيقك تنقل إلى محتوى معيّن: في بيان التطبيق، أنشئ فلاتر أهداف لمعرّفات الموارد المنتظمة لموقعك الإلكتروني وضبط تطبيقك لاستخدام البيانات من الأهداف لإرسال المستخدمين إلى المحتوى الصحيح في تطبيقك. اطّلِع على مزيد من المعلومات في مقالة إنشاء روابط لصفحات في التطبيق تنقل إلى محتوى معيّن.
  2. إضافة عملية إثبات ملكية روابط صفحاتك في التطبيق: يمكنك ضبط إعدادات تطبيقك لطلب إثبات ملكية روابط التطبيقات. بعد ذلك، عليك نشر ملف روابط التنقل إلى مواد العرض الرقمية بتنسيق JSON على مواقعك الإلكترونية لإثبات الملكية من خلال Google Search Console. اطّلِع على مزيد من المعلومات في مقالة التحقّق من روابط التطبيقات.

كبديل للمستندات المرتبطة أعلاه، يُعدّ مساعِد روابط تطبيقات Android أداة في "استوديو Android" ترشدك خلال كل خطوة من الخطوات المطلوبة لإنشاء روابط تطبيقات Android.

للحصول على معلومات إضافية، يُرجى الاطّلاع على المراجع التالية:

إدارة روابط تطبيقات Android والتحقّق منها

يمكنك إدارة الروابط لصفحات معيّنة والتحقّق منها من خلال Play Console. بعد تحميل تطبيق بنجاح، تعرض لوحة البيانات (المتوفّرة ضمن "النمو" > الروابط لصفحات في التطبيق) نظرة عامة على الروابط لصفحات في التطبيق وأخطاء الضبط.

الشكل 3: لوحة بيانات الروابط لصفحات في التطبيق على Play Console

تقدّم لوحة البيانات الأقسام التالية:

  • أهمّ تفاصيل إعداد الروابط لصفحات في التطبيق بشكل عام
  • جميع النطاقات المعرَّفة في ملف البيان
  • روابط الويب المجمّعة حسب المسار
  • الروابط التي تحتوي على مخطّطات مخصّصة
يعرض كل قسم من هذه الأقسام حالة الرابط لصفحة في التطبيق وطريقة إصلاحه في حال حدوث خطأ.

يُرجى الرجوع إلى هذا الدليل للحصول على مزيد من المعلومات حول لوحة التحكّم.