جمع ردود الفعل من المختبرين

يصف هذا الدليل كيفية تمكين التعليقات داخل التطبيق باستخدام Firebase App Distribution Android SDK ، بحيث يمكن للمختبرين إرسال التعليقات (بما في ذلك لقطات الشاشة) مباشرةً في التطبيق.

قبل ان تبدأ

أضف Firebase إلى مشروع Android ، إذا لم تكن قد قمت بذلك بالفعل.

الخطوة 1: تفعيل واجهة برمجة تطبيقات اختبار توزيع التطبيق

  1. افتح Google Cloud Console وحدد مشروع Firebase الخاص بك.

  2. ضمن Firebase App Testers API ، انقر على تمكين .

الخطوة 2: أضف توزيع التطبيق إلى تطبيقك

يتكون تطبيق Android SDK لتوزيع التطبيقات من مكتبتين:

  • firebase-appdistribution-api : مكتبة واجهة برمجة التطبيقات فقط ، والتي يمكنك تضمينها في جميع متغيرات الإنشاء .
  • firebase-appdistribution : تطبيق SDK الكامل (اختياري).

تتيح مكتبة واجهة برمجة التطبيقات (API) فقط للكود الخاص بك إجراء مكالمات إلى SDK. لا يكون للمكالمات أي تأثير إذا لم يكن تطبيق SDK الكامل موجودًا.

  1. قم بتعريف تبعية App Distribution Android SDK في الوحدة النمطية الخاصة بك (على مستوى التطبيق) ملف Gradle (عادةً <project>/<app-module>/build.gradle.kts أو <project>/<app-module>/build.gradle ).

  2. لتجنب تضمين وظيفة التحديث الذاتي لتطبيق SDK الكامل في إصدارات Google Play ، حدد متغيرات الإنشاء ، بما في ذلك أنواع الإنشاء أو نكهات المنتجات التي ستوزعها من خلال توزيع التطبيقات.

  3. قم بتعريف تبعية تطبيق Android SDK لتوزيع التطبيقات في ملف Gradle (على مستوى التطبيق) للوحدة النمطية (عادةً app/build.gradle ). أضف فقط تنفيذ SDK الكامل إلى المتغيرات المخصصة حصريًا لاختبار ما قبل الإصدار:

    Kotlin+KTX

    dependencies {
    // ADD the API-only library to all variants
    implementation("com.google.firebase:firebase-appdistribution-api-ktx:16.0.0-beta10")

    // ADD the full SDK implementation to the "beta" variant only (example)
    betaImplementation("com.google.firebase:firebase-appdistribution:16.0.0-beta10")
}

    Java

    dependencies {
    // ADD the API-only library to all variants
    implementation("com.google.firebase:firebase-appdistribution-api:16.0.0-beta10")

    // ADD the full SDK implementation to the "beta" variant only (example)
    betaImplementation("com.google.firebase:firebase-appdistribution:16.0.0-beta10")
}

الخطوة 3: تكوين التعليقات داخل التطبيق

لجمع التعليقات من المختبرين ، استخدم أحد المشغلات التالية لتمكين المختبرين من بدء التعليقات:

  • مشغل الإخطار المدمج : يمكن أن يعرض تطبيق Android SDK لتوزيع التطبيقات إشعارًا مستمرًا يمكن للمختبِر النقر عليه من أي مكان في التطبيق. استخدم هذا المشغل إذا كنت تريد البدء بسرعة أكبر ولا تحتاج إلى تخصيص كيفية تقديم المختبرين للتعليقات.

  • المشغل المخصص : يمكنك توفير آلية التشغيل الخاصة بك ، مثل النقر على زر أو عنصر قائمة في تطبيقك أو هز الجهاز.

عند استخدام أي من هذه المشغلات وإرسال المختبر ملاحظات ، يقوم Android SDK بتنفيذ الإجراءات التالية:

  1. يلتقط لقطة شاشة للنشاط الحالي للتطبيق.

  2. يجري عمليات فحص للتأكد من أن المُختبِر قد قام بتمكين ميزات اختبار SDK. إذا لم يتم تمكين ميزات الاختبار ، فإن Android SDK يطالب المختبر بتسجيل الدخول إلى App Distribution باستخدام حساب Google الخاص به.

  3. يبدأ نشاطًا بملء الشاشة يسمح للمختبِر بكتابة ملاحظاته وإرسالها.

الخيار 1: مشغل الإعلام

استخدم showFeedbackNotification() لعرض إشعار مستمر أو مستمر على جهاز المختبِر بحيث يمكنهم النقر عليه لبدء التعليقات. عند تكوين الإشعار ، تحتاج إلى تقديم بعض النص الذي سيتم عرضه للمختبِر قبل إرسال التعليقات ، ومستوى مقاطعة للإعلام (يتوافق مع أهمية قناة الإعلام). إذا كنت ترغب في تقديم إشعار إلى المختبرين حول جمع ومعالجة بيانات الملاحظات الخاصة بهم ، يمكنك استخدام النص لتقديم مثل هذا الإشعار.

عند استخدام showFeedbackNotification() وعندما ينتقل التطبيق إلى الخلفية ، يكون الإخطار مخفيًا. إذا كنت تريد إخفاء الإشعار صراحةً ، فاستخدم cancelFeedbackNotification() . نوصي بوضع showFeedbackNotification() في نشاطك الرئيسي onCreate() .

Kotlin+KTX

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        Firebase.appDistribution.showFeedbackNotification(
            // Text providing notice to your testers about collection and
            // processing of their feedback data
            R.string.additionalFormText,
            // The level of interruption for the notification
            InterruptionLevel.HIGH)
    }
}

Java

public class MainActivity extends AppCompatActivity {
    FirebaseAppDistribution firebaseAppDistribution =
        FirebaseAppDistribution.getInstance();
    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        firebaseAppDistribution.showFeedbackNotification(
            // Text providing notice to your testers about collection and
            // processing of their feedback data
            R.string.additionalFormText,
            // The level of interruption for the notification
            InterruptionLevel.HIGH);
    }
}

الخيار 2: مشغل مخصص

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

Kotlin+KTX

Firebase.appDistribution.startFeedback(R.string.feedbackMessage)

Java

FirebaseAppDistribution.getInstance().startFeedback(R.string.feedbackMessage);

الخطوة 4: بناء واختبار التنفيذ الخاص بك

الاختبار المحلي

لاختبار التنفيذ دون الحاجة إلى توزيع التطبيق أولاً ، اتبع الخطوات التالية:

  1. قم بتمكين وضع dev على جهازك المحلي:

    adb shell setprop debug.firebase.appdistro.devmode true

  2. أنشئ تطبيقك كمتغير ما قبل الإصدار يتضمن مكتبات توزيع التطبيقات الكاملة ، واختبر أنه يمكنك تشغيل التعليقات باستخدام الآلية المطبقة في الخطوة 3: تكوين التعليقات داخل التطبيق . لا يتم إرسال التعليقات عندما تكون في وضع التطوير.

  3. بعد الاختبار ، يمكنك تعطيل وضع dev على جهازك:

    adb shell setprop debug.firebase.appdistro.devmode false

الاختبار الشامل

لاختبار قدرة تطبيقك على إرسال التعليقات ، أنشئ تطبيقك كمتغير ما قبل الإصدار يتضمن مكتبات توزيع التطبيقات الكاملة ، واختبر التنفيذ باتباع الخطوات التالية:

  1. قم بتحميل إصدار تطبيق جديد إلى توزيع التطبيقات.

  2. قم بتوزيع إصدار التطبيق على حساب لديك إذن بالوصول إليه.

  3. قم بتنزيل التطبيق من خلال الويب أو تطبيق Android tester الخاص بـ App Distribution.

  4. تشغيل التعليقات باستخدام الآلية المطبقة في الخطوة 3: تكوين التعليقات داخل التطبيق .

  5. تأكد من أنك قمت بتسجيل الدخول بنفس الحساب الذي قمت بتوزيع إصدار التطبيق عليه ، وقم بإرسال الملاحظات.

  6. اعرض تعليقاتك في بطاقة الإصدار الجديد في وحدة تحكم Firebase .

لمعرفة كيفية حل المشكلات الشائعة ، مثل عدم قدرة المختبرين على بدء التعليقات في التطبيق ، راجع تمكين ميزات الاختبار باستخدام SDK .

الخطوة 5: إدارة ملاحظات المُختبِر

بعد قيامك بتمكين المختبرين من إرسال التعليقات ، يمكنك استخدام الأدوات التالية لمراجعة تلك الملاحظات والعمل وفقًا لها:

اعرض التعليقات وحذفها في وحدة تحكم Firebase

يمكنك مراجعة تعليقات المستخدم وحذفها ، بما في ذلك لقطات الشاشة ، عن طريق فتح علامة تبويب ملاحظات المختبِر ضمن إصدار محدد في وحدة تحكم Firebase. يتم تنظيم ملاحظات المستخدم حسب الإصدار حتى تتمكن من تأكيد الإصدار الذي تنطبق عليه الملاحظات.

بعد مراجعة ملاحظات المستخدم ، يمكنك حذف هذه الملاحظات بالنقر فوق الزر حذف التعليقات . تمت إزالة التعليقات المحذوفة من إصدارك.

تلقي تنبيهات البريد الإلكتروني لملاحظات جديدة

للتعرف بشكل استباقي على ملاحظات المُختبِر الجديدة ، يمكنك تلقي تنبيهات عبر البريد الإلكتروني عندما يُرسل المُختبِر ملاحظاته. يتضمن تنبيه البريد الإلكتروني التعليقات المكتوبة التي قدمها المختبِر ورابط إلى أي لقطات شاشة أرسلوها.

لتلقي تنبيهات البريد الإلكتروني لتوزيع التطبيقات عبر هذه الآلية الافتراضية ، يجب أن يكون لديك إذن firebase.projects.update . تتضمن الأدوار التالية هذا الإذن المطلوب افتراضيًا: مشرف Firebase أو مالك المشروع أو محرره .

بشكل افتراضي ، سيتلقى كل عضو في المشروع لديه الأذونات المطلوبة لتلقي تنبيهات البريد الإلكتروني رسالة بريد إلكتروني عند إرسال تقرير ملاحظات جديد. يمكن لأعضاء المشروع بشكل فردي إلغاء الاشتراك في هذه التنبيهات.

لتعطيل تنبيهات البريد الإلكتروني ، راجع تلقي تنبيهات Firebase .

إرسال ملاحظات جديدة إلى أدوات الطرف الثالث

يمكنك أيضًا إرسال تنبيهات توزيع التطبيق إلى قناة الإشعارات المفضلة لفريقك باستخدام وظائف السحابة لـ Firebase. على سبيل المثال ، يمكنك كتابة وظيفة تلتقط حدث تنبيه للتعليقات الجديدة داخل التطبيق وتنشر معلومات التنبيه إلى خدمة جهة خارجية مثل Discord أو Slack أو Jira.

لإعداد إمكانات التنبيه المتقدمة باستخدام وظائف السحابة لـ Firebase ، اتبع الخطوات التالية:

  1. قم بإعداد وظائف السحابة لـ Firebase ، والتي تتضمن المهام التالية:

    1. قم بتنزيل Node.js و npm.

    2. قم بتثبيت Firebase CLI وتسجيل الدخول إليه.

    3. قم بتهيئة وظائف السحابة لـ Firebase باستخدام Firebase CLI.

  2. اكتب ونشر وظيفة تلتقط حدث تنبيه بالتعليقات داخل التطبيق من App Distribution وتعالج حمولة الحدث (على سبيل المثال ، تنشر معلومات التنبيه في رسالة على Discord).

للاطلاع على دالة كمثال توضح لك كيفية إرسال ملاحظات جديدة إلى Jira ، راجع هذا النموذج .

للتعرف على جميع أحداث التنبيه التي يمكنك التقاطها ، راجع الوثائق المرجعية لتنبيهات توزيع التطبيق .