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