הפעלת אפליקציית ההדגמה

הדף הזה מתאר איך להריץ בדיקה מקצה לקצה באמצעות אפליקציית הדגמה Google Play Console.

צעדים

כדי להוריד את ה-SDK, מריצים את אפליקציית ההדגמה, מוודאים שהאפליקציה פועלת בצורה תקינה וכן להציג מידע על תזמון הפריימים מהאפליקציה ב-Google Play Console, הבאים:

1. מורידים את קובץ ה-ZIP של ה-SDK ומחלצים את תוכן ה-ZIP.
2. יוצרים ומפעילים את אפליקציית ההדגמה.
3. מפעילים את אפליקציית המעקב.
4. יוצרים build של גרסה.
5. מריצים את גרסת ה-build של הגרסה.
6. אפשר לצפות בתרשימים ב-Google Play Console.

יצירה והפעלה של אפליקציית ההדגמה

הפעילו את אפליקציית APT Insights להדגמה ב-Android Studio כדי לוודא שהכול תקין נוצר בצורה נכונה. בפרויקט הזה אנחנו משתמשים ב-CMake לצורך פיתוח קוד נייטיב, ומראים איך להשתמש בקובץ gamesdk.cmake, זו הדרך הקלה ביותר להתחיל.

כדי להפעיל את אפליקציית ההדגמה:

1. מחלצים את התוכן של קובץ ה-ZIP לתיקייה.
2. פותחים את Android Studio.
3. לוחצים על קובץ > פתיחה ובחירה gamesdk/samples/tuningfork/insightsdemo/build.gradle.
4. ממתינים עד ש-Android Studio יסנכרן את הפרויקט.
5. חיבור מכשיר (או יצירת מכשיר וירטואלי) כדי להריץ את הדוגמה. אפשר אפשרויות למפתחים וניפוי באגים ב-USB מופעלים במכשיר.

6. בוחרים את מכשיר היעד ולוחצים על הפעלה. . מידע נוסף זמין במאמר יצירה והפעלה של אפליקציה.

   

   איור 1. אפליקציית הבדיקה פועלת בהצלחה

7. גרסת ה-APK לדוגמה צריכה להיווצר ולהתקין במכשיר היעד. אם אם נתקלים בשגיאות, צריך לבדוק את הדברים הבאים:

   • במכשיר מותקנת גרסה נתמכת של מכשיר Android. SDK; רואים את השדה compileSdkVersion במודול האפליקציה build.gradle לקבלת מידע נוסף. אפשר לעדכן את גרסת ה-SDK SDK Platforms (פלטפורמות SDK) ב-SDK Manager.
   • במכשיר מותקנת גרסה נתמכת של מכשיר Android. NDK; לראות את השדה ndkVersion בקובץ של מודול האפליקציה build.gradle. אפשר לקבל מידע נוסף. אפשר להתקין גרסה ספציפית של ה-NDK מהכרטיסייה SDK Tools ב-SDK Manager.
   • לקובץ local.properties בפרויקט אין רשומה עבור ndk.dir המיקום הזה צוין על ידי Android Studio והוא משתמש ב-NDK שלמעלה. אם יש לכם את הרשומה הזו, צריך למחוק את השורה כולה.
   • אחרי שמבצעים שינויים בהגדרת ה-build, מנקים את הפרויקט (Build > ניקוי) פרויקט), ומרעננים את הפרויקטים המקושרים של C++ (פיתוח > רענון מקושרים) פרויקטים של C++).

הפעלה של אפליקציית המעקב

באמצעות גרסת build לניפוי באגים של אפליקציית ההדגמה או כל אפליקציה אחרת שתומכת ב-Tuning Fork, אפשר להגדיר שהאפליקציה תשלח ולקבל נתונים מנקודת קצה מקומית מאשר בשרת של Google Play. כדי לעשות את זה, צריך להגדיר את endpoint_uri_override ההגדרות של Tuning Fork:

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

צריך לכלול גם את ההרשאות הבאות בAndroidManifest.xml file:

<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 כדי לשלוח את האפליקציה Tuning Fork Monitor את הרקע במכשיר.
4. מריצים את אפליקציית ההדגמה שוב בחזית למשך כ-30 שניות שניות.
5. חוזרים לאפליקציה Tuning Fork Monitor.
6. אפליקציית ההדגמה מופיעה בקטע אפליקציות בשידור חי בשם com.tuningfork.insightsdemo 16. צריך להקיש על הרשומה הזו כדי לראות את פרטי האפליקציה ולהציג אותה בזמן אמת טלמטריה.

איור 2. אפליקציית המעקב מזהה את אפליקציית ההדגמה

איור 3. אפליקציית המעקב מציגה נתונים מאפליקציית ההדגמה

יצירת build של גרסה

יוצרים גרסת build להפצה של אפליקציית ההדגמה ב-Android Studio. העלאת ה-build הזה ל-Google Play Console כדי להפעיל תרשימים של תזמון פריימים ב-Android Vitals.

1. הפעלת ה-Android Performance Parameters API במסוף Google Cloud. ה-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 > ניקוי פרויקט) ומרעננים את הקובץ C++ המקושר. פרויקטים (Build > הרענון של C++ פרויקטים מקושרים)).

5. יצירת הגדרת חתימה לגרסאות build של גרסאות.

   1. בוחרים באפשרות קובץ > מבנה הפרויקט > מודולים
   2. בוחרים את הכרטיסייה Signing Configs.
   3. מוסיפים מערך הגדרות אישיות חדש בשם release.
   4. ליצור מאגר מפתחות בשביל הגדרה אישית.

6. משייכים את ההגדרות של חתימת הגרסה לווריאנט של גרסת ה-build של הגרסה.

   1. בוחרים באפשרות קובץ > מבנה הפרויקט > יוצרים וריאציות.
   2. לוחצים על הכרטיסייה סוגי Build.
   3. בוחרים את סוג ה-build בשם release.
   4. בתיבה Signing Config, בוחרים את הגדרת הגרסה מותאם אישית.

7. בחלון של פרויקט Android Studio, בוחרים את ספריית האפליקציות. (ה בחירה באפשרות הזו מפעילה את בחירת התפריט בשלב הבא).

8. צריך לשנות את גרסת ה-build הפעילה ל-release (Build > בחירת Build) וריאציה).

9. בוחרים באפשרות Build > (בנייה >) בניית חבילות/חבילות APK > בניית חבילות APK. כשגרסת ה-build לוחצים על הקישור איתור כדי למצוא את גרסת ה-APK.

10. אפשר ליצור אפליקציה חדשה לאפליקציית ההדגמה ב-Google Play Console. עבור מידע נוסף: מעלים אפליקציה.

11. מעלים את ה-APK של הגרסה אל מסלול הבדיקה הפנימי. לקבלת מידע נוסף, לראות הכנה להשיק גרסאות.

    הערה: צריך להעלות את ה-APK למסלול בדיקה פנימי ב-Google Play. אם המיקום אין לכם הרשאות כאלה, מסנני הפרטיות חוסמים את הצגת התרשים המשויך.

הפעלת ה-build של הגרסה

בוחרים את מכשיר היעד ולוחצים על הפעלה. . עליך להשתמש באותה APK להפצה שהעלית אל Google Play Console.

כדאי לחכות קצת עם אפליקציית ההדגמה. עשויות לחלוף עד 30 דקות עד שבדיקת Google Play Console כדי להתחיל להציג נתונים. צריך להקפיד להעלות נתונים השרת על ידי בחירה ברמת היומן Info בחלון 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 {}

הערה: חשוב לוודא שמפעילים את וריאנט ה-build של הגרסה, אחרת נתונים לא יועלו אל ה-Google Play Console.

לצפייה בתרשימים ב-Google Play Console

פותחים את Google Play Console ובוחרים את אפליקציית הבדיקה. בוחרים באפשרות Android תפקוד האפליקציה > ביצועים > תובנות כדי לראות את התרשים של זמן רינדור הפריים.

איור 4. תרשים תפקוד האפליקציה

הרצת בהצלחה בדיקה מקצה לקצה עם Tuning Fork לספרייה. אפשר למחוק את פרויקט אפליקציית הבדיקה ב-Google Play Console, אינה נחוצה יותר.