GitHub 저장소에서 플러그인을 다운로드합니다. .unitypackage 파일 다운로드를 선택합니다.
플러그인 가져오기
플러그인을 가져오기 전에 먼저, 프로젝트에서 .NET 버전 4.6을 사용하고 있는지 확인합니다.
이는 Unity 버전 2018.4 및 이전 버전에 적용됩니다(이후 버전의 Unity에만 .NET 버전 4.6이 포함됨).
File(파일) > Build Settings(빌드 설정)를 선택합니다. Android가 현재 플랫폼으로 선택되어 있는지 확인합니다.
Player Settings(플레이어 설정) 버튼을 클릭합니다.
Other Settings(기타 설정)에서 Scripting Runtime Version(스크립트 런타임 버전)을 찾아 .NET 4.6을 선택합니다.
플러그인은 프로젝트에 가져올 수 있는 Unity 패키지로 제공됩니다.
Assets(애셋) > Import Package(패키지 가져오기) > Custom Package(맞춤 패키지)를 선택하고 다운로드한 .unitypackage 파일을 선택합니다.
Unity 2017을 사용하는 Android Performance Tuner 버전 1.5.1 이상
Unity 2017을 사용하는 Android Performance Tuner 버전 1.5.1 이상을 사용하려면 플러그인을 가져올 때 다음과 같은 추가 단계가 필요합니다.
Assets/AndroidPerformanceTuner/Editor 폴더로 이동합니다.
Google.Android.PerformanceTuner.Editor 파일을 클릭하여 Inspector(인스펙터)에서 엽니다.
누락된 어셈블리 참조를 클릭한 다음 -를 클릭하여 삭제합니다.
적용 버튼을 클릭합니다.
그림 1. 어셈블리 참조가 누락되었습니다.
Assets/AndroidPerformanceTuner/Runtime 폴더로 이동합니다.
Google.Android.PerformanceTuner 파일을 클릭하여 Inspector(인스펙터)에서 엽니다.
3단계를 반복하여 누락된 어셈블리 참조 2개를 삭제합니다.
Unity를 다시 시작합니다.
Window(창) > AndroidPerformanceTuner > Setup(설정)으로 이동하여 오류가 표시되지 않는지 확인합니다.
삭제 후 플러그인 다시 가져오기
프로젝트에서 플러그인을 삭제한 후 다시 가져올 경우 먼저 Player Settings(플레이어 설정) > Scripting Create Symbols(스크립팅 생성 기호)에서 ANDROID_PERFORMANCE_TUNER_UTILITIES를 삭제합니다.
플러그인 구성
플러그인을 구성하려면 다음 단계를 따르세요.
Unity 버전 2019.3.14 이상의 경우:
Android Frame Pacing 라이브러리를 사용 설정합니다. Android Performance Tuner는 이 라이브러리를 사용하여 Unity의 단독 보고 항목보다 더 심층적인 측정을 포함하여 게임의 성능을 측정합니다.
File(파일) > Build Settings(빌드 설정)를 선택하고 Player Settings(플레이어 설정) 버튼을 클릭합니다.
Resolution and Presentation(해상도 및 프레젠테이션)에서 Optimized Frame Pacing(최적화된 프레임 속도) 체크박스를 선택합니다.
프레임 렌더링을 수직 공백과 동기화합니다.
Player Settings(플레이어 설정)에서 Quality(화질) 탭을 선택하고 VSync Count(VSync 수) 메뉴를 찾습니다. 선택 항목을 사용합니다(Don't Sync(동기화 안 함) 제외).
Don't Sync(동기화 안 함) 이외의 선택 항목은 Android Frame Pacing 라이브러리와 함께 더 정확한 측정을 가능하게 합니다.
(2019 이전 Unity 버전의 경우) 빌드 시스템을 Gradle로 설정합니다. File(파일) > Build Settings(빌드 설정)를 선택합니다. Build System(빌드 시스템)을 찾아 Gradle을 선택합니다.
인터넷 액세스 권한을 추가합니다. Other Settings(기타 설정)에서 Internet Access(인터넷 액세스)를 찾아 Require(필요)를 선택합니다.
API 키를 입력합니다. 플러그인이 설치되면 Window > Android Performance Tuner > Setup 메뉴에서 입력할 수 있습니다. 이 대화상자에서 Settings(설정) 탭을 선택하고 API key(API 키) 필드에 Google Cloud 프로젝트의 API 키를 입력합니다.
이 페이지에 나와 있는 콘텐츠와 코드 샘플에는 콘텐츠 라이선스에서 설명하는 라이선스가 적용됩니다. 자바 및 OpenJDK는 Oracle 및 Oracle 계열사의 상표 또는 등록 상표입니다.
최종 업데이트: 2025-08-26(UTC)
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 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"]]