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

يوضّح هذا الدليل كيفية تفعيل ميزة "ملاحظات وآراء" داخل التطبيق باستخدام 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 إشعارًا مستمرًا بأن يمكن للمختبِر النقر من أي مكان في التطبيق. استخدِم هذا المشغّل إذا كنت تريد في البدء بسرعة أكبر بدون الحاجة إلى تخصيص طريقة استخدام المختبِرين ويقدمون ملاحظاتهم.

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

عند استخدام أيّ من هذين المشغّلين وإرسال المختبِر ملاحظاته، تنفِّذ IDE لنظام التشغيل 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. نزِّل التطبيق من خلال موقع "App Distribution" الإلكتروني أو تطبيق "مختبِر Android".

  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 تنبيه.