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

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

قبل البدء

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

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

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

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

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

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

  • 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-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) لنظام التشغيل 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 تنبيه.