تحديد تطبيقات الويب التقدّمية (PWA) بشكل فريد باستخدام خاصية معرّف بيان تطبيق الويب

Pete LePage

عندما يُثبِّت المستخدم تطبيق الويب التقدّمي، يحتاج المتصفّح إلى طريقة لتحديد هوية تطبيق الويب التقدّمي بشكل فريد. ولكن حتى وقت قريب، لم تحدد مواصفات بيان تطبيق الويب بشكل صريح طريقة لتعريف تطبيق الويب التقدّمي (PWA) بشكل فريد، ما ترك المتصفحات لتقرر عملية التنفيذ المختلفة وتؤدي إلى تنفيذها. في بعض المتصفّحات، يتم استخدام start_url ، وفي متصفّحات أخرى، يتم استخدام مسار ملف البيان، ما يجعل تعديل أيّ من هذين الحقلين مستحيلاً.

لحلّ هذه المشكلة، تتوفّر سمة id اختيارية جديدة في مواصفات بيان تطبيق الويب، تتيح لك تحديد المعرّف المستخدَم لتطبيقك المتوافق مع الأجهزة الجوّالة. تؤدي إضافة السمة id إلى ملف البيان إلى إزالة الاعتمادية على start_url أو موقع البيان، وإتاحة إمكانية تعديله في المستقبل.

ما هي وظيفة السمة id؟

تمثّل السمة id هوية تطبيق الويب التقدّمي للمتصفّح. عندما يصادف المتصفّح بيانًا لا يحتوي على هوية تتطابق مع هوية تطبيق ويب تقدّمي تم تثبيته من قبل، سيتعامل معه على أنّه تطبيق ويب تقدّمي جديد، حتى إذا كان يتم عرضه من عنوان URL نفسه لتطبيق ويب تقدّمي آخر. ولكن إذا رصد البيان هوية تتطابق مع تطبيق الويب التقدّمي المثبَّت، سيتعامل معه على أنّه تطبيق الويب التقدّمي المثبَّت.

دعم المتصفح

أصبح الإصدار id متوافقًا مع الإصدار 96 من Chrome.

ماذا أفعل إذا كان لديّ تطبيق بدون id؟

ليس عليك اتّخاذ أي إجراء، ولن يحدث أي خلل في حال عدم إضافة id إلى بيان تطبيق الويب (ما دامت قيمة start_url و مسار البيان متطابقَين). لضمان توافق تطبيقك على الويب التقدّمي مع الإصدارات المستقبلية، يمكنك إضافة سمة id إلى بيان تطبيق الويب.

كيف يمكنني تحديد id وضبطه؟

إنّ الطريقة الأكثر أمانًا ودقة لتحديد id لتطبيق متوافق مع الأجهزة الجوّالة فقط هي التحقّق من القيمة التي يحتسِبها Chrome.

  1. باستخدام الإصدار 96 من Chrome أو إصدار أحدث، افتح pane (لوحة) Manifest (بيان التطبيق) في لوحة Application (التطبيق) في "أدوات مطوّري البرامج في Chrome".
  2. ستظهر ملاحظة أسفل سمة معرّف التطبيق المحسوب عندما يكون id غير محدّد في ملف بيان تطبيق الويب.
  3. انسخ قيمة id المعروضة في الملاحظة (راجِع لقطة الشاشة أدناه).
  4. أضِف موقعًا على id إلى بيان تطبيق الويب باستخدام قيمة id المعروضة في الملاحظة.

رقم تعريف التطبيق الذي تم احتسابه في لوحة تطبيق "أدوات مطوّري البرامج"

{
  ...
  id: "/?homescreen=1",
  start_url: "/?homescreen=1",
  ...
}

ماذا يحدث إذا لم أضبط id؟

لا داعي للقلق، لن يحدث أي خلل. بدءًا من الإصدار 96 من Chrome، سينشئ المتصفّح id إذا لم يكن هناك id في البيان، وذلك استنادًا إلى start_url في بيان تطبيق الويب.

من خلال إضافة id إلى بيان تطبيق الويب، يمكن تغيير start_url ومسار البيان (إذا ظلّ المصدر الخاص به كما هو فقط)، لأنّ المتصفّح سيحدد تطبيق الويب التقدّمي استنادًا إلى id المحدّد، بدلاً من start_url أو مسار البيان.

كيف يمكنني اختبار ذلك؟

لاختبار السلوك، اتّبِع الخطوات التالية:

  1. ثبِّت تطبيق الويب التقدّمي (PWA).
  2. افتح about://web-app-internals/ وتحقّق من manifest_id وstart_url لتطبيق الويب التقدّمي المثبَّت.
  3. أضِف سمة id إلى بيان تطبيق الويب من خلال اتّباع الخطوات الواردة في القسم كيفية تحديد id وإعداده أعلاه.
  4. أعِد تشغيل المتصفّح باستخدام chrome://restart، ثم افتح تطبيق الويب التقدّمي من about://apps، ثم أغلِق تطبيق الويب التقدّمي لفرض إعادة تحميل ملف البيان.
  5. افتح about://web-app-internals/ وتحقّق من موقع manifest_id للتأكّد من عدم تغيير تطبيق الويب التقدّمي المثبَّت.
  6. غيِّر start_url في ملف بيان تطبيق الويب.
  7. أعِد تشغيل المتصفّح باستخدام chrome://restart، وشغِّل تطبيق الويب التقدّمي (PWA) من about://apps، ثم أغلِق تطبيق الويب التقدّمي (PWA) لفرض إعادة تحميل ملف البيان.
  8. افتح about://web-app-internals/ وتحقّق من موقع start_url لمحاولة العثور على تطبيق الويب التقدّمي المثبّت للتأكّد من أنّه تم تحديثه على النحو المتوقّع.

مراجع إضافية