إنّ نشر مشروع "برمجة تطبيقات Google" هو إصدار من البرنامج النصي متاح للاستخدام كتطبيق ويب أو إضافة Google Workspace أو ملف تنفيذي لواجهة برمجة التطبيقات. من خلال إنشاء عمليات نشر وإدارتها، يمكنك تكرار الرمز والتحكّم في إصدار البرنامج النصي الذي يمكن للمستخدمين الوصول إليه.
هناك نوعان من عمليات النشر:
- عمليات النشر الرئيسية التي تتم مزامنتها دائمًا مع رمز المشروع الحالي
- عمليات النشر المستندة إلى الإصدار، والتي ترتبط بإصدار محدّد من المشروع
عمليات النشر الرئيسية
يشير نشر الإصدار الرئيسي إلى رمز المشروع الحالي. عند إنشاء مشروع في برمجة تطبيقات، ينشئ النظام تلقائيًا عملية نشر رئيسية لهذا المشروع.
تتم مزامنة عملية النشر الرئيسية دائمًا مع آخر رمز تم حفظه. على سبيل المثال، إذا أنشأت عملية نشر ذات إصدار ثم عدّلت الرمز، ستعرض عملية النشر الرئيسية هذه التغييرات بينما تظل عملية النشر ذات الإصدار كما هي.
استخدِم عمليات النشر الرئيسية لاختبار الرمز. لا تستخدم عمليات نشر على مستوى الرأس للاستخدام العام.
لا يمكن أن يتضمّن كل مشروع برمجة تطبيقات سوى عملية نشر واحدة للنسخة الرئيسية. لاستخدام عملية نشر رئيسية، يجب أن يكون لديك على الأقل إذن وصول للقراءة إلى مشروع البرنامج النصي.
عمليات النشر المحدّدة بإصدار
يتيح النشر الذي يتضمّن إصدارًا توفير إصدار معيّن من رمز المشروع. يتيح ذلك للمستخدمين مواصلة استخدام نسخة تعمل بشكل جيد أثناء إجراء تغييرات وتحسينات على الرمز.
عند نشر تطبيق للاستخدام العام، استخدِم دائمًا عملية نشر تتضمّن إصدارًا. يمكنك نشر إصدارات متعددة نشطة في الوقت نفسه.
ملاحظة مهمة: لا يمكنك نقل ملكية عمليات النشر التي تتضمّن إصدارات. في حال نقل ملكية مشروع نص برمجي، لن يتغيّر مالك عمليات النشر الحالية التي تم إصدارها. إذا حذف المشرف حساب مالك عملية النشر، قد تحدث أخطاء في النصوص البرمجية لعمليات النشر.
عمليات النشر مقارنةً بالإصدارات
الإصدار وعملية النشر مفهومان مختلفان في برمجة تطبيقات:
- الإصدار: لقطة ثابتة لرمز مشروع النص البرمجي. بعد إنشاء إصدار، يصبح غير قابل للتغيير. اعتبِر الإصدار بمثابة "نقطة حفظ" في سجلّ التطوير.
- النشر: إصدار يتيح للمستخدمين استخدام نسخة معيّنة من البرنامج النصي. يتضمّن عملية النشر عنوان URL أو معرّفًا فريدًا.
عندما تريد تعديل الرمز المستخدَم في عملية نشر حالية (مثل تطبيق ويب)، يمكنك إنشاء إصدار جديد ثم تعديل عملية النشر للإشارة إلى هذا الإصدار الجديد. يؤدي ذلك إلى تعديل التطبيق لجميع المستخدمين مع الحفاظ على عنوان URL أو معرّف النشر نفسه.
إنشاء عملية نشر ذات إصدار
لنشر إصدار من إضافة أو إضافة محرّر أو تطبيق Chat أو ملف تنفيذي لواجهة برمجة تطبيقات، عليك أولاً تبديل ربط مشروع Google Cloud في Apps Script من المشروع التلقائي إلى مشروع عادي.
لإنشاء عملية نشر تتضمّن إصدارًا، اتّبِع الخطوات التالية:
- افتح مشروع برمجة تطبيقات.
- في أعلى يسار الصفحة، انقر على نشر > عملية نشر جديدة.
- بجانب اختيار النوع، انقر على "تفعيل أنواع النشر" .
- اختَر نوع النشر الذي تريد تنفيذه. بالنسبة إلى إضافات Google Workspace وإضافات المحرّر وتطبيقات Google Chat، اختَر إضافة.
- أدخِل معلومات حول عملية النشر وانقر على نشر.
يمكن مشاركة كل عملية نشر جديدة كمكتبة. إذا شاركت النص البرمجي كمكتبة، سيظهر وصف عملية النشر لمستخدمي المكتبة.
عرض عمليات النشر التي تتضمّن إصدارات
لعرض عمليات نشر مشروع في "برمجة تطبيقات Google"، انقر على نشر > إدارة عمليات النشر في أعلى الصفحة.
للاطّلاع على رمز إصدار معيّن، يُرجى الرجوع إلى مقالة عرض إصدار سابق.
تعديل عملية نشر تتضمّن إصدارات
يمكنك تعديل عملية نشر ذات إصدار لتغيير وصفها أو إصدارها. لتعديل عملية نشر، اتّبِع الخطوات التالية:
- افتح مشروع برمجة تطبيقات.
- انقر على نشر > إدارة عمليات النشر.
- اختَر عملية النشر النشطة وانقر على تعديل .
- أدخِل التغييرات وانقر على نشر.
لتعديل عملية نشر مؤرشفة، أعِد نشرها ثم اتّبِع الخطوات السابقة.
لنشر تغيير في رمز المشروع، أنشئ إصدارًا جديدًا وعدِّل عملية النشر لاستخدامه. هذه هي الطريقة العادية لتعديل تطبيقك بدون تغيير عنوان URL أو رقم تعريف النشر. يستخدم النشر تلقائيًا الإصدار الجديد لجميع المستخدمين.
العثور على رقم تعريف عملية نشر
لكل عملية نشر معرّف سلسلة مرتبط بها. للعثور على هذا المعرّف:
- افتح مشروع برمجة تطبيقات.
- في أعلى يسار الصفحة، انقر على نشر > إدارة عمليات النشر.
- اختَر عملية نشر نشطة للعثور على رقم تعريفها.
لا تظهر أرقام تعريف عمليات النشر إلا في عمليات النشر النشطة.
اختبار عملية نشر
تعتمد طريقة اختبار عملية النشر على نوع التطبيق الذي تنشئه.
إضافة Google Workspace
لاختبار نشر إضافة، يُرجى الاطّلاع على اختبار الإضافات.
إضافة "المحرّر"
لاختبار نشر إحدى "إضافات المحرِّر"، يُرجى الاطّلاع على اختبار إحدى "إضافات المحرِّر".
تطبيق الويب
لاختبار عملية نشر تطبيق ويب، يُرجى الاطّلاع على اختبار عملية نشر تطبيق ويب.
تطبيق Google Chat
لاختبار عملية نشر تطبيق محادثات، أنشئ عملية نشر ذات إصدار للبرنامج النصي للوصول إلى معرّف عملية النشر.
بعد الحصول على معرّف النشر، حدِّد المعرّف في إعدادات Chat API واتّبِع الخطوات لاختبار الميزات التفاعلية.
واجهة برمجة تطبيقات قابلة للتنفيذ
لاختبار عملية نشر قابلة للتنفيذ لواجهة برمجة التطبيقات، عليك إنشاء عملية نشر مُحدَّدة الإصدار. بعد إنشاء عملية نشر، اتّبِع الخطوات التالية:
- في أعلى يسار مشروع برمجة تطبيقات، انقر على نشر > اختبار عمليات النشر.
- بجانب "اختيار النوع"، انقر على
> ملف تنفيذي لواجهة برمجة التطبيقات. - انسخ عنوان URL واستخدِمه لاختبار عملية نشر واجهة برمجة التطبيقات القابلة للتنفيذ.
أرشفة عملية نشر ذات إصدار
لا يمكنك حذف عمليات النشر التي تم إصدارها من سجلّ عمليات النشر. بدلاً من ذلك، يمكنك أرشفة هذه الرسائل.
لأرشفة عملية نشر مُحدَّدة الإصدار، اتّبِع الخطوات التالية:
- افتح مشروع برمجة تطبيقات.
- انقر على نشر > إدارة عمليات النشر.
- اختَر عملية النشر وانقر على أرشفة عملية النشر .
حذف نسخة من سجلّ المشاريع
على الرغم من أنّه لا يمكنك حذف عمليات النشر التي تتضمّن إصدارات، يمكنك حذف إصدارات النصوص البرمجية التي تستخدمها من سجلّ مشروعك. لحذف نسخة، يجب ألا تكون قيد الاستخدام في عملية نشر نشطة.
لحذف إصدار، يُرجى الرجوع إلى مقالة حذف الإصدارات.
إعادة نشر عملية نشر مؤرشفة
- افتح مشروع برمجة تطبيقات.
- في أعلى يسار الصفحة، انقر على نشر > إدارة عمليات النشر.
- ضمن الأرشيف، اختَر عملية النشر وانقر على تعديل > نشر.