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