מורידים את הפלאגין ממאגר GitHub. בוחרים באפשרות .unitypackage להורדת הקובץ.
ייבוא הפלאגין
לפני שמייבאים את הפלאגין, צריך לוודא שהפרויקט משתמש בגרסה 4 .6 של .NET.
ההמלצה הזו רלוונטית ל-Unity בגרסה 2018.4 ומטה (בגרסאות מאוחרות יותר של Unity יש רק .NET בגרסה 4.6).
בוחרים באפשרות קובץ > הגדרות בנייה. מוודאים ש-Android נבחרה כפלטפורמה הנוכחית.
לוחצים על הלחצן הגדרות הנגן.
בקטע Other Settings (הגדרות אחרות), מחפשים את Scripting Runtime Version (גרסת זמן הריצה של הסקריפט) ובוחרים באפשרות .NET 4.6.
Android Performance Tuner בגרסה 1.5.1 ואילך עם Unity 2017
כדי להשתמש ב-Android Performance Tuner בגרסה 1.5.1 ואילך עם Unity 2017, צריך לבצע את השלבים הנוספים הבאים כשמייבאים את הפלאגין:
עוברים לתיקייה Assets/AndroidPerformanceTuner/Editor.
לוחצים על הקובץ Google.Android.PerformanceTuner.Editor כדי לפתוח אותו בכלי הבדיקה.
לוחצים על הפניה החסרה לאוסף ואז על - כדי להסיר אותה.
לוחצים על הלחצן החלה.
איור 1. חסרה הפניה לאוסף.
עוברים לתיקייה Assets/AndroidPerformanceTuner/Runtime.
לוחצים על הקובץ Google.Android.PerformanceTuner כדי לפתוח אותו בכלי Inspector.
חוזרים על שלב 3 כדי להסיר את שני ההפניות החסרות לאסמבלי.
מפעילים מחדש את Unity.
עוברים אל Window > AndroidPerformanceTuner > Setup ומוודאים שלא מוצגות שגיאות.
ייבוא מחדש של הפלאגין אחרי המחיקה
אם מייבאים מחדש את הפלאגין אחרי שמסירים אותו מהפרויקט, צריך קודם להסיר את ANDROID_PERFORMANCE_TUNER_UTILITIES מPlayer Settings > Scripting Define Symbols.
הגדרת הפלאגין
כדי להגדיר את הפלאגין:
לגרסה 2019.3.14 ואילך של Unity:
מפעילים את הספרייה Android Frame Pacing. הכלי Android Performance Tuner ישתמש בספרייה הזו כדי למדוד את הביצועים של המשחק, כולל מדדים מעמיקים יותר מאלה ש-Unity מדווחת עליהם לבד.
בוחרים באפשרות File > Build Settings (קובץ > הגדרות בנייה) ולוחצים על הלחצן Player Settings (הגדרות נגן).
בקטע Resolution and Presentation (רזולוציה והצגה), מסמנים את התיבה Optimized Frame Pacing (קצב פריימים אופטימלי).
מסנכרנים את עיבוד המסגרת עם קטעים אנכיים ריקים.
בהגדרות הנגן, בוחרים בכרטיסייה איכות ומחפשים את התפריט VSync Count. בוחרים באפשרות כלשהי (חוץ מלא לסנכרן).
בחירה באפשרות אחרת מלבד Don't Sync מאפשרת מדידות מדויקות יותר בשילוב עם ספריית Android Frame Pacing.
(בגרסאות של Unity מלפני 2019) מגדירים את מערכת ה-Build ל-Gradle. בוחרים באפשרות File > Build Settings (קובץ > הגדרות בנייה). מחפשים את Build System ובוחרים באפשרות Gradle.
מוסיפים את הרשאת הגישה לאינטרנט. בקטע הגדרות אחרות, מחפשים את האפשרות גישה לאינטרנט ובוחרים באפשרות נדרשת.
מזינים את מפתח ה-API. אחרי שמתקינים את הפלאגין, אפשר להיכנס אליו דרך התפריט Window > Android Performance Tuner > Setup (חלון > כלי לשיפור הביצועים של Android > הגדרה). בתיבת הדו-שיח הזו, בוחרים בכרטיסייה Settings ומזינים את מפתח ה-API מהפרויקט ב-Google Cloud בשדה API key.
דוגמאות התוכן והקוד שבדף הזה כפופות לרישיונות המפורטים בקטע רישיון לתוכן. Java ו-OpenJDK הם סימנים מסחריים או סימנים מסחריים רשומים של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-08-26 (שעון UTC).
[null,null,["עדכון אחרון: 2025-08-26 (שעון UTC)."],[],[],null,["This page describes how to download, import, and configure the Unity plugin for\nAndroid Performance Tuner.\n\nRequirements\n\nTo use the plugin in your game, use a supported version of Unity:\n\n- Unity version 2017.4 or later and [.NET version 4.6](https://dotnet.microsoft.com/download/dotnet-framework/net46)\n- To use APK Expansion files, Unity 2018.2 is required\n- For improved frame pacing and GPU measurements, Unity version 2019.3.14 or later is required\n- For Addressables scenes support, Unity 2019.3 or later and [Addressables package 1.19.4](https://docs.unity3d.com/Packages/com.unity.addressables@0.8/manual/index.html) or later are required.\n\nDownload the plugin\n\nDownload the plugin from the\n[GitHub repository](https://github.com/android/tuningfork/releases). Select the\n`.unitypackage` file download.\n\nImport the plugin\n\nBefore importing the plugin, make sure your project is using .NET version 4.6.\nThis applies to Unity version 2018.4 and earlier (later versions of Unity\ncontain .NET version 4.6 only).\n\n1. Select **File \\\u003e Build Settings**. Make sure Android is selected as the current platform.\n2. Click the **Player Settings** button.\n3. Under **Other Settings** , find **Scripting Runtime Version** and select **.NET 4.6**.\n\nThe plugin is provided as a Unity Package that you can import in your project.\nSelect **Assets \\\u003e Import Package \\\u003e Custom Package** and select the\n`.unitypackage` file you downloaded.\n\nAndroid Performance Tuner version **1.5.1 or higher** with **Unity 2017**\n\nUsing Android Performance Tuner version **1.5.1 or higher** with **Unity 2017**\nrequires the following additional steps when importing the plugin:\n\n1. Go to the **Assets/AndroidPerformanceTuner/Editor** folder.\n2. Click the **Google.Android.PerformanceTuner.Editor** file to open it in the **Inspector**.\n3. Click the missing assembly reference and then click **-** to remove it.\n4. Click the **Apply** button.\n\n\n **Figure 1.** Missing assembly reference.\n5. Go to the **Assets/AndroidPerformanceTuner/Runtime** folder.\n\n6. Click the **Google.Android.PerformanceTuner** file to open it in the\n Inspector.\n\n7. Repeat **step 3** to remove the two missing assembly references.\n\n8. Restart Unity.\n\n9. Go to **Window \\\u003e AndroidPerformanceTuner \\\u003e Setup** and verify that no errors\n are displayed.\n\nRe-importing the plugin after deletion\n\nIf you're re-importing the plugin after removing it from the project, remove\n`ANDROID_PERFORMANCE_TUNER_UTILITIES` from\n**Player Settings \\\u003e Scripting Define Symbols** first.\n\nConfigure the plugin\n\nTo configure the plugin, do the following:\n\n1. For Unity version 2019.3.14 or later:\n\n - Enable the Android Frame Pacing library. Android Performance Tuner will use\n this library to measure the performance of your game, including more\n in-depth measures than what Unity alone reports.\n\n Select **File \\\u003e Build Settings** and click the **Player Settings** button.\n Under **Resolution and Presentation** , select the **Optimized Frame Pacing**\n checkbox.\n - Synchronize the frame rendering with vertical blanks.\n\n From the Player Settings, select the **Quality** tab and find the\n **VSync Count** menu. Use any selection (except **Don't Sync** ).\n Selections other than **Don't Sync** enable more precise measurements in\n conjunction with the Android Frame Pacing library.\n2. (For versions of Unity prior to 2019) Set the build system to Gradle. Select\n **File \\\u003e Build Settings** . Find **Build System** and select **Gradle**.\n\n3. Add the internet access permission. Under **Other Settings** , find\n **Internet Access** and select **Require**.\n\n4. Enter your API key. Once the plugin is installed, you can enter it from the\n **Window \\\u003e Android Performance Tuner \\\u003e Setup** menu. On this dialog, select the\n **Settings** tab and enter the\n [API key from your Google Cloud project](/games/sdk/performance-tuner/unity/enable-api)\n into the **API key** field.\n\n | **Note:** If you don't enter your API key, Android Performance Tuner won't send your game performance data to the Google Play Console. Android Performance Tuner logs this error, and you can see the error using `adb logcat`. (You will run `adb logcat` in the next section to confirm the proper operation of Android Performance Tuner.)\n\n\n **Figure 2.** Settings tab in the plugin"]]
איור 1. חסרה הפניה לאוסף.
איור 2. הכרטיסייה 'הגדרות' בפלאגין