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