App Bundle 또는 APK에서 출시 대상 제한을 사용하면 아직 준비되지 않은 앱 버전을 실수로 배포할 가능성을 크게 줄일 수 있습니다. 이를 통해 빌드가 Play Console을 통해 프로덕션 사용자에게 출시되지 않도록 하거나 Play Console을 통해 배포되지 않도록 할 수 있습니다.
잠재고객 제한 사용 해제
출시 잠재고객 제한을 사용하려면 AndroidManifest.xml 파일의 <application> 요소에 <meta-data> 요소를 추가해야 합니다. 이 요소는 빌드 배포가 진행될 수 있는 정도를 제어합니다.
<meta-data> 태그의 android:value 속성은 빈 문자열로 설정해야 하고 android:name 속성은 다음 값 중 하나여야 합니다.
이 페이지에 나와 있는 콘텐츠와 코드 샘플에는 콘텐츠 라이선스에서 설명하는 라이선스가 적용됩니다. 자바 및 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,["# 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."]]
