01
빌드에 쓰이는 값을 가져오기
Android에서는 코드 namespace와 별도로 앱 모듈의 applicationId를 확인하세요. iOS에서는 Target의 Bundle Identifier를 사용하세요. 와일드카드 App ID는 앱의 실제 번들 ID가 아닙니다.
모바일 개발
앱 패키지명 검사플랫폼별 구간 규칙 확인
프로젝트에 설정한 식별자 하나를 입력하고 플랫폼을 골라 구간별 진단을 확인하세요.
앱 패키지명 검사
앱 식별자
검사 보고서
식별자를 입력하면 구간별 보고서가 표시됩니다.
식별자는 이 브라우저에서만 검사합니다. 스토어에는 접속하지 않습니다.
식별자를 입력하면 구간별 보고서가 표시됩니다.
출시 직전에 식별자의 점 하나를 잘못 입력하면 업데이트와 연동 설정이 꼬일 수 있습니다. 앱 패키지명 검사는 실제 프로젝트 값을 그대로 검사하며, 문자를 삭제하거나 소문자로 바꾸지 않습니다.
Android 패키지명에는 밑줄이 허용되지만 iOS 번들 ID에는 허용되지 않습니다. 하이픈은 그 반대입니다. 이 도구는 문법 오류와 이름 짓기 권장을 나눠 보여 줍니다.안드로이드 패키지 이름과 애플리케이션 ID의 표기가 실제 빌드에서 일치하는지도 확인하세요.
앱 패키지명 검사가 필요한 이유
같은 문자열도 Android와 iOS에서 판정이 달라집니다.
어느 구간이 잘못됐는지 확인
앱 패키지명 검사는 점을 기준으로 나눈 뒤 빈 구간, 숫자로 시작한 구간, 허용되지 않는 기호를 해당 번호와 함께 보여 줍니다. 원문을 유지하므로 Gradle이나 Xcode에서 직접 고칠 수 있습니다.
한 입력값으로 두 규칙 비교
Android는 구간 안의 밑줄을 허용하고 하이픈을 거부합니다. iOS는 하이픈을 허용하고 밑줄을 거부합니다. 플랫폼을 바꿔도 입력을 고치지 않아 차이를 확인하기 쉽습니다.
출시 설정을 확인하는 순서
02
플랫폼을 먼저 선택하기
기본값은 Android입니다. iOS로 바꾸면 하이픈과 밑줄의 판정이 바뀌지만 입력은 그대로 남습니다. 두 프로젝트에서 같은 표기를 쓰려면 각각 검사하세요.
03
최신 결과만 복사하기
자동 검사는 마지막 입력 후 350ms가 지나면 실행됩니다. 끄면 버튼이나 Ctrl/Cmd+Enter로 검사할 수 있습니다. 값을 수정하면 이전 결과의 복사가 막힙니다.
구간별로 드러나는 규칙 차이
Android applicationId
구간이 최소 두 개이고 각 구간이 영문자로 시작하는지 확인합니다. 나머지 문자는 영문자, 숫자, 밑줄을 허용합니다. 대문자는 문법상 가능하므로 오류로 처리하지 않습니다.
iOS 번들 ID
영문자, 숫자, 하이픈과 점을 검사하고 밑줄이나 별표는 오류로 표시합니다. 한 구간만 있으면 역방향 도메인 형식 권장을 보여 주되 문법 오류로 바꾸지는 않습니다.
복사할 수 있는 단일 보고서
각 구간과 문제를 번호로 제시해 이슈에 붙일 수 있습니다. 형식이 통과해도 도메인 소유권, 서명, 스토어 등록 상태까지 보증하지는 않습니다.
형식 검사와 실제 등록의 경계
- 스토어 점유 여부는 조회하지 않음
- 통과는 로컬 문자와 구간 규칙만 뜻합니다. Apple이나 Google에 이미 등록된 값인지, 내 계정에 사용 권한이 있는지는 해당 개발자 콘솔에서 확인해야 합니다.
- 서명과 프로젝트 파일은 읽지 않음
- 문자열 하나만 받습니다. APK, IPA, Info.plist, Gradle을 열지 않으므로 Team ID, 인증서, 실제 빌드의 식별자 일치 여부는 판단할 수 없습니다.
- 와일드카드 App ID는 제외
- com.company.*는 프로비저닝에 쓰이는 패턴이지 구체적인 iOS 번들 ID가 아닙니다. 별표는 이 도구의 허용 문자 목록에도 없습니다.
- 권장 사항은 문법이 아님
- 소문자가 흔해도 Android 공식 규칙은 대문자와 밑줄을 허용합니다. 특정 SDK의 길이 제한이나 예약어 정책을 모든 플랫폼의 형식 오류로 적용하지 않습니다.
- 자동 수정과 일괄 검사는 하지 않음
- 이미 정한 식별자 하나씩 확인합니다. 자동으로 문자를 지우면 앱 정체성이 바뀔 수 있으며, 공개 후 ID 변경은 별도 앱으로 취급될 수 있습니다.
앱 패키지명 검사에서 자주 묻는 질문
패키지 등록 상태는 어디에서 확인하나요?
해당 플랫폼의 개발자 콘솔에서 확인해야 합니다. 앱 패키지명 검사는 브라우저 안에서 문자열 형식만 살피고 등록 API를 호출하지 않습니다.
패키지명을 바꾼 뒤 Android 회원가입이 안 되는 이유는 무엇인가요?
SDK에 등록된 패키지명과 실제 빌드의 applicationId가 다르면 연동이 실패할 수 있습니다. 이 도구는 입력 문자열의 형식만 검사하므로 콘솔 설정과 서명도 따로 비교하세요.
Android 패키지명이나 iOS 번들 ID를 변경할 수 있나요?
출시 전에 프로젝트 설정을 조정할 수 있지만, 이미 배포한 앱의 ID를 바꾸면 같은 앱의 업데이트가 아닐 수 있습니다. 이 도구는 변경을 수행하지 않습니다.
앱 정보의 번들 ID나 App Store 링크만 바꾸면 되나요?
아니요. 표시 정보와 실제 빌드 식별자, 개발자 계정의 등록값은 별개입니다. 여기서는 붙여 넣은 번들 ID의 문자 규칙만 확인합니다.
하나의 Kakao Developers 앱에 여러 네이티브 앱 키로 tenant 앱을 묶을 수 있나요?
그 구성은 Kakao Developers의 앱 등록 및 키 정책에 따릅니다. 각 Android applicationId와 iOS 번들 ID의 형식은 이 도구로 확인할 수 있지만, 키 연결이나 등록 가능 여부는 판단하지 않습니다.
규칙 해석에 빠진 점이 있나요?
출시 전에 앱 패키지명 검사 실행
앱 패키지명 검사에 최종 식별자를 넣고 결과를 확인한 다음, Xcode·Gradle 설정과 개발자 콘솔의 등록값을 따로 대조하세요.