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

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

   

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

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

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

باستخدام إصدار تصحيح الأخطاء للتطبيق التجريبي أو أي تطبيق آخر يفعّل ميزة Tuning Fork، يمكنك إعداد التطبيق لإرسال البيانات وتلقّيها من نقطة نهاية محلية بدلاً من خادم 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 لإرسال تطبيق "Tunning 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.

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

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

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

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

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

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

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