جمع الملاحظات من المختبِرين

يوضّح هذا الدليل كيفية تفعيل ميزة "الملاحظات والآراء داخل التطبيق" باستخدام حزمة تطوير البرامج (SDK) الاختيارية لنظام التشغيل Android Firebase App Distribution، ما يتيح للمختبِرين إرسال الملاحظات والآراء (بما في ذلك لقطات الشاشة) مباشرةً في التطبيق.

قبل البدء

إذا لم يسبق لك ذلك، أضِف Firebase إلى مشروع Android.

الخطوة 1: تفعيل واجهة برمجة التطبيقات App Distribution Tester API

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

  2. ضمن واجهة برمجة التطبيقات Firebase App Testers API، انقر على تفعيل.

الخطوة 2: إضافة App Distribution إلى تطبيقك

تتألف حزمة تطوير البرامج (SDK) لنظام التشغيل Android الخاصة بخدمة App Distribution من مكتبتَين:

  • firebase-appdistribution-api: هي مكتبة تتضمّن واجهة برمجة التطبيقات فقط، ويمكنك تضمينها في جميع أشكال الإصدار.
  • firebase-appdistribution: هي عملية التنفيذ الكاملة لحزمة تطوير البرامج (SDK) (اختيارية).

تتيح مكتبة واجهة برمجة التطبيقات فقط للرمز البرمجي إجراء طلبات إلى حزمة تطوير البرامج (SDK). لن يكون للطلبات أي تأثير إذا لم تكن عملية التنفيذ الكاملة لحزمة تطوير البرامج (SDK) متوفّرة.

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

  2. لتجنُّب تضمين وظيفة التحديث الذاتي لعملية التنفيذ الكاملة لحزمة تطوير البرامج (SDK) في إصدارات Google Play، حدِّد أشكال الإصدار، بما في ذلك أنواع الإصدار أو نُسخ المنتجات التي ستوزّعها من خلال App Distribution.

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

    Kotlin 

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

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

    Java 

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

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

الخطوة 3: ضبط ميزة "الملاحظات والآراء داخل التطبيق"

لجمع الملاحظات والآراء من المختبِرين، استخدِم أحد المشغّلات التالية للسماح للمختبِرين ببدء إرسال الملاحظات والآراء:

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

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

عند استخدام أي من هذَين المشغّلين وإرسال المختبِر للملاحظات والآراء، تنفّذ حزمة تطوير البرامج (SDK) لنظام التشغيل Android الإجراءات التالية:

  1. تأخذ لقطة شاشة للنشاط الحالي في التطبيق.

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

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

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

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

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

Kotlin 

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 

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

Java 

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

الخطوة 4: إنشاء عملية التنفيذ واختبارها

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

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

  1. فعِّل وضع المطوّر على جهازك المحلّي:

    adb shell setprop debug.firebase.appdistro.devmode true

  2. أنشِئ تطبيقك كشكل إصدار قبل الإطلاق يتضمّن مكتبات App Distribution الكاملة، واختبِر ما إذا كان بإمكانك بدء إرسال الملاحظات والآراء باستخدام الآلية التي تم تنفيذها في الخطوة 3: ضبط ميزة "الملاحظات والآراء داخل التطبيق". لا يتم إرسال الملاحظات والآراء في وضع المطوّر.

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

    adb shell setprop debug.firebase.appdistro.devmode false

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

لاختبار ما إذا كان بإمكان تطبيقك إرسال الملاحظات والآراء، أنشِئ تطبيقك كشكل إصدار قبل الإطلاق يتضمّن مكتبات App Distribution الكاملة، واختبِر عملية التنفيذ باتّباع الخطوات التالية:

  1. حمِّل إصدارًا جديدًا من التطبيق إلى App Distribution.

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

  3. نزِّل التطبيق من خلال تطبيق المختبِر على الويب أو Android في App Distribution.

  4. ابدأ إرسال الملاحظات والآراء باستخدام الآلية التي تم تنفيذها في الخطوة 3: ضبط ميزة "الملاحظات والآراء داخل التطبيق".

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

  6. اطّلِع على ملاحظاتك وآرائك في بطاقة الإصدار الجديد في الـ Firebase Console.

للتعرّف على كيفية حلّ المشاكل الشائعة، مثل عدم قدرة المختبِرين على بدء إرسال الملاحظات والآراء في التطبيق، يُرجى الاطّلاع على مقالة تفعيل ميزات الاختبار باستخدام حزمة تطوير البرامج (SDK).

الخطوة 5: إدارة ملاحظات المختبِرين وآرائهم

بعد السماح للمختبِرين بإرسال الملاحظات والآراء، يمكنك استخدام الأدوات التالية لمراجعة هذه الملاحظات والآراء واتّخاذ إجراء بشأنها:

عرض الملاحظات والآراء وحذفها في Firebase Console

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

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

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

للتعرّف بشكلٍ استباقي على ملاحظات المختبِرين وآرائهم الجديدة، يمكنك تلقّي تنبيهات عبر البريد الإلكتروني عندما يرسل المختبِر ملاحظات وآراء. يتضمّن التنبيه عبر البريد الإلكتروني الملاحظات والآراء المكتوبة التي قدّمها المختبِر ورابطًا يؤدي إلى أي لقطات شاشة أرسلها.

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

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

لإيقاف التنبيهات عبر البريد الإلكتروني، يُرجى الاطّلاع على مقالة تلقّي تنبيهات Firebase.

إرسال ملاحظات وآراء جديدة إلى أدوات خارجية

يمكنك أيضًا إرسال تنبيهات App Distribution إلى قناة الإشعارات المفضّلة لفريقك باستخدام Cloud Functions for Firebase. على سبيل المثال، يمكنك كتابة دالة تسجِّل حدث تنبيه للملاحظات والآراء الجديدة داخل التطبيق وتنشر معلومات التنبيه على خدمة خارجية مثل Discord أو Slack أو Jira.

لإعداد إمكانات التنبيه المتقدّمة باستخدام Cloud Functions for Firebase، اتّبِع الخطوات التالية:

  1. إعداد Cloud Functions for Firebase، الذي يتضمّن المهام التالية:

    1. تنزيل Node.js وnpm

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

    3. تهيئة Cloud Functions for Firebase باستخدام Firebase CLI.

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

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

للتعرّف على جميع أحداث التنبيه التي يمكنك تسجيلها، يُرجى الاطّلاع على المستندات المرجعية لتنبيهات App Distributionalerts.