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

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

قبل البدء

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

الخطوة 1: تفعيل App Distribution Tester API

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

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

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

تتكوّن حزمة App Distribution Android SDK من مكتبتَين:

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

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

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

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

  3. يُرجى تعريف الاعتمادية لحزمة تطوير البرامج (SDK) لنظام التشغيل App Distribution لنظام التشغيل 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-beta14")

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

    Java 

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

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

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

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

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

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

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

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

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

    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.

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

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

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

الاطّلاع على الملاحظات وحذفها في وحدة تحكُّم "Firebase"

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

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

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

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

لتلقي تنبيهات 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" وسجِّل الدخول إليها.

    3. شغِّل Cloud Functions for Firebase باستخدام واجهة سطر أوامر Firebase.

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

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

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