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