النشر في متجر Chrome: التسجيل والحزم والرفع للمراجعة - الدليل الكامل
الهدف في جملة واحدة: نشر الإضافة المحلية التي شغّلتها في الدرس السابق — إكمال الخطوات الثلاث لنشر إضافة chrome «تسجيل حساب المطوّر ← الحزم والرفع ← إرسال المراجعة»، ودخول قائمة انتظار مراجعة متجر Chrome، بحيث يستطيع المستخدمون الغرباء البحث عن إضافتك وتثبيتها.
ماذا ستستطيع أن تفعل بعد إتمام الدرس
- تسجيل حساب مطوّر في Chrome Web Store والدخول إلى لوحة المطوّر
- حزم مجلد الإضافة في ملف zip متوافق يقع manifest.json في جذرها
- تعبئة معلومات المنتج في 5 من علامات التبويب في اللوحة
- الضغط على Submit for Review لإدخال الإضافة في قائمة انتظار مراجعة المتجر
مأزقك الحالي
- «الإضافة تعمل، لكنها تعيش في متصفحي أنا فقط. عندما يريدها صديق، لا يمكنني سوى إرشاده عن بُعد لتفعيل وضع المطوّر وتحميل المجلد يدويًا.»
- «سمعت أن النشر يتطلب دفع رسوم ومراجعة، لكن لا فكرة لدي عن عدد الخطوات وما المواد المطلوبة في كل خطوة.»
- «أكثر ما أخشاه هو إدخال معلومات خاطئة: إذا كتبت بريد الحساب خطأً، هل يصبح الحساب غير صالح؟»
متى تستخدم هذه الطريقة
عندما تحتاج إلى: توزيع الإضافة على الغرباء — أي شخص يستطيع البحث عن إضافتك في متجر Chrome وتثبيتها بنقرة واحدة، دون أن ترسل الملفات واحدًا واحدًا.
ولا تريد: إرشاد صديقك عن بُعد لتفعيل وضع المطوّر والتحميل اليدوي؛ أو أن تبقى الإضافة مثبتة على حاسوبك وحده إلى الأبد.
🎒 الاستعدادات قبل البدء
- إتمام الدرس السابق«أول إضافة Chrome: تشغيل Hello World في 15 دقيقة»، بحيث تُحمَّل الإضافة في المتصفح بشكل طبيعي وتعمل جميع وظائفها — وتؤكد الوثائق الرسمية أيضًا ضرورة اختبار الوظائف محليًا قبل الرفع.
- حساب Google تختاره بعناية قبل الاستخدام: البريد المرتبط بحساب المطوّرلا يمكن تغييره بعد الإنشاء. توصي الوثائق الرسمية بفتح بريد جديد مخصص للنشر، وأن يكون بريدًا تتفقده باستمرار — فالإشعارات المهمة مثل الإزالة والرفض تُرسل افتراضيًا عبر البريد.
- تخصيص ميزانية لرسوم التسجيل لمرة واحدة، والمبلغ يُعتمد وفقًا لصفحة الدفع الفعلية في لوحة المطوّر@@I18N_KEEP_000007@@.
- تجهيز مواد الإضافة بالكامل: manifest.json والأيقونات ولقطات الشاشة ونص الوصف — الحقول الإلزامية في 5 من علامات التبويب ليست قليلة، وتجهيزها أثناء العمل سيقطع المسار.
- تأكيد النطاق: يغطي هذا الدليل إضافات Manifest V3 في متجر Chrome فقط، والنشر على Firefox وEdge خارج هذا المسار.
الفكرة الأساسية
جوهر نشر إضافة chrome هو تحويل «مجلد على حاسوبك» إلى «منتج في المتجر». كل خطوة من الخطوات الثلاث مسؤولة عن أمر واحد:
| المرحلة | ما عليك فعله | الناتج | أكثر موضع عرضة للخطأ |
|---|---|---|---|
| ① التسجيل | دفع رسوم التسجيل لمرة واحدة والحصول على حساب المطوّر | حساب قادر على نشر المنتجات | البريد لا يمكن تغييره بعد الإنشاء |
| ② الحزم | فحص الـ manifest وضغطه في zip متوافق | حزمة zip يقع الـ manifest في جذرها | مجلد إضافي متداخل داخل الـ zip |
| ③ الرفع للمراجعة | رفع الـ zip وتعبئة 5 من علامات التبويب ثم الإرسال | دخول المنتج في قائمة انتظار المراجعة | الضغط على الإرسال قبل استكمال الحقول الإلزامية |
الخطوات الثلاث متسلسلة: الحساب هو تذكرة الدخول، والـ zip هو جوهر المنتج، ومعلومات المنتج هي عرض الرفّ. ما يستلمه المراجع هو مزيج من هذه الثلاثة، وأي خلل في حلقة واحدة يعني الإرجاع والبدء من جديد.
اتبع خطواتي
الخطوة 1: تسجيل حساب المطوّر (الخطوة الأولى لنشر إضافة chrome)
لماذا: بدون حساب مطوّر، لن تمنحك لوحة المطوّر حتى مدخل «إضافة منتج جديد» — احصل على تذكرة الدخول هذه أولًا، حتى يكون للخطوتين التاليتين مكان تستقران فيه.
افتح لوحة مطوّري Chrome Web Store (chrome.google.com/webstore/devconsole)، وسجّل الدخول بحساب Google. عند الدخول لأول مرة ستظهر صفحة التسجيل: وافق أولًا على اتفاقية وسياسات المطوّرين، ثم ادفع رسوم التسجيل لمرة واحدة@@I18N_KEEP_000008@@. يلزم أثناء التسجيل تقديم بريد المطوّر؛ والصين (China) ضمن قائمة الدول/المناطق المدعومة للتسجيل.
ينبغي أن ترى: بعد إتمام الدفع والعودة إلى اللوحة، لن تظهر صفحة التسجيل مجددًا، وسترى قائمة المنتجات وزر «إضافة منتج جديد (Add new item)».
- صفحة التسجيل لم تعد تظهر، ومدخل «إضافة منتج جديد» ظاهر في اللوحة
الخطوة 2: فحص الـ manifest وحزمه في ملف zip (حزم الإضافة في zip)
لماذا: بمجرد رفع الإضافة، لن تتمكن من تعديل البيانات الوصفية للـ manifest في لوحة المطوّر — حتى خطأ إملائي واحد يتطلب تعديل الملف ورفع رقم الإصدار وإعادة الحزم. لذا افحص الـ manifest قبل الحزم.
افحص أربعة أمور بالترتيب:
- اكتمال الحقول الأربعة
nameوversionوiconsوdescription— يظهرnameفي المتجر والمتصفح، ولا يمكن أن يتجاوزdescriptionعدد 132 من الأحرف. - ضبط
versionعلى قيمة منخفضة مثل0.0.0.1— يطلب المتجر أن يكون رقم إصدار كل رفعة جديدة أكبر من سابقه، والبدء بقيمة منخفضة يترك مجالًا للزيادة. - لا يجوز ترك تعليقات في الـ manifest — التعليقات سبب شائع لظهور خطأ «Cannot parse the manifest» عند الرفع.
- عند الضغط، حدّد** الملفات الموجودة داخل** مجلد الإضافة ثم اضغط، إذ يجب أن يقع manifest.json في جذر الـ zip لا داخل مجلد فرعي. الحد الأقصى لحجم الحزمة 2GB، وهو حد بعيد عن متناول الإضافات العادية.
ينبغي أن ترى: عند فك ضغط الـ zip في مجلد مؤقت، يظهر manifest.json مباشرة في الطبقة الأولى.
- فك ضغط الـ zip فيظهر manifest.json في الطبقة الأولى
الخطوة 3: رفع ملف zip وتعبئة معلومات المنتج وإرساله للمراجعة (رفع الإضافة للمراجعة)
لماذا: ملف zip هو جوهر المنتج فقط، لكن المتجر يطلب منك أيضًا استكمال «معلومات الرفّ» — المستخدمون يعتمدون عليها في قرار التثبيت، والمراجعون يعتمدون عليها لفهم وظيفة إضافتك.
- في لوحة المطوّر اضغط على Add new item، واختر Choose file لتحديد ملف zip الذي حزمته للتو، ثم اضغط Upload. إذا كان الـ zip والـ manifest صالحين، ستنتقل إلى صفحة تعديل المنتج.
- عبّئ بالتسلسل 5 من علامات التبويب في القائمة الجانبية:
- Package: معلومات الحزمة المرفوعة، لا يمكن تعديل هذه الصفحة عند الإنشاء الأول؛
- Store Listing: تفاصيل المنتج، تحدد كيف تُعرض صفحة المتجر؛
- Privacy: يُعلن الغرض الوحيد من الإضافة وكيفية تعاملها مع بيانات المستخدمين؛
- Distribution: هل هي مدفوعة، وفي أي دول تُطرح، وأي المستخدمين يمكنهم رؤيتها؛
- Test instructions: تعليمات وبيانات الاختبار الخاصة بالمراجعين، تُملأ عند الضرورة فقط.
- بعد إكمال جميع الحقول الإلزامية، انقر على Submit for Review، ثم أكّد مرة أخرى في نافذة التأكيد المنبثقة.
يجب أن ترى: تتغير حالة المنتج إلى «قيد المراجعة»، ويظهر امتدادك في قائمة المنتجات في لوحة التحكم الخلفية.
- 5 علامة تبويب اكتملت حقولها الإلزامية، والحالة تغيّرت إلى «قيد المراجعة»
💡 تريد التحكم في وقت الإطلاق بنفسك؟
يمكنك التحكم في توقيت النشر من نافذة تأكيد الإرسال: بإلغاء تحديد ذلك الخيار، لن يُنشر المنتج تلقائيًا فور اكتمال المراجعة، ويمكنك نشره يدويًا في الوقت المناسب. متى تنشر وكيف تتراجع، سيُشرح بالتفصيل في الدرس التالي.
⚠️ الناشرون الجدد لديهم حد أقصى للعدد
عند إنشاء حساب ناشر لأول مرة، يمكنك امتلاك 2 من الإضافات المنشورة كحد أقصى (يُحسب حسب العدد المعروض، والثيمات لا تستهلك من الحصة). الحد الأقصى الحالي مرئي في لوحة المطورين، وعند بلوغه يمكنك طلب رفعه، وفي معظم الحالات يصدر القرار فورًا. صقل إضافة واحدة جيدًا أفضل من رفع مجموعة كبيرة دفعة واحدة.
نقطة تحقق ✅
- لم تعد صفحة التسجيل تظهر، ويمكن رؤية مدخل «إضافة عنصر جديد (Add new item)» في لوحة المطورين
- عند فك ضغط ملف zip يكون manifest.json في الطبقة الأولى، ولا توجد تعليقات داخل manifest
- الحقول الأربعة لملف manifest مكتملة، و description لا تتجاوز 132 حرفًا، و version تبدأ من قيمة منخفضة مثل 0.0.0.1
- 5 علامة تبويب اكتملت جميع حقولها الإلزامية، وتم النقر على Submit for Review
- تظهر حالة المنتج في اللوحة الخلفية «قيد المراجعة»، وبريد التسجيل هو بريد تتفقده بانتظام
تنبيهات لتجنب الأخطاء
❌ مجلد إضافي داخل ملف zip
عند الضغط، تم سحب مجلد المشروع بأكمله للضغط، فانتهى manifest.json داخل مجلد فرعي.
السبب: يفرض المتجر أن يكون manifest في الدليل الجذري لملف zip، وأي طبقة إضافية تعني الفشل مباشرة.
الطريقة الصحيحة: حدد الملفات الموجودة داخل دليل الإضافة قبل الضغط؛ وقبل الإرسال فك ضغط ملف zip مرة وتأكد من أن manifest.json في الطبقة الأولى.
❌ ترك تعليقات داخل manifest
عند الرفع تظهر رسالة «Cannot parse the manifest».
السبب: ملف manifest بصيغة JSON، ووجود التعليقات سبب شائع لهذا الخطأ في التحليل.
الطريقة الصحيحة: احذف جميع التعليقات من manifest، ثم أعد التغليف والرفع.
❌ إدخال بريد إلكتروني لا تتفقده عادةً
السبب: بريد حساب المطور لا يمكن تغييره بعد الإنشاء، ولتغييره يجب إنشاء حساب جديد ثم نقل المنتجات إليه عبر النموذج الرسمي؛ إشعارات مهمة مثل الإزالة والرفض تُرسل افتراضيًا إلى هذا البريد، وإغفالها قد يسبب تأخيرات.
الطريقة الصحيحة: فكّر جيدًا قبل التسجيل. توصي الجهة الرسمية بإنشاء بريد إلكتروني جديد مخصص للنشر، والتأكد من أنك ستتفقده بانتظام.
❌ كتابة رقم إصدار كبير جدًا من البداية
السبب: يفرض المتجر أن يكون رقم الإصدار لكل رفعة جديدة أكبر من السابقة؛ كما أن بيانات manifest الوصفية لا يمكن تعديلها من اللوحة الخلفية بعد الرفع، فتصحيح خطأ إملائي واحد يتطلب رفع رقم الإصدار وإعادة التغليف. إذا بدأت بقيمة كبيرة، لن يبقى مجال للزيادة لاحقًا.
الطريقة الصحيحة: اجعل رقم الإصدار الأول قيمة منخفضة، مثل 0.0.0.1.
خلاصة الدرس
نشر إضافة chrome هو ثلاث خطوات: تسجيل حساب مطوّر → تغليف zip → إرسال للمراجعة.
- ✅ التسجيل: رسم تسجيل لمرة واحدة (المبلغ وفقًا لصفحة الدفع الفعلية)، والبريد الإلكتروني لا يمكن تغييره بعد الإنشاء
- ✅ التغليف: الحقول الأربعة لملف manifest مكتملة وبلا تعليقات، و manifest.json في الدليل الجذري لملف zip، وحجم الحزمة ≤ 2GB
- ✅ الإرسال للمراجعة: ارفع ملف zip عبر Add new item، وأكمل 5 علامات تبويب، وانقر على Submit for Review
- ✅ الناشرون الجدد لديهم 2 من الإضافات المنشورة كحد أقصى، فركّز أولًا على صقل إضافة واحدة
مراجعة حقول الإعداد الرئيسية:
| الحقل | القيمة الموصى بها | الشرح |
|---|---|---|
manifest.json لـ version | قيمة منخفضة مثل 0.0.0.1 | يجب أن يكون رقم كل إصدار جديد أكبر من السابق، والبدء بقيمة منخفضة يترك مجالًا للزيادة |
manifest.json لـ description | ≤ 132 حرفًا | يُستخدم للعرض في تفاصيل المتجر، والحد الأقصى 132 حرفًا |
manifest.json لـ name و icons | ضبطها نهائيًا مسبقًا | بيانات manifest الوصفية لا يمكن تعديلها من اللوحة الخلفية بعد الرفع |
| بنية zip | manifest.json في الدليل الجذري | إضافة طبقة مجلد إضافية تؤدي إلى الفشل |
| حجم الحزمة | ≤ 2GB | التجاوز يؤدي إلى الرفض |
استعراض الدرس التالي
الإرسال مجرد بداية: كم تستغرق المراجعة، وكيف ترفع نسبة القبول، وماذا تفعل بعد الرفض؟ تابع التعلم في «مراجعة المتجر واستراتيجيات النشر: مراجعة خلال 3 أيام، والإطلاق التدريجي والتراجع».
ستتعلم:
- سير عملية مراجعة المتجر والمدة التقريبية
- ما الاستعدادات التي يمكن القيام بها لرفع نسبة القبول
- التصحيح وإعادة الإرسال بعد الرفض
- كيفية الإطلاق التدريجي والتراجع
إذا اخترت مسار تطبيقات WeChat المصغرة، يمكنك الرجوع إلى «إرسال المراجعة والنشر: دليل تجنب أخطاء قواعد مراجعة WeChat».