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