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

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

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

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

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

النشر الرئيسي هو رمز المشروع الحالي. عند إنشاء مشروع Apps Script، يتم تلقائيًا إنشاء عملية نشر رئيسية لهذا المشروع.

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

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

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

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

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

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

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

لنشر إصدار من إضافة Google Workspace أو إضافة المحرِّر أو تطبيق Google Chat أو ملف تنفيذي لواجهة برمجة التطبيقات، يجب أولاً تبديل ربط مشروع Google Cloud في Apps Script من المشروع التلقائي إلى مشروع عادي.

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

1. افتح مشروع Apps Script.
2. في أعلى يسار الصفحة، انقر على نشر > نشر جديد.
3. بجانب اختيار النوع، انقر على رمز تفعيل أنواع عمليات النشر settings.
4. اختَر نوع النشر الذي تريده. بالنسبة إلى إضافات Google Workspace وإضافات "محرّر Google" و تطبيقات Google Chat، اختَر إضافة.

5. أدخِل معلومات حول عملية النشر وانقر على نشر.

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

للاطّلاع على عمليات نشر مشروع "برمجة تطبيقات 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 > نشر.