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

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

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

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

إضافة فلاتر الأهداف

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

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

1. اختَر الأدوات > مساعِد روابط التطبيقات.
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();
    ...
}

هذا الرمز غير مكتمل بمفرده. عليك الآن اتّخاذ إجراء استنادًا إلى معرّف الموارد المنتظم (URI) في 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 افتراضي.