Google is committed to advancing racial equity for Black communities. See how.
ترجمت واجهة Cloud Translation API‏ هذه الصفحة.
Switch to English

خذ لقطات شاشة في اختبارات الأجهزة

يتضمن Firebase Test Lab مكتبة يمكنك استخدامها لالتقاط لقطات شاشة عند إجراء اختبارات الأجهزة ، مثل الاختبارات المكتوبة باستخدام إطار عمل اختبار Espresso . لإضافة هذه الإمكانية إلى اختبارك ، قم بتنزيل مكتبة cloudtestingscreenshotter_lib.aar .

تم دمج القدرة على التقاط لقطات شاشة بالفعل في اختبار APK ، app-debug-test-unaligned.apk ، لتطبيق نموذج NotePad ، كما يتم التقاط لقطات شاشة عند تشغيل اختبار Robo . تخبرك الإرشادات التالية بكيفية إضافة مكتبة لقطات الشاشة إلى تطبيقك وكيفية استدعاء هذه المكتبة من الاختبار.

بعد تشغيل الاختبار ، يمكنك مراجعة لقطات الشاشة في Android Studio أو في وحدة تحكم Firebase.

أضف مكتبة لقطات الشاشة إلى مشروعك

  1. في Android Studio ، افتح طريقة عرض Project وانقر بزر الماوس الأيمن فوق اسم المشروع الخاص بك. ثم انقر فوق جديد > دليل .

  2. في مربع حوار الدليل الجديد ، اكتب aars . يؤدي هذا إلى إنشاء دليل aars في جذر مشروع الاختبار الخاص بك (كدليل نظير لمجلد التطبيق ).

  3. انسخ cloudtestingscreenshotter_lib.aar والصقها في مجلد aars .

  4. في ملف build.gradle على مستوى الجذر (مستوى المشروع) build.gradle ، أضف مرجعًا إلى مجلد aars في كل كتلة repositories :

    repositories {
        jcenter()
        flatDir {
            dirs '../aars'
        }
    }
    ...
  5. في دليل المستوى الأعلى للوحدة (بالنسبة لتطبيق مثال build.gradle ، هذا هو دليل التطبيق ) ، افتح ملف build.gradle وأضف تبعية إلى cloudtestingscreenshotter_lib.aar إلى كتلة dependencies ذات المستوى الأعلى:

    dependencies {
        // Cloud testing
        androidTestCompile (name:'cloudtestingscreenshotter_lib', ext:'aar')
        // Other dependencies go here
        }
    
  6. في ملف AndroidManifest.xml الخاص بك ، حدد أذونات النظام لتطبيقك عن طريق إضافة الأسطر التالية داخل علامة <manifest> . إذا كنت تختبر على Android 10 (مستوى API 29) أو أعلى ، WRITE_EXTERNAL_STORAGE بحذف إذن WRITE_EXTERNAL_STORAGE (لا يتطلب تطبيقك هذا الإذن لقراءة لقطات الشاشة وكتابتها على الجهاز).

    <manifest ... >
       <!-- WRITE_EXTERNAL_STORAGE is not needed on Android 10 (API level 29) or higher. -->
       <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
       <uses-permission android:name="android.permission.INTERNET"/>
       ...
    </manifest>
    

خذ لقطة شاشة من اختبارك

في أي مرحلة من الاختبار حيث تريد التقاط لقطة شاشة ، اتصل بطريقة ScreenShotter.takeScreenshot من مكتبة cloudtestingscreenshotter_lib ، حيث تكون الوسيطة الأولى عبارة عن تسمية تستخدمها لتحديد لقطة الشاشة (يتم استخدام main_screen_2 في المثال التالي):

جافا

ScreenShotter.takeScreenshot("main_screen_2", this /* activity */);

Kotlin + KTX

ScreenShotter.takeScreenshot("main_screen_2", this /* activity */)

عرض لقطات

بعد اكتمال الاختبار ، يمكنك مقارنة أي لقطات شاشة تم التقاطها أثناء الاختبار عن طريق تحديد عنصر في شجرة نتائج الاختبار ثم النقر فوق عرض لقطات الشاشةمشاهدة لقطات اختيار.

Screenshot comparison screen

يمكنك تحديد ومقارنة لقطات الشاشة من تكوينات مختلفة على النحو التالي:

مهمة عمل
التبديل بين عمليات تنفيذ الاختبار. استخدم القائمة المنسدلة في الزاوية العلوية اليسرى.

قائمة حالة الاختبار
التبديل بين لقطات الشاشة في تنفيذ الاختبار. استخدم الأسهم في الزاوية العلوية اليمنى.

أداة تبديل لقطة الشاشة
أضف لوحات مقارنة لقطة شاشة إضافية إلى العرض الحالي. انقر فوق قارن .

قارن
اختر بُعدًا مختلفًا للاختبار (نوع الجهاز ، والاتجاه ، واللغة ، وما إلى ذلك). حدد عضو بُعد جديدًا من القائمة الموجودة أسفل لقطة الشاشة.

الخطوة التالية

قم بتنزيل تطبيق نموذج NotePad .