신원 입력값

Android 패키지 이름 확인: 추측 없이 찾는 방법

등록 API에는 정확한 전체 패키지 이름이 필요합니다. ‘My Notes’ 같은 표시 이름으로는 부족하고, 디버그 application ID가 프로덕션과 다를 수 있습니다.

가이드 요약

Android 패키지 이름 확인을 위해 Gradle, 설치된 앱, Play Console, APK에서 정확한 application ID를 찾습니다.

대상: 여러 프로젝트의 패키지 식별자를 모으는 개발자, QA 팀, 앱 포트폴리오 담당자.

출시 점검 순서

  1. 앱 모듈의 Gradle 설정에서 applicationId를 확인합니다.
  2. 빌드 변형이 있다면 applicationIdSuffix까지 반영합니다.
  3. Play Console 앱 URL 또는 출시 메타데이터의 패키지와 교차 확인합니다.
  4. 디버그나 내부 테스트 접미사가 아닌 프로덕션 ID를 사용합니다.

핵심 정보

예상 형식com.company.product
대소문자원본 값을 그대로 유지
흔한 실수디버그 application ID 조회
주의 사항

생성 코드에 쓰는 namespace와 최종 applicationId는 다를 수 있습니다. 등록 기준은 설치되는 패키지 신원입니다.

상세 안내

Android 프로젝트에서 읽기

앱 모듈의 applicationId가 설치 패키지 신원입니다. namespace는 생성 코드를 제어하며 다를 수 있습니다. 값을 복사하기 전에 대상 출시 변형의 product flavor와 applicationIdSuffix를 모두 반영하세요.

Gradle 예시
android {
  namespace = "com.example.code"
  defaultConfig { applicationId = "com.example.app" }
}

빌드된 APK에서 읽기

소스나 CI 설정이 불분명하면 실제 배포할 아티팩트를 검사합니다. 명령은 com.example.app 같은 값을 출력하며 런처 아이콘 아래의 마케팅 이름을 반환하지 않습니다.

APK 명령
apkanalyzer manifest application-id app-release.apk
# com.example.app

설치된 앱 또는 스토어 목록에서 읽기

기기를 연결한 뒤 ID의 특징적인 문자열로 패키지 목록을 좁힙니다. Google Play URL의 id 쿼리 매개변수도 패키지 이름입니다. 둘 중 하나를 프로덕션 출시 기록과 교차 확인하세요.

  • 앱 표시 이름을 사용하지 않습니다.
  • 프로덕션 flavor 접미사를 빼지 않습니다.
  • 디버그 빌드가 아니라 배포된 출시 신원을 사용합니다.
기기와 Play 예시
adb shell pm list packages | grep example
https://play.google.com/store/apps/details?id=com.example.app

찾은 패키지 조회하기

먼저 패키지 이름만으로 등록 상태를 조회합니다. 등록된 서명 신원과 사용자가 받는 아티팩트가 일치하는지 확인하려면 프로덕션 인증서 SHA-256도 추가합니다.

운영 패키지 이름을 입력하고, 서명까지 확인하려면 실제 배포 APK의 인증서 SHA-256을 추가하세요. 이 조회는 스토어 심사와 별개입니다.

상태 확인 →

자주 묻는 질문

namespace가 항상 패키지 이름인가요?

아닙니다. 현대 Android 프로젝트에서는 namespace가 생성 코드를, applicationId가 설치 패키지를 정의하므로 서로 다를 수 있습니다.

두 빌드 변형의 등록 상태가 다를 수 있나요?

가능합니다. 서로 다른 application ID로 설치되는 변형은 각각 별도의 패키지 등록 신원입니다.

출처 및 검토

최종 검토일: