Testar o envio de recursos
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Use as etapas deste guia para testar como seu app integra o Play Asset Delivery
para recuperar pacotes de recursos.
Teste local
O Play Asset Delivery é compatível com testes locais instalando uma nova versão do
jogo usando bundletool. Use testes locais
para ciclos iterativos rápidos, evitando a necessidade de fazer upload do jogo para os servidores do Google
Play. As etapas que você precisa seguir dependem se você fez
o desenvolvimento em Java, código nativo ou Unity.
Java ou nativo
Siga estas etapas para testar o app localmente:
Crie seu pacote de apps.
Gere APKs com a sinalização --local-testing:
java -jar bundletool-all.jar build-apks --bundle=path/to/your/bundle.aab \
--output=output.apks --local-testing
Conecte um dispositivo e execute bundletool para transferir os APKs por sideload:
java -jar bundletool.jar install-apks --apks=output.apks
Unity
No Unity Editor, selecione Google > Build and Run.
Comportamento
Pacotes install-time serão instalados durante o processo de instalação do app.
Os pacotes fast-follow se comportam como pacotes on-demand. Ou seja, eles não serão
buscados automaticamente quando o jogo for transferido por sideload. Os desenvolvedores precisam solicitá-los
manualmente quando o jogo começar. Isso não exige nenhuma mudança no código
do app.
Limitações
Veja a seguir as limitações dos testes locais:
- Os pacotes são buscados do armazenamento externo em vez do Play. Por isso, não é possível testar
como o código se comporta em caso de erros de rede.
- Os testes locais não abrangem o cenário "Aguardando Wi-Fi".
- Atualizações não são compatíveis. Antes de instalar uma nova versão do seu
build, desinstale manualmente a versão anterior.
Como testar com o Compartilhamento interno de apps
Na medida que você se aproximar de ter um candidato a lançamento, teste
o jogo usando uma configuração realista para garantir que ele tenha um bom
desempenho para os usuários durante a produção. Para validar isso, você pode usar o
Compartilhamento interno de apps
para receber um link compartilhável, que pode ser usado para fazer o download do jogo do Google Play e
receber o mesmo comportamento que seus usuários veriam após a
publicação do jogo na Play Store.
Para testar o Asset Delivery usando o Compartilhamento interno de apps, faça o seguinte:
- Crie seu pacote de apps.
- Siga as instruções do Play Console sobre como
compartilhar seu app internamente.
- No dispositivo de teste, clique no link do Compartilhamento interno de apps referente à versão do
app que você acabou de fazer upload.
- Instale o app da página da Google Play Store que for exibida após clicar no
link.
O conteúdo e os exemplos de código nesta página estão sujeitos às licenças descritas na Licença de conteúdo. Java e OpenJDK são marcas registradas da Oracle e/ou suas afiliadas.
Última atualização 2025-07-27 UTC.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 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."]]
