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