Play Uygulama İmzalama özelliğini kullanma

İşlem şöyle gerçekleşir:

1. Uygulama paketinizi imzalayın ve Play Console'a yükleyin.
2. Google, uygulama paketinizden optimize edilmiş APK'lar oluşturur ve bunları uygulama imzalama anahtarıyla imzalar.
3. Google, apksigner aracını kullanarak uygulamanızın manifest dosyasına iki damga (com.android.stamp.source ve com.android.stamp.type) ekler ve ardından uygulama imzalama anahtarınızla APK'ları imzalar. Apksigner ile eklenen damgalar, APK'ların kimin tarafından imzalandığı bilgisine ulaşılabilmesini sağlar.
4. Google, kullanıcılara imzalanmış APK'ları teslim eder.

Google tarafından oluşturulan bir anahtar kullandığınızda, Google, otomatik olarak 4096 bit boyutunda, şifreleme açısından güçlü bir RSA anahtarı oluşturur. Kendi uygulama imzalama anahtarınızı yüklemeyi tercih ederseniz anahtarınız en az 2.048 bit boyutunda bir RSA anahtarı olmalıdır.

1. adım: Play Uygulama İmzalama'yı yapılandırın

1. Play Console'u açıp Play Uygulama İmzalama sayfasına (Test edin ve yayınlayın > Kurulum > Uygulama imzalama) gidin.
   • İpucu: Bu sayfaya ayrıca Uygulama bütünlüğü sayfasından (Test edin ve yayınlayın > Uygulama bütünlüğü) da erişebilirsiniz. Uygulama büyünlüğü sayfası, kullanıcıların uygulama ve oyunlarınızı amaçladığınız şekilde deneyimlemelerine yardımcı olacak bütünlük ve imzalama hizmetlerini sunar.
2. Henüz yapmadıysanız Play Uygulama İmzalama Hizmet Şartları'nı inceleyin ve Kabul et'i seçin.

2. adım: Orijinal anahtarınızın bir kopyasını Google'a gönderin ve bir yükleme anahtarı oluşturun

1. Orijinal uygulama imzalama anahtarınızı bulun.
2. Play Console'u açıp Play Uygulama İmzalama sayfasına (Test edin ve yayınlayın > Kurulum > Uygulama imzalama) gidin.
3. Yayınlama sürecinize en uygun dışa aktarma ve yükleme seçeneğini belirleyip mevcut bir uygulama imzalama anahtarı yükleyin.

3. adım: Yükleme anahtarı oluşturun (isteğe bağlı olup önerilir)

1. Bir yükleme anahtarı oluşturun ve sertifikayı Google Play'e yükleyin.
   • İsterseniz uygulama imzalama anahtarını yükleme anahtarınız olarak kullanmaya devam edebilirsiniz.
2. Uygulama imzalama sertifikanızın dijital parmak izlerini (MD5, SHA-1 ve SHA-256) kopyalayın.
   • Test amaçlı olarak, yükleme anahtarınızın sertifikasını, sertifikanın dijital parmak izini ve uygulama imzalama anahtarını kullanarak API sağlayıcılara kaydetmeniz gerekebilir.

4. adım: Sıradaki uygulama güncellemenizi yükleme anahtarıyla imzalayın

Uygulamanız için güncellemeler yayınladığınızda bunları yükleme anahtarınızla imzalamanız gerekir.

• Yeni bir yükleme anahtarı oluşturmadıysanız: Uygulama paketlerini Google Play'e yüklemeden önce imzalamak için orijinal uygulama imzalama anahtarınızı kullanmaya devam edin. Orijinal uygulama imzalama anahtarınızı kaybederseniz yeni bir yükleme anahtarı oluşturabilir ve Google'a kaydederek uygulamanızı güncellemeye devam edebilirsiniz.
• Yeni bir yükleme anahtarı oluşturduysanız: Uygulama paketlerini Google Play'e yüklemeden önce imzalamak için yeni yükleme anahtarınızı kullanın. Google, kimliğinizi doğrulamak için yükleme anahtarını kullanır. Yükleme anahtarınızı kaybederseniz destek ekibiyle iletişime geçerek yükleme anahtarınızın sıfırlanmasını sağlayabilirsiniz.

Mevcut anahtarınızı paylaşamıyorsanız bu adımı uygulayabilirsiniz. Kaydolmak için uygulama imzalama anahtarınızı yeni sürüme geçirmeden önce aşağıdaki bilgileri dikkate alın:

• Bu seçenek için ikili sürüm gereklidir.
• Her sürümde eski anahtarınızla imzalanmış bir uygulama paketi ve APK yüklemeniz gerekir. Google Play, uygulama paketlerinizi kullanarak Android R* (API düzeyi 30) ve sonraki sürümlerde çalışan cihazlar için yeni anahtarla imzalanmış APK'lar oluşturur. Eski Android sürümleri için (API düzeyi 29'a kadar) eski APK'larınız kullanılır.

*Uygulamanız sharedUserId kullanıyorsa Android T (API düzeyi 33) veya sonraki sürümleri çalıştıran cihazlardaki yükleme ve güncellemeler için anahtarı yeni sürüme yükseltmeniz önerilir. Bu işlemi yapılandırmak için lütfen paket konfigürasyonunda doğru minimum SDK sürümünü belirleyin.

1. adım: Yeni anahtarınızı yükleyip rotasyon kanıtını oluşturun ve yükleyin

Android cihazlarda yeni anahtara güvenilmesi için depodan yeni bir imzalama anahtarı yükleyip rotasyon kanıtı oluşturmanız ve yüklemeniz gerekir:

1. Play Console'u açıp Play Uygulama İmzalama sayfasına (Test edin ve yayınlayın > Kurulum > Uygulama imzalama) gidin.
   • İpucu: Bu sayfaya ayrıca Uygulama bütünlüğü sayfasından (Test edin ve yayınlayın > Uygulama bütünlüğü) da erişebilirsiniz. Uygulama büyünlüğü sayfası, kullanıcıların uygulama ve oyunlarınızı amaçladığınız şekilde deneyimlemelerine yardımcı olacak bütünlük ve imzalama hizmetlerini sunar.
2. Uygulama imzalama sekmesini seçin.
3. Gelişmiş seçenekleri göster'i seçip Yeni uygulama imzalama anahtarı kullan (bunun için devam eden ikili yayınlama gereklidir) seçeneğini belirleyin.
4. Geliştirici hesabınızdaki başka bir uygulamayla aynı uygulama imzalama anahtarını kullanmayı seçebilir veya Android Studio'dan, Java anahtar deposundan ya da başka bir depodan yeni bir uygulama imzalama anahtarı yükleyebilirsiniz.
5. Ekrandaki talimatları uygulayarak PEPK aracını indirip çalıştırın.
6. ZIP dosyanız hazır olduğunda Oluşturulan ZIP dosyasını yükle'yi tıklayıp Play Console'a yükleyin.
7. "5. Rotasyon kanıtı yükleyerek Android cihazlarda yeni anahtara güvenilmesine izin verin"in yanında Talimatları göster'i tıklayın.
8. APKSigner'ı indirip aşağıdaki komutu çalıştırarak rotasyon kanıtı oluşturun:
   • $ 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. Oluşturulan rotasyon kanıtı dosyasını yükle'yi tıklayıp 8. adımda oluşturduğunuz rotasyon kanıtını yükleyin.
10. Kaydet'i tıklayın.

• 2048 bit veya daha yüksek bir RSA anahtarı olmalıdır.

Yükleme anahtarı oluşturduktan sonra, aşağıda belirtilen yerleri kontrol etmeniz ve güncellemeniz önerilir:

• Yerel makineler
• Fiziksel erişiminizin olduğu kilitli sunucu (değişik ACL'ler)
• Bulut makinesi (değişik ACL'ler)
• Özel gizli veri yönetim hizmetleri
• (Git) depoları

Anahtarı yeni sürüme geçirme isteğinde bulunmadan önce, yeni sürüme geçiş işleminin tamamlanmasının ardından yapmanız gerekebilecek değişiklikleri anlamanız önemlidir.

• Uygulamalar arasında kod/veri paylaşmak için aynı uygulama imzalama anahtarını birden fazla uygulamada kullanıyorsanız, uygulamalarınızı hem yeni hem de eski uygulama imzalama anahtarı sertifikalarını tanıyacak şekilde güncellemeniz gerekir. Android S (API düzeyi 32) veya önceki sürümleri çalıştıran cihazlarda Android platformu yalnızca eski uygulama imzalama anahtarı sertifikasını, veri/kod paylaşma amacıyla tanır.
• Uygulamanız API'ler kullanıyorsa API'lerin çalışmaya devam etmesini sağlamak için bir güncelleme yayınlamadan önce API sağlayıcılarında yeni ve eski uygulama imzalama anahtarınızın sertifikalarını kaydettiğinizden emin olun. Sertifikalar, Play Console'daki Play Uygulama İmzalama sayfasında (Test edin ve yayınlayın > Kurulum > Uygulama imzalama) bulunabilir.  
• Güncellemeleri eşler arası paylaşım yoluyla yükleyen kullanıcılarınız varsa bu kullanıcılar yalnızca uygulamanızın halihazırda yüklemiş oldukları sürümüyle aynı anahtar kullanılarak imzalanmış güncellemeleri yükleyebilirler. Farklı bir anahtarla imzalanmış sürümüne sahip oldukları için uygulamalarını güncelleyemiyorlarsa güncellemeyi almak için uygulamayı kaldırıp yeniden yükleyebilirler.

Her uygulamanın uygulama imzalama anahtarı, Android N (API düzeyi 24) ve üzeri sürümlerdeki tüm yüklemeler için yılda bir kez yeni sürüme geçirilebilir.

Anahtarı yeni sürüme geçirme isteğiniz başarılı olursa yeni yüklemeleri ve uygulama güncellemelerini imzalamak için yeni anahtarınız kullanılır. Android T (API düzeyi 33) ve sonraki sürümleri çalıştıran cihazlarda Android platformu, yeni sürüme geçirilen anahtarın kullanımını zorunlu kılar. Android S (API düzeyi 32) veya önceki sürümleri çalıştıran cihazlarda Android platformu, yeni sürüme geçirilen bu anahtarın kullanılmasını zorunlu kılmaz ve eski imzalama anahtarını, uygulamanın imzalama anahtarı olarak tanımaya devam eder. Uygulamanın imzalama anahtarını kullanan tüm Android platformu özellikleri de (ör. özel izin paylaşımı) de buna dahildir. Google Play Protect, Android N (API düzeyi 24) ile Android S (API level 32) arasındaki sürümleri çalıştıran cihazlarda, kullanıcı tarafından devre dışı bırakılmadığı sürece uygulama güncellemelerinizin yeni sürüme geçirilmiş anahtarınızla imzalanıp imzalanmadığını kontrol edecektir. Android platformu, Android S (API düzeyi 32) veya önceki sürümleri çalıştıran cihazlarda yeni sürüme geçirilmiş anahtarın kullanılmasını zorunlu kılmadığından bu ek bir doğrulama sağlar.

1. Play Console'u açıp Play Uygulama İmzalama sayfasına (Test edin ve yayınlayın > Kurulum > Uygulama imzalama) gidin.
   • İpucu: Bu sayfaya ayrıca Uygulama bütünlüğü sayfasından (Test edin ve yayınlayın > Uygulama bütünlüğü) da erişebilirsiniz. Uygulama büyünlüğü sayfası, kullanıcıların uygulama ve oyunlarınızı amaçladığınız şekilde deneyimlemelerine yardımcı olacak bütünlük ve imzalama hizmetlerini sunar.
2. "Uygulama imzalama anahtarınızı yeni sürüme geçirin" kartında Anahtarın yeni sürümünü iste'yi seçin.
3. Uygulama imzalama anahtarınızı Android N ve üstü sürümlerdeki tüm yüklemeler için yeni sürüme geçirmek üzere bir seçenek belirleyin.
4. Google'ın yeni bir uygulama imzalama anahtarı oluşturmasını sağlayın (önerilen) veya siz bir tane yükleyin.
   • Uygulama imzalama anahtarınız yeni sürüme geçtikten sonra, uygulama imzalama ve yükleme anahtarınız için aynı anahtarı kullanıyorsanız eski uygulama imzalama anahtarınızı yükleme anahtarınız olarak kullanmaya devam edebilir veya yeni bir yükleme anahtarı oluşturabilirsiniz.
5. Uygulama imzalama anahtarını yeni sürüme geçirme isteğinizin nedenini seçin.
6. Gerekiyorsa yeni uygulama imzalama anahtarınızı API sağlayıcılara kaydedin.

İpucu: Uygulamanızı birden fazla dağıtım kanalında dağıtıyorsanız ve kullanıcılarınız için uygulama güncelleme uyumluluğunu en üst düzeye çıkarmak istiyorsanız anahtarınızı her dağıtım kanalında yeni sürüme geçirmeniz gerekir. Google Play'in anahtarınızı yeni sürüme geçirme işlemiyle uyumluluk için Android SDK Derleme Araçları (düzeltme 33.0.1+) ile birlikte sunulan ApkSigner aracını kullanın:

$ apksigner işareti -- ${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}

Uygulama güncellemelerinin işleyiş şekli hakkında daha fazla bilgi edinin.