Usar uma restrição de público-alvo de lançamento para limitar a distribuição do app
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
É possível reduzir bastante as chances de distribuir acidentalmente uma versão do
app que ainda não está pronta usando uma restrição de público-alvo de lançamento no
pacote de apps ou no APK. É possível usar isso para evitar que um build seja lançado para
usuários de produção pelo Play Console ou até mesmo seja distribuído pelo
Play Console.
Uso de restrições de público-alvo de lançamento
Para usar uma restrição de público-alvo de lançamento, adicione um elemento <meta-data> ao
elemento <application> no arquivo AndroidManifest.xml. Esse elemento
controla até que ponto a distribuição do build pode progredir.
A tag <meta-data> precisa ter o atributo android:value definido como a string vazia, e o atributo android:name precisa ser um dos seguintes valores:
O pacote de apps ou o APK pode ser enviado para o Play Console e distribuído aos
usuários pelo Compartilhamento interno de apps ou qualquer faixa de teste, incluindo testes
abertos. Não é possível incluir uma versão na faixa de
produção.
O objetivo é evitar o lançamento acidental
de versões de teste de apps para usuários de produção.
O pacote de apps ou o APK pode ser enviado para o Play Console e distribuído aos
usuários pelo Compartilhamento interno de apps ou qualquer faixa de teste fechada. Ele não pode ser incluído em uma versão nas faixas de produção ou de teste aberto.
O objetivo é evitar o lançamento acidental de versões de teste de apps para um grande número de usuários.
O pacote de apps ou o APK pode ser enviado para o Play Console e distribuído aos
usuários pelo Compartilhamento interno de apps ou pela Faixa de teste interno. Ele
não pode ser incluído em uma versão nas faixas de produção,
teste aberto ou teste fechado.
O objetivo é
evitar o lançamento acidental de versões de teste de apps fora da
equipe imediata.
O pacote de apps ou APK não pode ser enviado nem distribuído pelo Play
Console.
O objetivo é impedir o lançamento de versões de apps
somente para desenvolvimento para qualquer usuário. Por exemplo, um build com recursos de segurança
principais desativados para facilitar a depuração.
Por exemplo, para impedir que um build seja lançado para usuários de produção, atualize seu
arquivo AndroidManifest.xml da seguinte maneira:
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,["# Use a release audience restriction to limit your app's distribution\n\nYou can greatly reduce the chances of accidentally distributing a version of\nyour app that isn't ready yet by using a release audience restriction in your\napp bundle or APK. You can use this to prevent a build from being released to\nproduction users through Play Console, or even from being distributed through\nPlay Console at all.\n\nRelease audience restrictions usage\n-----------------------------------\n\nTo use a release audience restriction, you must add a `\u003cmeta-data\u003e` element to\nthe `\u003capplication\u003e` element in your `AndroidManifest.xml` file. This element\ncontrols how far the distribution of the build can progress.\nThe `\u003cmeta-data\u003e` tag must have its `android:value` attribute set to the empty\nstring, and the `android:name` attribute must be one of the following values:\n\n| Name | Effect |\n|-----------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ` com.google.android.play.largest_release_audience.NONPRODUCTION ` | The app bundle or APK can be uploaded to Play Console and distributed to users through Internal App Sharing or any testing track, including open testing. It **cannot** be included in a release on the Production track. This is intended to prevent accidental release of test versions of apps to production users. |\n| ` com.google.android.play.largest_release_audience.CLOSED_TESTING ` | The app bundle or APK can be uploaded to Play Console and distributed to users through Internal App Sharing or any closed testing track. It **cannot** be included in a release on the Production or Open Testing tracks. This is intended to prevent accidental release of test versions of apps to a large number of users. |\n| ` com.google.android.play.largest_release_audience.INTERNAL_TESTING ` | The app bundle or APK can be uploaded to Play Console and distributed to users through Internal App Sharing or the Internal Test Track. It **cannot** be included in a release on the Production, Open Testing, or Closed Testing tracks. This is intended to prevent accidental release of test versions of apps outside your immediate team. |\n| ` com.google.android.play.largest_release_audience.STOPSHIP ` | The app bundle or APK cannot be uploaded to or distributed through Play Console. This is intended to prevent releasing development-only versions of apps to any users. For example, a build which has key security features disabled for easier debugging. |\n\n| **Note:** Because the restriction is built into your app bundle or APK, you can only change it by compiling a new build of your app with a new versionCode.\n\nFor example, to prevent a build being released to production users, update your\n`AndroidManifest.xml` file as follows: \n\n \u003cmanifest ... \u003e\n \u003capplication ... \u003e\n ...\n \u003cmeta-data\n android:name=\"com.google.android.play.largest_release_audience.NONPRODUCTION\"\n android:value=\"\" /\u003e\n \u003c/application\u003e\n \u003c/manifest\u003e\n\n| **Important:** The `\u003cmeta-data\u003e` element must be a direct child of the `\u003capplication\u003e` element in order for it to be detected by Google Play. It won't be detected if it is part of an `\u003cactivity\u003e` or `\u003cservice\u003e` element. If there are multiple restrictions in your application manifest, then the most restrictive will be applied.\n| **Tip:** If you have an Android library that adds some optional features for testing or internal debugging, you can add the restriction to the library's manifest. Any build which includes the library will then automatically include the release audience restriction."]]
