APK 유효성 검사, 패키징, 게시
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
이 페이지의 안내에 따라 검증된 APK를 Google Play에 업로드할 수 있습니다.
proto 파일 유효성 검사
APK 애셋 폴더의 assets/tuningfork
아래에 다음 파일을 배치합니다.
dev_tuningfork.proto
tuningfork_settings.txt
dev_tuningfork_fidelityparams_i.txt
파일 여러 개(충실도가 증가하는 순서대로)
유효성 검사 도구는 assets/tuningfork
디렉터리에 설정 및 기본 충실도 매개변수 파일의 직렬화된 바이너리(.bin
) 프로토콜 버퍼를 생성합니다. 도구 자체는 src/tuningfork/tools/validation
디렉터리에 있습니다.
유효성 검사 도구는 바이너리 파일을 생성합니다.
샘플 프로젝트의 유효성을 검사하려면 다음 명령어를 실행합니다. 운영체제(LOCAL_OS
)는 다음 중 하나로 대체합니다.
cd gamesdk/src/tuningfork/tools/validation
java -jar build/libs/TuningforkApkValidationTool.jar \
--tuningforkPath ../../../../samples/tuningfork/insightsdemo/app/src/main/assets/tuningfork \
--protoCompiler ../../../../third_party/protobuf-3.0.0/install/LOCAL_OS/bin/protoc
다음과 같이 끝나는 출력이 표시됩니다.
...
May 19, 2020 3:42:11 PM com.google.tuningfork.validation.TuningforkApkValidationTool main
INFO: Tuning Fork settings are valid
유효성 검사 도구 실행에 관한 자세한 내용은 validation tool README
를 참고하세요.
통합 체크리스트 검토
Google Play Console에 APK를 업로드하기 전에 다음 작업을 실행합니다.
업로드 및 게시
성능 통계를 받으려면 Google Play Console에 새 APK를 업로드하고 출시 버전을 만듭니다. Google Play에서 출시하여 트랙을 테스트하거나 전체 사용자층에 공개할 수 있습니다. 출시 버전 생성에 관한 자세한 내용은 Console 고객센터 문서를 참고하세요.
APK를 게시했다면 Google Play Console의 Android Vitals > 성능 > 통계에서 사용자의 새로운 성능 통계를 받을 수 있습니다. 자세한 내용은 성능 통계 문서를 참고하세요.
이 페이지에 나와 있는 콘텐츠와 코드 샘플에는 콘텐츠 라이선스에서 설명하는 라이선스가 적용됩니다. 자바 및 OpenJDK는 Oracle 및 Oracle 계열사의 상표 또는 등록 상표입니다.
최종 업데이트: 2025-08-26(UTC)
[null,null,["최종 업데이트: 2025-08-26(UTC)"],[],[],null,["Use the instructions on this page to upload a validated APK to Google Play.\n\nValidate the proto files\n\nPlace the following files in your APK assets folder under `assets/tuningfork`:\n\n- `dev_tuningfork.proto`\n- `tuningfork_settings.txt`\n- Several `dev_tuningfork_fidelityparams_`\u003cvar translate=\"no\"\u003ei\u003c/var\u003e`.txt` files, in increasing fidelity order\n\nThe validation tool generates binary (`.bin`) serialized protocol buffers of the\nsettings and default fidelity parameters files in the `assets/tuningfork`\ndirectory. The tool itself is located in the `src/tuningfork/tools/validation`\ndirectory.\n\n\nThe validation tool generates binary files\n\nRun the following commands to validate the sample project. Substitute one of the\nfollowing for your operating system (`LOCAL_OS`):\n\n- `mac`\n- `win`\n- `linux-x86`\n\n cd gamesdk/src/tuningfork/tools/validation\n java -jar build/libs/TuningforkApkValidationTool.jar \\\n --tuningforkPath ../../../../samples/tuningfork/insightsdemo/app/src/main/assets/tuningfork \\\n --protoCompiler ../../../../third_party/protobuf-3.0.0/install/\u003cvar translate=\"no\"\u003eLOCAL_OS\u003c/var\u003e/bin/protoc\n\nOutput ending in the following appears: \n\n ...\n\n May 19, 2020 3:42:11 PM com.google.tuningfork.validation.TuningforkApkValidationTool main\n INFO: Tuning Fork settings are valid\n\nFor more information on running the validation tool, see the\n[`validation tool README`](https://android.googlesource.com/platform/frameworks/opt/gamesdk/+/refs/heads/master/src/tuningfork/tools/validation).\n\nReview the integration checklist\n\nBefore uploading your APK to the Google Play Console, do the following:\n\n- Review and, if necessary, update your app's [Privacy Policy](/games/sdk/performance-tuner/custom-engine/enable-api#privacy)\n- Integrate the [Android Frame Pacing library](/games/sdk/frame-pacing) into your project\n- Provide [fidelity parameters](/games/sdk/performance-tuner/custom-engine/define-parameters#annotations-and-fidelity-parameters) and all of your app's [quality levels](/games/sdk/performance-tuner/custom-engine/define-parameters#define-quality-levels)\n- Record when your game is performing [loading events](/games/sdk/performance-tuner/custom-engine/loading-functions)\n- Successfully run the [validation tool](#validate)\n- Run your game in debug mode and validate the output using `logcat` or the Tuning Fork Monitor app\n- Confirm that you and other relevant game engineers have access to Android Vitals in the Google Play Console\n\nUpload and publish\n\nTo receive performance insights, upload your new APK to the\nGoogle Play Console and create a release. You can release on Google Play to\ntest tracks or to your entire user base. For more information on creating a\nrelease, see the\n[Console Help Center documentation](https://support.google.com/googleplay/android-developer/answer/7159011).\n\nOnce you have published your APK, you can receive new performance insights from\nyour users in the Google Play Console under **Android Vitals \\\u003e Performance \\\u003e\nInsights** . For more information, see the\n[Performance insights documentation](https://support.google.com/googleplay/android-developer/answer/9876283)."]]