Android Developer Console에 등록

Google Play 외부에서만 앱을 배포하는 경우 Android Developer Console을 사용하여 개발자 신원을 관리하고 앱의 패키지 이름을 등록하세요. 이 가이드에서는 계정을 확인하고 인증된 Android 기기에 앱을 설치할 수 있도록 하는 방법을 설명합니다.

계정 만들기

Google 계정을 사용하여 계정에 가입할 수 있습니다. 학생 또는 취미로 개발하는 경우 인증 요구사항이 적고 수수료가 없는 특별한 계정 유형을 만들 수 있습니다.

앱 배포 방법 선택

앱은 계속 사이드로드할 수 있습니다. 사용자 환경은 선택한 경로에 따라 달라집니다.

본인 확인을 완료하세요

계정 유형마다 요구사항이 다릅니다. 전체 배포 계정제한적 배포 계정 가이드를 검토하여 가장 적합한 계정을 결정하세요.

패키지 이름 등록

인증이 완료되면 패키지 페이지에서 앱의 패키지 이름을 등록할 수 있습니다. 등록 절차를 통해 앱이 인증된 개발자 신원에 연결됩니다. Android Developer Console에서 다음을 완료하여 등록하세요.

  1. 패키지 이름 입력: 등록하려는 고유한 패키지 이름을 제공합니다.
  2. 키 추가: 앱의 서명 키 쌍에서 SHA-256 인증서 지문을 입력합니다. 그러면 상태가 검토 중 으로 변경됩니다.
  3. 소유권 증명: 기존 패키지 이름의 경우 비공개 키로 APK에 서명하고 업로드해야 합니다. Android Developer Console에서는 이 챌린지를 위해 APK의 애셋 폴더에 추가할 스니펫을 제공합니다. 등록이 완료되면 이메일로 알림이 전송되고 Developer Console의 패키지 이름 상태가 등록됨 으로 업데이트됩니다.

워크플로 자동화

Google API를 사용하여 개발자 인증 및 패키지 등록을 자동화할 수 있습니다.

  • Android 개발자 ID 상태 API: 패키지 이름이 이미 등록되어 있는지 확인하고 자격 요건을 확인할 수 있습니다.
  • Android Developer Console API: 개발 환경 또는 CI/CD 파이프라인 내에서 직접 패키지 이름과 키를 등록하고 관리할 수 있습니다.

두 API 모두 OAuth 위임을 지원하므로 서드 파티 플랫폼 (예: 대체 Android 앱 스토어)에서 개발자를 대신하여 이러한 작업을 안전하게 실행할 수 있습니다.

중복 패키지 이름 처리

여러 개발자가 동일한 패키지 이름을 사용하는 경우 등록 권한은 패키지 이름 등록 규칙에 따라 결정됩니다. 다음 규칙은 서명 키가 알려진 총 설치 수의 50% 를 초과하는 개발자에게 패키지 이름을 할당하는 것을 목표로 합니다.

  • 다수 클러스터: 개발자의 키가 모든 설치 수의 50% 를 초과하는 경우 해당 개발자가 등록 우선순위를 갖습니다.
  • 상당한 클러스터: 설치 수가 50% 를 초과하는 단일 키가 없는 경우 '상당한 클러스터'(설치 수 50회 이상)가 있는 개발자는 패키지 이름을 등록할 수 있습니다.
  • 선착순: 상당한 클러스터가 없는 경우 알려진 키가 있는 개발자는 선착순으로 패키지 이름을 등록할 수 있습니다.

다음 예에서는 이러한 규칙을 보여줍니다.

다수 키 보유자의 우선순위:

서명 키가 알려진 총 설치 수의 50% 를 초과하는 개발자가 등록 우선순위를 갖습니다. 다른 모든 개발자는 다른 패키지 이름을 사용해야 합니다.

개발자

패키지 이름

설치 수

A

com.test.1

11

1000

B

com.test.1

12

100

이 시나리오에서는 개발자 A가 패키지 이름을 등록할 수 있습니다. 개발자 B는 다른 이름을 사용하거나 예외를 신청해야 합니다.

설치 수가 50회 이상인 키의 자격 요건:

설치 수가 50% 를 초과하는 단일 키가 없는 경우 설치 수가 50회 이상인 모든 키가 등록 자격 요건을 충족합니다. 설치 수가 50회 미만인 키를 보유한 다른 모든 개발자는 패키지 이름을 사용할 수 있는 권한을 요청해야 합니다.

개발자

패키지 이름

설치 수

C

com.test.2

21

100

D

com.test.2

22

100

E

com.test.2

23

10

여기서는 설치 수가 50%를 초과하는 단일 키가 없습니다. 설치 수가 50회 이상인 개발자 C와 D는 패키지 이름을 등록할 수 있습니다. 개발자 E는 다른 패키지 이름을 사용하거나 이 패키지 이름을 사용할 수 있는 권한을 요청해야 합니다.

설치 수가 50회 미만인 키의 선착순:

설치 수가 50회 이상인 키가 없는 경우 모든 키를 선착순으로 등록할 수 있습니다. 한 개발자가 패키지 이름을 등록하면 다른 개발자는 패키지 이름에 다른 이름을 사용하거나 예외를 요청해야 합니다.

개발자

패키지 이름

설치 수

F

com.test.3

31

10

G

com.test.3

31

10

이 시나리오에서는 키가 있는 모든 개발자가 자격 요건을 충족합니다. 한 개발자가 패키지 이름을 등록하면 다른 개발자는 권한을 요청해야 합니다.