Per utilizzare i file di espansione APK, è necessario Unity 2018.2
Per una migliore spaziatura dei frame e misurazioni della GPU,
è necessaria la versione 2019.3.14 o successive di Unity.
Per il supporto delle scene Addressables, sono necessari Unity 2019.3 o versioni successive e Addressables package 1.19.4 o versioni successive.
Scarica il plug-in
Scarica il plug-in dal
repository GitHub. Seleziona il
download del file .unitypackage.
Importare il plug-in
Prima di importare il plug-in, assicurati che il progetto utilizzi .NET versione 4.6.
Ciò vale per Unity versione 2018.4 e precedenti (le versioni successive di Unity
contengono solo .NET versione 4.6).
Seleziona File > Impostazioni build. Assicurati che Android sia selezionato come
piattaforma attuale.
Fai clic sul pulsante Impostazioni del player.
In Altre impostazioni, trova Versione runtime scripting e seleziona
.NET 4.6.
Il plug-in viene fornito come pacchetto Unity che puoi importare nel tuo progetto.
Seleziona Assets > Import Package > Custom Package (Asset > Importa pacchetto > Pacchetto personalizzato) e seleziona il file
.unitypackage che hai scaricato.
Android Performance Tuner versione 1.5.1 o successive con Unity 2017
L'utilizzo di Android Performance Tuner versione 1.5.1 o successive con Unity 2017
richiede i seguenti passaggi aggiuntivi durante l'importazione del plug-in:
Vai alla cartella Assets/AndroidPerformanceTuner/Editor.
Fai clic sul file Google.Android.PerformanceTuner.Editor per aprirlo in
Inspector.
Fai clic sul riferimento all'assembly mancante e poi su - per rimuoverlo.
Fai clic sul pulsante Applica.
Figura 1. Riferimento all'assembly mancante.
Vai alla cartella Assets/AndroidPerformanceTuner/Runtime.
Fai clic sul file Google.Android.PerformanceTuner per aprirlo in
Inspector.
Ripeti il passaggio 3 per rimuovere i due riferimenti di assembly mancanti.
Riavvia Unity.
Vai a Window > AndroidPerformanceTuner > Setup e verifica che non vengano visualizzati errori.
Reimportazione del plug-in dopo l'eliminazione
Se stai reimportando il plug-in dopo averlo rimosso dal progetto, rimuovi
ANDROID_PERFORMANCE_TUNER_UTILITIES da
Impostazioni player > Simboli di definizione scripting.
Configurare il plug-in
Per configurare il plug-in:
Per Unity versione 2019.3.14 o successive:
Attiva la libreria Android Frame Pacing. Android Performance Tuner utilizzerà
questa libreria per misurare le prestazioni del tuo gioco, incluse misure più
approfondite rispetto a quelle riportate solo da Unity.
Seleziona File > Build Settings (Impostazioni build) e fai clic sul pulsante Player Settings (Impostazioni player).
Nella sezione Risoluzione e presentazione, seleziona la casella di controllo Ottimizzazione della cadenza dei fotogrammi.
Sincronizza il rendering dei fotogrammi con gli spazi verticali.
Nelle impostazioni del player, seleziona la scheda Qualità e trova il menu
Conteggio VSync. Utilizza una qualsiasi selezione (tranne Non sincronizzare).
Le selezioni diverse da Non sincronizzare consentono misurazioni più precise in
combinazione con la libreria Android Frame Pacing.
(Per le versioni di Unity precedenti al 2019) Imposta il sistema di compilazione su Gradle. Seleziona
File > Impostazioni build. Trova Sistema di compilazione e seleziona Gradle.
Aggiungi l'autorizzazione di accesso a internet. Nella sezione Altre impostazioni, trova
Accesso a internet e seleziona Richiedi.
Inserisci la chiave API. Una volta installato il plug-in, puoi accedervi dal menu
Finestra > Android Performance Tuner > Configurazione. In questa finestra di dialogo, seleziona la scheda
Impostazioni e inserisci la
chiave API del tuo progetto Google Cloud
nel campo Chiave API.
I campioni di contenuti e codice in questa pagina sono soggetti alle licenze descritte nella Licenza per i contenuti. Java e OpenJDK sono marchi o marchi registrati di Oracle e/o delle sue società consociate.
Ultimo aggiornamento 2025-08-26 UTC.
[null,null,["Ultimo aggiornamento 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"]]
Figura 1. Riferimento all'assembly mancante.
Figura 2. Scheda Impostazioni del plug-in