هذه هي الواجهة التي تحدِّد عنوان URL المطلوب للمتابعة/الحالة مع معرّفات حِزم Android وiOS الاختيارية.
Signature:
export interface ActionCodeSettings
أماكن إقامة
الموقع | النوع | الوصف |
---|---|---|
Android | { packageName: string; installApp?: boolean; الحد الأدنى من الإصدارات?: سلسلة؛ } | تُحدِّد اسم حزمة Android. سيؤدي هذا الإجراء إلى فتح الرابط في تطبيق Android إذا كان مثبّتًا. في حال ضبط السياسة installApp ، يتم تحديد ما إذا كان يجب تثبيت تطبيق Android إذا كان الجهاز يتيحه ولم يكن التطبيق مثبّتًا. إذا تم توفير هذا الحقل بدون packageName ، يتم عرض رسالة خطأ توضّح أنّه يجب توفير السمة packageName مع هذا الحقل. إذا تم تحديد السمة minimumVersion وتم تثبيت إصدار قديم من التطبيق، سيتم نقل المستخدم إلى "متجر Play" لترقية التطبيق. |
DynamicLinkDomain | السلسلة | تحدِّد نطاق الرابط الديناميكي المطلوب استخدامه للرابط الحالي إذا كان سيتم فتحه باستخدام روابط Firebase الديناميكية، حيث يمكن ضبط نطاقات روابط ديناميكية متعددة لكل مشروع. يوفّر هذا الحقل إمكانية الاختيار بشكلٍ صريح لكل مشروع. تتيح هذه الحقول إمكانية اختيار أحد الحقول بشكل صريح. وفي حال عدم تقديم أي نطاق، سيتم تلقائيًا استخدام النطاق الأقدم. |
handleCodeInApp | قيمة منطقية | ما إذا كنت تريد فتح الرابط عبر تطبيق متوافق مع الأجهزة الجوّالة أو متصفّح. وتكون القيمة التلقائية false. عند ضبط هذه السياسة على "صحيح"، يتم إرسال رابط رمز الإجراء كرابط عام أو رابط تطبيق Android، ويفتحه التطبيق إذا كان مثبّتًا. وفي الحالة الخاطئة، يتم إرسال الرمز إلى تطبيق الويب المصغّر أولاً، ثم يُعاد توجيهه إلى التطبيق في حال تثبيته. |
iOS | {packageId: string; } | تحدّد معرّف حزمة iOS. سيؤدي ذلك إلى محاولة فتح الرابط في تطبيق iOS إذا كان مثبتًا. |
url | السلسلة | تحدّد هذه السمة عنوان URL للمتابعة/حالة الرابط والذي له معانٍ مختلفة في السياقات المختلفة:
|
ActionCodeSettings.android
تُحدِّد اسم حزمة Android. سيؤدي هذا الإجراء إلى فتح الرابط في تطبيق Android إذا كان مثبّتًا. في حال ضبط السياسة installApp
، يتم تحديد ما إذا كان يجب تثبيت تطبيق Android إذا كان الجهاز يتيحه ولم يكن التطبيق مثبّتًا. إذا تم توفير هذا الحقل بدون packageName
، يتم عرض رسالة خطأ توضّح أنّه يجب توفير السمة packageName
مع هذا الحقل. إذا تم تحديد السمة minimumVersion
وتم تثبيت إصدار قديم من التطبيق، سيتم نقل المستخدم إلى "متجر Play" لترقية التطبيق.
Signature:
android?: {
packageName: string;
installApp?: boolean;
minimumVersion?: string;
};
ActionCodeSettings.dynamicLinkDomain
تحدِّد نطاق الرابط الديناميكي المطلوب استخدامه للرابط الحالي إذا كان سيتم فتحه باستخدام روابط Firebase الديناميكية، حيث يمكن ضبط نطاقات روابط ديناميكية متعددة لكل مشروع. يوفّر هذا الحقل إمكانية الاختيار بشكلٍ صريح لكل مشروع. تتيح هذه الحقول إمكانية اختيار أحد الحقول بشكل صريح. وفي حال عدم تقديم أي نطاق، سيتم تلقائيًا استخدام النطاق الأقدم.
Signature:
dynamicLinkDomain?: string;
ActionCodeSettings.handleCodeInApp
ما إذا كنت تريد فتح الرابط عبر تطبيق متوافق مع الأجهزة الجوّالة أو متصفّح. وتكون القيمة التلقائية false. عند ضبط هذه السياسة على "صحيح"، يتم إرسال رابط رمز الإجراء كرابط عام أو رابط تطبيق Android، ويفتحه التطبيق إذا كان مثبّتًا. وفي الحالة الخاطئة، يتم إرسال الرمز إلى تطبيق الويب المصغّر أولاً، ثم يُعاد توجيهه إلى التطبيق في حال تثبيته.
Signature:
handleCodeInApp?: boolean;
ActionCodeSettings.iOS
تحدّد معرّف حزمة iOS. سيؤدي ذلك إلى محاولة فتح الرابط في تطبيق iOS إذا كان مثبتًا.
Signature:
iOS?: {
bundleId: string;
};
ActionCodeSettings.url
تحدّد هذه السمة عنوان URL للمتابعة أو الحالة الذي يحمل معانٍ مختلفة في السياقات المختلفة:
- عند معالجة الرابط في أدوات إجراءات الويب، يكون هذا هو الرابط لصفحة في التطبيق في مَعلمة طلب البحث
continueUrl
. - عند معالجة الرابط في التطبيق مباشرةً، تكون هذه هي مَعلمة طلب البحث "
continueUrl
" في الرابط لصفحة معيّنة في الرابط الديناميكي.
Signature:
url: string;