جمع التعليقات من المختبرين ، وجمع التعليقات من المختبرين

يصف هذا الدليل كيفية تمكين التعليقات داخل التطبيق باستخدام Firebase App Distribution Android SDK الاختياري، حتى يتمكن المختبرون لديك من إرسال التعليقات (بما في ذلك لقطات الشاشة) مباشرة في التطبيق.

قبل ان تبدأ

إذا لم تكن قد قمت بذلك بالفعل، فأضف Firebase إلى مشروع Android الخاص بك .

الخطوة 1: تمكين واجهة برمجة تطبيقات اختبار توزيع التطبيقات

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

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

الخطوة 2: أضف توزيع التطبيق إلى تطبيقك

يتكون App Distribution Android SDK من مكتبتين:

  • firebase-appdistribution-api : مكتبة API فقط، والتي يمكنك تضمينها في جميع متغيرات البناء .
  • firebase-appdistribution : تطبيق SDK الكامل (اختياري).

تتيح مكتبة API فقط للتعليمات البرمجية الخاصة بك إجراء مكالمات إلى SDK. لن يكون للاستدعاءات أي تأثير في حالة عدم وجود تطبيق SDK الكامل.

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

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

  3. قم بتعريف تبعية App Distribution Android SDK في ملف 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-beta12")
    
        // ADD the full SDK implementation to the "beta" variant only (example)
        betaImplementation("com.google.firebase:firebase-appdistribution:16.0.0-beta12")
    }
    

    Java

    dependencies {
        // ADD the API-only library to all variants
        implementation("com.google.firebase:firebase-appdistribution-api:16.0.0-beta12")
    
        // ADD the full SDK implementation to the "beta" variant only (example)
        betaImplementation("com.google.firebase:firebase-appdistribution:16.0.0-beta12")
    }
    

الخطوة 3: تكوين التعليقات داخل التطبيق

لجمع التعليقات من المختبرين لديك، استخدم أحد المشغلات التالية لتمكين المختبرين من بدء التعليقات:

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

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

عندما تستخدم أيًا من هذه المشغلات ويقوم المختبر بإرسال التعليقات، يقوم Android SDK بتنفيذ الإجراءات التالية:

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

  2. يقوم بإجراء عمليات التحقق للتأكد من قيام المختبر بتمكين ميزات اختبار SDK. إذا لم يتم تمكين ميزات الاختبار، فإن Android SDK يطالب المختبر بتسجيل الدخول إلى 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. أنشئ تطبيقك كمتغير للإصدار التجريبي يتضمن مكتبات توزيع التطبيقات الكاملة، واختبر أنه يمكنك تشغيل التعليقات باستخدام الآلية المطبقة في الخطوة 3: تكوين التعليقات داخل التطبيق . لا يتم إرسال التعليقات عندما تكون في وضع التطوير.

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

    adb shell setprop debug.firebase.appdistro.devmode false
    

اختبار نهاية إلى نهاية

لاختبار قدرة تطبيقك على إرسال تعليقات، أنشئ تطبيقك كمتغير ما قبل النشر الذي يتضمن مكتبات توزيع التطبيقات الكاملة، واختبر التنفيذ باتباع الخطوات التالية:

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

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

  3. قم بتنزيل التطبيق من خلال تطبيق الويب الخاص بتوزيع التطبيقات أو تطبيق اختبار Android.

  4. قم بتشغيل التعليقات باستخدام الآلية الموضحة في الخطوة 3: تكوين التعليقات داخل التطبيق .

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

  6. اعرض تعليقاتك في بطاقة الإصدار الجديد في وحدة تحكم Firebase .

لمعرفة كيفية حل المشكلات الشائعة، مثل عدم قدرة المختبرين على بدء تقديم الملاحظات في التطبيق، راجع تمكين ميزات الاختبار باستخدام SDK .

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

بعد تمكين المختبرين لديك من إرسال التعليقات، يمكنك استخدام الأدوات التالية لمراجعة هذه التعليقات والتصرف بناءً عليها:

عرض وحذف التعليقات في وحدة تحكم Firebase

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

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

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

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

لتلقي تنبيهات البريد الإلكتروني الخاصة بتوزيع التطبيقات عبر هذه الآلية الافتراضية، يجب أن يكون لديك إذن firebase.projects.update . تتضمن الأدوار التالية هذا الإذن المطلوب افتراضيًا: مسؤول Firebase أو مالك المشروع أو المحرر .

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

لتعطيل تنبيهات البريد الإلكتروني، راجع تلقي تنبيهات Firebase .

إرسال تعليقات جديدة إلى أدوات الطرف الثالث

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

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

  1. قم بإعداد Cloud Functions لـ Firebase ، والتي تتضمن المهام التالية:

    1. قم بتنزيل Node.js وnpm.

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

    3. تهيئة الوظائف السحابية لـ Firebase باستخدام Firebase CLI.

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

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

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