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

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

قبل البدء

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

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

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

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

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

تتألف حزمة تطوير برامج Android لتوزيع التطبيقات من مكتبتَين:

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

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

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

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

  3. يُرجى توضيح التبعية لحزمة تطوير البرامج (SDK) الخاصة بميزة "توزيع التطبيقات" في Android في ملف 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-beta13")

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

    Java 

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

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

الخطوة 3: ضبط الملاحظات داخل التطبيق

لجمع الملاحظات من المختبِرين، يمكنك استخدام أحد عاملَي التفعيل التاليَين من أجل: لتمكين المختبرين من بدء الملاحظات:

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

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

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

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

  2. تُجري عمليات تحقّق للتأكّد من أنّ المختبِر قد فعّل ميزات اختبار حزمة تطوير البرامج (SDK). إذا كانت ميزات الاختبار غير مُفعَّلة، تطلب حزمة تطوير البرامج (SDK) لنظام التشغيل Android من المختبِر التوقيع التطبيق من خلال حسابهم على 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. تفعيل وضع مطور البرامج على جهازك المحلي:

    adb shell setprop debug.firebase.appdistro.devmode true

  2. إنشاء تطبيقك على شكل نسخة تجريبية تتضمّن ميزة "توزيع التطبيقات" الكاملة واختبر إمكانية إرسال ملاحظات باستخدام الآلية تم التنفيذ في الخطوة 3: ضبط الملاحظات داخل التطبيق الملاحظات هي لم يتم إرساله عندما يكون في وضع مطور البرامج.

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

    adb shell setprop debug.firebase.appdistro.devmode false

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

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

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

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

  3. يمكنك تنزيل التطبيق من خلال الويب أو التطبيق المخصّص لاختبار Android من 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 وسجِّل الدخول إليها.

    3. إعداد وظائف السحابة الإلكترونية لبرنامج Firebase باستخدام واجهة سطر الأوامر في Firebase

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

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

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