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

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

عندما ينقر المستخدمون على الروابط على الأجهزة، يكون لديهم هدف واحد في أذهانهم، وهو الوصول إلى المحتوى الذي يريدون الاطّلاع عليه. بصفتك مطوِّرًا، يمكنك إعداد "روابط التطبيق" على Android لنقل المستخدمين إلى محتوى معيّن في رابط مباشرةً في تطبيقك، وتخطّي مربّع حوار اختيار التطبيق، المعروف أيضًا باسم مربّع حوار توضيح المعنى. بما أنّ "روابط تطبيقات Android" تستفيد من عناوين 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 App Link:

<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" عناوين URL لبروتوكول HTTP تربط بنطاق موقع إلكتروني تملكه، وبالتالي لا يمكن لأي تطبيق آخر استخدام روابطك. من متطلبات روابط التطبيقات على Android إثبات ملكية نطاقك من خلال إحدى طرق ربط الموقع الإلكتروني.
  • سلاسة تجربة المستخدِم: بما أنّ "روابط تطبيقات Android" تستخدم عنوان URL واحدًا لبروتوكول HTTP للمحتوى نفسه على موقعك الإلكتروني وفي تطبيقك، يمكن للمستخدمين الذين لم يثبّتوا التطبيق الانتقال إلى موقعك الإلكتروني بدلاً من التطبيق - لا يوجد 404، ولا توجد أخطاء.
  • التوافق مع "تطبيقات Android الفورية": تتيح "تطبيقات Android الفورية" للمستخدمين تشغيل تطبيق Android بدون تثبيته. لإتاحة استخدام تطبيقك على Android كتطبيق فوري، عليك إعداد روابط التطبيقات على Android والانتقال إلى g.co/InstantApps.
  • التفاعل مع المستخدمين من &quot;بحث Google&quot;: يفتح المستخدمون المحتوى المحدّد مباشرةً في تطبيقك من خلال النقر على عنوان URL من Google في متصفّح على الأجهزة الجوّالة أو في تطبيق &quot;بحث Google&quot; أو في ميزة &quot;البحث على الشاشة&quot; على Android أو من خلال &quot;مساعد Google&quot;.

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

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

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

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

إدارة روابط Android App Links وإثبات ملكيتها

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

الشكل 3. لوحة بيانات الروابط لصفحات معيّنة في Play Console

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

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

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