هوية تطبيق الويب: خاصية id في manifest قبل تغيير الروابط
باختصار: إن كان لموقعك تطبيق ويب يثبّته الزبائن أو الموظفون على الشاشة الرئيسية، فخاصية id في ملف manifest هي ما يعرّف «هذا التطبيق نفسه» عند المتصفح. توضح MDN أنه إن لم تُحدد id، يُستخدم start_url بدلاً منها. والنتيجة: إن غيّرت مسار البداية يوماً، كأن تنقله من /app إلى /ar/app، فقد يعامل المتصفح النسخة الجديدة كتطبيق مختلف. حدّد id ثابتاً من الآن، بمسار يبدأ بـ /، وبالقيمة نفسها التي يحسبها المتصفح حالياً لتطبيقك المثبت، ثم لا تغيّره، حتى لو تغيّر start_url لاحقاً.
المشكلة كما يرويها صاحب العمل
مركز تعليمي في عمّان لديه تطبيق ويب للطلاب: جدول الحصص، والواجبات، والإشعارات. ثبّته معظم الطلاب على هواتفهم من زر «إضافة إلى الشاشة الرئيسية». بعد سنة، أعاد المطور تنظيم الموقع: صارت الواجهة العربية تحت /ar/ والإنجليزية تحت /en/، وتغيّر start_url في ملف manifest من /portal إلى /ar/portal.
بعدها بدأت ملاحظات متفرقة: طلاب يرون اقتراحاً بتثبيت التطبيق مع أنه مثبت عندهم، وآخرون صار عندهم أيقونتان متشابهتان. لم يتغير شيء في التصميم، لكن المتصفح لم يعد يعرف أن هذا هو التطبيق نفسه.
لماذا يحدث هذا
تشرح MDN أن عضو id في ملف manifest يحدد معرّفاً فريداً لتطبيق الويب، وأنه يسمح للمتصفحات بالتمييز بين التطبيقات:
- حين يجد المتصفح ملف manifest بمعرّف لا يطابق تطبيقاً مثبتاً، يعامله كوصف لتطبيق مستقل، حتى لو كان يُقدَّم من نفس رابط تطبيق آخر.
- وحين يجد ملفاً بمعرّف يطابق هوية تطبيق مثبت، يعامل الملف الجديد كبديل لملف ذلك التطبيق، حتى لو كان التطبيق يُقدَّم من رابط مختلف عن الذي ثُبّت منه.
وتذكر MDN أنه إن لم يُحدد id، أو كانت قيمته غير صالحة بأي شكل، كأن لا تكون نصاً أو رابطاً صحيحاً أو لا تكون من نفس أصل start_url، فإن قيمة start_url هي التي تُستخدم.
أي أن تطبيق المركز التعليمي كان معرّفه فعلياً هو رابط البداية القديم. حين تغيّر الرابط، تغيّر المعرّف.
كيف يُحسب المعرّف
تعرض MDN قواعد واضحة:
- القيمة تأخذ شكل رابط، ويجب أن تكون من نفس أصل start_url.
- إن كانت نسبية، تُحل باستخدام أصل start_url، لا مساره. لذلك القيم ../foo وfoo و/foo و./foo كلها تُحل إلى المعرّف نفسه.
- أي جزء بعد # يُحذف دائماً.
- معاملات الاستعلام بعد ? تبقى جزءاً من المعرّف.
- ورغم أن id يُعالج كرابط، فهو لا يشير إلى صفحة يجب أن تكون موجودة، ولا يشترط أن يكون ضمن نطاق التطبيق.
وتوصي MDN بأن تبدأ القيمة بـ / لتكون مساراً نسبياً للجذر بوضوح.
مثال توضيحي لملف manifest
{
"name": "بوابة الطلاب",
"id": "/portal",
"start_url": "/ar/portal?source=pwa",
"scope": "/",
"display": "standalone"
}
هنا المعرّف يُحل إلى https://example.jo/portal، وهو ثابت. يمكن للمطور أن يغيّر start_url إلى أي مسار آخر لاحقاً، ويبقى المتصفح يعرف أنه التطبيق نفسه.
إن كان تطبيقك مثبتاً بالفعل دون id
هذه أهم نقطة عملية: إن أضفت id الآن بقيمة جديدة مختلفة، فقد تحدث المشكلة التي تحاول تجنبها، لأن المعرّف الفعلي لتطبيقك المثبت هو start_url الحالي.
الطريقة الآمنة:
- انظر إلى start_url الحالي في ملف manifest، مثل /portal.
- احسب المعرّف الذي يستخدمه المتصفح الآن: أصل الموقع مع ذلك المسار، بعد حذف أي جزء بعد #، مع الإبقاء على معاملات الاستعلام إن وُجدت.
- اجعل قيمة id مساوية لهذا المعرّف بالضبط.
- بعدها فقط، غيّر start_url إن أردت.
انتبه للمعاملات: إن كان start_url الحالي /portal?source=pwa، فالمعرّف الحالي يحتوي على ?source=pwa، لأن MDN تذكر أن معاملات الاستعلام تبقى في المعرّف. ضع id بالمعاملات نفسها، وإلا تغيّرت الهوية.
متى تريد تطبيقاً جديداً فعلاً
أحياناً يكون الفصل مقصوداً. تذكر MDN مثالاً لتطبيق طقس: إن أنشأت لاحقاً نسخة بتغييرات كبيرة وأردت أن تُعامل كتطبيق مختلف، فيمكنك إعطاؤها id مختلفاً. مثال توضيحي من عمل صغير: مطعم لديه تطبيق للزبائن، ويريد تطبيقاً منفصلاً للمطبخ يُثبت على جهاز لوحي. كل منهما يحتاج id مختلفاً وملف manifest خاصاً، حتى لا يستبدل أحدهما الآخر على الجهاز نفسه.
تطبيق واحد بلغتين أم تطبيقان؟
مع وجود واجهة عربية وأخرى إنجليزية، يسأل المطور: هل نجعل لكل لغة ملف manifest ومعرّفاً خاصاً؟ القرار يعتمد على ما تريده للمستخدم:
- تطبيق واحد: معرّف واحد ثابت، مثل /portal، والمستخدم يغيّر اللغة من داخل التطبيق. هذا الأبسط لمعظم الأعمال الصغيرة، ولا يرى الطالب أيقونتين إن تنقّل بين اللغتين.
- تطبيقان: معرّف مختلف لكل لغة، مثل /ar/portal و/en/portal. يناسب فقط إن كان الجمهوران مختلفين فعلاً، ولا يُتوقع أن يثبّت أحد التطبيقين معاً.
المهم أن يكون القرار مقصوداً ومكتوباً، لا نتيجة جانبية لترتيب الروابط. وإن اخترت تطبيقاً واحداً، فاجعل ملف manifest نفسه يُقدَّم من الصفحتين، أو ملفين بالمعرّف نفسه وأسماء مختلفة حسب اللغة، فهذا يبقي الهوية واحدة.
الموظفون أيضاً مستخدمون
لا تنسَ التطبيقات الداخلية: لوحة طلبات المطبخ، أو تطبيق المندوبين، أو شاشة الاستقبال. هذه غالباً مثبتة على أجهزة يستخدمها الموظفون يومياً، وأي ارتباك في الهوية بعد تحديث يوقف العمل صباحاً. طبّق القاعدة نفسها عليها قبل أي تعديل في الروابط.
علامات تدل على مشكلة في الهوية
- الزبائن يرون اقتراح التثبيت مع أن التطبيق مثبت عندهم.
- أيقونتان للتطبيق على الشاشة الرئيسية نفسها.
- تغيير الاسم أو الأيقونة في manifest لا يظهر عند المستخدمين الحاليين.
- الإشعارات أو الإعدادات المرتبطة بالتطبيق المثبت تتصرف بشكل غريب بعد تعديل الروابط.
إن رأيت أياً منها بعد إعادة تنظيم الروابط، فراجع start_url وid أولاً، قبل أن تبحث عن السبب في الكود أو الخادم.
قائمة قبل أي إعادة تنظيم للموقع
- هل في ملف manifest قيمة id؟ إن لا، أضفها مساوية للمعرّف الحالي قبل أي تغيير.
- هل سيتغير مسار ملف manifest نفسه أو start_url أو scope؟
- هل التحويلات من الروابط القديمة إلى الجديدة جاهزة؟
- هل اختبرت على جهاز فيه التطبيق مثبت مسبقاً، لا على جهاز جديد فقط؟
أسئلة شائعة
هل يجب أن تكون صفحة id موجودة على الموقع؟
لا. MDN توضح أن id يُعالج كرابط لكنه لا يشير إلى مورد يجب الوصول إليه.
ماذا يحدث إن لم أحدد id؟
يُستخدم start_url كمعرّف. فإن تغيّر start_url لاحقاً، قد يُعامل التطبيق كتطبيق مختلف.
هل تؤثر علامة # في المعرّف؟
لا. أي جزء بعد # يُحذف عند حساب المعرّف، بحسب MDN.
هل تؤثر معاملات الاستعلام؟
نعم. معاملات ? تبقى جزءاً من المعرّف، فانتبه إليها عند نسخ القيمة.
إذا كان لديك تطبيق ويب مثبت عند زبائنك وتخطط لتغيير روابط موقعك، تواصل معنا لنحافظ على هويته أثناء التغيير.