Play 앱 서명 사용하기

절차는 다음과 같습니다.

1. App Bundle에 서명하고 Play Console에 업로드합니다.
2. Google에서는 App Bundle로부터 최적화된 APK를 생성하고 앱 서명 키로 이에 서명합니다.
3. Google은 apksigner를 사용하여 앱 매니페스트에 스탬프 두 개(com.android.stamp.source, com.android.stamp.type)를 추가한 다음 앱 서명 키로 APK에 서명합니다. apksigner로 추가된 스탬프를 통해 APK에 서명한 사람을 추적할 수 있습니다.
4. Google에서 서명된 APK를 통해 앱을 게시하고 사용자에게 표시합니다.

Google 생성 키를 사용하면 Google에서 강력한 암호화가 적용된 RSA 키(4096비트)를 자동으로 생성합니다. 자체 앱 서명 키를 업로드하려는 경우 2048비트 이상의 RSA 키여야 합니다.

1단계: Play 앱 서명 구성하기

1. Play Console을 열고 Play 앱 서명 페이지(테스트 및 출시 > 설정 > 앱 서명)로 이동합니다.
   • 도움말: 개발자가 의도한 방식대로 앱과 게임을 경험하도록 도와주는 무결성 및 서명 서비스가 포함된 앱 무결성 페이지(테스트 및 출시 > 앱 무결성)를 통해서도 이 페이지에 액세스할 수 있습니다.
2. 아직 동의하지 않은 경우 Play 앱 서명 서비스 약관을 검토하고 동의를 선택합니다.

2단계: Google에 원래 키 사본 전송 및 업로드 키 만들기

1. 원래 앱 서명 키를 찾습니다.
2. Play Console을 열고 Play 앱 서명 페이지(테스트 및 출시 > 설정 > 앱 서명)로 이동합니다.
3. 출시 프로세스에 가장 적합한 내보내기 및 업로드 옵션을 선택하고 기존 앱 서명 키를 업로드합니다.

3단계: 업로드 키 만들기(선택사항 및 권장)

1. 업로드 키를 만들고 인증서를 Google Play에 업로드합니다.
   • 앱 서명 키를 업로드 키로 계속 사용할 수도 있습니다.
2. 앱 서명 인증서의 지문(MD5, SHA-1 및 SHA-256)을 복사합니다.
   • 테스트를 위해 인증서 지문 및 앱 서명 키를 사용하여 업로드 키 인증서를 API 제공업체에 등록해야 할 수 있습니다.

4단계: 업로드 키로 다음 앱 업데이트에 서명하기

앱 업데이트를 출시하면 업로드 키를 사용하여 서명해야 합니다.

• 새로운 업로드 키를 생성하지 않은 경우: 원래 앱 서명 키를 계속 사용하여 Google Play에 업로드하기 전에 App Bundle에 서명합니다. 원래 앱 서명 키를 분실했다면 새 업로드 키를 생성하고 Google에 등록하여 계속 앱을 업데이트할 수 있습니다.
• 새 업로드 키를 생성한 경우: 새 업로드 키를 사용하여 버전을 Google Play에 업로드하기 전에 App Bundle에 서명합니다. Google은 업로드 키를 사용하여 신원을 확인합니다. 업로드 키를 분실하면 지원팀에 문의하여 재설정할 수 있습니다.

기존 키를 공유할 수 없는 경우 앱 서명 키를 업그레이드하는 것이 좋습니다. 등록할 앱 서명 키를 업그레이드하기 전에 다음 사항에 유의하세요.

• 이 옵션을 사용하려면 이중 출시 버전이 필요합니다.
• 모든 출시 버전에 App Bundle과 기존 키로 서명된 APK를 업로드해야 합니다. Google Play는 App Bundle을 사용하여 Android R*(API 수준 30) 및 이후 기기에 새 키로 서명된 APK를 생성합니다. 기존 APK는 이전 Android 출시 버전(API 수준 29까지)에 사용됩니다.

*앱에서 sharedUserId를 사용하는 경우 Android T(API 수준 33) 이상을 실행하는 기기에 설치 및 업데이트용 키 업그레이드를 적용하는 것이 좋습니다. 이를 구성하려면 번들 구성에서 정확한 최소 SDK 버전을 설정하세요.

1단계: 새 키 업로드 및 키 순환 증빙 자료 생성/업로드하기

Android 기기에서 새 키를 신뢰하려면 저장소에서 새 서명 키를 업로드하고 다음과 같이 키 순환 증빙 자료를 생성하고 업로드해야 합니다.

1. Play Console을 열고 Play 앱 서명 페이지(테스트 및 출시 > 설정 > 앱 서명)로 이동합니다.
   • 도움말: 개발자가 의도한 방식대로 앱과 게임을 경험하도록 도와주는 무결성 및 서명 서비스가 포함된 앱 무결성 페이지(테스트 및 출시 > 앱 무결성)를 통해서도 이 페이지에 액세스할 수 있습니다.
2. 앱 서명 탭을 선택합니다.
3. 고급 옵션 표시를 클릭하고 새 앱 서명 키 사용(지속적인 이중 출시 버전이 필요함)을 선택합니다.
4. 개발자 계정의 다른 앱과 동일한 앱 서명 키를 사용하거나 Android 스튜디오, 자바 키 저장소, 다른 저장소에서 새 앱 서명 키를 업로드합니다.
5. 화면에 표시된 안내에 따라 PEPK 도구를 다운로드하고 실행합니다.
6. ZIP 파일이 준비되면 생성된 ZIP 업로드를 클릭하여 Play Console에 업로드합니다.
7. '5. 키 순환 증빙 자료를 업로드하여 Android 기기에서 새 키를 신뢰하도록 허용합니다.' 옆에 있는 안내 표시를 클릭합니다.
8. 다음 명령어를 실행하여 APKSigner를 다운로드하고 키 순환 증빙 자료를 생성합니다.
   • $ apksigner rotate --out /path/to/new/file --old-signer --ks old-signer-jks --set-rollback true --new-signer --ks new-signer-jks --set-rollback true
9. 생성된 키 순환 증빙 자료 파일 업로드를 클릭하고 8단계에서 생성된 키 순환 증빙 자료를 업로드합니다.
10. 저장을 클릭합니다.

• 2048비트 이상의 RSA 키여야 합니다.

업로드 키를 만든 후 확인하고 업데이트할 수 있는 몇 개의 위치는 다음과 같습니다.

• 로컬 기기
• 잠긴 온사이트 서버(다양한 ACL)
• 클라우드 기기(다양한 ACL)
• 전용 비밀 관리 서비스
• (Git) 저장소

키 업그레이드를 요청하기 전에 업그레이드 완료 후 필요한 변경사항을 숙지해야 합니다.

• 여러 앱에 같은 앱 서명 키를 사용하여 앱 간에 데이터/코드를 공유하려면 앱을 업데이트해야 새로운 앱 서명 키 인증서와 기존 앱 서명 키 인증서를 인식할 수 있습니다. Android S(API 수준 32) 이하를 실행하는 기기에서는 Android 플랫폼에서 데이터/코드 공유 목적으로 기존 앱 서명 키 인증서만 인식합니다.
• 앱이 API를 사용하는 경우, API 제공업체에 새 앱 서명 키와 기존 앱 서명 키의 인증서를 등록한 후 업데이트를 게시해야 API가 계속해서 정상적으로 작동합니다. 인증서는 Play Console의 Play 앱 서명 페이지(테스트 및 출시 > 설정 > 앱 서명)에서 확인할 수 있습니다.  
• 사용자가 P2P 공유를 통해 업데이트를 설치하는 경우 이미 설치한 앱 버전과 같은 키로 서명된 업데이트만 설치할 수 있습니다. 다른 키로 서명한 앱 버전이 설치되어 있어서 앱을 업데이트할 수 없는 경우 앱을 제거 후 재설치하면 업데이트를 받을 수 있습니다.

각 앱은 Android N(API 수준 24)의 모든 설치에 대해 앱 서명 키를 1년에 한 번 업그레이드할 수 있습니다.

키 업그레이드를 요청하는 데 성공하면 모든 설치 및 앱 업데이트에 새 키를 사용하여 서명하게 됩니다. Android T(API 수준 33) 이상을 실행하는 기기에서 Android 플랫폼은 업그레이드된 키 사용을 시행합니다. Android S(API 수준 32) 이하를 실행하는 기기에서 Android 플랫폼은 업그레이드된 키의 사용을 강제하지 않으며 여전히 기존 서명 키를 앱의 서명 키로 인식합니다. 여기에는 앱의 서명 키를 사용하는 모든 Android 플랫폼 기능(예: 맞춤 권한 공유)도 포함됩니다. Android N(API 수준 24)~Android S(API 수준 32)를 실행하는 기기에서는 사용자가 사용 중지하지 않는 한 Google Play 프로텍트가 업그레이드된 키로 앱 업데이트에 서명했는지 확인합니다. Android 플랫폼은 Android S(API 수준 32) 이하를 실행하는 기기에서 업그레이드된 키 사용을 강제하지 않으므로 이렇게 하면 추가적인 검증이 가능합니다.

1. Play Console을 열고 Play 앱 서명 페이지(테스트 및 출시 > 설정 > 앱 서명)로 이동합니다.
   • 도움말: 개발자가 의도한 방식대로 앱과 게임을 경험하도록 도와주는 무결성 및 서명 서비스가 포함된 앱 무결성 페이지(테스트 및 출시 > 앱 무결성)를 통해서도 이 페이지에 액세스할 수 있습니다.
2. '앱 서명 키 업그레이드' 카드에서 키 업그레이드 요청을 선택합니다.
3. Android N 이상의 모든 설치에 대해 앱 서명 키를 업그레이드하는 옵션을 선택합니다.
4. Google에서 신규 앱 서명 키를 생성하도록 하거나(권장) 앱 서명 키를 직접 업로드합니다.
   • 앱 서명 키와 업로드 키로 동일한 키를 사용했다면 앱 서명 키를 업그레이드한 후 기존 앱 서명 키를 업로드 키로 계속 사용하거나 업로드 키를 새로 생성할 수 있습니다.
5. 앱 서명 키 업그레이드를 요청하는 이유를 선택합니다.
6. 필요하다면 API 제공업체에 새 앱 서명 키를 등록합니다.

도움말: 여러 배포 채널에 앱을 배포하고 사용자에게 앱 업데이트 호환성을 극대화하려면 각 배포 채널에서 키를 업그레이드해야 합니다. Google Play의 키 업그레이드와 호환되도록 하려면 Android SDK 빌드 도구(버전 33.0.1 이상)와 함께 번들로 제공되는 ApkSigner 도구를 사용하세요.

$ apksigner sign --in ${INPUT_APK}

--out ${OUTPUT_APK}

--ks ${ORIGINAL_KEYSTORE}

--ks-key-alias ${ORIGINAL_KEY_ALIAS}

--next-signer --ks ${UPGRADED_KEYSTORE}

--ks-key-alias ${UPGRADED_KEY_ALIAS}

--lineage ${LINEAGE}

 앱 업데이트 작동 방식을 자세히 알아보세요.