يمكنك السماح لتطبيقات الويب التقدّمية (PWA) المثبّتة بمعالجة الروابط التي تستخدم بروتوكولاً معيّنًا للحصول على تجربة أكثر تكاملاً.
معلومات أساسية عن المخططات (المعروفة أيضًا باسم البروتوكولات)
معرّف الموارد المنتظم (URI) هو تسلسل مضغوط من الأحرف يحدّد موردًا مجردًا أو ماديًا. يبدأ كل معرّف موارد منتظم (URI) باسم مخطط يشير إلى مواصفات لتعيين المعرّفات ضمن هذا المخطط. وبالتالي، فإنّ بنية معرّف الموارد المنتظم (URI) هي نظام تسمية موحّد وقابل للتوسيع، حيث قد تفرض مواصفات كل نظام قيودًا إضافية على بنية ودلالات المعرّفات التي تستخدم هذا النظام. تُعرف المخططات أيضًا باسم البروتوكولات. يمكنك الاطّلاع على بعض الأمثلة على المخططات.
tel:+1-816-555-1212
mailto:Jane.Doe@example.com
news:comp.infosystems.www.servers.unix
https://web.dev/
يشير المصطلح محدّد موقع الموارد (URL) إلى المجموعة الفرعية من معرّفات الموارد المنتظمة (URI) التي توفّر، بالإضافة إلى تحديد المورد، وسيلة لتحديد موقع المورد من خلال وصف آلية الوصول الأساسية إليه (مثل موقعه على الشبكة).
معلومات أساسية عن طريقة registerProtocolHandler()
تتيح طريقة Navigator المخصّصة للمحتوى الآمن فقط
registerProtocolHandler()
للمواقع الإلكترونية تسجيل قدرتها على فتح مخطّطات عناوين URL معيّنة أو التعامل معها. لذلك، يجب أن تستدعي المواقع الإلكترونية الطريقة على النحو التالي: navigator.registerProtocolHandler(scheme, url). يتم تعريف المعلمتين
على النحو التالي:
-
scheme: سلسلة تحتوي على البروتوكول الذي يريد الموقع الإلكتروني معالجته. -
url: سلسلة تحتوي على عنوان URL الخاص بالمعالج. يجب أن يتضمّن عنوان URL هذا%sكعنصر نائب سيتم استبداله بعنوان URL الذي تمت معالجته.
يجب أن يكون المخطط إما أحد المخططات المُدرَجة في القائمة المسموح بها (على سبيل المثال، mailto أو bitcoin أو magnet) أو يبدأ بـ web+، متبوعًا بحرف واحد على الأقل أو أكثر من أحرف ASCII الصغيرة بعد البادئة web+، مثل web+coffee.
لتوضيح ذلك، إليك مثال ملموس على العملية:
- يزور المستخدم موقعًا إلكترونيًا على
https://coffeeshop.example.com/يُجري الطلب التالي:navigator.registerProtocolHandler('web+coffee', 'coffee?type=%s'). - في وقت لاحق، أثناء زيارة
https://randomsite.example.com/، ينقر المستخدم على رابط مثل<a href="web+coffee:latte-macchiato">All about latte macchiato</a>. - يؤدي ذلك إلى انتقال المتصفّح إلى عنوان URL التالي:
https://coffeeshop.example.com/coffee?type=web%2Bcoffee%3A%2F%2Flatte-macchiato. بعد فك ترميز عنوان URL، تصبح سلسلة البحث?type=web+coffee://latte-macchiato.
لمحة عن معالجة البروتوكولات
تتعلّق آلية تسجيل معالج بروتوكول عنوان URL لتطبيقات الويب التقدّمية (PWA) الحالية بتقديم تسجيل معالج البروتوكول كجزء من تثبيت تطبيق الويب التقدّمي من خلال بيانه. بعد تسجيل تطبيق ويب تقدّمي (PWA) كمعالج بروتوكول، عندما ينقر المستخدم على رابط تشعّبي يتضمّن مخططًا محددًا، مثل mailto أو bitcoin أو web+music من متصفّح أو تطبيق خاص بنظام أساسي، سيتم فتح تطبيق الويب التقدّمي المسجَّل وسيتلقّى عنوان URL. تجدر الإشارة إلى أنّ كلاً من التسجيل المقترَح المستنِد إلى البيان وregisterProtocolHandler() التقليدي يؤديان أدوارًا متشابهة جدًا من الناحية العملية، مع السماح بإمكانية تقديم تجارب مستخدم تكميلية:
- تشمل أوجه التشابه المتطلبات المتعلقة بقائمة المخططات المسموح بتسجيلها، واسم المَعلمات وتنسيقها، وما إلى ذلك.
- الاختلافات في التسجيل المستند إلى البيان دقيقة، ولكنها قد تكون مفيدة لتحسين تجربة مستخدمي تطبيقات الويب التقدّمية. على سبيل المثال، قد لا يتطلّب تسجيل تطبيق الويب التقدّمي المستنِد إلى البيان إجراءً إضافيًا من المستخدم بخلاف تثبيت تطبيق الويب التقدّمي الذي بدأه المستخدم.
حالات الاستخدام
- في تطبيق ويب تقدّمي لمعالجة النصوص، يظهر للمستخدم في مستند رابط لعرض تقديمي مثل
web+presentations://deck2378465. عندما ينقر المستخدم على الرابط، يتم فتح تطبيق الويب التقدّمي (PWA) للعرض التقديمي تلقائيًا في النطاق الصحيح ويعرض مجموعة الشرائح. - في تطبيق محادثات خاص بنظام أساسي معيّن، يتلقّى المستخدم في رسالة محادثة رابطًا يؤدي إلى عنوان URL لـ
magnet. عند النقر على الرابط، يتم تشغيل تطبيق ويب تقدّمي مثبَّت لتنزيل ملفات التورنت ويبدأ التنزيل. - ثبّت المستخدم تطبيق ويب تقدّميًا لبث الموسيقى. عندما يشارك صديق رابطًا لأغنية مثل
web+music://songid=1234&time=0:13وينقر المستخدم عليه، سيتم تشغيل تطبيق الويب التقدّمي (PWA) لبث الموسيقى تلقائيًا في نافذة مستقلة.
كيفية استخدام تسجيل معالج بروتوكول عنوان URL لتطبيقات الويب التقدّمية (PWA)
تم تصميم واجهة برمجة التطبيقات لتسجيل معالج بروتوكول عنوان URL بشكل وثيق على
navigator.registerProtocolHandler(). ولكن هذه المرة يتم تمرير المعلومات بشكل تعريفي باستخدام بيان تطبيق الويب في سمة جديدة تسمى "protocol_handlers" تأخذ مصفوفة من الكائنات مع المفتاحين المطلوبين "protocol" و"url". يوضّح مقتطف الرمز التالي كيفية تسجيل web+tea وweb+coffee. القيم هي سلاسل تحتوي على عنوان URL الخاص بالمعالج مع
العنصر النائب %s المطلوب لعنوان URL الذي تم إلغاؤه.
{
"protocol_handlers": [
{
"protocol": "web+tea",
"url": "/tea?type=%s"
},
{
"protocol": "web+coffee",
"url": "/coffee?type=%s"
}
]
}
تسجيل تطبيقات متعددة للبروتوكول نفسه
إذا سجّلت تطبيقات متعددة نفسها كمعالِجات للمخطط نفسه، على سبيل المثال، بروتوكول mailto، سيعرض نظام التشغيل للمستخدم أداة اختيار ويسمح له بتحديد المعالِجات المسجّلة التي يريد استخدامها.
التطبيق نفسه يسجّل في بروتوكولات متعددة
يمكن للتطبيق نفسه تسجيل نفسه لبروتوكولات متعددة، كما ترى في عينة تعليمات برمجية.
تحديثات التطبيق وتسجيل المعالِج
تتم مزامنة عمليات تسجيل المعالِجات مع أحدث إصدار من ملف البيان الذي يوفّره التطبيق، وهناك حالتان:
- يؤدي التحديث الذي يضيف معالِجات جديدة إلى تفعيل تسجيل المعالِج (بشكل منفصل عن تثبيت التطبيق).
- يؤدي التحديث الذي يزيل المعالِجات إلى إلغاء تسجيل المعالِج (بشكل منفصل عن إلغاء تثبيت التطبيق).
تصحيح أخطاء معالج البروتوكول في "أدوات مطوّري البرامج"
انتقِل إلى قسم معالِجات البروتوكول باستخدام لوحة التطبيق > البيان. يمكنك الاطّلاع على جميع البروتوكولات المتاحة واختبارها هنا.

الاعتبارات الأمنية
بما أنّ تثبيت تطبيق الويب التقدّمي يتطلّب أن يكون السياق آمنًا، فإنّ معالجة البروتوكول تكتسب هذا القيد. لا يتم عرض قائمة معالِجات البروتوكولات المسجَّلة على الويب بأي شكل من الأشكال، لذا لا يمكن استخدامها كمتّجه لبصمات الأصابع.
محاولات التنقّل التي لا يبدأها المستخدم
قد لا يتم فتح التطبيقات من خلال محاولات التنقّل التي لا يبدأها المستخدم، ولكنها تكون آلية. لا يمكن استخدام عنوان URL للبروتوكول المخصّص إلا في سياقات التصفّح ذات المستوى الأعلى، ولكن لا يمكن استخدامه، على سبيل المثال، كعنوان URL لإطار iframe.
القائمة المسموح بها للبروتوكولات
كما هو الحال مع registerProtocolHandler()، هناك قائمة مسموح بها للبروتوكولات التي يمكن للتطبيقات تسجيلها
لمعالجتها.
طلب الموافقة
عند تشغيل تطبيق الويب التقدّمي (PWA) لأول مرة بسبب بروتوكول تم استدعاؤه، سيظهر للمستخدم مربّع حوار لطلب الإذن. سيعرض مربّع الحوار هذا اسم التطبيق ومصدره، ويسأل المستخدم عمّا إذا كان يُسمح للتطبيق بمعالجة الروابط من البروتوكول. إذا رفض المستخدم مربّع حوار الإذن، سيتجاهل نظام التشغيل معالج البروتوكول المسجَّل. لإلغاء تسجيل معالج البروتوكول، على المستخدم إلغاء تثبيت تطبيق الويب التقدّمي الذي سجّله. سيلغي المتصفّح أيضًا تسجيل معالِج البروتوكول إذا اختار المستخدم "تذكُّر خياري" واختار "عدم السماح".
الملاحظات
يريد فريق Chromium معرفة تجاربك في تسجيل معالج بروتوكول عنوان URL لتطبيقات الويب التقدّمية (PWA).
أخبِرنا عن تصميم واجهة برمجة التطبيقات
هل هناك مشكلة في واجهة برمجة التطبيقات لا تعمل على النحو المتوقّع؟ أو هل هناك طرق أو خصائص مفقودة تحتاجها لتنفيذ فكرتك؟ هل لديك سؤال أو تعليق حول نموذج الأمان؟ يمكنك الإبلاغ عن مشكلة في المواصفات في مستودع GitHub المقابل، أو إضافة أفكارك إلى مشكلة حالية.
الإبلاغ عن مشكلة في عملية التنفيذ
هل عثرت على خطأ في تنفيذ Chromium؟ أم أنّ التنفيذ يختلف عن المواصفات؟
يمكنك الإبلاغ عن خطأ على new.crbug.com. تأكَّد من تضمين أكبر قدر ممكن من التفاصيل،
وتعليمات إعادة إنتاج الخطأ، وأدخِل UI>Browser>WebAppInstalls في مربّع المكوّنات.
إظهار الدعم لواجهة برمجة التطبيقات
هل تخطّط لاستخدام ميزة تسجيل معالج بروتوكول عنوان URL لتطبيقات الويب التقدّمية (PWA)؟ يساعد دعمك العلني فريق Chromium في تحديد أولويات الميزات، كما يوضّح لمورّدي المتصفّحات الآخرين مدى أهمية توفير الدعم لها.
شارِكنا خططك لاستخدامها في سلسلة محادثات WICG Discourse. أرسِل تغريدة إلى
@ChromiumDev باستخدام الهاشتاغ
#ProtocolHandler
وأخبِرنا عن مكان وكيفية استخدامك له.
روابط مفيدة
الإقرارات
تم تنفيذ تسجيل معالج بروتوكول عنوان URL لتطبيقات الويب التقدّمية (PWA) وتحديده من قِبل فابيو روشا ودييغو غونزاليس وكونور مودي وصامويل تانغ من فريق Microsoft Edge. تمت مراجعة هذا المستند من قِبل جو ميدلي وفابيو روشا.