في نظام Android، الرابط لصفحة في التطبيق هو رابط ينقلك مباشرةً إلى صفحة المقصودة داخل التطبيق.
يتيح لك مكوِّن التنقل إنشاء نوعين مختلفين من الروابط لمواضع معيَّنة: صريحًا وضمنيًا.
إنشاء رابط صريح لصفحة في التطبيق
الرابط الفاضح لصفحة في التطبيق هو نسخة واحدة.
من رابط لصفحة في التطبيق يستخدم PendingIntent
لتوجيه المستخدمين إلى مكان محدد داخل تطبيقك. قد تعرض
رابط صريح لصفحة في التطبيق كجزء من إشعار أو تطبيق مصغّر
على سبيل المثال.
عندما يفتح أحد المستخدمين تطبيقك من خلال رابط صريح لصفحة في التطبيق، يتم استخدام حزمة مهام
محوها واستبدالها بوجهة الرابط لصفحة في التطبيق. فعندما
الرسوم البيانية المتداخلة،
وجهة البداية من كل مستوى من مستويات التداخل - أي وجهة البداية
من كل عنصر <navigation>
في التدرج الهرمي، تتم إضافته أيضًا إلى الحزمة.
هذا يعني أنه عندما يضغط المستخدم على الزر "رجوع" من رابط لموضع معيّن
الوجهة، فإنهم يتنقلون إلى أعلى حزمة التنقل كما لو
دخل إلى تطبيقك منذ نقطة دخوله.
يمكنك استخدام NavDeepLinkBuilder
.
لإنشاء PendingIntent
،
كما هو موضح في المثال أدناه. لاحظ أنه إذا لم يكن السياق المقدم
Activity
، تستخدم الدالة الإنشائية
PackageManager.getLaunchIntentForPackage()
كالنشاط الافتراضي لإطلاقه، إذا كان متاحًا.
Kotlin
val pendingIntent = NavDeepLinkBuilder(context) .setGraph(R.navigation.nav_graph) .setDestination(R.id.android) .setArguments(args) .createPendingIntent()
Java
PendingIntent pendingIntent = new NavDeepLinkBuilder(context) .setGraph(R.navigation.nav_graph) .setDestination(R.id.android) .setArguments(args) .createPendingIntent();
بشكل تلقائي، يُطلق NavDeepLinkBuilder
الرابط الصريح لصفحة معيّنة في
عملية التشغيل التلقائية Activity
المُعلَن عنها في بيان التطبيق. في حال حذف
تكون NavHost
في نشاط آخر، عليك تحديد المكوّن الخاص به.
اسم المستخدم عند إنشاء أداة إنشاء الروابط لصفحات في التطبيق:
Kotlin
val pendingIntent = NavDeepLinkBuilder(context) .setGraph(R.navigation.nav_graph) .setDestination(R.id.android) .setArguments(args) .setComponentName(DestinationActivity::class.java) .createPendingIntent()
Java
PendingIntent pendingIntent = new NavDeepLinkBuilder(context) .setGraph(R.navigation.nav_graph) .setDestination(R.id.android) .setArguments(args) .setComponentName(DestinationActivity.class) .createPendingIntent();
إذا كان لديك ComponentName
،
يمكنك تمريره مباشرة إلى المنشئ:
Kotlin
val componentName = ... val pendingIntent = NavDeepLinkBuilder(context) .setGraph(R.navigation.nav_graph) .setDestination(R.id.android) .setArguments(args) .setComponentName(componentName) .createPendingIntent()
Java
ComponentName componentName = ...; PendingIntent pendingIntent = new NavDeepLinkBuilder(context) .setGraph(R.navigation.nav_graph) .setDestination(R.id.android) .setArguments(args) .setComponentName(componentName) .createPendingIntent();
إذا كان لديك NavController
حالية،
يمكنك أيضًا إنشاء رابط لصفحة في التطبيق باستخدام
NavController.createDeepLink()
إنشاء رابط ضمني لصفحة في التطبيق
يشير الرابط الضمني لصفحة في التطبيق إلى وجهة محددة في التطبيق. عند استدعاء الرابط لصفحة في التطبيق، على سبيل المثال، عندما ينقر مستخدِم على رابط، يمكن لنظام Android فتح تطبيقك على الوجهة.
يمكن مطابقة الروابط المؤدية إلى صفحات في التطبيق حسب معرّف الموارد المنتظم (URI) وإجراءات intent وأنواع MIME. يمكنك تحديد أنواع مطابقة متعددة لرابط واحد لصفحة في التطبيق، ولكن لاحظ أن معرّف الموارد المنتظم (URI) تُعطى الأولوية لمطابقة الوسيطة أولاً، ويتبعها الإجراء، ثم MIME الكتابة.
في ما يلي مثال على رابط لصفحة في التطبيق يحتوي على معرّف موارد منتظم (URI) وإجراء ونوع MIME:
<fragment android:id="@+id/a"
android:name="com.example.myapplication.FragmentA"
tools:layout="@layout/a">
<deepLink app:uri="www.example.com"
app:action="android.intent.action.MY_ACTION"
app:mimeType="type/subtype"/>
</fragment>
يمكنك أيضًا استخدام "محرِّر التنقل" لإنشاء رابط ضمني لموضع معيّن إلى الوجهة على النحو التالي:
- في علامة التبويب التصميم في محرر التنقل، حدد وجهة الرابط لموضع معين.
- انقر على + في قسم الروابط لصفحات في التطبيق في لوحة السمات.
في مربّع الحوار إضافة رابط لصفحة في التطبيق الذي يظهر، أدخِل معلومات رابط لموضع معيّن.
ملاحظات:
- يتم الافتراض أن معرِّفات الموارد المنتظمة (URI) التي لا تتضمن مخطَّطًا هي http أو https. على سبيل المثال:
تتطابق السمة
www.google.com
مع كل منhttp://www.google.com
https://www.google.com
- تتطابق العناصر النائبة لمَعلمات المسار على شكل
{placeholder_name}
مع عنصر واحد أو أكثر. الأحرف. على سبيل المثال،http://www.example.com/users/{id}
يطابقhttp://www.example.com/users/4
يحاول مكوِّن التنقل تحليل قيم العنصر النائب إلى أنواع مناسبة من خلال مطابقة العنصر النائب بأسماء للوسيطات المحددة التي يتم تحديدها لوجهة الرابط لموضع معيّن. إذا لم تكن هناك وسيطة مع تم تحديد الاسم نفسه، ويتم استخدام نوعString
تلقائي للوسيطة. يمكنك استخدام حرف البدل .* لمطابقة 0 حرف أو أكثر. - ويمكن استخدام العناصر النائبة لمعاملات طلب البحث بدلاً من أو جنبًا إلى جنب مع
مَعلمات المسارات. على سبيل المثال:
http://www.example.com/users/{id}?myarg={myarg}
مطابقةhttp://www.example.com/users/4?myarg=28
- العناصر النائبة لمَعلمات طلب البحث للمتغيرات التي تم تحديدها باستخدام الإعداد التلقائي أو
لا يلزم تطابق القيم القابلة للقيم. على سبيل المثال:
http://www.example.com/users/{id}?arg1={arg1}&arg2={arg2}
مطابقةhttp://www.example.com/users/4?arg2=28
أوhttp://www.example.com/users/4?arg1=7
هذا لا يحدث مع المسار المعلَمات. على سبيل المثال:http://www.example.com/users?arg1=7&arg2=28
لا تتطابق مع النمط أعلاه لأن معلمة المسار المطلوبة هي لم يتم توفيرها. - لا تؤثر مَعلمات طلب البحث غير الضرورية في مطابقة معرّف الموارد المنتظم (URI) لرابط صفحة معيّنة في التطبيق. بالنسبة
مثال، يتطابق
http://www.example.com/users/{id}
http://www.example.com/users/4?extraneousParam=7
، على الرغم من لم يتم تحديدextraneousParam
في نمط عنوان URI.
- يتم الافتراض أن معرِّفات الموارد المنتظمة (URI) التي لا تتضمن مخطَّطًا هي http أو https. على سبيل المثال:
تتطابق السمة
(اختياري) ضع علامة في المربّع إثبات الملكية التلقائي لمطالبة Google بإثبات هويتك مالك معرِّف الموارد المنتظم (URI). لمزيد من المعلومات، يُرجى مراجعة التحقّق من روابط تطبيقات Android
انقر على إضافة. رمز رابط
أعلى الوجهة المحدّدة للإشارة إلى أنّ الوجهة تحتوي على رابط لموضع معيّن.
انقر على علامة التبويب الرمز للتبديل إلى عرض XML. نوع
<deepLink>
مدمج تمت إضافة العنصر إلى الوجهة:<deepLink app:uri="https://www.google.com" />
لتفعيل الربط الضمني، يجب أيضًا إجراء إضافات على واجهة
ملف manifest.xml
. يمكنك إضافة عنصر <nav-graph>
واحد إلى نشاط
يشير إلى رسم بياني حالي للتنقل، كما هو موضح في المثال التالي:
<?xml version="1.0" encoding="utf-8"?> <manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.example.myapplication"> <application ... > <activity name=".MainActivity" ...> ... <nav-graph android:value="@navigation/nav_graph" /> ... </activity> </application> </manifest>
عند إنشاء مشروعك، يحل مكوِّن التنقل محل <nav-graph>
.
يتضمّن عناصر <intent-filter>
التي تم إنشاؤها لمطابقة جميع الروابط المؤدية إلى صفحات في التطبيق
في الرسم البياني للتنقل.
عند تشغيل رابط ضمني لصفحة في التطبيق، تعتمد حالة الحزمة الخلفية على
ما إذا كان قد تم إطلاق Intent
الضمني باستخدام
Intent.FLAG_ACTIVITY_NEW_TASK
:
- إذا تم تعيين العلامة، فسيتم محو حزمة الرجوع للمهمة واستبدالها
وجهة الرابط لموضع معيّن. وكما هو الحال مع الربط الفاضح لصفحة في التطبيق، عندما
والرسوم البيانية المتداخلة،
وجهة البداية من كل مستوى من مستويات التداخل - أي البداية
من كل عنصر
<navigation>
في التسلسل الهرمي، كما تتم إضافتها إلى المكدس. وهذا يعني أنه عندما يضغط المستخدم على زر الرجوع من صفحة وجهة الرابط، فإنهم يتنقلون إلى أعلى حزمة التنقل كما لو الدخول إلى تطبيقك منذ نقطة دخوله - إذا لم يتم ضبط العلامة، ستظل في حزمة المهام الخاصة بالتطبيق السابق. الذي تم فيه تشغيل الرابط الضمني لصفحة في التطبيق. في هذه الحالة، زر الرجوع الرجوع إلى التطبيق السابق، بينما يبدأ الزر للأعلى في بدء مهمة تطبيقك في الوجهة الرئيسية الهرمية ضمن الرسم البياني للتنقل.
التعامل مع الروابط لصفحات معيّنة
ننصحك بشدة باستخدام القيمة التلقائية
launchMode
من إجمالي standard
عند استخدام التنقل. عند استخدام وضع تشغيل "standard
"، التنقّل
تعالج الروابط لمواضع معينة تلقائيًا عن طريق استدعاء
handleDeepLink()
معالجة أي روابط صريحة أو ضمنية لصفحة في التطبيق ضمن Intent
ومع ذلك،
لا يحدث ذلك تلقائيًا إذا تمت إعادة استخدام Activity
عند استخدام
قيمة launchMode
بديلة مثل singleTop
. في هذه الحالة، من الضروري
للاتصال يدويًا بـ handleDeepLink()
في onNewIntent()
، كما هو موضح في
المثال التالي:
Kotlin
override fun onNewIntent(intent: Intent?) { super.onNewIntent(intent) navController.handleDeepLink(intent) }
Java
@Override protected void onNewIntent(Intent intent) { super.onNewIntent(intent); navController.handleDeepLink(intent); }
مصادر إضافية
لمعرفة المزيد من المعلومات حول التنقّل، يُرجى الاطّلاع على المراجع التالية.