تشغيل التطبيق التجريبي

توضح هذه الصفحة كيفية إجراء اختبار شامل باستخدام تطبيق تجريبي Google Play Console

الخطوات

لتنزيل حزمة تطوير البرامج (SDK)، يجب تشغيل التطبيق التجريبي والتحقّق من عمل التطبيق بشكل صحيح للاطّلاع على معلومات توقيت عرض الإطار من التطبيق في Google Play Console التالي:

1. نزِّل ملف .zip لحزمة تطوير البرامج (SDK)، ثم فُكِّ ضغطه.
2. إنشاء التطبيق التجريبي وتشغيله.
3. شغِّل تطبيق المراقبة.
4. أنشئ بنية إصدار.
5. يمكنك تشغيل إصدار الإصدار.
6. يمكنك عرض الرسومات البيانية في Google Play Console.

إنشاء التطبيق التجريبي وتشغيله

يمكنك تشغيل تطبيق APT Insights Demo في "استوديو Android" للتأكّد من تنفيذ كل الإجراءات. يتم بناؤه بشكل صحيح. يستخدم هذا المشروع أداة CMake لإنشاء رموز برمجية أصلية ويوضح كيفية لاستخدام ملف gamesdk.cmake، فهو أسهل طريقة للبدء.

لتشغيل التطبيق التجريبي، اتّبِع الخطوات التالية:

1. استخرِج محتوى ملف ZIP .إلى مجلد.
2. افتح "استوديو Android".
3. انقر على ملف > فتح واختيار gamesdk/samples/tuningfork/insightsdemo/build.gradle
4. انتظِر إلى أن تتم مزامنة المشروع في "استوديو Android".
5. ربط جهاز (أو إنشاء جهاز افتراضي) لتشغيل العينة. تفعيل خيارات المطوّرين وتصحيح أخطاء الجهاز عبر USB الجهاز.

6. اختَر الجهاز المستهدَف وانقر على تشغيل لمزيد من المعلومات، يُرجى الاطّلاع على مقالة إنشاء تطبيقك وتشغيله.

   

   الشكل 1. جارٍ تشغيل التطبيق التجريبي بنجاح

7. يجب إنشاء نموذج حزمة APK وتثبيته على الجهاز المستهدَف. إذا كنت من الأخطاء، فتحقق مما يلي:

   • لديك إصدار متوافق من نظام Android حزمة تطوير البرامج (SDK) اطّلع على الحقل compileSdkVersion في وحدة التطبيق build.gradle للحصول على مزيد من المعلومات. يمكنك تحديث إصدار حزمة تطوير البرامج (SDK) من علامة التبويب منصّات حِزم SDK في "أداة إدارة حِزم تطوير البرامج (SDK)".
   • لديك إصدار متوافق من نظام Android NDK؛ عرض الحقل ndkVersion في ملف build.gradle لوحدة التطبيق لمزيد من المعلومات. يمكنك تثبيت إصدار محدّد من NDK من علامة التبويب أدوات حِزم تطوير البرامج (SDK) في "أداة إدارة حِزم SDK".
   • لا يحتوي ملف local.properties في المشروع على إدخال ndk.dir يتم تحديد هذا الموقع بواسطة Android Studio ويستخدم NDK من أعلى. إذا كان لديك هذا الإدخال، عليك محو السطر بالكامل.
   • بعد أي تغيير في إعداد الإصدار، عليك تنظيف المشروع (إنشاء > تنظيف المشروع المشروع) وأعد تحميل مشاريع C++ المرتبطة (إنشاء > تحديث المرتبط مشاريع C++).

تشغيل تطبيق المراقبة

من خلال إصدار تصحيح الأخطاء من التطبيق التجريبي أو أي تطبيق آخر متوافق مع "الشوكة الرنانة"، يمكنك ضبط التطبيق لإرسال البيانات واستلامها من نقطة نهاية محلية بدلاً من مقارنةً بخادم Google Play. لإجراء ذلك، يجب ضبط endpoint_uri_override في إعدادات الشوكة الرنانة:

#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 على في نفس الوقت. يعمل تطبيق المراقبة هذا كخادم محلي ويعرض البيانات. التي ينتجها التطبيق المتوافق مع "الشوكة الرنانة".

تشغيل تطبيق المراقبة والتطبيق التجريبي في الوقت نفسه للتحقق من أنّ العرض التوضيحي التطبيق يعمل بشكل صحيح، فقم بما يلي:

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". أنت تحمّل هذا الإصدار إلى Google Play Console لتفعيل الرسوم البيانية لتوقيت عرض الإطارات في "مؤشرات Android الحيوية".

1. تفعيل واجهة برمجة التطبيقات Android Performance Integrations API في Google Cloud Console. تتيح واجهة برمجة التطبيقات هذه للتطبيق التواصل مع Google Play. لا تحتاج إلى تقييد مفتاح واجهة برمجة التطبيقات للتطبيق التجريبي.

2. احرِص على نسخ مفتاح واجهة برمجة التطبيقات من الخطوة السابقة إلى 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. نظِّف المشروع (إنشاء > مشروع نظيف) وأعِد تحميل ملف C++ المرتبط. (إنشاء > تحديث مشاريع C++ المرتبطة).

5. يمكنك إنشاء إعدادات توقيع خاصة بإصدارات الإصدارات.

   1. حدد ملف > هيكل المشروع > الوحدات:
   2. اختَر علامة التبويب إعدادات التوقيع.
   3. أضِف إعدادًا جديدًا باسم release.
   4. إنشاء ملف تخزين مفاتيح التكوين.

6. يمكنك ربط إعدادات توقيع الإصدار بنسخة الإصدار.

   1. حدد ملف > هيكل المشروع > صيغ الإصدارات:
   2. اختَر علامة التبويب أنواع التصميم.
   3. اختَر نوع الإصدار المُسمى "release".
   4. في مربّع إعدادات التوقيع، اختَر إعدادات الإصدار. المتغير.

7. في نافذة المشروع على "استوديو Android"، اختَر دليل التطبيق. (هذه تحديد القائمة إلى تمكين تحديد القائمة في الخطوة التالية).

8. تغيير صيغة الإصدار النشط إلى release (إنشاء > اختيار إصدار خيار المنتج).

9. اختَر إنشاء > إنشاء حِزم/حِزم APK > إنشاء حِزم APK: عند إنشاء انقر على رابط locate للعثور على حزمة APK للإصدار.

10. أنشِئ تطبيقًا جديدًا للتطبيق التجريبي في Google Play Console. بالنسبة مزيد من المعلومات، راجع حمِّل التطبيق.

11. حمِّل حِزمة APK للإصدار على مسار الاختبار الداخلي. لمزيد من المعلومات الرؤية الإعداد إصدارات جديدة.

    ملاحظة: يجب تحميل حزمة APK إلى مسار اختبار داخلي على Google Play. في حال حذف وإذا لم تفعل ذلك، تحظر فلاتر الخصوصية ظهور الرسم البياني المرتبط.

تشغيل إصدار الإصدار

اختَر الجهاز المستهدَف وانقر على تشغيل يجب استخدام حِزمة APK نفسها التي حمّلتها إلى الإصدار. Google Play Console

دع التطبيق التجريبي يعمل لفترة. قد تستغرق Google ما يصل إلى 30 دقيقة Play Console لبدء عرض البيانات. التحقق من أن البيانات يتم تحميلها إلى الخادم عن طريق اختيار مستوى سجلّ المعلومات في نافذة 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 Console

عرض الرسوم البيانية في Google Play Console

افتح Google Play Console واختَر التطبيق التجريبي. اختَر Android المؤشرات الحيوية > الأداء > الإحصاءات للاطّلاع على الرسم البياني لوقت عرض اللقطة.

الشكل 4. الرسم البياني لمؤشرات Android الحيوية

تم إجراء اختبار شامل بنجاح باستخدام "الشوكة الرنانة". المكتبة. يمكنك حذف مشروع التطبيق التجريبي في Google Play Console لأنّه لم يعد هناك حاجة إليه.