등록 절차는 패키지 이름이 새 이름인지 기존 이름인지(설치됨)에 따라 다릅니다.
1단계: 패키지 이름 세부정보 제공하기(새 패키지 이름과 기존 패키지 이름 모두에 공통)
- Android 개발자 인증 페이지로 이동합니다.
- 패키지 이름 탭에서 패키지 이름 등록을 선택합니다.
- 등록하려는 패키지 이름을 입력합니다.
- Play Console에서 쉽게 식별할 수 있도록 친숙한 이름을 제공합니다.
- 계속 진행하려면 다음을 선택합니다.
2단계: 키 등록하기
다음 단계는 새 패키지 이름을 등록하는지 기존 패키지 이름을 등록하는지에 따라 다릅니다.
A. 새 패키지 이름 등록하기
Android에서 사용된 적이 없는 새 패키지 이름의 경우 앱의 서명 키 쌍에서 공개키 인증서만 제공하면 됩니다.
- 키 추가를 선택합니다.
- 앱의 서명 키 쌍에서 공개키 인증서를 제공합니다. 이 서명 키는 Android에서 앱 업데이트가 개발자 본인이 제공한 것인지 확인하는 데 사용됩니다. 공개 SHA-256 인증서 찾는 방법 알아보기
- 키를 입력하고 키 추가를 선택합니다.
B. 기존 패키지 이름 등록하기
기존 패키지 이름을 등록하려면 알려진 비공개 서명 키의 소유권을 증명해야 합니다.
- 키 선택으로 이동합니다.
- 신규 등록과 달리 사용 가능한 공개 인증서 지문 목록이 표시됩니다. 이러한 키는 직접 등록에 사용할 수 있습니다.
- 목록을 살펴보거나 직접 검색하여 인증서 지문을 찾습니다.
- 키를 선택하고(목록에 있는 경우) 키 추가를 선택합니다.
- 등록 페이지로 돌아가 키가 추가되었는지 확인합니다.
주요 자격 요건 규칙 및 패키지 이름 사용 요청하기
자격 요건을 충족하는 키 목록은 패키지 이름 공유를 최소화하도록 설계된 패키지 이름 등록 요건 규칙에 따라 결정됩니다(Android 개발자 인증의 일환으로 도입됨).
패키지 이름을 여러 개발자가 사용하거나 서명 키가 여러 개인 시나리오에서는 자격 요건이 다음과 같이 결정됩니다.
|
시나리오 |
직접 등록 규칙 |
다른 개발자를 위한 규칙 |
|
다수 키 보유자 |
알려진 총 설치 수의 50%를 초과하는 키가 우선순위를 차지합니다. |
그 외 개발자는 요청을 제출해야 합니다. |
|
50회 초과 설치 |
총 설치 수의 50%를 초과하는 단일 키가 없는 경우 설치 수가 50회 이상인 모든 키가 자격 요건을 충족합니다. |
설치 수가 50회 미만인 키를 보유한 개발자는 요청을 제출해야 합니다. |
|
설치 수 50회 미만 |
설치 수가 50회 미만인 키가 없는 경우 알려진 모든 키를 선착순으로 등록할 수 있습니다. |
한 개발자가 등록하면 다른 개발자는 요청을 제출해야 합니다. |
SHA-256 지문 인증서가 등록 가능으로 표시되지 않는 경우에도 등록할 수는 있지만 이 절차에서는 Google에 요청하는 작업이 필요하며 요청이 거부될 수도 있습니다.
- 페이지에서 기타 키 목록을 펼칩니다.
- 이러한 방식으로 패키지 이름을 사용하도록 요청하는 경우의 영향을 이해했는지 확인합니다.
- 소유권 증빙(3단계 참고)을 완료하는 것 외에도 패키지 이름을 사용하는 이유(예: 사용자를 이전하면 앱 배포가 중단됨)를 제출해야 합니다.
사전 체험판 기간에는 자격 요건을 충족하는 키를 소유한 앱의 패키지 이름만 등록할 수 있습니다. 다른 키로 패키지를 등록하는 기능은 2026년 3월 공식 출시와 함께 제공됩니다.
3단계: 비공개 키 소유권 인증(기존 패키지만 해당)
기존 패키지 이름의 인증을 완료하려면 제공한 공개 키에 해당하는 비공개 키를 사용하여 APK에 서명하고 업로드해야 합니다.
- APK 업로드를 선택하여 소유권 인증 사용자 여정을 엽니다.
- 다음 화면에는 패키지 이름, 선택된 SHA-256 공개 인증서, 서명 안내가 표시됩니다.
- 개발자 계정에 연결된 고유 식별자인 스니펫을 복사합니다.
- APK 준비: 패키지 이름이 동일한 빈 프로젝트 또는 실제 앱을 사용하여 IDE에서 앱의 소스 트리로 이동합니다.
- 애셋 폴더 내부에 정확하게 이름이
adi-registration.properties라는 파일을 만듭니다. - 파일을 열고 스니펫을 붙여넣습니다.
- GitHub의 샘플 프로젝트를 검토하여 소유권 증빙을 위한 올바른 구조와 스니펫 배치를 확인합니다.
- 빌드 및 서명: 출시 APK를 빌드하고 공개 인증서 지문과 일치하는 비공개 키로 서명합니다. 서명(
jarsigner또는 Gradle의signingConfigs를 통해)은 합법적인 소유권의 증거로 사용됩니다.참고: 서명 키가 위임된 앱의 패키지 이름 등록등록하려는 패키지 이름이 삼성 Galaxy Store와 같은 서드 파티 배포 플랫폼에 비공개 서명 키가 위임된 앱에 속하는 경우, 비공개 키의 소유권을 증명할 때 다음 단계를 따라야 합니다.- 출시 APK 또는 AAB를 빌드하고 배포 플랫폼에 업로드합니다.
- 해당 배포 플랫폼에서 최종 서명된 출시 APK를 직접 다운로드합니다.
- 8번 단계에서 다운로드한 서명된 APK를 Play Console에 업로드합니다.
- 업로드: Play Console로 돌아가 업로드를 선택하고 서명된 출시 APK를 찾아 업로드합니다. 그러면 Android에서는 서명을 확인하고 소유권을 등록합니다.
4단계: 패키지 이름 등록 추적하기
Android에서는 패키지 이름을 공식적으로 등록하여 인증된 Play 개발자 신원에 연결하려고 시도합니다.
완료되면 이메일 알림이 전송됩니다.
패키지 페이지에서 등록 및 키 상태를 모니터링할 수 있습니다.
키 더 추가하기
패키지 이름을 등록한 후 키를 더 추가할 수 있습니다.
- APK 업로드를 선택하여 소유권 인증 사용자 여정을 엽니다.
- 다음 화면에는 패키지 이름, 선택된 SHA-256 공개 인증서, 서명 안내가 표시됩니다.
- 개발자 계정에 연결된 고유 식별자인 스니펫을 복사합니다.
- APK 준비: 패키지 이름이 동일한 빈 프로젝트 또는 실제 앱을 사용하여 IDE에서 앱의 소스 트리로 이동합니다.
- 애셋 폴더 내부에 정확하게 이름이 adi-registration.properties인 파일을 만듭니다.
- 파일을 열고 스니펫을 붙여넣습니다.
- GitHub의 샘플 프로젝트를 검토하여 소유권 증빙을 위한 올바른 구조와 스니펫 배치를 확인합니다.
- 빌드 및 서명: 출시 APK를 빌드하고 공개 인증서 지문과 일치하는 비공개 키로 서명합니다. 서명(
jarsigner또는Gradle의 signingConfigs를 통해)은 합법적인 소유권의 증거로 사용됩니다. - 업로드: Play Console로 돌아가 업로드를 선택하고 서명된 출시 APK를 찾아 업로드합니다. 그러면 Android에서는 서명을 확인하고 소유권을 등록합니다.