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