این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

با تست های Game Loop شروع کنید

زمانی که برنامه‌های بازی بر روی چارچوب‌های مختلف رابط کاربری ساخته می‌شوند، آزمایش خودکار بازی دشوار است. تست‌های حلقه بازی به شما این امکان را می‌دهند که تست‌های بومی خود را با Test Lab ادغام کنید و به راحتی آنها را روی دستگاه‌هایی که انتخاب می‌کنید اجرا کنید. تست Game Loop تست شما را از طریق برنامه بازی شما انجام می دهد و در عین حال اقدامات یک بازیکن واقعی را شبیه سازی می کند. این راهنما به شما نشان می دهد که چگونه یک تست Game Loop را اجرا کنید، سپس نتایج آزمایش خود را در کنسول Firebase مشاهده و مدیریت کنید.

بسته به موتور بازی خود، می توانید تست ها را با حلقه های تک یا چندگانه اجرا کنید. یک حلقه آزمایش کامل یا جزئی از آزمایش شما در برنامه بازی شما است. از حلقه های بازی می توان برای موارد زیر استفاده کرد:

یک سطح از بازی خود را به همان شیوه ای که کاربر نهایی آن را بازی می کند اجرا کنید. می‌توانید ورودی کاربر را اسکریپت کنید، اجازه دهید کاربر بی‌حرکت باشد، یا اگر در بازی شما منطقی است، کاربر را با یک هوش مصنوعی جایگزین کنید (مثلاً، بگویید که یک برنامه بازی ماشین مسابقه دارید و قبلاً یک هوش مصنوعی پیاده‌سازی کرده‌اید. می‌توانید به راحتی یک درایور هوش مصنوعی را مسئول ورودی کاربر قرار دهید).
بازی خود را با بالاترین کیفیت اجرا کنید تا ببینید آیا دستگاه‌ها از آن پشتیبانی می‌کنند یا خیر.
یک تست فنی را اجرا کنید (چند سایه زن را کامپایل کنید، آنها را اجرا کنید، بررسی کنید که خروجی مطابق انتظار است و غیره).

می‌توانید آزمایش حلقه بازی را روی یک دستگاه آزمایشی، مجموعه‌ای از دستگاه‌های آزمایشی یا در Test Lab اجرا کنید. با این حال، اجرای تست های Game Loop را در دستگاه های مجازی توصیه نمی کنیم زیرا نرخ فریم گرافیکی آنها نسبت به دستگاه های فیزیکی کمتر است.

قبل از شروع

برای اجرای یک تست، ابتدا باید اپلیکیشن خود را برای تست های Game Loop پیکربندی کنید.

در مانیفست برنامه خود، یک فیلتر قصد جدید به فعالیت خود اضافه کنید:
```
<activity android:name=".MyActivity">
   <intent-filter>
       <action android:name="com.google.intent.action.TEST_LOOP"/>
       <category android:name="android.intent.category.DEFAULT"/>
       <data android:mimeType="application/javascript"/>
   </intent-filter>
   <intent-filter>
      ... (other intent filters here)
   </intent-filter>
</activity>
```
این به Test Lab اجازه می دهد تا بازی شما را با راه اندازی آن با یک هدف خاص راه اندازی کند.
توجه: حلقه های بازی به یک فیلتر هدف جداگانه و اختصاصی نیاز دارند که برای اهداف دیگر استفاده نمی شود. فعالیت شما می‌تواند شامل فیلترهای هدف دیگری نیز باشد. برای کسب اطلاعات بیشتر در مورد فیلترهای هدف، به صفحه مرجع <intent-filter> مراجعه کنید.

در کد خود (توصیه می کنیم در بیانیه متد onCreate )، موارد زیر را اضافه کنید:

Kotlin+KTX

val launchIntent = intent
if (launchIntent.action == "com.google.intent.action.TEST_LOOP") {
    val scenario = launchIntent.getIntExtra("scenario", 0)
    // Code to handle your game loop here
}MainActivity.kt

Java

Intent launchIntent = getIntent();
if(launchIntent.getAction().equals("com.google.intent.action.TEST_LOOP")) {
    int scenario = launchIntent.getIntExtra("scenario", 0);
    // Code to handle your game loop here
}MainActivity.java

این به فعالیت شما اجازه می دهد تا هدفی را که آن را راه اندازی می کند بررسی کند. در صورت تمایل می‌توانید این کد را بعداً اضافه کنید (به عنوان مثال، پس از بارگذاری اولیه موتور بازی خود).

توصیه می شود: در پایان آزمون، اضافه کنید:
Kotlin+KTX
```
yourActivity.finish()MainActivity.kt
```
Java
```
yourActivity.finish();MainActivity.java
```
هنگامی که تست حلقه بازی کامل شد، برنامه شما را می‌بندد. آزمایش برای شروع حلقه بعدی به چارچوب رابط کاربری برنامه شما متکی است و بستن برنامه به آن می گوید که آزمایش به پایان رسیده است.

یک تست Game Loop ایجاد و اجرا کنید

بعد از اینکه برنامه خود را برای تست های Game Loop پیکربندی کردید، می توانید بلافاصله یک آزمایش ایجاد کنید و آن را در برنامه بازی خود اجرا کنید. می‌توانید آزمایشی را در Test Lab با استفاده از کنسول Firebase یا رابط خط فرمان gcloud (CLI) یا روی یک دستگاه محلی با استفاده از Test Loop Manager اجرا کنید.

روی یک دستگاه محلی اجرا کنید

Test Loop Manager Test Lab یک برنامه منبع باز است که به شما کمک می کند تست های Game Loop را ادغام کنید و آنها را در دستگاه های محلی خود اجرا کنید. همچنین به تیم تضمین کیفیت شما اجازه می‌دهد تا حلقه‌های بازی مشابهی را روی دستگاه‌های خود اجرا کند.

برای اجرای یک آزمایش بر روی یک دستگاه محلی با استفاده از Test Loop Manager:

Test Loop Manager را در تلفن یا رایانه لوحی دانلود کرده و با اجرای:
```
adb install testloopmanager.apk
```
در دستگاه خود، برنامه Test Loop Apps را در تلفن یا رایانه لوحی خود باز کنید. این برنامه لیستی از برنامه های موجود در دستگاه شما را نشان می دهد که می توانند با حلقه های بازی اجرا شوند. اگر برنامه بازی خود را در اینجا نمی‌بینید، مطمئن شوید که فیلتر قصد شما با فیلتری که در مرحله اول بخش قبل از شروع توضیح داده شد مطابقت دارد.
برنامه بازی خود را انتخاب کنید، سپس تعداد حلقه هایی را که می خواهید اجرا کنید انتخاب کنید. توجه: در این مرحله می‌توانید به جای یک حلقه، زیرمجموعه‌ای از حلقه‌ها را اجرا کنید. برای اطلاعات بیشتر در مورد اجرای چندین حلقه به طور همزمان، ویژگی های اختیاری را ببینید.
روی Run test کلیک کنید. تست شما بلافاصله شروع به اجرا می کند.

در Test Lab اجرا کنید

می‌توانید با استفاده از کنسول Firebase یا gcloud CLI یک تست Game Loop را در Test Lab اجرا کنید . قبل از شروع، اگر قبلاً این کار را نکرده اید، کنسول Firebase را باز کنید و یک پروژه ایجاد کنید.

از کنسول Firebase استفاده کنید

در کنسول Firebase ، روی Test Lab از پانل سمت چپ کلیک کنید.
روی Run Your First Test (یا اجرای تست اگر پروژه شما قبلاً آزمایشی انجام داده است) کلیک کنید.
Game Loop را به عنوان نوع تست انتخاب کنید و سپس روی Continue کلیک کنید.
روی Browse کلیک کنید و سپس فایل .apk . برنامه خود را مرور کنید. توجه: در این مرحله می‌توانید به جای یک حلقه، زیرمجموعه‌ای از حلقه‌ها را اجرا کنید. برای اطلاعات بیشتر در مورد اجرای چندین حلقه به طور همزمان، ویژگی های اختیاری را ببینید.
روی Continue کلیک کنید.
دستگاه های فیزیکی را برای آزمایش برنامه خود انتخاب کنید.
روی Start Tests کلیک کنید.

برای اطلاعات بیشتر درباره شروع کار با کنسول Firebase ، به شروع آزمایش با کنسول Firebase مراجعه کنید.

از خط فرمان gcloud (CLI) استفاده کنید

اگر قبلاً این کار را نکرده‌اید، Google Cloud SDK را دانلود و نصب کنید
با استفاده از حساب Google خود به gcloud CLI وارد شوید:
gcloud auth login
پروژه Firebase خود را در gcloud تنظیم کنید، جایی که PROJECT_ID شناسه پروژه Firebase شما است:
```
gcloud config set project PROJECT_ID
```
اولین تست خود را اجرا کنید:
```
gcloud firebase test android run \
 --type=game-loop --app=<var>path-to-apk</var> \
 --device model=herolte,version=23
```
توجه: در این مرحله می‌توانید به جای یک حلقه، زیرمجموعه‌ای از حلقه‌ها را اجرا کنید. برای اطلاعات بیشتر در مورد اجرای چندین حلقه به طور همزمان، ویژگی های اختیاری را ببینید.

برای اطلاعات بیشتر در مورد شروع کار با gcloud CLI، به شروع آزمایش از خط فرمان gcloud مراجعه کنید.

ویژگی های اختیاری

Test Lab چندین ویژگی اختیاری را ارائه می دهد که به شما امکان می دهد تست های خود را بیشتر سفارشی کنید، از جمله توانایی نوشتن داده های خروجی، پشتیبانی از حلقه های بازی چندگانه و برچسب برای حلقه های مرتبط.

داده های خروجی را بنویسید

تست Game Loop شما می تواند خروجی را روی فایلی که در متد launchIntent.getData() مشخص شده است بنویسد. پس از اجرای یک آزمایش، می‌توانید به این داده‌های خروجی در بخش Test Lab کنسول Firebase دسترسی داشته باشید ( به مثال فایل خروجی تست حلقه بازی مراجعه کنید).

Test Lab بهترین روش‌ها را برای اشتراک‌گذاری یک فایل بین برنامه‌های شرح داده شده در اشتراک‌گذاری فایل دنبال می‌کند. در متد onCreate() اکتیویتی خود، جایی که قصد شما قرار دارد، می توانید فایل خروجی داده خود را با اجرای کد زیر بررسی کنید:

Kotlin+KTX

val launchIntent = intent
val logFile = launchIntent.data
logFile?.let {
    Log.i(TAG, "Log file ${it.encodedPath}")
    // ...
}MainActivity.kt

Java

Intent launchIntent = getIntent();
Uri logFile = launchIntent.getData();
if (logFile != null) {
    Log.i(TAG, "Log file " + logFile.getEncodedPath());
    // ...
}MainActivity.java

اگر می‌خواهید از سمت C++ برنامه بازی خود روی فایل بنویسید، می‌توانید به جای مسیر فایل، توصیفگر فایل را ارسال کنید:

Kotlin+KTX

val launchIntent = intent
val logFile = launchIntent.data
var fd = -1
logFile?.let {
    Log.i(TAG, "Log file ${it.encodedPath}")
    fd = try {
        contentResolver
            .openAssetFileDescriptor(logFile, "w")!!
            .parcelFileDescriptor
            .fd
    } catch (e: FileNotFoundException) {
        e.printStackTrace()
        -1
    } catch (e: NullPointerException) {
        e.printStackTrace()
        -1
    }
}

// C++ code invoked here.
// native_function(fd);MainActivity.kt

Java

Intent launchIntent = getIntent();
Uri logFile = launchIntent.getData();
int fd = -1;
if (logFile != null) {
    Log.i(TAG, "Log file " + logFile.getEncodedPath());
    try {
        fd = getContentResolver()
                .openAssetFileDescriptor(logFile, "w")
                .getParcelFileDescriptor()
                .getFd();
    } catch (FileNotFoundException e) {
        e.printStackTrace();
        fd = -1;
    } catch (NullPointerException e) {
        e.printStackTrace();
        fd = -1;
    }
}

// C++ code invoked here.
// native_function(fd);MainActivity.java

C++

#include <unistd.h>
JNIEXPORT void JNICALL
Java_my_package_name_MyActivity_native_function(JNIEnv *env, jclass type, jint log_file_descriptor) {
// The file descriptor needs to be duplicated.
int my_file_descriptor = dup(log_file_descriptor);
}

نمونه فایل خروجی

می‌توانید از فایل‌های داده‌های خروجی (مانند نمونه زیر قالب‌بندی شده) برای نمایش نتایج تست حلقه بازی در بخش Test Lab کنسول Firebase استفاده کنید. مناطقی که به صورت /.../ نشان داده شده اند می توانند حاوی هر فیلد سفارشی مورد نیاز شما باشند، به شرطی که با نام فیلدهای دیگر استفاده شده در این فایل مغایرت نداشته باشند:

{
  "name": "test name",
  "start_timestamp": 0, // Timestamp of the test start (in us).
                           Can be absolute or relative
  "driver_info": "...",
  "frame_stats": [
    {
      "timestamp": 1200000, // Timestamp at which this section was written
                               It contains value regarding the period
                               start_timestamp(0) -> this timestamp (1200000 us)
      "avg_frame_time": 15320, // Average time to render a frame in ns
      "nb_swap": 52, // Number of frame rendered
      "threads": [
        {
          "name": "physics",
          "Avg_time": 8030 // Average time spent in this thread per frame in us
        },
        {
          "name": "AI",
          "Avg_time": 2030 // Average time spent in this thread per frame in us
        }
      ],
      /.../ // Any custom field you want (vertices display on the screen, nb units …)
    },
    {
      // Next frame data here, same format as above
    }
  ],
  "loading_stats": [
    {
      "name": "assets_level_1",
      "total_time": 7850, // in us
      /.../
    },
    {
      "name": "victory_screen",
      "total_time": 554, // in us
      /.../
    }

  ],
  /.../, // You can add custom fields here
}

حلقه های بازی چندگانه

ممکن است برای شما مفید باشد که چندین حلقه بازی را در برنامه خود اجرا کنید. یک حلقه یک اجرای کامل برنامه بازی شما از ابتدا تا انتها است. به عنوان مثال، اگر چندین سطح در بازی خود دارید، ممکن است بخواهید یک حلقه بازی برای راه اندازی هر سطح به جای داشتن یک حلقه که در همه آنها تکرار می شود، داشته باشید. به این ترتیب، اگر برنامه شما در سطح 32 خراب شد، می توانید مستقیماً آن حلقه بازی را برای بازتولید خرابی و آزمایش رفع اشکال راه اندازی کنید.

برای فعال کردن برنامه خود برای اجرای چندین حلقه به طور همزمان:

اگر آزمایشی را با Test Loop Manager اجرا می کنید:
1. در داخل عنصر <application> خط زیر را به مانیفست برنامه خود اضافه کنید:
```
<meta-data
  android:name="com.google.test.loops"
  android:value="5" />
```
  این هدف راه اندازی شامل حلقه هدف به عنوان یک پارامتر عدد صحیح است. در قسمت android:value می توانید یک عدد صحیح از 1 تا 1024 (حداکثر تعداد حلقه های مجاز برای یک تست) را مشخص کنید. توجه داشته باشید که حلقه ها از 1 و نه 0 شروع می شوند.
2. در برنامه Test Loop Manager، یک صفحه انتخاب ظاهر می شود که به شما امکان می دهد حلقه(هایی) را که می خواهید اجرا کنید انتخاب کنید. اگر چندین حلقه را انتخاب کنید، هر حلقه به ترتیب پس از تکمیل حلقه قبلی راه اندازی می شود.
اگر آزمایشی را با کنسول Firebase انجام می دهید، یک لیست یا محدوده ای از اعداد حلقه را در قسمت سناریوها وارد کنید.
اگر آزمایشی را با gcloud CLI انجام می‌دهید، فهرستی از اعداد حلقه را با استفاده از پرچم --scenario-numbers مشخص کنید. به عنوان مثال، --scenario-numbers=1,3,5 حلقه های 1، 3 و 5 را اجرا می کند.
اگر در حال نوشتن C++ هستید و می خواهید رفتار حلقه خود را تغییر دهید، موارد اضافی زیر را به کد اصلی C++ خود منتقل کنید:
Kotlin+KTX
```
val launchIntent = intent
val scenario = launchIntent.getIntExtra("scenario", 0)MainActivity.kt
```
Java
```
Intent launchIntent = getIntent();
int scenario = launchIntent.getIntExtra("scenario", 0);MainActivity.java
```
اکنون می توانید رفتار حلقه خود را بر اساس مقدار int به دست آمده تغییر دهید.

حلقه های بازی را برچسب بزنید

هنگامی که حلقه‌های بازی خود را با یک یا چند برچسب سناریو برچسب‌گذاری می‌کنید، شما و تیم QA خود می‌توانید به راحتی مجموعه‌ای از حلقه‌های بازی مرتبط را راه‌اندازی کنید (به عنوان مثال، "همه حلقه‌های بازی سازگاری") و آنها را در یک ماتریس آزمایش کنید. می توانید برچسب های خود را ایجاد کنید یا از برچسب های از پیش تعریف شده ارائه شده توسط Test Lab استفاده کنید:

com.google.test.loops.player_experience : برای حلقه هایی که برای بازتولید تجربه واقعی کاربر در هنگام بازی استفاده می شود. هدف از آزمایش با این حلقه‌ها یافتن مشکلاتی است که یک کاربر واقعی در حین انجام بازی با آن مواجه می‌شود.
com.google.test.loops.gpu_compatibility : برای حلقه هایی که برای آزمایش مسائل مربوط به GPU استفاده می شوند. هدف از آزمایش با این حلقه‌ها اجرای کدهای GPU است که ممکن است به درستی در تولید اجرا نشود، تا مشکلات سخت‌افزار و درایورها را آشکار کند.
com.google.test.loops.compatibility : برای حلقه هایی که برای آزمایش طیف وسیعی از مشکلات سازگاری، از جمله مشکلات I/O و مسائل OpenSSL استفاده می شود.
com.google.test.loops.performance : برای حلقه هایی که برای آزمایش عملکرد دستگاه استفاده می شوند. برای مثال، یک بازی ممکن است در پیچیده ترین تنظیمات گرافیکی اجرا شود تا ببیند یک دستگاه جدید چگونه رفتار می کند.

برای فعال کردن برنامه خود برای اجرای حلقه هایی با همان برچسب:

اگر آزمایشی را با Test Loop Manager اجرا می کنید:
1. در مانیفست برنامه خود، خط فراداده زیر را اضافه کنید و LABEL_NAME با یک برچسب انتخابی جایگزین کنید:
```
<meta-data
 android:name="com.google.test.loops.LABEL_NAME"
 android:value="1,3-5" />
```
  در قسمت android:value ، می‌توانید محدوده یا مجموعه‌ای از اعداد صحیح از 1 تا 1024 (حداکثر تعداد حلقه‌های مجاز برای یک تست) را مشخص کنید که نشان‌دهنده حلقه‌هایی است که می‌خواهید برچسب‌گذاری کنید. توجه داشته باشید که حلقه ها از 1 شروع می شوند نه 0. برای مثال، android:value="1,3-5" LABEL_NAME برای حلقه های 1، 3، 4، و 5 اعمال می کند.
2. در برنامه Test Loop Manager، یک یا چند برچسب را در قسمت Labels وارد کنید.
اگر آزمایشی را با کنسول Firebase انجام می‌دهید، یک یا چند برچسب را در قسمت Labels وارد کنید.
اگر آزمایشی را با gcloud CLI انجام می‌دهید، یک یا چند برچسب سناریو را با استفاده از پرچم --scenario-labels (مثلا --scenario-labels=performance,gpu ) مشخص کنید.

پشتیبانی از مجوز برنامه

Test Lab از برنامه هایی پشتیبانی می کند که از سرویس مجوز برنامه ارائه شده توسط Google Play استفاده می کنند. برای بررسی موفقیت آمیز مجوز هنگام آزمایش برنامه خود با Test Lab ، باید برنامه خود را در کانال تولید در فروشگاه Play منتشر کنید. برای آزمایش برنامه خود در کانال آلفا یا بتا با استفاده از Test Lab ، قبل از آپلود برنامه خود در Test Lab ، بررسی مجوز را بردارید.

مسائل شناخته شده

تست های حلقه بازی در Test Lab دارای مشکلات شناخته شده زیر هستند:

برخی از خرابی ها از backtraces پشتیبانی نمی کنند. برای مثال، برخی از نسخه‌های انتشار ممکن است خروجی فرآیند debuggerd با استفاده از prctl(PR_SET_DUMPABLE, 0) سرکوب کنند. برای کسب اطلاعات بیشتر، debuggerd ببینید.
API Level 19 به دلیل خطاهای مجوز فایل در حال حاضر پشتیبانی نمی شود.

یک سطح از بازی خود را به همان شیوه ای که کاربر نهایی آن را بازی می کند اجرا کنید. می‌توانید ورودی کاربر را اسکریپت کنید، اجازه دهید کاربر بی‌حرکت باشد، یا اگر در بازی شما منطقی است، کاربر را با یک هوش مصنوعی جایگزین کنید (مثلاً، بگویید که یک برنامه بازی ماشین مسابقه دارید و قبلاً یک هوش مصنوعی پیاده‌سازی کرده‌اید. می‌توانید به راحتی یک درایور هوش مصنوعی را مسئول ورودی کاربر قرار دهید).
بازی خود را با بالاترین کیفیت اجرا کنید تا ببینید آیا دستگاه‌ها از آن پشتیبانی می‌کنند یا خیر.
یک تست فنی را اجرا کنید (چند سایه زن را کامپایل کنید، آنها را اجرا کنید، بررسی کنید که خروجی مطابق انتظار است و غیره).

قبل از شروع

برای اجرای یک تست، ابتدا باید اپلیکیشن خود را برای تست های Game Loop پیکربندی کنید.

در مانیفست برنامه خود، یک فیلتر قصد جدید به فعالیت خود اضافه کنید:
```
<activity android:name=".MyActivity">
   <intent-filter>
       <action android:name="com.google.intent.action.TEST_LOOP"/>
       <category android:name="android.intent.category.DEFAULT"/>
       <data android:mimeType="application/javascript"/>
   </intent-filter>
   <intent-filter>
      ... (other intent filters here)
   </intent-filter>
</activity>
```
این به Test Lab اجازه می دهد تا بازی شما را با راه اندازی آن با یک هدف خاص راه اندازی کند.
توجه: حلقه های بازی به یک فیلتر هدف جداگانه و اختصاصی نیاز دارند که برای اهداف دیگر استفاده نمی شود. فعالیت شما می‌تواند شامل فیلترهای هدف دیگری نیز باشد. برای کسب اطلاعات بیشتر در مورد فیلترهای هدف، به صفحه مرجع <intent-filter> مراجعه کنید.

در کد خود (توصیه می کنیم در بیانیه متد onCreate )، موارد زیر را اضافه کنید:

Kotlin+KTX

val launchIntent = intent
if (launchIntent.action == "com.google.intent.action.TEST_LOOP") {
    val scenario = launchIntent.getIntExtra("scenario", 0)
    // Code to handle your game loop here
}MainActivity.kt

Java

Intent launchIntent = getIntent();
if(launchIntent.getAction().equals("com.google.intent.action.TEST_LOOP")) {
    int scenario = launchIntent.getIntExtra("scenario", 0);
    // Code to handle your game loop here
}MainActivity.java

توصیه می شود: در پایان آزمون، اضافه کنید:
Kotlin+KTX
```
yourActivity.finish()MainActivity.kt
```
Java
```
yourActivity.finish();MainActivity.java
```
هنگامی که تست حلقه بازی کامل شد، برنامه شما را می‌بندد. آزمایش برای شروع حلقه بعدی به چارچوب رابط کاربری برنامه شما متکی است و بستن برنامه به آن می گوید که آزمایش به پایان رسیده است.

یک تست Game Loop ایجاد و اجرا کنید

روی یک دستگاه محلی اجرا کنید

برای اجرای یک آزمایش بر روی یک دستگاه محلی با استفاده از Test Loop Manager:

Test Loop Manager را در تلفن یا رایانه لوحی دانلود کرده و با اجرای:
```
adb install testloopmanager.apk
```
در دستگاه خود، برنامه Test Loop Apps را در تلفن یا رایانه لوحی خود باز کنید. این برنامه لیستی از برنامه های موجود در دستگاه شما را نشان می دهد که می توانند با حلقه های بازی اجرا شوند. اگر برنامه بازی خود را در اینجا نمی‌بینید، مطمئن شوید که فیلتر قصد شما با فیلتری که در مرحله اول بخش قبل از شروع توضیح داده شد مطابقت دارد.
برنامه بازی خود را انتخاب کنید، سپس تعداد حلقه هایی را که می خواهید اجرا کنید انتخاب کنید. توجه: در این مرحله می‌توانید به جای یک حلقه، زیرمجموعه‌ای از حلقه‌ها را اجرا کنید. برای اطلاعات بیشتر در مورد اجرای چندین حلقه به طور همزمان، ویژگی های اختیاری را ببینید.
روی Run test کلیک کنید. تست شما بلافاصله شروع به اجرا می کند.

در Test Lab اجرا کنید

از کنسول Firebase استفاده کنید

در کنسول Firebase ، روی Test Lab از پانل سمت چپ کلیک کنید.
روی Run Your First Test (یا اجرای تست اگر پروژه شما قبلاً آزمایشی انجام داده است) کلیک کنید.
Game Loop را به عنوان نوع تست انتخاب کنید و سپس روی Continue کلیک کنید.
روی Browse کلیک کنید و سپس فایل .apk . برنامه خود را مرور کنید. توجه: در این مرحله می‌توانید به جای یک حلقه، زیرمجموعه‌ای از حلقه‌ها را اجرا کنید. برای اطلاعات بیشتر در مورد اجرای چندین حلقه به طور همزمان، ویژگی های اختیاری را ببینید.
روی Continue کلیک کنید.
دستگاه های فیزیکی را برای آزمایش برنامه خود انتخاب کنید.
روی Start Tests کلیک کنید.

برای اطلاعات بیشتر درباره شروع کار با کنسول Firebase ، به شروع آزمایش با کنسول Firebase مراجعه کنید.

از خط فرمان gcloud (CLI) استفاده کنید

اگر قبلاً این کار را نکرده‌اید، Google Cloud SDK را دانلود و نصب کنید
با استفاده از حساب Google خود به gcloud CLI وارد شوید:
gcloud auth login
پروژه Firebase خود را در gcloud تنظیم کنید، جایی که PROJECT_ID شناسه پروژه Firebase شما است:
```
gcloud config set project PROJECT_ID
```
اولین تست خود را اجرا کنید:
```
gcloud firebase test android run \
 --type=game-loop --app=<var>path-to-apk</var> \
 --device model=herolte,version=23
```
توجه: در این مرحله می‌توانید به جای یک حلقه، زیرمجموعه‌ای از حلقه‌ها را اجرا کنید. برای اطلاعات بیشتر در مورد اجرای چندین حلقه به طور همزمان، ویژگی های اختیاری را ببینید.

برای اطلاعات بیشتر در مورد شروع کار با gcloud CLI، به شروع آزمایش از خط فرمان gcloud مراجعه کنید.

ویژگی های اختیاری

داده های خروجی را بنویسید

Kotlin+KTX

val launchIntent = intent
val logFile = launchIntent.data
logFile?.let {
    Log.i(TAG, "Log file ${it.encodedPath}")
    // ...
}MainActivity.kt

Java

Intent launchIntent = getIntent();
Uri logFile = launchIntent.getData();
if (logFile != null) {
    Log.i(TAG, "Log file " + logFile.getEncodedPath());
    // ...
}MainActivity.java

Kotlin+KTX

val launchIntent = intent
val logFile = launchIntent.data
var fd = -1
logFile?.let {
    Log.i(TAG, "Log file ${it.encodedPath}")
    fd = try {
        contentResolver
            .openAssetFileDescriptor(logFile, "w")!!
            .parcelFileDescriptor
            .fd
    } catch (e: FileNotFoundException) {
        e.printStackTrace()
        -1
    } catch (e: NullPointerException) {
        e.printStackTrace()
        -1
    }
}

// C++ code invoked here.
// native_function(fd);MainActivity.kt

Java

Intent launchIntent = getIntent();
Uri logFile = launchIntent.getData();
int fd = -1;
if (logFile != null) {
    Log.i(TAG, "Log file " + logFile.getEncodedPath());
    try {
        fd = getContentResolver()
                .openAssetFileDescriptor(logFile, "w")
                .getParcelFileDescriptor()
                .getFd();
    } catch (FileNotFoundException e) {
        e.printStackTrace();
        fd = -1;
    } catch (NullPointerException e) {
        e.printStackTrace();
        fd = -1;
    }
}

// C++ code invoked here.
// native_function(fd);MainActivity.java

C++

#include <unistd.h>
JNIEXPORT void JNICALL
Java_my_package_name_MyActivity_native_function(JNIEnv *env, jclass type, jint log_file_descriptor) {
// The file descriptor needs to be duplicated.
int my_file_descriptor = dup(log_file_descriptor);
}

نمونه فایل خروجی

{
  "name": "test name",
  "start_timestamp": 0, // Timestamp of the test start (in us).
                           Can be absolute or relative
  "driver_info": "...",
  "frame_stats": [
    {
      "timestamp": 1200000, // Timestamp at which this section was written
                               It contains value regarding the period
                               start_timestamp(0) -> this timestamp (1200000 us)
      "avg_frame_time": 15320, // Average time to render a frame in ns
      "nb_swap": 52, // Number of frame rendered
      "threads": [
        {
          "name": "physics",
          "Avg_time": 8030 // Average time spent in this thread per frame in us
        },
        {
          "name": "AI",
          "Avg_time": 2030 // Average time spent in this thread per frame in us
        }
      ],
      /.../ // Any custom field you want (vertices display on the screen, nb units …)
    },
    {
      // Next frame data here, same format as above
    }
  ],
  "loading_stats": [
    {
      "name": "assets_level_1",
      "total_time": 7850, // in us
      /.../
    },
    {
      "name": "victory_screen",
      "total_time": 554, // in us
      /.../
    }

  ],
  /.../, // You can add custom fields here
}

حلقه های بازی چندگانه

برای فعال کردن برنامه خود برای اجرای چندین حلقه به طور همزمان:

اگر آزمایشی را با Test Loop Manager اجرا می کنید:
1. در داخل عنصر <application> خط زیر را به مانیفست برنامه خود اضافه کنید:
```
<meta-data
  android:name="com.google.test.loops"
  android:value="5" />
```
  این هدف راه اندازی شامل حلقه هدف به عنوان یک پارامتر عدد صحیح است. در قسمت android:value می توانید یک عدد صحیح از 1 تا 1024 (حداکثر تعداد حلقه های مجاز برای یک تست) را مشخص کنید. توجه داشته باشید که حلقه ها از 1 و نه 0 شروع می شوند.
2. در برنامه Test Loop Manager، یک صفحه انتخاب ظاهر می شود که به شما امکان می دهد حلقه(هایی) را که می خواهید اجرا کنید انتخاب کنید. اگر چندین حلقه را انتخاب کنید، هر حلقه به ترتیب پس از تکمیل حلقه قبلی راه اندازی می شود.
اگر آزمایشی را با کنسول Firebase انجام می دهید، یک لیست یا محدوده ای از اعداد حلقه را در قسمت سناریوها وارد کنید.
اگر آزمایشی را با gcloud CLI انجام می‌دهید، فهرستی از اعداد حلقه را با استفاده از پرچم --scenario-numbers مشخص کنید. به عنوان مثال، --scenario-numbers=1,3,5 حلقه های 1، 3 و 5 را اجرا می کند.
اگر در حال نوشتن C++ هستید و می خواهید رفتار حلقه خود را تغییر دهید، موارد اضافی زیر را به کد اصلی C++ خود منتقل کنید:
Kotlin+KTX
```
val launchIntent = intent
val scenario = launchIntent.getIntExtra("scenario", 0)MainActivity.kt
```
Java
```
Intent launchIntent = getIntent();
int scenario = launchIntent.getIntExtra("scenario", 0);MainActivity.java
```
اکنون می توانید رفتار حلقه خود را بر اساس مقدار int به دست آمده تغییر دهید.

حلقه های بازی را برچسب بزنید

com.google.test.loops.player_experience : برای حلقه هایی که برای بازتولید تجربه واقعی کاربر در هنگام بازی استفاده می شود. هدف از آزمایش با این حلقه‌ها یافتن مشکلاتی است که یک کاربر واقعی در حین انجام بازی با آن مواجه می‌شود.
com.google.test.loops.gpu_compatibility : برای حلقه هایی که برای آزمایش مسائل مربوط به GPU استفاده می شوند. هدف از آزمایش با این حلقه‌ها اجرای کدهای GPU است که ممکن است به درستی در تولید اجرا نشود، تا مشکلات سخت‌افزار و درایورها را آشکار کند.
com.google.test.loops.compatibility : برای حلقه هایی که برای آزمایش طیف وسیعی از مشکلات سازگاری، از جمله مشکلات I/O و مسائل OpenSSL استفاده می شود.
com.google.test.loops.performance : برای حلقه هایی که برای آزمایش عملکرد دستگاه استفاده می شوند. برای مثال، یک بازی ممکن است در پیچیده ترین تنظیمات گرافیکی اجرا شود تا ببیند یک دستگاه جدید چگونه رفتار می کند.

برای فعال کردن برنامه خود برای اجرای حلقه هایی با همان برچسب:

اگر آزمایشی را با Test Loop Manager اجرا می کنید:
1. در مانیفست برنامه خود، خط فراداده زیر را اضافه کنید و LABEL_NAME با یک برچسب انتخابی جایگزین کنید:
```
<meta-data
 android:name="com.google.test.loops.LABEL_NAME"
 android:value="1,3-5" />
```
  در قسمت android:value ، می‌توانید محدوده یا مجموعه‌ای از اعداد صحیح از 1 تا 1024 (حداکثر تعداد حلقه‌های مجاز برای یک تست) را مشخص کنید که نشان‌دهنده حلقه‌هایی است که می‌خواهید برچسب‌گذاری کنید. توجه داشته باشید که حلقه ها از 1 شروع می شوند نه 0. برای مثال، android:value="1,3-5" LABEL_NAME برای حلقه های 1، 3، 4، و 5 اعمال می کند.
2. در برنامه Test Loop Manager، یک یا چند برچسب را در قسمت Labels وارد کنید.
اگر آزمایشی را با کنسول Firebase انجام می‌دهید، یک یا چند برچسب را در قسمت Labels وارد کنید.
اگر آزمایشی را با gcloud CLI انجام می‌دهید، یک یا چند برچسب سناریو را با استفاده از پرچم --scenario-labels (مثلا --scenario-labels=performance,gpu ) مشخص کنید.

پشتیبانی از مجوز برنامه

مسائل شناخته شده

تست های حلقه بازی در Test Lab دارای مشکلات شناخته شده زیر هستند:

برخی از خرابی ها از backtraces پشتیبانی نمی کنند. برای مثال، برخی از نسخه‌های انتشار ممکن است خروجی فرآیند debuggerd با استفاده از prctl(PR_SET_DUMPABLE, 0) سرکوب کنند. برای کسب اطلاعات بیشتر، debuggerd ببینید.
API Level 19 به دلیل خطاهای مجوز فایل در حال حاضر پشتیبانی نمی شود.

یک سطح از بازی خود را به همان شیوه ای که کاربر نهایی آن را بازی می کند اجرا کنید. می‌توانید ورودی کاربر را اسکریپت کنید، اجازه دهید کاربر بی‌حرکت باشد، یا اگر در بازی شما منطقی است، کاربر را با یک هوش مصنوعی جایگزین کنید (مثلاً، بگویید که یک برنامه بازی ماشین مسابقه دارید و قبلاً یک هوش مصنوعی پیاده‌سازی کرده‌اید. می‌توانید به راحتی یک درایور هوش مصنوعی را مسئول ورودی کاربر قرار دهید).
بازی خود را با بالاترین کیفیت اجرا کنید تا ببینید آیا دستگاه‌ها از آن پشتیبانی می‌کنند یا خیر.
یک تست فنی را اجرا کنید (چند سایه زن را کامپایل کنید، آنها را اجرا کنید، بررسی کنید که خروجی مطابق انتظار است و غیره).

قبل از شروع

برای اجرای یک تست، ابتدا باید اپلیکیشن خود را برای تست های Game Loop پیکربندی کنید.

در مانیفست برنامه خود، یک فیلتر قصد جدید به فعالیت خود اضافه کنید:
```
<activity android:name=".MyActivity">
   <intent-filter>
       <action android:name="com.google.intent.action.TEST_LOOP"/>
       <category android:name="android.intent.category.DEFAULT"/>
       <data android:mimeType="application/javascript"/>
   </intent-filter>
   <intent-filter>
      ... (other intent filters here)
   </intent-filter>
</activity>
```
این به Test Lab اجازه می دهد تا بازی شما را با راه اندازی آن با یک هدف خاص راه اندازی کند.
توجه: حلقه های بازی به یک فیلتر هدف جداگانه و اختصاصی نیاز دارند که برای اهداف دیگر استفاده نمی شود. فعالیت شما می‌تواند شامل فیلترهای هدف دیگری نیز باشد. برای کسب اطلاعات بیشتر در مورد فیلترهای هدف، به صفحه مرجع <intent-filter> مراجعه کنید.

در کد خود (توصیه می کنیم در بیانیه متد onCreate )، موارد زیر را اضافه کنید:

Kotlin+KTX

val launchIntent = intent
if (launchIntent.action == "com.google.intent.action.TEST_LOOP") {
    val scenario = launchIntent.getIntExtra("scenario", 0)
    // Code to handle your game loop here
}MainActivity.kt

Java

Intent launchIntent = getIntent();
if(launchIntent.getAction().equals("com.google.intent.action.TEST_LOOP")) {
    int scenario = launchIntent.getIntExtra("scenario", 0);
    // Code to handle your game loop here
}MainActivity.java

توصیه می شود: در پایان آزمون، اضافه کنید:
Kotlin+KTX
```
yourActivity.finish()MainActivity.kt
```
Java
```
yourActivity.finish();MainActivity.java
```
هنگامی که تست حلقه بازی کامل شد، برنامه شما را می‌بندد. آزمایش برای شروع حلقه بعدی به چارچوب رابط کاربری برنامه شما متکی است و بستن برنامه به آن می گوید که آزمایش به پایان رسیده است.

یک تست Game Loop ایجاد و اجرا کنید

روی یک دستگاه محلی اجرا کنید

برای اجرای یک آزمایش بر روی یک دستگاه محلی با استفاده از Test Loop Manager:

Test Loop Manager را در تلفن یا رایانه لوحی دانلود کرده و با اجرای:
```
adb install testloopmanager.apk
```
در دستگاه خود، برنامه Test Loop Apps را در تلفن یا رایانه لوحی خود باز کنید. این برنامه لیستی از برنامه های موجود در دستگاه شما را نشان می دهد که می توانند با حلقه های بازی اجرا شوند. اگر برنامه بازی خود را در اینجا نمی‌بینید، مطمئن شوید که فیلتر قصد شما با فیلتری که در مرحله اول بخش قبل از شروع توضیح داده شد مطابقت دارد.
برنامه بازی خود را انتخاب کنید، سپس تعداد حلقه هایی را که می خواهید اجرا کنید انتخاب کنید. توجه: در این مرحله می‌توانید به جای یک حلقه، زیرمجموعه‌ای از حلقه‌ها را اجرا کنید. برای اطلاعات بیشتر در مورد اجرای چندین حلقه به طور همزمان، ویژگی های اختیاری را ببینید.
روی Run test کلیک کنید. تست شما بلافاصله شروع به اجرا می کند.

در Test Lab اجرا کنید

از کنسول Firebase استفاده کنید

در کنسول Firebase ، روی Test Lab از پانل سمت چپ کلیک کنید.
روی Run Your First Test (یا اجرای تست اگر پروژه شما قبلاً آزمایشی انجام داده است) کلیک کنید.
Game Loop را به عنوان نوع تست انتخاب کنید و سپس روی Continue کلیک کنید.
روی Browse کلیک کنید و سپس فایل .apk . برنامه خود را مرور کنید. توجه: در این مرحله می‌توانید به جای یک حلقه، زیرمجموعه‌ای از حلقه‌ها را اجرا کنید. برای اطلاعات بیشتر در مورد اجرای چندین حلقه به طور همزمان، ویژگی های اختیاری را ببینید.
روی Continue کلیک کنید.
دستگاه های فیزیکی را برای آزمایش برنامه خود انتخاب کنید.
روی Start Tests کلیک کنید.

برای اطلاعات بیشتر درباره شروع کار با کنسول Firebase ، به شروع آزمایش با کنسول Firebase مراجعه کنید.

از خط فرمان gcloud (CLI) استفاده کنید

اگر قبلاً این کار را نکرده‌اید، Google Cloud SDK را دانلود و نصب کنید
با استفاده از حساب Google خود به gcloud CLI وارد شوید:
gcloud auth login
پروژه Firebase خود را در gcloud تنظیم کنید، جایی که PROJECT_ID شناسه پروژه Firebase شما است:
```
gcloud config set project PROJECT_ID
```
اولین تست خود را اجرا کنید:
```
gcloud firebase test android run \
 --type=game-loop --app=<var>path-to-apk</var> \
 --device model=herolte,version=23
```
توجه: در این مرحله می‌توانید به جای یک حلقه، زیرمجموعه‌ای از حلقه‌ها را اجرا کنید. برای اطلاعات بیشتر در مورد اجرای چندین حلقه به طور همزمان، ویژگی های اختیاری را ببینید.

برای اطلاعات بیشتر در مورد شروع کار با gcloud CLI، به شروع آزمایش از خط فرمان gcloud مراجعه کنید.

ویژگی های اختیاری

داده های خروجی را بنویسید

Kotlin+KTX

val launchIntent = intent
val logFile = launchIntent.data
logFile?.let {
    Log.i(TAG, "Log file ${it.encodedPath}")
    // ...
}MainActivity.kt

Java

Intent launchIntent = getIntent();
Uri logFile = launchIntent.getData();
if (logFile != null) {
    Log.i(TAG, "Log file " + logFile.getEncodedPath());
    // ...
}MainActivity.java

Kotlin+KTX

val launchIntent = intent
val logFile = launchIntent.data
var fd = -1
logFile?.let {
    Log.i(TAG, "Log file ${it.encodedPath}")
    fd = try {
        contentResolver
            .openAssetFileDescriptor(logFile, "w")!!
            .parcelFileDescriptor
            .fd
    } catch (e: FileNotFoundException) {
        e.printStackTrace()
        -1
    } catch (e: NullPointerException) {
        e.printStackTrace()
        -1
    }
}

// C++ code invoked here.
// native_function(fd);MainActivity.kt

Java

Intent launchIntent = getIntent();
Uri logFile = launchIntent.getData();
int fd = -1;
if (logFile != null) {
    Log.i(TAG, "Log file " + logFile.getEncodedPath());
    try {
        fd = getContentResolver()
                .openAssetFileDescriptor(logFile, "w")
                .getParcelFileDescriptor()
                .getFd();
    } catch (FileNotFoundException e) {
        e.printStackTrace();
        fd = -1;
    } catch (NullPointerException e) {
        e.printStackTrace();
        fd = -1;
    }
}

// C++ code invoked here.
// native_function(fd);MainActivity.java

C++

#include <unistd.h>
JNIEXPORT void JNICALL
Java_my_package_name_MyActivity_native_function(JNIEnv *env, jclass type, jint log_file_descriptor) {
// The file descriptor needs to be duplicated.
int my_file_descriptor = dup(log_file_descriptor);
}

نمونه فایل خروجی

{
  "name": "test name",
  "start_timestamp": 0, // Timestamp of the test start (in us).
                           Can be absolute or relative
  "driver_info": "...",
  "frame_stats": [
    {
      "timestamp": 1200000, // Timestamp at which this section was written
                               It contains value regarding the period
                               start_timestamp(0) -> this timestamp (1200000 us)
      "avg_frame_time": 15320, // Average time to render a frame in ns
      "nb_swap": 52, // Number of frame rendered
      "threads": [
        {
          "name": "physics",
          "Avg_time": 8030 // Average time spent in this thread per frame in us
        },
        {
          "name": "AI",
          "Avg_time": 2030 // Average time spent in this thread per frame in us
        }
      ],
      /.../ // Any custom field you want (vertices display on the screen, nb units …)
    },
    {
      // Next frame data here, same format as above
    }
  ],
  "loading_stats": [
    {
      "name": "assets_level_1",
      "total_time": 7850, // in us
      /.../
    },
    {
      "name": "victory_screen",
      "total_time": 554, // in us
      /.../
    }

  ],
  /.../, // You can add custom fields here
}

حلقه های بازی چندگانه

برای فعال کردن برنامه خود برای اجرای چندین حلقه به طور همزمان:

اگر آزمایشی را با Test Loop Manager اجرا می کنید:
1. در داخل عنصر <application> خط زیر را به مانیفست برنامه خود اضافه کنید:
```
<meta-data
  android:name="com.google.test.loops"
  android:value="5" />
```
  این هدف راه اندازی شامل حلقه هدف به عنوان یک پارامتر عدد صحیح است. در قسمت android:value می توانید یک عدد صحیح از 1 تا 1024 (حداکثر تعداد حلقه های مجاز برای یک تست) را مشخص کنید. توجه داشته باشید که حلقه ها از 1 و نه 0 شروع می شوند.
2. در برنامه Test Loop Manager، یک صفحه انتخاب ظاهر می شود که به شما امکان می دهد حلقه(هایی) را که می خواهید اجرا کنید انتخاب کنید. اگر چندین حلقه را انتخاب کنید، هر حلقه به ترتیب پس از تکمیل حلقه قبلی راه اندازی می شود.
اگر آزمایشی را با کنسول Firebase انجام می دهید، یک لیست یا محدوده ای از اعداد حلقه را در قسمت سناریوها وارد کنید.
اگر آزمایشی را با gcloud CLI انجام می‌دهید، فهرستی از اعداد حلقه را با استفاده از پرچم --scenario-numbers مشخص کنید. به عنوان مثال، --scenario-numbers=1,3,5 حلقه های 1، 3 و 5 را اجرا می کند.
اگر در حال نوشتن C++ هستید و می خواهید رفتار حلقه خود را تغییر دهید، موارد اضافی زیر را به کد اصلی C++ خود منتقل کنید:
Kotlin+KTX
```
val launchIntent = intent
val scenario = launchIntent.getIntExtra("scenario", 0)MainActivity.kt
```
Java
```
Intent launchIntent = getIntent();
int scenario = launchIntent.getIntExtra("scenario", 0);MainActivity.java
```
اکنون می توانید رفتار حلقه خود را بر اساس مقدار int به دست آمده تغییر دهید.

حلقه های بازی را برچسب بزنید

com.google.test.loops.player_experience : برای حلقه هایی که برای بازتولید تجربه واقعی کاربر در هنگام بازی استفاده می شود. هدف از آزمایش با این حلقه‌ها یافتن مشکلاتی است که یک کاربر واقعی در حین انجام بازی با آن مواجه می‌شود.
com.google.test.loops.gpu_compatibility : برای حلقه هایی که برای آزمایش مسائل مربوط به GPU استفاده می شوند. هدف از آزمایش با این حلقه ها ، اجرای کد GPU است که ممکن است به درستی در تولید اجرا نشود ، تا مشکلات مربوط به سخت افزار و درایورها را در معرض دید خود قرار دهد.
com.google.test.loops.compatibility : برای حلقه هایی که برای آزمایش طیف گسترده ای از مسائل سازگاری ، از جمله موارد I/O و مسائل OpenSSL استفاده می شود.
com.google.test.loops.performance : برای حلقه هایی که برای آزمایش عملکرد دستگاه استفاده می شود. به عنوان مثال ، یک بازی ممکن است در پیچیده ترین تنظیمات گرافیکی اجرا شود تا ببیند چگونه یک دستگاه جدید رفتار می کند.

برای فعال کردن برنامه خود برای اجرای حلقه ها با همان برچسب:

اگر با مدیر حلقه آزمون تست می کنید:
1. در مانیفست برنامه خود ، خط متا داده های زیر را اضافه کنید و LABEL_NAME با برچسب مورد نظر خود جایگزین کنید:
```
<meta-data
 android:name="com.google.test.loops.LABEL_NAME"
 android:value="1,3-5" />
```
  در قسمت android:value ، می توانید دامنه یا مجموعه ای از اعداد صحیح را از 1 تا 1024 (حداکثر تعداد حلقه های مجاز برای یک آزمایش واحد) مشخص کنید که نمایانگر حلقه هایی است که می خواهید برچسب بزنید. توجه داشته باشید که حلقه ها از 1 و نه 0 فهرست بندی می شوند. به عنوان مثال ، android:value="1,3-5" LABEL_NAME برای حلقه های 1 ، 3 ، 4 و 5 اعمال می کند.
2. در برنامه Test Loop Manager ، یک یا چند برچسب را در قسمت برچسب ها وارد کنید.
اگر با کنسول Firebase آزمایش می کنید ، یک یا چند برچسب را در قسمت برچسب وارد کنید.
اگر با GCLOUD CLI آزمایشی را انجام می دهید ، با استفاده از پرچم- --scenario-labels (به عنوان مثال ، --scenario-labels=performance,gpu ) یک یا چند برچسب سناریوی را مشخص کنید.

پشتیبانی مجوز برنامه

Test Lab از برنامه هایی که از سرویس صدور مجوز برنامه ارائه شده توسط Google Play استفاده می کنند ، پشتیبانی می کند. برای بررسی موفقیت آمیز مجوز هنگام آزمایش برنامه خود با Test Lab ، باید برنامه خود را در کانال تولید در فروشگاه Play منتشر کنید. برای آزمایش برنامه خود در کانال آلفا یا بتا با استفاده از Test Lab ، قبل از بارگذاری برنامه خود برای Test Lab چک مجوز را حذف کنید.

مسائل شناخته شده

تست های حلقه بازی در Test Lab موارد شناخته شده زیر را دارند:

برخی از تصادفات از پشتی ها پشتیبانی نمی کنند. به عنوان مثال ، برخی از ساختهای انتشار ممکن است با استفاده از PRCTL ، خروجی فرآیند debuggerd سرکوب کند prctl(PR_SET_DUMPABLE, 0) . برای کسب اطلاعات بیشتر ، به debuggerd مراجعه کنید.
API سطح 19 به دلیل خطاهای اجازه پرونده در حال حاضر پشتیبانی نمی شود.

هنگام ساخت برنامه های بازی در چارچوب های مختلف UI ، تست بازی بازی دشوار است. تست های حلقه بازی به شما امکان می دهد تست های بومی خود را با Test Lab ادغام کنید و به راحتی آنها را بر روی دستگاه هایی که انتخاب می کنید اجرا کنید. یک تست حلقه بازی ضمن شبیه سازی اقدامات یک بازیکن واقعی ، تست شما را از طریق برنامه بازی خود اجرا می کند. این راهنما به شما نشان می دهد که چگونه یک تست حلقه بازی را اجرا کنید ، سپس نتایج تست خود را در کنسول Firebase مشاهده و مدیریت کنید.

بسته به موتور بازی خود ، می توانید تست ها را با حلقه های تک یا چندگانه پیاده سازی کنید. یک حلقه یک اجرای کامل یا جزئی از تست شما در برنامه بازی شما است. از حلقه های بازی می توان استفاده کرد:

یک سطح از بازی خود را به همان روشی اجرا کنید که کاربر نهایی آن را بازی کند. شما می توانید ورودی کاربر را اسکریپت کنید ، به کاربر اجازه دهید بیکار باشد ، یا اگر در بازی شما منطقی باشد کاربر را با هوش مصنوعی جایگزین کنید (به عنوان مثال ، بگویید شما یک برنامه بازی اتومبیل مسابقه دارید و قبلاً AI را اجرا کرده اید. می توانید به راحتی درایور AI را مسئول ورودی کاربر قرار دهید).
بازی خود را با بالاترین کیفیت تنظیم کنید تا ببینید دستگاه ها از آن پشتیبانی می کنند یا خیر.
یک تست فنی را اجرا کنید (چندین سایه بان را کامپایل کنید ، آنها را اجرا کنید ، بررسی کنید که خروجی همانطور که انتظار می رود و غیره).

شما می توانید یک تست حلقه بازی را روی یک دستگاه تست واحد ، مجموعه ای از دستگاه های تست یا در Test Lab اجرا کنید. با این حال ، ما توصیه نمی کنیم تست های حلقه بازی را روی دستگاه های مجازی اجرا کنید زیرا آنها نرخ قاب گرافیکی کمتری نسبت به دستگاه های فیزیکی دارند.

قبل از شروع

برای اجرای یک تست ، ابتدا باید برنامه خود را برای تست های حلقه بازی پیکربندی کنید.

در آشکار برنامه خود ، یک فیلتر قصد جدید به فعالیت خود اضافه کنید:
```
<activity android:name=".MyActivity">
   <intent-filter>
       <action android:name="com.google.intent.action.TEST_LOOP"/>
       <category android:name="android.intent.category.DEFAULT"/>
       <data android:mimeType="application/javascript"/>
   </intent-filter>
   <intent-filter>
      ... (other intent filters here)
   </intent-filter>
</activity>
```
این به Test Lab اجازه می دهد تا با ایجاد یک هدف خاص ، بازی خود را راه اندازی کنید.
توجه: حلقه های بازی به یک فیلتر هدف جداگانه و اختصاصی نیاز دارند که برای اهداف دیگر استفاده نمی شود. فعالیت شما می تواند شامل سایر فیلترهای قصد باشد. برای کسب اطلاعات بیشتر در مورد فیلترهای قصد ، به صفحه مرجع <tent-filter> مراجعه کنید.

در کد خود (ما در اعلامیه روش onCreate توصیه می کنیم) موارد زیر را اضافه کنید:

Kotlin+KTX

val launchIntent = intent
if (launchIntent.action == "com.google.intent.action.TEST_LOOP") {
    val scenario = launchIntent.getIntExtra("scenario", 0)
    // Code to handle your game loop here
}MainActivity.kt

Java

Intent launchIntent = getIntent();
if(launchIntent.getAction().equals("com.google.intent.action.TEST_LOOP")) {
    int scenario = launchIntent.getIntExtra("scenario", 0);
    // Code to handle your game loop here
}MainActivity.java

این به فعالیت شما اجازه می دهد تا قصد راه اندازی آن را بررسی کنید. در صورت تمایل می توانید این کد را نیز بعداً اضافه کنید (به عنوان مثال ، پس از بارگذاری موتور بازی خود).

توصیه می شود: در پایان آزمون ، اضافه کنید:
Kotlin+KTX
```
yourActivity.finish()MainActivity.kt
```
Java
```
yourActivity.finish();MainActivity.java
```
این برنامه شما را بسته می کند که تست حلقه بازی کامل شود. این آزمون برای شروع حلقه بعدی به چارچوب UI برنامه شما متکی است و بستن برنامه شما به آن می گوید که آزمون به پایان رسیده است.

تست حلقه بازی را ایجاد و اجرا کنید

بعد از پیکربندی برنامه خود برای تست های حلقه بازی ، می توانید بلافاصله یک تست ایجاد کرده و آن را در برنامه بازی خود اجرا کنید. شما می توانید با استفاده از کنسول Firebase یا رابط خط فرمان GCLOUD (CLI) یا در یک دستگاه محلی با استفاده از مدیر حلقه آزمایش ، آزمایش آزمایشگاه را در Test Lab انجام دهید.

روی یک دستگاه محلی اجرا کنید

مدیر حلقه آزمایش Test Lab یک برنامه منبع باز است که به شما کمک می کند تست های حلقه بازی را ادغام کنید و آنها را در دستگاه های محلی خود اجرا کنید. همچنین به تیم تضمین کیفیت شما اجازه می دهد تا همان حلقه های بازی را در دستگاه های خود اجرا کنند.

برای اجرای یک تست روی یک دستگاه محلی با استفاده از مدیر حلقه تست:

مدیر حلقه تست را روی تلفن یا رایانه لوحی بارگیری کنید و با اجرای آن نصب کنید:
```
adb install testloopmanager.apk
```
در دستگاه خود ، برنامه برنامه Loop Loop را روی تلفن یا رایانه لوحی خود باز کنید. این برنامه لیستی از برنامه های موجود در دستگاه شما را نشان می دهد که می توانند با حلقه های بازی اجرا شوند. اگر برنامه بازی خود را در اینجا نمی بینید ، اطمینان حاصل کنید که فیلتر هدف شما با یکی از موارد شرح داده شده در اولین مرحله از بخش قبل از شروع کار مطابقت دارد.
برنامه بازی خود را انتخاب کنید ، سپس تعداد حلقه هایی را که می خواهید اجرا کنید انتخاب کنید. توجه: در این مرحله می توانید به جای فقط یک حلقه ، زیر مجموعه ای از حلقه ها را اجرا کنید. برای اطلاعات بیشتر در مورد اجرای چندین حلقه به طور همزمان ، به ویژگی های اختیاری مراجعه کنید.
روی تست Run کلیک کنید. تست شما بلافاصله شروع به کار می کند.

در Test Lab اجرا کنید

می توانید با استفاده از کنسول Firebase یا GCLOUD CLI ، آزمایش حلقه بازی را در Test Lab انجام دهید . قبل از شروع ، اگر قبلاً این کار را نکرده اید ، کنسول Firebase را باز کرده و یک پروژه ایجاد کنید.

از کنسول Firebase استفاده کنید

در کنسول Firebase ، روی Test Lab از پنل سمت چپ کلیک کنید.
روی اجرای اولین تست خود کلیک کنید (یا اگر پروژه شما قبلاً یک تست را اجرا کرده است) تست را اجرا کنید .
بازی Loop را به عنوان نوع تست انتخاب کنید و سپس بر روی ادامه کلیک کنید.
روی مرور کلیک کنید ، و سپس به پرونده .apk برنامه خود مرور کنید. توجه: در این مرحله می توانید به جای فقط یک حلقه ، زیر مجموعه ای از حلقه ها را اجرا کنید. برای اطلاعات بیشتر در مورد اجرای چندین حلقه به طور همزمان ، به ویژگی های اختیاری مراجعه کنید.
روی Continue کلیک کنید.
دستگاه های فیزیکی را برای استفاده برای آزمایش برنامه خود انتخاب کنید.
روی تست های شروع کلیک کنید.

برای کسب اطلاعات بیشتر در مورد شروع کار با کنسول Firebase ، شروع به آزمایش با کنسول Firebase کنید.

از خط فرمان gcloud (CLI) استفاده کنید

اگر قبلاً چنین نکرده اید ، Google Cloud SDK را بارگیری و نصب کنید
با استفاده از حساب Google خود وارد GCLOUD CLI شوید:
gcloud auth login
پروژه Firebase خود را در Gcloud تنظیم کنید ، جایی که PROJECT_ID شناسه پروژه Firebase شماست:
```
gcloud config set project PROJECT_ID
```
اولین تست خود را اجرا کنید:
```
gcloud firebase test android run \
 --type=game-loop --app=<var>path-to-apk</var> \
 --device model=herolte,version=23
```
توجه: در این مرحله می توانید به جای فقط یک حلقه ، زیر مجموعه ای از حلقه ها را اجرا کنید. برای اطلاعات بیشتر در مورد اجرای چندین حلقه به طور همزمان ، به ویژگی های اختیاری مراجعه کنید.

برای کسب اطلاعات بیشتر در مورد شروع با GCLOUD CLI ، به آزمایش شروع از خط فرمان GCLOUD مراجعه کنید.

ویژگی های اختیاری

Test Lab چندین ویژگی اختیاری را ارائه می دهد که به شما امکان می دهد تست های خود را بیشتر سفارشی کنید ، از جمله امکان نوشتن داده های خروجی ، پشتیبانی از چندین حلقه بازی و برچسب های مربوط به حلقه های مرتبط.

داده های خروجی را بنویسید

تست حلقه بازی شما می تواند خروجی را به یک فایل مشخص شده در روش launchIntent.getData() بنویسد. پس از انجام آزمایش ، می توانید به این داده های خروجی در بخش Test Lab کنسول Firebase دسترسی پیدا کنید ( به مثال فایل خروجی آزمایش حلقه بازی مراجعه کنید).

Test Lab بهترین روشها را برای به اشتراک گذاری پرونده بین برنامه های شرح داده شده در به اشتراک گذاری یک پرونده دنبال می کند. در روش onCreate() فعالیت خود ، جایی که قصد شما در آن قرار دارد ، می توانید با اجرای کد زیر ، پرونده خروجی داده خود را بررسی کنید:

Kotlin+KTX

val launchIntent = intent
val logFile = launchIntent.data
logFile?.let {
    Log.i(TAG, "Log file ${it.encodedPath}")
    // ...
}MainActivity.kt

Java

Intent launchIntent = getIntent();
Uri logFile = launchIntent.getData();
if (logFile != null) {
    Log.i(TAG, "Log file " + logFile.getEncodedPath());
    // ...
}MainActivity.java

اگر می خواهید از طرف C ++ برنامه بازی خود به پرونده بنویسید ، می توانید به جای مسیر پرونده ، در توصیف کننده پرونده عبور کنید:

Kotlin+KTX

val launchIntent = intent
val logFile = launchIntent.data
var fd = -1
logFile?.let {
    Log.i(TAG, "Log file ${it.encodedPath}")
    fd = try {
        contentResolver
            .openAssetFileDescriptor(logFile, "w")!!
            .parcelFileDescriptor
            .fd
    } catch (e: FileNotFoundException) {
        e.printStackTrace()
        -1
    } catch (e: NullPointerException) {
        e.printStackTrace()
        -1
    }
}

// C++ code invoked here.
// native_function(fd);MainActivity.kt

Java

Intent launchIntent = getIntent();
Uri logFile = launchIntent.getData();
int fd = -1;
if (logFile != null) {
    Log.i(TAG, "Log file " + logFile.getEncodedPath());
    try {
        fd = getContentResolver()
                .openAssetFileDescriptor(logFile, "w")
                .getParcelFileDescriptor()
                .getFd();
    } catch (FileNotFoundException e) {
        e.printStackTrace();
        fd = -1;
    } catch (NullPointerException e) {
        e.printStackTrace();
        fd = -1;
    }
}

// C++ code invoked here.
// native_function(fd);MainActivity.java

C++

#include <unistd.h>
JNIEXPORT void JNICALL
Java_my_package_name_MyActivity_native_function(JNIEnv *env, jclass type, jint log_file_descriptor) {
// The file descriptor needs to be duplicated.
int my_file_descriptor = dup(log_file_descriptor);
}

مثال فایل خروجی

برای نمایش نتایج آزمایش حلقه بازی در بخش Test Lab کنسول Firebase می توانید از پرونده های داده خروجی (مانند مثال زیر) استفاده کنید. مناطقی که به عنوان /.../ نشان داده شده است می توانند حاوی هر زمینه سفارشی مورد نیاز شما باشند ، تا زمانی که آنها با نام سایر زمینه های مورد استفاده در این پرونده مغایرت نداشته باشند:

{
  "name": "test name",
  "start_timestamp": 0, // Timestamp of the test start (in us).
                           Can be absolute or relative
  "driver_info": "...",
  "frame_stats": [
    {
      "timestamp": 1200000, // Timestamp at which this section was written
                               It contains value regarding the period
                               start_timestamp(0) -> this timestamp (1200000 us)
      "avg_frame_time": 15320, // Average time to render a frame in ns
      "nb_swap": 52, // Number of frame rendered
      "threads": [
        {
          "name": "physics",
          "Avg_time": 8030 // Average time spent in this thread per frame in us
        },
        {
          "name": "AI",
          "Avg_time": 2030 // Average time spent in this thread per frame in us
        }
      ],
      /.../ // Any custom field you want (vertices display on the screen, nb units …)
    },
    {
      // Next frame data here, same format as above
    }
  ],
  "loading_stats": [
    {
      "name": "assets_level_1",
      "total_time": 7850, // in us
      /.../
    },
    {
      "name": "victory_screen",
      "total_time": 554, // in us
      /.../
    }

  ],
  /.../, // You can add custom fields here
}

چندین حلقه بازی

ممکن است اجرای چندین حلقه بازی در برنامه خود مفید باشد. یک حلقه یک اجرای کامل از برنامه بازی شما از ابتدا تا انتها است. به عنوان مثال ، اگر در بازی خود چندین سطح دارید ، ممکن است بخواهید یک حلقه بازی داشته باشید تا به جای داشتن یک حلقه که از طریق همه آنها تکرار می شود ، هر سطح را راه اندازی کنید. به این ترتیب ، اگر برنامه شما در سطح 32 خراب شود ، می توانید مستقیماً آن حلقه بازی را برای بازتولید رفع خرابی و تست اشکال راه اندازی کنید.

برای فعال کردن برنامه خود برای اجرای چندین حلقه به طور هم زمان:

اگر با مدیر حلقه آزمون تست می کنید:
1. خط زیر را به مانیفست برنامه خود اضافه کنید ، در داخل عنصر <application> :
```
<meta-data
  android:name="com.google.test.loops"
  android:value="5" />
```
  این هدف پرتاب شامل حلقه هدف به عنوان یک پارامتر عدد صحیح است. در قسمت android:value ، می توانید یک عدد صحیح را از 1 تا 1024 مشخص کنید (حداکثر تعداد حلقه های مجاز برای یک آزمایش واحد). توجه داشته باشید که حلقه ها از 1 و نه 0 فهرست بندی می شوند.
2. در برنامه Test Loop Manager ، یک صفحه انتخابی ظاهر می شود که به شما امکان می دهد کدام حلقه (ها) را که می خواهید اجرا کنید انتخاب کنید. اگر چندین حلقه را انتخاب کنید ، هر حلقه پس از اتمام حلقه قبلی به صورت توالی راه اندازی می شود.
اگر با کنسول Firebase تست می کنید ، لیست یا طیف وسیعی از شماره های حلقه را در قسمت سناریوها وارد کنید.
اگر با GCLOUD CLI تست می کنید ، لیستی از شماره های حلقه را با استفاده از پرچم- --scenario-numbers مشخص کنید. به عنوان مثال ، --scenario-numbers=1,3,5 حلقه حلقه 1 ، 3 و 5.
اگر در حال نوشتن C ++ هستید و می خواهید رفتار حلقه خود را تغییر دهید ، موارد زیر را به کد C ++ بومی خود منتقل کنید:
Kotlin+KTX
```
val launchIntent = intent
val scenario = launchIntent.getIntExtra("scenario", 0)MainActivity.kt
```
Java
```
Intent launchIntent = getIntent();
int scenario = launchIntent.getIntExtra("scenario", 0);MainActivity.java
```
اکنون می توانید رفتار حلقه خود را بر اساس مقدار int حاصل تغییر دهید.

حلقه های بازی برچسب

هنگامی که حلقه های بازی خود را با یک یا چند برچسب سناریو برچسب گذاری می کنید ، شما و تیم QA شما می توانید به راحتی مجموعه ای از حلقه های بازی مرتبط را راه اندازی کنید (به عنوان مثال ، "همه حلقه های بازی سازگاری") و آنها را در یک ماتریس تست کنید. شما می توانید برچسب های خود را ایجاد کنید یا از برچسب های از پیش تعریف شده ارائه شده توسط Test Lab استفاده کنید:

com.google.test.loops.player_experience : برای حلقه هایی که برای تولید مثل یک کاربر واقعی هنگام بازی استفاده می شود. هدف از آزمایش با این حلقه ها ، یافتن مواردی است که یک کاربر واقعی هنگام بازی با آن روبرو می شود.
com.google.test.loops.gpu_compatibility : برای حلقه هایی که برای آزمایش مسائل مربوط به GPU استفاده می شود. هدف از آزمایش با این حلقه ها ، اجرای کد GPU است که ممکن است به درستی در تولید اجرا نشود ، تا مشکلات مربوط به سخت افزار و درایورها را در معرض دید خود قرار دهد.
com.google.test.loops.compatibility : برای حلقه هایی که برای آزمایش طیف گسترده ای از مسائل سازگاری ، از جمله موارد I/O و مسائل OpenSSL استفاده می شود.
com.google.test.loops.performance : برای حلقه هایی که برای آزمایش عملکرد دستگاه استفاده می شود. به عنوان مثال ، یک بازی ممکن است در پیچیده ترین تنظیمات گرافیکی اجرا شود تا ببیند چگونه یک دستگاه جدید رفتار می کند.

برای فعال کردن برنامه خود برای اجرای حلقه ها با همان برچسب:

اگر با مدیر حلقه آزمون تست می کنید:
1. در مانیفست برنامه خود ، خط متا داده های زیر را اضافه کنید و LABEL_NAME با برچسب مورد نظر خود جایگزین کنید:
```
<meta-data
 android:name="com.google.test.loops.LABEL_NAME"
 android:value="1,3-5" />
```
  در قسمت android:value ، می توانید دامنه یا مجموعه ای از اعداد صحیح را از 1 تا 1024 (حداکثر تعداد حلقه های مجاز برای یک آزمایش واحد) مشخص کنید که نمایانگر حلقه هایی است که می خواهید برچسب بزنید. توجه داشته باشید که حلقه ها از 1 و نه 0 فهرست بندی می شوند. به عنوان مثال ، android:value="1,3-5" LABEL_NAME برای حلقه های 1 ، 3 ، 4 و 5 اعمال می کند.
2. در برنامه Test Loop Manager ، یک یا چند برچسب را در قسمت برچسب ها وارد کنید.
اگر با کنسول Firebase آزمایش می کنید ، یک یا چند برچسب را در قسمت برچسب وارد کنید.
اگر با GCLOUD CLI آزمایشی را انجام می دهید ، با استفاده از پرچم- --scenario-labels (به عنوان مثال ، --scenario-labels=performance,gpu ) یک یا چند برچسب سناریوی را مشخص کنید.

پشتیبانی مجوز برنامه

مسائل شناخته شده

تست های حلقه بازی در Test Lab موارد شناخته شده زیر را دارند:

برخی از تصادفات از پشتی ها پشتیبانی نمی کنند. به عنوان مثال ، برخی از ساختهای انتشار ممکن است با استفاده از PRCTL ، خروجی فرآیند debuggerd سرکوب کند prctl(PR_SET_DUMPABLE, 0) . برای کسب اطلاعات بیشتر ، به debuggerd مراجعه کنید.
API سطح 19 به دلیل خطاهای اجازه پرونده در حال حاضر پشتیبانی نمی شود.