إنشاء عمليات النشر وإدارتها

إنّ عملية نشر مشروع "برمجة تطبيقات Google" هي إصدار من النص البرمجي متاح للاستخدام كتطبيق ويب أو إضافة Google Workspace أو ملف تنفيذي لواجهة برمجة التطبيقات. من خلال إنشاء عمليات نشر وإدارتها، يمكنك تكرار الرمز البرمجي وتتبُّع التغييرات والتحكّم في إصدار الرمز البرمجي الذي يمكن للمستخدمين الوصول إليه.

هناك نوعان من عمليات النشر:

• عمليات نشر الإصدار الرئيسي التي تتم مزامنتها دائمًا مع رمز المشروع الحالي
• عمليات النشر المستندة إلى الإصدار، والتي ترتبط بإصدار محدّد من المشروع

عمليات النشر الرئيسية

يشير نشر الإصدار الرئيسي إلى رمز المشروع الحالي. عند إنشاء مشروع في برمجة تطبيقات، ينشئ النظام تلقائيًا عملية نشر رئيسية لهذا المشروع.

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

استخدِم عمليات نشر الإصدار الرئيسي لاختبار الرمز. لا تستخدم عمليات نشر الرأس للاستخدام العام.

لا يمكن أن يتضمّن كل مشروع من مشاريع "برمجة التطبيقات" سوى عملية نشر واحدة للنسخة الرئيسية. لاستخدام عملية نشر رئيسية، يجب أن يكون لديك على الأقل إذن وصول للقراءة إلى مشروع البرنامج النصي.

عمليات النشر المحدّدة بإصدار

يتيح النشر المستند إلى إصدار استخدام إصدار معيّن من رمز المشروع. يتيح ذلك للمستخدمين مواصلة استخدام نسخة تعمل بشكل جيد أثناء إجراء تغييرات وتحسينات على الرمز.

عند نشر تطبيق للاستخدام العام، استخدِم دائمًا عملية نشر تتضمّن إصدارًا. يمكنك إجراء عمليات نشر متعددة نشطة ومحدّدة الإصدار في الوقت نفسه.

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

إنشاء عملية نشر ذات إصدار

لتفعيل إصدار من إضافة أو إضافة في "أدوات التحرير" أو تطبيق محادثات أو ملف تنفيذي لواجهة برمجة تطبيقات، عليك أولاً تبديل ربط مشروع Google Cloud في "برمجة التطبيقات" من المشروع التلقائي إلى مشروع عادي.

لإنشاء عملية نشر تتضمّن إصدارًا، اتّبِع الخطوات التالية:

1. افتح مشروع Apps Script. <<../_common/snippets/create-new-deployment.md>>

يمكن مشاركة كل عملية نشر جديدة كمكتبة. إذا شاركت النص البرمجي كمكتبة، سيظهر وصف عملية النشر لمستخدمي المكتبة.

عرض عمليات النشر التي تمّت إضافتها إلى نظام التحكّم بالإصدار

لعرض عمليات نشر مشروع في "برمجة تطبيقات Google"، انقر على نشر > إدارة عمليات النشر في أعلى الصفحة.

للاطّلاع على رمز إصدار معيّن، يُرجى الرجوع إلى مقالة عرض إصدار سابق.

تعديل عملية نشر تتضمّن إصدارات

يمكنك تعديل عملية نشر ذات إصدار لتغيير وصفها أو إصدارها. لتعديل عملية نشر، اتّبِع الخطوات التالية:

1. افتح مشروع Apps Script.
2. انقر على نشر > إدارة عمليات النشر.
3. اختَر عملية النشر النشطة وانقر على تعديل edit.
4. أدخِل التغييرات وانقر على نشر.

لتعديل عملية نشر مؤرشفة، أعِد نشرها ثم اتّبِع الخطوات السابقة.

لنشر تغيير في رمز المشروع، أنشئ إصدارًا جديدًا وعدِّل عملية النشر لاستخدامه. يستخدم النشر تلقائيًا الإصدار الجديد لجميع المستخدمين.

العثور على رقم تعريف عملية نشر

لكل عملية نشر معرّف سلسلة مرتبط بها. للعثور على رقم التعريف هذا، اتّبِع الخطوات التالية:

1. افتح مشروع Apps Script.
2. في أعلى يسار الصفحة، انقر على نشر > إدارة عمليات النشر.
3. اختَر عملية نشر نشطة للعثور على رقم تعريفها.

لا تظهر أرقام تعريف عمليات النشر إلا في عمليات النشر النشطة.

اختبار عملية نشر

تعتمد طريقة اختبار عملية النشر على نوع التطبيق الذي تنشئه.

أرشفة عملية نشر ذات إصدار

لا يمكنك حذف عمليات النشر التي تتضمّن إصدارات. بدلاً من ذلك، يمكنك أرشفة هذه الرسائل.

لأرشفة عملية نشر مُحدَّدة الإصدار، اتّبِع الخطوات التالية:

1. افتح مشروع Apps Script.
2. انقر على نشر > إدارة عمليات النشر.
3. اختَر عملية النشر وانقر على أرشفة عملية النشر archive.

إعادة نشر عملية نشر مؤرشفة

1. افتح مشروع Apps Script.
2. في أعلى يسار الصفحة، انقر على نشر > إدارة عمليات النشر.
3. ضمن الأرشيف، اختَر عملية النشر وانقر على تعديل edit > نشر.