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