إضافة روابط تطبيقات Android

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

يسهّل "مساعِد روابط التطبيقات" في "استوديو Android" هذه العملية من خلال معالج تفصيلي، كما هو موضّح أدناه.

لمزيد من المعلومات عن طريقة عمل روابط التطبيقات والمزايا التي تقدّمها، يمكنك الاطّلاع على مقالة التعامل مع روابط Android App Links.

إضافة فلاتر intent

يمكن أن يساعدك "مساعِد روابط التطبيقات" في استوديو Android في إنشاء intent filters في ملف البيان وربط عناوين URL الحالية من موقعك الإلكتروني بالأنشطة في تطبيقك. يضيف "مساعِد روابط التطبيقات" أيضًا رمزًا نموذجيًا في كل نشاط ذي صلة للتعامل مع intent.

لإضافة فلاتر الأهداف والتعامل مع عناوين URL، اتّبِع الخطوات التالية:

1. اختَر الأدوات (Tools) > مساعِد روابط التطبيقات (App Links Assistant).
2. انقر على فتح أداة تعديل ربط عناوين URL، ثم انقر على إضافة في أسفل قائمة ربط عناوين URL لإضافة عملية ربط جديدة بين عناوين URL.

3. أضِف تفاصيل عملية ربط عنوان URL الجديد:

   

   الشكل 1: أضِف تفاصيل أساسية حول بنية الروابط في موقعك الإلكتروني لربط عناوين URL بالأنشطة في تطبيقك.

   1. أدخِل عنوان URL لموقعك الإلكتروني في الحقل المضيف.

   2. أضِف path أو pathPrefix أو pathPattern لعناوين URL التي تريد ربطها.

      على سبيل المثال، إذا كان لديك تطبيق لمشاركة وصفات الطعام يتضمّن جميع الوصفات المتاحة في النشاط نفسه، وكانت جميع وصفات الطعام على موقعك الإلكتروني المقابل موجودة في الدليل نفسه /recipe، استخدِم pathPrefix وأدخِل /recipe. بهذه الطريقة، يتم ربط عنوان URL http://www.recipe-app.com/recipe/grilled-potato-salad بالنشاط الذي تختاره في الخطوة التالية.

   3. اختَر النشاط الذي يجب أن تنقل عناوين URL المستخدمين إليه.
   4. انقر على حسنًا.

   تظهر نافذة "محرّر ربط عناوين URL". يضيف "مساعد روابط التطبيقات" فلاتر الأهداف استنادًا إلى عملية ربط عناوين URL التي أجريتها إلى ملف AndroidManifest.xml، ويُبرز التغييرات في الحقل معاينة. إذا أردت إجراء أي تغييرات، انقر على Open AndroidManifest.xml لتعديل intent filter. لمزيد من المعلومات، اطّلِع على فلاتر الأهداف للروابط الواردة.

   تعرض نافذة أداة "مساعد روابط التطبيق" الرئيسية أيضًا جميع الروابط الحالية لصفحات معيّنة في ملف AndroidManifest.xml وتتيح لك إصلاح أي مشاكل في الإعداد بسرعة من خلال النقر على إصلاح جميع مشاكل البيان.

   

   ملاحظة: لتوفير روابط مستقبلية بدون تحديث تطبيقك، حدِّد عملية ربط لعناوين URL تتوافق مع عناوين URL التي تخطّط لإضافتها. يجب أيضًا تضمين عنوان URL لشاشة تطبيقك الرئيسية كي يتم تضمينه في نتائج البحث.

4. للتأكّد من أنّ عملية ربط عناوين URL تعمل بشكل سليم، أدخِل عنوان URL في الحقل التحقّق من ربط عناوين URL.

   إذا كان يعمل بشكل صحيح، ستظهر رسالة النجاح التي تشير إلى أنّ عنوان URL الذي أدخلته مرتبط بالنشاط الذي اخترته.

التعامل مع الروابط الواردة

بعد التأكّد من أنّ عملية ربط عناوين URL تعمل بشكل صحيح، أضِف منطقًا للتعامل مع الغرض الذي أنشأته:

1. انقر على اختيار نشاط من "مساعِد روابط التطبيقات".
2. اختَر نشاطًا من القائمة وانقر على إدراج الرمز.

يضيف مساعِد روابط التطبيقات رمزًا إلى نشاطك، على النحو التالي:

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    ...
    // ATTENTION: This was auto-generated to handle app links.
    val appLinkIntent: Intent = intent
    val appLinkAction: String? = appLinkIntent.action
    val appLinkData: Uri? = appLinkIntent.data
    ...
}

@Override
void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    ...
    // ATTENTION: This was auto-generated to handle app links.
    Intent appLinkIntent = getIntent();
    String appLinkAction = appLinkIntent.getAction();
    Uri appLinkData = appLinkIntent.getData();
    ...
}

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

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    ...
    handleIntent(intent)
}

override fun onNewIntent(intent: Intent) {
    super.onNewIntent(intent)
    handleIntent(intent)
}

private fun handleIntent(intent: Intent) {
    val appLinkAction = intent.action
    val appLinkData: Uri? = intent.data
    if (Intent.ACTION_VIEW == appLinkAction) {
        appLinkData?.lastPathSegment?.also { recipeId ->
            Uri.parse("content://com.recipe_app/recipe/")
                    .buildUpon()
                    .appendPath(recipeId)
                    .build().also { appData ->
                        showRecipe(appData)
                    }
        }
    }
}

protected void onCreate(Bundle savedInstanceState) {
  super.onCreate(savedInstanceState);
  ...
  handleIntent(getIntent());
}

protected void onNewIntent(Intent intent) {
  super.onNewIntent(intent);
  handleIntent(intent);
}

private void handleIntent(Intent intent) {
    String appLinkAction = intent.getAction();
    Uri appLinkData = intent.getData();
    if (Intent.ACTION_VIEW.equals(appLinkAction) && appLinkData != null){
        String recipeId = appLinkData.getLastPathSegment();
        Uri appData = Uri.parse("content://com.recipe_app/recipe/").buildUpon()
            .appendPath(recipeId).build();
        showRecipe(appData);
    }
}

ربط تطبيقك بموقعك الإلكتروني

بعد إعداد إمكانية استخدام عناوين URL في تطبيقك، ينشئ "مساعد روابط التطبيقات" ملف روابط التنقل إلى مواد العرض الرقمية يمكنك استخدامه لربط موقعك الإلكتروني بتطبيقك.

كبديل لاستخدام ملف روابط تنقل إلى مواد عرض رقمية، يمكنك ربط موقعك الإلكتروني وتطبيقك في Search Console.

إذا كنت تستخدم ميزة "توقيع التطبيق" من Play لتطبيقك، لن يتطابق ملف الشهادة المرجعي الذي ينتجه "مساعد روابط التطبيقات" عادةً مع الملف الموجود على أجهزة المستخدمين. في هذه الحالة، يمكنك العثور على مقتطف JSON الصحيح لروابط تنقل إلى مواد عرض رقمية الخاص بتطبيقك في حساب المطوِّر على Play Console ضمن Release > Setup > App signing.

لربط تطبيقك بموقعك الإلكتروني باستخدام "مساعِد روابط التطبيقات"، انقر على فتح أداة إنشاء ملفات روابط التنقّل إلى مواد العرض الرقمية من "مساعِد روابط التطبيقات" واتّبِع الخطوات التالية:

الشكل 2: أدخِل تفاصيل حول موقعك الإلكتروني وتطبيقك لإنشاء ملف روابط تنقل إلى مواد عرض رقمية.

1. أدخِل نطاق الموقع الإلكتروني ورقم تعريف التطبيق.

2. لتضمين إمكانية استخدام ميزة تسجيل الدخول باستخدام ميزة "نقرة واحدة" في ملف روابط تنقل إلى مواد عرض رقمية، ضَع علامة في المربّع بجانب السماح بمشاركة بيانات الاعتماد بين التطبيق والموقع الإلكتروني وأدخِل عنوان URL لتسجيل الدخول إلى موقعك الإلكتروني.سيؤدي ذلك إلى إضافة السلسلة التالية إلى ملف روابط تنقل إلى مواد عرض رقمية للإشارة إلى أنّ تطبيقك وموقعك الإلكتروني يشاركان بيانات اعتماد تسجيل الدخول: delegate_permission/common.get_login_creds.

3. حدِّد إعدادات التوقيع أو اختَر ملف تخزين مفاتيح.

   احرِص على اختيار إعداد الإصدار أو ملف تخزين المفاتيح الصحيحين لبنية الإصدار أو إعداد تصحيح الأخطاء أو ملف تخزين المفاتيح الصحيحين لإصدار مخصص لتصحيح الأخطاء من تطبيقك. إذا أردت إعداد الإصدار العلني، استخدِم إعداد الإصدار. إذا أردت اختبار الإصدار، استخدِم إعدادات تصحيح الأخطاء.

4. انقر على إنشاء ملف روابط تنقل إلى مواد عرض رقمية.
5. بعد أن ينشئ "استوديو Android" الملف، انقر على حفظ الملف لتنزيله.
6. حمِّل ملف assetlinks.json إلى موقعك الإلكتروني، مع منح إذن الوصول للقراءة للجميع، على https://yoursite/.well-known/assetlinks.json.

   ملاحظة مهمة: يتحقّق النظام من ملف روابط تنقل إلى مواد عرض رقمية من خلال بروتوكول HTTPS المشفّر. تأكَّد من إمكانية الوصول إلى ملف assetlinks.json عبر اتصال HTTPS، بغض النظر عمّا إذا كان فلتر الأهداف في تطبيقك يتضمّن https.

7. انقر على ربط الحساب وإثبات ملكيته للتأكيد على أنّك حمّلت ملف Digital Asset Links الصحيح إلى الموقع الصحيح.

يمكن لأداة "مساعِد روابط التطبيقات" التحقّق من صحة ملف "روابط تنقّل إلى مواد عرض رقمية" الذي يجب نشره على موقعك الإلكتروني. بالنسبة إلى كل نطاق تم تحديده في ملف البيان، يحلّل "مساعد Google" الملف على موقعك الإلكتروني، ويجري عمليات التحقّق من الصحة، ويقدّم شرحًا تفصيليًا حول كيفية إصلاح أي أخطاء.

يمكنك الاطّلاع على مزيد من المعلومات حول ربط موقعك الإلكتروني بتطبيقك من خلال ملف روابط تنقل إلى مواد عرض رقمية في مقالة تحديد عمليات الربط بالمواقع الإلكترونية.

اختبار روابط التطبيق على Android

للتأكّد من أنّ الروابط تفتح النشاط الصحيح، اتّبِع الخطوات التالية:

1. في "مساعِد روابط التطبيقات"، انقر على اختبار روابط التطبيقات.
2. أدخِل عنوان URL الذي تريد اختباره في حقل عنوان URL، مثلاً، http://recipe-app.com/recipe/grilled-potato-salad.


الشكل 3: مربّع الحوار اختبار روابط التطبيق الذي يعرض عنوان URL قيد الاختبار ورسالة نجاح

3. انقر على إجراء الاختبار.

إذا لم يتم إعداد عملية ربط عناوين URL بشكل صحيح أو لم تكن متوفّرة، ستظهر رسالة خطأ ضمن عنوان URL في مربّع الحوار اختبار روابط التطبيق. بخلاف ذلك، سيشغّل استوديو Android تطبيقك في الجهاز أو المحاكي عند النشاط المحدّد بدون عرض مربّع الحوار الخاص بإزالة الغموض ("أداة اختيار التطبيق") ويعرض رسالة نجاح في مربّع الحوار اختبار App Link، كما هو موضّح في الشكل 3.

إذا تعذّر على "استوديو Android" تشغيل التطبيق، ستظهر رسالة خطأ في نافذة التشغيل في "استوديو Android".

لاختبار Android App Links من خلال مساعِد روابط التطبيقات، يجب أن يكون لديك جهاز متصل أو جهاز افتراضي متاح يعمل بالإصدار 6.0 من نظام التشغيل Android (مستوى واجهة برمجة التطبيقات 23) أو إصدار أحدث. لمزيد من المعلومات، يمكنك الاطّلاع على كيفية ربط جهاز أو إنشاء جهاز Android افتراضي (AVD).