برنامه دمو را اجرا کنید

این صفحه نحوه اجرای یک آزمایش سرتاسری را با استفاده از یک برنامه آزمایشی و کنسول Google Play توضیح می‌دهد.

مراحل

برای دانلود SDK، اجرای برنامه آزمایشی، تأیید صحت عملکرد برنامه و مشاهده اطلاعات زمان بندی فریم از برنامه در کنسول Google Play، موارد زیر را انجام دهید:

1. فایل SDK.zip را دانلود کرده و از حالت فشرده خارج کنید.
2. برنامه دمو را بسازید و اجرا کنید.
3. برنامه مانیتور را اجرا کنید.
4. ساخت انتشار ایجاد کنید.
5. نسخه انتشار را اجرا کنید.
6. نمودارها را در کنسول Google Play مشاهده کنید.

برنامه دمو را بسازید و اجرا کنید

برنامه آزمایشی APT Insights را در Android Studio اجرا کنید تا مطمئن شوید همه چیز به درستی ساخته شده است. این پروژه از CMake برای ساخت کد بومی استفاده می کند و نحوه استفاده از فایل gamesdk.cmake را نشان می دهد که ساده ترین راه برای شروع است.

برای اجرای برنامه دمو موارد زیر را انجام دهید:

1. محتویات فایل .zip را در یک پوشه استخراج کنید.
2. اندروید استودیو را باز کنید.
3. روی File > Open کلیک کنید و gamesdk/samples/tuningfork/insightsdemo/build.gradle را انتخاب کنید.
4. منتظر بمانید تا Android Studio پروژه را همگام کند.
5. برای اجرای نمونه، یک دستگاه را وصل کنید (یا یک دستگاه مجازی ایجاد کنید ). گزینه های توسعه دهنده و اشکال زدایی USB را در دستگاه فعال کنید.

6. دستگاه مورد نظر را انتخاب کرده و روی Run کلیک کنید . برای اطلاعات بیشتر، به ساخت و اجرای برنامه خود مراجعه کنید.

   

   شکل 1. اجرای موفقیت آمیز برنامه را آزمایش کنید

7. APK نمونه باید روی دستگاه مورد نظر ساخته و نصب شود. اگر با خطا مواجه شدید، موارد زیر را بررسی کنید:

   • شما یک نسخه پشتیبانی شده از Android SDK دارید. برای اطلاعات بیشتر به قسمت compileSdkVersion در فایل build.gradle ماژول برنامه مراجعه کنید. می‌توانید نسخه SDK را از تب Platforms SDK در مدیر SDK به‌روزرسانی کنید.
   • شما یک نسخه پشتیبانی شده از Android NDK دارید. برای اطلاعات بیشتر به قسمت ndkVersion در فایل build.gradle ماژول برنامه مراجعه کنید. می توانید نسخه خاصی از NDK را از تب ابزار SDK در مدیر SDK نصب کنید.
   • فایل local.properties در پروژه ورودی برای ndk.dir ندارد . این مکان توسط Android Studio مشخص شده و از نسخه NDK از بالا استفاده می کند. اگر این ورودی را دارید، کل خط را پاک کنید.
   • پس از هر تغییری در تنظیمات ساخت، پروژه را تمیز کنید ( Build > Clean Project ) و پروژه های C++ پیوند داده شده را بازخوانی کنید ( Build > Refresh Linked C++ Projects ).

برنامه مانیتور را اجرا کنید

با ساخت اشکال‌زدایی برنامه آزمایشی یا هر برنامه دیگری که Tuning Fork را فعال می‌کند، می‌توانید برنامه را برای ارسال و دریافت داده‌ها از نقطه پایانی محلی به جای سرور Google Play پیکربندی کنید. برای انجام این کار، endpoint_uri_override را در تنظیمات Tuning Fork تنظیم کنید:

#ifndef NDEBUG
   settings.endpoint_uri_override = "http://localhost:9000";
#endif

همچنین باید مجوزهای زیر را در فایل AndroidManifest.xml قرار دهید:

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

برنامه آزمایشی قبلاً این تغییرات را دارد (به insightsdemo.cpp مراجعه کنید).

می‌توانید از این ویژگی برای تأیید اینکه یک برنامه داده‌های مناسب را ارسال و دریافت می‌کند استفاده کنید. برای تأیید این موضوع، برنامه آزمایشی و برنامه Tuning Fork Monitor را همزمان اجرا کنید. این برنامه مانیتورینگ به عنوان یک سرور محلی عمل می کند و داده هایی را که یک برنامه با قابلیت Tuning Fork تولید می کند را نمایش می دهد.

برای اجرای همزمان برنامه مانیتورینگ و برنامه آزمایشی و تأیید اینکه برنامه آزمایشی به درستی کار می کند، موارد زیر را انجام دهید:

1. APK برنامه Tuning Fork Monitor را با استفاده از adb روی دستگاه مورد نظر نصب کنید:

   adb install gamesdk/gamesdk/apks/tools/TuningForkMonitor.apk
   

2. برنامه مانیتورینگ را باز کنید.
3. دکمه Android Home را فشار دهید تا برنامه Tuning Fork Monitor به پس‌زمینه دستگاه ارسال شود.
4. برنامه دمو را دوباره در پیش زمینه حدود 30 ثانیه اجرا کنید .
5. به برنامه Tuning Fork Monitor برگردید.
6. برنامه آزمایشی در زیر برنامه های کاربردی زنده به عنوان com.tuningfork.insightsdemo 16 ظاهر می شود. برای مشاهده جزئیات برنامه و تله متری زنده روی این ورودی ضربه بزنید.

شکل 2. برنامه مانیتور برنامه آزمایشی را شناسایی می کند

شکل 3. برنامه مانیتور داده ها را از برنامه آزمایشی نمایش می دهد

ساخت انتشار ایجاد کنید

یک نسخه انتشاری از برنامه آزمایشی در Android Studio ایجاد کنید. برای فعال کردن نمودارهای زمان بندی فریم در Android Vitals، این ساخت را در کنسول Google Play آپلود می کنید.

1. API پارامترهای عملکرد Android را در Google Cloud Console فعال کنید . این API برنامه را قادر می سازد تا با Google Play ارتباط برقرار کند. لازم نیست کلید API را برای برنامه آزمایشی محدود کنید.

2. مطمئن شوید که کلید API خود را از مرحله قبل در قسمت api_key در gamesdk/samples/tuningfork/insightsdemo/app/src/main/assets/tuningfork/tuningfork_settings.txt کپی کنید.

3. شناسه برنامه برنامه آزمایشی رزرو شده است، بنابراین نمی توان APK را که از آن استفاده می کند بارگذاری کرد. این شناسه را در فایل build.gradle برنامه تغییر دهید:

   applicationId "com.tuningfork.your-unique-identifier"
   

4. پروژه را پاک کنید ( Build > Clean Project ) و پروژه های C++ پیوند داده شده را بازخوانی کنید ( Build > Refresh Linked C++ Projects ).

5. یک پیکربندی امضا برای بیلدهای انتشار ایجاد کنید.

   1. File > Project Structure > Modules را انتخاب کنید.
   2. تب Signing Configs را انتخاب کنید.
   3. یک پیکربندی جدید به نام release اضافه کنید.
   4. یک فروشگاه کلید برای پیکربندی ایجاد کنید .

6. پیکربندی امضای انتشار را با نوع ساخت نسخه مرتبط کنید.

   1. File > Project Structure > Build Variants را انتخاب کنید.
   2. تب Build Types را انتخاب کنید.
   3. نوع ساخت با نام release انتخاب کنید.
   4. در کادر Signing Config ، متغیر پیکربندی انتشار را انتخاب کنید.

7. در پنجره پروژه Android Studio، فهرست برنامه را انتخاب کنید. (این انتخاب انتخاب منو را در مرحله بعد فعال می کند.)

8. نوع ساخت فعال را به release تغییر دهید ( Build > Select Build Variant ).

9. Build > Build Bundles/APK(s) > Build APK(s) را انتخاب کنید. پس از تکمیل ساخت، روی پیوند مکان یابی کلیک کنید تا APK انتشار را پیدا کنید.

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

11. APK انتشار را در مسیر آزمایشی داخلی آپلود کنید. برای اطلاعات بیشتر، به تهیه و عرضه نسخه‌ها مراجعه کنید.

    توجه: باید APK را در یک مسیر آزمایشی داخلی در Google Play آپلود کنید. اگر این کار را نکنید، فیلترهای حریم خصوصی مانع از نمایش نمودار مرتبط می شوند.

نسخه انتشار را اجرا کنید

دستگاه مورد نظر را انتخاب کرده و روی Run کلیک کنید . باید از همان نسخه APK استفاده کنید که در کنسول Google Play آپلود کردید.

اجازه دهید برنامه آزمایشی برای مدتی اجرا شود. ممکن است 30 دقیقه طول بکشد تا کنسول Google Play شروع به نمایش داده ها کند. با انتخاب سطح گزارش اطلاعات در پنجره Logcat ، بررسی کنید که داده ها در سرور بارگذاری می شوند. اگر خطاهایی در گزارش مشاهده کردید، به عیب‌یابی خطاهای رایج مراجعه کنید.

... I/TuningFork:Web: Connecting to:
    https://performanceparameters.googleapis.com/v1/applications/com.tuningfork.yourapp/apks/24:uploadTelemetry
... I/TuningFork: Scene loading 30 (true) took 166 ms
... I/TuningFork:Web: Response code: 200
... I/TuningFork:Web: Response message: OK
... I/TuningFork.GE: UPLOAD request returned 200 {}

توجه: مطمئن شوید که نسخه ساخت نسخه را اجرا کنید وگرنه داده‌ها در کنسول Google Play آپلود نمی‌شوند.

نمودارها را در کنسول Google Play مشاهده کنید

کنسول Google Play را باز کنید و برنامه آزمایشی را انتخاب کنید. Android Vitals > Performance > Insights را انتخاب کنید تا نمودار زمان فریم را ببینید.

شکل 4. نمودار حیاتی اندروید

شما با موفقیت یک تست سرتاسری را با کتابخانه Tuning Fork اجرا کرده اید. می‌توانید پروژه برنامه آزمایشی را در کنسول Google Play حذف کنید، زیرا دیگر به آن نیازی نیست.