Asset Delivery 테스트
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
이 가이드의 단계에 따라 앱이 Play Asset Delivery를 통합하여 애셋 팩을 검색하는 방식을 테스트할 수 있습니다.
로컬 테스트
Play Asset Delivery는 bundletool
을 사용하여 게임의 새 버전을 설치함으로써 로컬 테스트를 지원합니다. 로컬 테스트를 사용하면 Google Play 서버에 게임을 업로드할 필요가 없으므로 테스트 주기를 빠르게 반복할 수 있습니다. 거쳐야 하는 단계는 개발에 자바, 네이티브 또는 Unity를 사용하는지 여부에 따라 다릅니다.
자바 또는 네이티브
로컬에서 앱을 테스트하려면 다음 단계를 따르세요.
App Bundle을 빌드합니다.
다음과 같이 --local-testing
플래그를 사용하여 APK를 생성합니다.
java -jar bundletool-all.jar build-apks --bundle=path/to/your/bundle.aab \
--output=output.apks --local-testing
기기를 연결하고 다음과 같이 bundletool
을 실행하여 APK를 사이드로드합니다.
java -jar bundletool.jar install-apks --apks=output.apks
Unity
Unity Editor에서 Google > Build and Run(빌드 및 실행)을 선택합니다.
동작
install-time
팩은 앱 설치 프로세스 중에 설치됩니다.
fast-follow
팩은 on-demand
팩으로 동작합니다. 즉, 게임이 사이드로드될 때 자동으로 fast-follow 팩을 가져오지는 않습니다. 개발자는 게임이 시작될 때 수동으로 fast-follow 팩을 요청해야 합니다. 이를 위해 앱에서 코드를 변경할 필요는 없습니다.
제한사항
다음은 로컬 테스트의 제한사항입니다.
- 팩은 Play가 아닌 외부 저장소에서 가져오므로 네트워크 오류가 발생한 경우 코드가 작동하는 방식을 테스트할 수 없습니다.
- 로컬 테스트에서는 Wi-Fi 연결 대기 시나리오를 다루지 않습니다.
- 업데이트는 지원되지 않습니다. 빌드의 새 버전을 설치하기 전에 이전 버전을 수동으로 제거해야 합니다.
내부 앱 공유를 사용하여 테스트
출시 후보 공개가 다가옴에 따라 최대한 현실적인 구성을 사용하여 게임을 테스트함으로써 게임이 프로덕션 환경의 사용자에게 원활한 성능을 제공할지 확인합니다. 이를 확인하기 위해 내부 앱 공유를 사용하면 Play에서 게임을 다운로드하는 데 사용할 수 있는 공유 가능 링크를 구현하여 게임이 Play 스토어에 게시된 이후 사용자가 하는 것과 똑같은 동작을 구현해 볼 수 있습니다.
내부 앱 공유를 사용하여 Play Asset Delivery를 테스트하려면 다음 단계를 따르세요.
- App Bundle을 빌드합니다.
- 앱을 내부적으로 공유하는 방법에 관한 Play Console 안내를 따릅니다.
- 테스트 기기에서 방금 업로드한 앱 버전의 내부 앱 공유 링크를 클릭합니다.
- 링크를 클릭한 후 표시되는 Google Play 스토어 페이지에서 앱을 설치합니다.
이 페이지에 나와 있는 콘텐츠와 코드 샘플에는 콘텐츠 라이선스에서 설명하는 라이선스가 적용됩니다. 자바 및 OpenJDK는 Oracle 및 Oracle 계열사의 상표 또는 등록 상표입니다.
최종 업데이트: 2025-07-27(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-07-27(UTC)"],[],[],null,["# Test asset delivery\n\nUse the steps in this guide to test how your app integrates Play Asset Delivery\nto retrieve asset packs.\n\nLocal testing\n-------------\n\nPlay Asset Delivery supports local testing by installing a new version of the\ngame using [`bundletool`](/studio/command-line/bundletool). Use local testing\nfor quick, iterative cycles as it avoids the need to upload the game to Google\nPlay servers. The steps you need to take depend on whether you're\ndeveloping in Java, native, or Unity.\n\n- [Java](#steps-native-java)\n- [Native](#steps-native-java)\n- [Unity](#steps-unity)\n\n### Java or native\n\nFollow these steps to test your app locally:\n\n1. [Build your app bundle](/guide/playcore/asset-delivery#next-step-instructions).\n\n2. Generate APKs with the `--local-testing` flag:\n\n ```\n java -jar bundletool-all.jar build-apks --bundle=path/to/your/bundle.aab \\\n --output=output.apks --local-testing\n ```\n3. Connect a device and run `bundletool` to sideload the APKs:\n\n ```\n java -jar bundletool.jar install-apks --apks=output.apks\n ```\n\n### Unity\n\nIn the Unity Editor, select **Google \\\u003e Build and Run**.\n\n### Behavior\n\n`install-time` packs will be installed during the app installation process.\n\n`fast-follow` packs behave as `on-demand` packs. That is, they won't be\nautomatically fetched when the game is sideloaded. Developers need to request\nthem manually when the game starts; this does not require any code changes in\nyour app.\n\n### Limitations\n\nThe following are limitations of local testing:\n\n- Packs fetch from external storage instead of Play, so you cannot test how your code behaves in the case of network errors.\n- Local testing does not cover the wait-for-Wi-Fi scenario.\n- Updates are not supported. Before installing a new version of your build, manually uninstall the previous version.\n\nTesting with internal app sharing\n---------------------------------\n\nAs you get closer to having a release candidate, test\nyour game using as realistic a configuration as possible to make sure that your game will perform\nwell for your users in production. To validate this, you can use\n[internal app sharing](https://support.google.com/googleplay/android-developer/answer/9303479)\nto get a sharable link that you can use to download the game from Play while\ngetting the exact same behaviour as your users will once the game is\npublished to the Play Store.\n\nTo test Asset Delivery using internal app sharing, do the following:\n\n1. Build your app bundle.\n2. Follow the Play Console instructions on how to [share your app internally](https://support.google.com/googleplay/android-developer/answer/9303479).\n3. On the test device, click the internal app-sharing link for the version of your app you just uploaded.\n4. Install the app from the Google Play Store page you see after clicking the link."]]