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