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

توضّح هذه الصفحة كيفية إجراء اختبار شامل باستخدام تطبيق تجريبي و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. اختيار الجهاز المستهدف والنقر على Run (تشغيل) للحصول على مزيد من المعلومات، يُرجى الاطّلاع على إنشاء تطبيقك وتشغيله.

   

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

   • لديك إصدار متوافق من حزمة تطوير البرامج (SDK) لنظام التشغيل Android، يُرجى الاطّلاع على حقل 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 لإرسال تطبيق Tuning Fork Monitor إلى الخلفية على الجهاز.
4. شغِّل التطبيق التجريبي مرة أخرى في المقدّمة لمدة 30 ثانية تقريبًا.
5. انتقِل مرة أخرى إلى تطبيق Tuning Fork Monitor.
6. يظهر التطبيق التجريبي ضمن التطبيقات المباشرة باسم com.tuningfork.insightsdemo 16. انقر على هذا الإدخال لعرض تفاصيل التطبيق والقياس عن بُعد المباشر.

إنشاء بنية إصدار

يمكنك إنشاء إصدار من التطبيق التجريبي في "استوديو Android". ويمكنك تحميل هذا الإصدار إلى Google Play Console لتفعيل الرسوم البيانية لتوقيت عرض الإطارات في "مؤشرات Android الحيوية".

1. فعِّل Android Performance Parameters 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 > إنشاء حِزم APK. عند اكتمال الإصدار، انقر على الرابط تحديد الموقع للعثور على حزمة APK للإصدار.

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

11. حمِّل حِزمة APK للإصدار إلى قناة الاختبار الداخلي. لمزيد من المعلومات، يمكنك الاطّلاع على إعداد الإصدارات وطرحها.

تنفيذ إصدار الإصدار

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

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

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

لقد أجريتَ اختبارًا شاملاً بنجاح باستخدام مكتبة Tuning Fork. يمكنك حذف مشروع التطبيق التجريبي في Google Play Console، لأنّه لم يعُد ضروريًا.