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