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