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