مولّد بيان تطبيق الويب

اكتب اسم تطبيق الويب وعنوان بدايته ووضع عرضه وألوانه وأيقوناته. تحصل على ملف البيان لتحفظه بجانب صفحاتك، وعلى قائمة بما تحتاجه المتصفحات لتثبيت التطبيق.

مجانية تعمل داخل متصفحك آخر مراجعة: الثلاثاء، 30 جمادى الأولى 1448 بعد الهجرة

الاسم الكامل، ويظهر حيث يُدرج التطبيق. حتى 120 حرفًا.

الاسم الذي يظهر تحت الأيقونة على الشاشة الرئيسية، حين تكون المساحة ضيقة.

العنوان الذي يُفتح به التطبيق. العنوان النسبي مثل / يُحسب بالنسبة إلى المكان الذي يُقدَّم منه الملف.

نطاق العناوين الذي يغطيه التطبيق. يجب أن يحتوي عنوان البداية، وإلا تستخدم المتصفحات نطاقها الافتراضي.

كم من المتصفح يُظهر التطبيق.

لون شاشة الترحيب. لون بصيغة hex، مثل #ffffff.

لون شريط المتصفح أو النظام. لون بصيغة hex، مثل #1f6feb.

وسم لغة مثل en أو tr-TR. اتركه فارغًا إن لم تحتجه.

أيقونة في كل سطر: العنوان | الأبعاد | النوع | الأغراض. الأبعاد بصيغة WIDTHxHEIGHT، مثل 192x192، أو any لملفات SVG. الأغراض هي any أو maskable أو monochrome. العنوان وحده مطلوب.

النتيجة

manifest.webmanifest — احفظه كملف بالاسم الظاهر في العنوان، ثم اربطه من كل صفحة بعنصر link تكون قيمة rel فيه manifest.
فحوص قابلية التثبيت — تُدرج كل ملاحظة تحت النتيجة.
manifest.webmanifest

تعمل هذه الأداة داخل متصفحك. ما تكتبه فيها لا يُرسل إلينا.

طريقة الاستخدام

  1. اكتب الاسم والاسم القصير، ثم عنوان البداية والنطاق للتطبيق.
  2. اختر وضع العرض، واكتب لون الخلفية ولون السمة بصيغة hex.
  3. اكتب أيقونة في كل سطر تحت الأيقونات: العنوان، ثم الأبعاد والنوع والأغراض، مفصولة بخط عمودي |.
  4. احفظ النص تحت manifest.webmanifest، وأصلح كل ملاحظة مدرجة تحت فحوص قابلية التثبيت.

معنى الأعضاء

البيان ملف JSON. تُوصف أعضاؤه في مواصفة W3C لبيان تطبيق الويب (القسم 1). تُكتب الأعضاء التي تملؤها فقط، فالحقل الفارغ يترك عضوه خارج الملف. ويحدد وضع العرض كيف يُظهر المتصفح التطبيق؛ وإذا لم يدعم المتصفح وضعًا، يستخدم التالي له في هذه السلسلة (القسم 6): ملء الشاشة، ثم مستقل، ثم واجهة مبسطة، ثم لسان المتصفح.

عنوان البداية الواقع على أصل مختلف عن أصل الصفحة يُتجاهل، لأن المواصفة تشترط الأصل نفسه. ولا يُستخدم النطاق إلا إذا احتوى عنوان البداية؛ وإلا تستخدم المتصفحات النطاق الذي هو عنوان البداية دون اسم الملف والاستعلام والجزء الذي يبدأ بـ #.

ما تفحصه الملاحظات

تسرد MDN الأعضاء التي تحتاجها المتصفحات المبنية على Chromium قبل أن تعرض تثبيت تطبيق ويب: اسمًا أو اسمًا قصيرًا، وأيقونتين بحجم 192 و512 بكسل، وعنوان بداية، ووضع عرض. وتذكر أيضًا أن الموقع يجب أن يُقدَّم عبر https أو من localhost، وأن عامل الخدمة (service worker) ليس مطلوبًا. ولا يثبّت Firefox تطبيق ويب من ملف بيان على سطح المكتب.

تفحص الأداة الأعضاء السابقة وقاعدة النطاق. ولا تختبر ملفات الأيقونات ولا عنوان https ولا الرابط في صفحاتك؛ فهذه عليك أنت التأكد منها.

القيم الافتراضية

مع القيم التي تفتح بها الصفحة، يحتوي البيان على الأعضاء أدناه. ولا تظهر أي ملاحظة، لأن الاسم وعنوان البداية وكلا حجمي الأيقونة موجودة.

العضو القيمة
name, short_name ملاحظات، ملاحظات
start_url, scope /، /
display standalone
background_color, theme_color #ffffff، #1f6feb
icons ملفا PNG بأبعاد 192x192 و512x512؛ وللأيقونة 512 الغرض any maskable

الأسئلة الشائعة

أين أحفظ ملف البيان؟

احفظه في جذر الموقع، أو في مجلد التطبيق، وسمِّه manifest.webmanifest. ثم اربطه من كل صفحة في التطبيق بعنصر link تكون قيمة rel فيه manifest، كما تصف MDN.

هل أحتاج إلى عامل خدمة لتثبيت التطبيق؟

لا. تقول MDN إن عامل الخدمة ليس شرطًا لقابلية تثبيت PWA، مع أن تطبيقات كثيرة تستخدمه ليعمل دون اتصال. ويجب مع ذلك أن يُقدَّم الموقع عبر https، أو من localhost.

ما أبعاد الأيقونات التي أحتاجها؟

تسرد MDN أيقونة بحجم 192 بكسل وأخرى بحجم 512 بكسل للمتصفحات المبنية على Chromium. اكتب الأبعاد بصيغة WIDTHxHEIGHT، وافصل بينها بمسافات إذا كان لملف واحد أكثر من بُعد. ويمكن أن يكون بُعد ملف SVG هو any.

ما الفرق بين الاسم والاسم القصير؟

الاسم هو الاسم الكامل للتطبيق. أما الاسم القصير فللأماكن التي تضيق فيها المساحة، مثل النص تحت الأيقونة على الشاشة الرئيسية. اكتب واحدًا منهما على الأقل؛ وتحذّر الأداة إذا كانا فارغين معًا.

لماذا تحذّر الأداة بشأن النطاق؟

لا يُستخدم النطاق إلا إذا احتوى عنوان البداية (القسم 1 من W3C). فإذا كان عنوان البداية خارج النطاق، تتجاهل المتصفحات النطاق وتستخدم نطاقها الافتراضي، فقد يُفتح التطبيق خارج المنطقة التي قصدتها.

المصادر

آخر مراجعة للأرقام والنص: الثلاثاء، 30 جمادى الأولى 1448 بعد الهجرة.

نستخدم ملفات تعريف ارتباط ضرورية لتشغيل الموقع. وبموافقتك، تستخدم Google أيضاً ملفات تعريف ارتباط للإعلانات، لعرض إعلانات مخصصة. وإذا رفضتها، فستظل ترى إعلانات، لكنها لن تكون مخصصة لك.