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

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

צעדים

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

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

איך יוצרים ומריצים את אפליקציית ההדגמה

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

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

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

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

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

  6. חבילת ה-APK לדוגמה אמורה להיבנות ולהיות מותקנת במכשיר היעד. אם נתקלתם בשגיאות, כדאי לבדוק את הדברים הבאים:

    • יש לך גרסה נתמכת של Android SDK. מידע נוסף מופיע בשדה compileSdkVersion בקובץ build.gradle של מודול האפליקציה. אפשר לעדכן את גרסת ה-SDK בכרטיסייה SDK Platforms ב-SDK Manager.
    • יש לכם גרסה נתמכת של Android NDK. מידע נוסף זמין בשדה ndkVersion בקובץ build.gradle של מודול האפליקציה. אפשר להתקין גרסה ספציפית של NDK מהכרטיסייה SDK Tools ב-SDK Manager.
    • בקובץ local.properties בפרויקט לא מופיעה רשומה של ndk.dir. המיקום הזה מצוין על ידי Android Studio ומשתמש בגרסת NDK שצוינה למעלה. אם הרשומה הזו מופיעה, צריך למחוק את כל השורה.
    • אחרי כל שינוי בהגדרות ה-Build, צריך לנקות את הפרויקט (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 כדי להעביר את אפליקציית Tuning Fork Monitor לרקע במכשיר.
  4. מריצים שוב את אפליקציית ההדגמה בחזית למשך כ-30 שניות.
  5. חוזרים לאפליקציית Tuning Fork Monitor.
  6. אפליקציית ההדגמה מופיעה בקטע Live Applications בתור 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 > Clean Project) ומרעננים את פרויקטי C++‎ המקושרים (Build > Refresh Linked C++ Projects).

  5. יוצרים הגדרת חתימה לגרסאות של אפליקציות שמוכנות להפצה.

    1. בוחרים באפשרות File > Project Structure > Modules (קובץ > מבנה הפרויקט > מודולים).
    2. בוחרים בכרטיסייה הגדרות חתימה.
    3. מוסיפים הגדרה חדשה בשם release.
    4. יוצרים מאגר מפתחות להגדרה.

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

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

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

  8. משנים את וריאנט ה-Build הפעיל ל-release (Build > Select Build Variant).

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

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

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

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

בוחרים את מכשיר היעד ולוחצים על הפעלה כפתור ההפעלה ב-Android Studio. חובה להשתמש באותו קובץ 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 {}

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

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

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

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

הקודם
מידע על Android Performance Tur (טיונר)
הבא
הפעלת Android Performance Parameters API