Uygulamanızı yayına hazırlayın

Uygulamanızı yayınlanmaya hazırlamak için uygulamanızın yayınlanan sürümünü yapılandırmanız, derlemeniz ve test etmeniz gerekir. Yapılandırma görevleri, uygulamanızı optimize etmeye yardımcı olan temel kod temizleme ve kod değiştirme görevlerini içerir. Derleme işlemi, hata ayıklama derlemesi işlemine benzer ve JDK ile Android SDK araçları kullanılarak yapılabilir.

Test görevleri, uygulamanızın gerçek dünya koşullarında beklendiği gibi performans gösterdiğinden emin olmanıza yardımcı olan son bir kontrol görevi görür. Firebase, uygulamanızın kalitesini artırmak için kullanabileceğiniz çok sayıda fiziksel ve sanal test cihazını Firebase Test Lab aracılığıyla sunar.

Uygulamanızı yayınlanmaya hazır hale getirdiğinizde, doğrudan kullanıcılara veya Google Play gibi bir uygulama pazar yeri aracılığıyla dağıtabileceğiniz imzalı bir APK dosyanız olur.

Bu belgede, uygulamanızı yayınlanmaya hazırlamak için gerçekleştirmeniz gereken ana görevler özetlenmektedir. Bu sayfada açıklanan görevler, kullanıcılara nasıl yayınlandığına veya dağıtıldığına bakılmaksızın tüm Android uygulamaları için geçerlidir. Uygulamanızı Google Play üzerinden yayınlıyorsanız Güvenle yayınlayın başlıklı makaleyi okuyun.

Not: En iyi uygulama olarak, bu sayfada açıklanan görevleri gerçekleştirmeden önce uygulamanızın işlevsellik, performans ve kararlılıkla ilgili tüm yayınlama ölçütlerinizi karşıladığından emin olun.

Hazırlık sürecinin geliştirme sürecine nasıl uyduğunu gösterir.

Şekil 1. Sürüm hazırlığı, geliştirme sürecinde zorunlu bir görevdir ve yayınlama sürecinin ilk adımıdır.

Yayın için hazırlık görevleri

Uygulamanızı kullanıcılara sunmak için kullanıcıların Android destekli cihazlarına yükleyip çalıştırabilecekleri, kullanıma hazır bir paket oluşturmanız gerekir. Yayınlanmaya hazır paket, hata ayıklama APK dosyasıyla aynı bileşenleri (derlenmiş kaynak kodu, kaynaklar, manifest dosyası vb.) içerir ve aynı derleme araçları kullanılarak derlenir. Ancak hata ayıklama APK dosyasından farklı olarak, kullanıma hazır APK dosyası kendi sertifikanızla imzalanır ve zipalign aracıyla optimize edilir.

Uygulamanızı yayınlanmaya hazırlamak için gerçekleştirmeniz gereken beş görevi gösterir.

Şekil 2. Uygulamanızı yayınlanmaya hazırlamak için beş ana görev vardır.

Uygulamanızı Android Studio ile oluşturuyorsanız imzalama ve optimizasyon görevleri genellikle sorunsuz bir şekilde tamamlanır. Örneğin, uygulamanızı tek seferde derlemek, imzalamak ve optimize etmek için Android Studio'yu Gradle derleme dosyalarıyla kullanabilirsiniz. Komut satırından derleme yaptığınızda da aynı işlemi gerçekleştirmek için Gradle derleme dosyalarını yapılandırabilirsiniz. Gradle derleme dosyalarını kullanma hakkında daha fazla bilgi için Derlemenizi yapılandırma başlıklı makaleyi inceleyin.

Uygulamanızı yayınlanmaya hazırlamak için genellikle Şekil 2'de gösterilen beş ana görevi yerine getirirsiniz. Uygulamanızı nasıl yayınladığınıza bağlı olarak her ana görev bir veya daha fazla küçük görev içerebilir. Örneğin, uygulamanızı Google Play üzerinden yayınlıyorsanız uygulamanızı yayınlanmak üzere yapılandırırken manifest dosyanıza özel filtreleme kuralları eklemek isteyebilirsiniz. Benzer şekilde, Google Play yayınlama yönergelerine uymak için sürümle ilgili materyalleri toplarken ekran görüntüleri hazırlamanız ve tanıtım metni oluşturmanız gerekebilir.

Şekil 2'de listelenen görevleri genellikle uygulamanızda kapsamlı bir şekilde hata ayıklama ve test yaptıktan sonra gerçekleştirirsiniz. Android SDK'sı, Android uygulamalarınızı test etmenize ve hata ayıklamanıza yardımcı olacak çeşitli araçlar içerir. Daha fazla bilgi için Uygulamanızda hata ayıklama ve Uygulamanızı test etme başlıklı makaleleri inceleyin.

Malzemeleri ve kaynakları toplama

Uygulamanızı yayınlanmaya hazırlamak için birkaç destekleyici öğe toplamanız gerekir. Bu öğeler arasında en azından uygulamanızı imzalamak için şifreleme anahtarları ve bir uygulama simgesi bulunur. Son kullanıcı lisans sözleşmesi de ekleyebilirsiniz.

Şifreleme anahtarları

Android, tüm APK'ların bir cihaza yüklenmeden veya güncellenmeden önce bir sertifikayla dijital olarak imzalanmasını zorunlu kılar. Google Play Store'da Ağustos 2021'den sonra oluşturulan tüm uygulamaların Play Uygulama İmzalama'yı kullanması gerekir. Ancak AAB'nizi Google Play Console'a yüklemek için geliştirici sertifikanızla imzalamanız gerekir. Eski uygulamalar kendi kendine imzalanabilir ancak Play Uygulama İmzalama'yı kullanıyor veya kendi kendinize imzalıyor olsanız da uygulamanızı yüklemeden önce imzalamanız gerekir.

Sertifika şartları hakkında bilgi edinmek için Uygulamanızı imzalama başlıklı makaleyi inceleyin.

Önemli: Uygulamanız, geçerlilik dönemi 22 Ekim 2033'ten sonra sona eren bir şifreleme anahtarıyla imzalanmalıdır.

Uygulamanız, özel anahtarınıza dayalı bir anahtar kullanmanızı gerektiren bir hizmete erişiyor veya üçüncü taraf kitaplığı kullanıyorsa başka sürüm anahtarları da edinmeniz gerekebilir.

Uygulama simgesi

Uygulamanızın simgesi, kullanıcıların uygulamanızı cihazın ana ekranında ve başlatıcı penceresinde tanımasına yardımcı olur. Ayrıca Uygulamaları Yönet, İndirdiklerim ve diğer yerlerde de görünür. Ayrıca, Google Play gibi yayınlama hizmetleri simgenizi kullanıcılara gösterir. Uygulama simgenizin olduğundan ve önerilen simge kurallarına uyduğundan emin olun.

Not: Uygulamanızı Google Play'de yayınlıyorsanız simgenizin yüksek çözünürlüklü bir sürümünü oluşturmanız gerekir. Daha fazla bilgi için Uygulamanızı sergilemek için önizleme öğeleri ekleme başlıklı makaleyi inceleyin.

Son kullanıcı lisans sözleşmesi

Uygulamanız için bir son kullanıcı lisans sözleşmesi (EULA) hazırlamayı düşünebilirsiniz. EULA; şahsınızı, kuruluşunuzu ve fikri mülkiyetinizi korumaya yardımcı olabilir. Uygulamanızla birlikte bir EULA sunmanızı öneririz.

Çeşitli malzemeler

Uygulamanızı tanıtmak için tanıtım ve pazarlama materyalleri de hazırlamanız gerekebilir. Örneğin, uygulamanızı Google Play'de yayınlıyorsanız tanıtım metni hazırlamanız ve uygulamanızın ekran görüntülerini oluşturmanız gerekir. Daha fazla bilgi için Uygulamanızı sergilemek için önizleme öğeleri ekleme başlıklı makaleyi inceleyin.

Uygulamanızı yayınlanacak şekilde yapılandırma

Tüm destekleyici materyallerinizi topladıktan sonra uygulamanızı yayınlanmak üzere yapılandırmaya başlayabilirsiniz. Bu bölümde, uygulamanızı yayınlamadan önce kaynak kodunuzda, kaynak dosyalarınızda ve uygulama manifestinizde yapmanızı önerdiğimiz yapılandırma değişikliklerinin bir özeti sunulmaktadır.

Bu bölümde listelenen yapılandırma değişikliklerinin çoğu isteğe bağlı olsa da iyi kodlama uygulamaları olarak kabul edilir ve bunları uygulamanızı öneririz. Bazı durumlarda, geliştirme sürecinizin bir parçası olarak bu yapılandırma değişikliklerini zaten yapmış olabilirsiniz.

Uygun bir uygulama kimliği seçin.

Uygulamanızın kullanım ömrü boyunca uygun olacak bir uygulama kimliği seçtiğinizden emin olun. Uygulamanızı kullanıcılara dağıttıktan sonra uygulama kimliğini değiştiremezsiniz. Bunu ayarlamak için modül düzeyindeki build.gradle veya build.gradle.kts dosyasında applicationId özelliğini kullanın. Daha fazla bilgi için Uygulama kimliğini ayarlama başlıklı makaleyi inceleyin.

Hata ayıklamayı devre dışı bırakma

APK'nın hata ayıklanabilir olup olmadığını yapılandırmak için Groovy için debuggable işaretini veya Kotlin komut dosyası için isDebuggable işaretini kullanın:

Kotlin

  android {
    ...
    buildTypes {
      release {
        isDebuggable = false
        ...
      }
      debug {
        isDebuggable = true
        ...
      }
    }
    ...
  }

Modern

  android {
    ...
    buildTypes {
      release {
        debuggable false
        ...
      }
      debug {
        debuggable true
        ...
      }
    }
    ...
  }

Uygulama küçültmeyi etkinleştirme ve yapılandırma

Aşağıdaki optimizasyonların çoğu, yayınlanan derlemeniz için küçültme etkinleştirilerek otomatikleştirilebilir. Örneğin, günlük ifadelerini kaldırmak için ProGuard kuralları ekleyebilirsiniz. Küçültücü, kullanılmayan kod ve kaynakları tanımlayıp kaldırır. Küçültücü, DEX boyutunu daha da azaltmak için sınıf ve değişken adlarını daha kısa adlarla değiştirebilir.

Günlük kaydını devre dışı bırak

Uygulamanızı yayınlamak için derlemeden önce günlük kaydını devre dışı bırakın. Kaynak dosyalarınızdaki Log yöntemlerine yapılan çağrıları kaldırarak günlük kaydını devre dışı bırakabilirsiniz. Ayrıca, projenizde oluşturulan günlük dosyalarını veya statik test dosyalarını da kaldırın.

Ayrıca, kodunuza eklediğiniz tüm Debug izleme çağrılarını (ör. startMethodTracing() ve stopMethodTracing() yöntem çağrıları) kaldırın.

Önemli: Ücretli içerik göstermek için WebView kullanıyorsanız veya JavaScript arayüzleri kullanıyorsanız uygulamanızda hata ayıklamayı devre dışı bıraktığınızdan emin olun. Hata ayıklama, kullanıcıların Chrome Geliştirici Araçları'nı kullanarak komut dosyası eklemesine ve içerik ayıklamasına olanak tanır. Hata ayıklamayı devre dışı bırakmak için WebView.setWebContentsDebuggingEnabled() yöntemini kullanın.

Proje dizinlerinizi temizleme

Projenizi temizleyin ve Projelere genel bakış bölümünde açıklanan dizin yapısına uygun olduğundan emin olun. Projenizde artık durumdaki dosyaları bırakmak, uygulamanızın derlenmesini engelleyebilir ve uygulamanızın öngörülemeyen şekilde davranmasına neden olabilir. En azından aşağıdaki temizleme görevlerini gerçekleştirin:

  • cpp/, lib/ ve src/ dizinlerinizin içeriğini inceleyin. cpp/ dizini yalnızca Android NDK ile ilişkili kaynak dosyaları (ör. C veya C++ kaynak dosyaları, üstbilgi dosyaları ya da makefile dosyaları) içermelidir. lib/ dizini, önceden derlenmiş paylaşılan ve statik kitaplıklar da dahil olmak üzere yalnızca üçüncü taraf kitaplık dosyalarını veya özel kitaplık dosyalarını içermelidir. src/ dizini yalnızca uygulamanızın kaynak dosyalarını (Java, Kotlin ve AIDL dosyaları) içermelidir. src/ dizini herhangi bir JAR dosyası içermemelidir.
  • Projenizde uygulamanızın kullanmadığı özel veya tescilli veri dosyaları olup olmadığını kontrol edin ve bunları kaldırın. Örneğin, projenizin res/ dizininde artık kullanmadığınız eski çizilebilir dosyaları, düzen dosyalarını ve değer dosyalarını arayıp silin.
  • lib/ dizininizde test kitaplıkları olup olmadığını kontrol edin ve uygulamanız tarafından artık kullanılmıyorlarsa bunları kaldırın.
  • Yayınlamadan önce güncellemeniz veya kaldırmanız gereken ham öğe dosyaları ve statik dosyalar için assets/ dizininizin ve res/raw/ dizininizin içeriğini inceleyin.

Manifest ve Gradle derleme ayarlarınızı inceleyip güncelleme

Aşağıdaki manifest ve derleme dosyası öğelerinin doğru şekilde ayarlandığını doğrulayın:

  • <uses-permission> öğesi

    Yalnızca uygulamanızla alakalı ve gerekli olan izinleri belirtin.

  • android:icon ve android:label özellikleri

    <application> öğesinde bulunan bu özellikler için değer belirtmeniz gerekir.

  • versionCode ve versionName mülkleri

    Uygulama modülü düzeyindeki build.gradle veya build.gradle.kts dosyasında bulunan bu özellikler için değerler belirtmenizi öneririz. Daha fazla bilgi için Uygulamanıza sürüm oluşturma konusuna bakın.

Uygulamanızı Google Play'de yayınlıyorsanız ayarlayabileceğiniz birkaç ek derleme dosyası öğesi vardır. Örneğin, uygulama modülü düzeyindeki build.gradle veya build.gradle.kts dosyasında bulunan minSdk ve targetSdk özellikleri. Bu ve diğer Google Play ayarları hakkında daha fazla bilgi için Google Play'deki filtreler başlıklı makaleyi inceleyin.

Uyumluluk sorunlarını giderme

Android, uygulamanızı çok çeşitli cihazlarla uyumlu hale getirmek için çeşitli araçlar ve teknikler sunar. Uygulamanızı mümkün olduğunca çok kullanıcıya sunmak için şunları yapabilirsiniz:

Birden fazla ekran yapılandırması için destek ekleyin.
Birden fazla ekranı desteklemeyle ilgili en iyi uygulamalara uyduğunuzdan emin olun. Birden fazla ekran yapılandırmasını destekleyerek Android tarafından desteklenen tüm ekran boyutlarında düzgün çalışan ve iyi görünen bir uygulama oluşturabilirsiniz.
Uygulamanızı daha büyük ekranlar için optimize edin.
Uygulamanızı tablet ve katlanabilir cihazlar gibi büyük ekranlı cihazlarda iyi çalışacak şekilde optimize edebilirsiniz. Örneğin, liste-ayrıntı düzenleri daha büyük ekranlarda kullanılabilirliği artırabilir.
Jetpack kitaplıklarını kullanabilirsiniz.
Jetpack, geliştiricilerin en iyi uygulamaları takip etmesine, ortak metin kodunu azaltmasına ve Android sürümleri ile cihazlarında tutarlı bir şekilde çalışan kodlar yazmasına yardımcı olan bir kitaplık paketidir.

Sunucu ve hizmet URL'lerini güncelleme

Uygulamanız uzak sunuculara veya hizmetlere erişiyorsa sunucu ya da hizmet için test URL'si veya yolu yerine üretim URL'sini ya da yolunu kullandığınızdan emin olun.

Google Play için lisanslama özelliğini uygulama

Google Play üzerinden ücretli bir uygulama yayınlıyorsanız Google Play Lisanslama desteği eklemeyi düşünebilirsiniz. Lisanslama, mevcut kullanıcının satın alıp almadığına bağlı olarak uygulamanıza erişimi kontrol etmenizi sağlar. Uygulamanızı Google Play üzerinden yayınlıyor olsanız bile Google Play Lisanslama hizmetini kullanmak isteğe bağlıdır.

Google Play Lisanslama Hizmeti ve bu hizmeti uygulamanızda nasıl kullanacağınız hakkında daha fazla bilgi için Uygulama Lisanslama başlıklı makaleyi inceleyin.

Uygulamanızı yayınlanmaya hazır hale getirme

Uygulamanızı yapılandırmayı tamamladıktan sonra, imzalanmış ve optimize edilmiş, kullanıma hazır bir APK dosyası olarak derleyebilirsiniz. JDK, APK dosyasını imzalamak için gereken araçları (Keytool ve Jarsigner) içerir. Android SDK ise APK dosyasını derlemek ve optimize etmek için gereken araçları içerir. Android Studio veya komut satırından Gradle derleme sistemini kullanıyorsanız tüm derleme sürecini otomatik hale getirebilirsiniz. Gradle derlemelerini yapılandırma hakkında daha fazla bilgi için Derleme varyantlarını yapılandırma başlıklı makaleyi inceleyin.

Sürekli entegrasyon sistemi kullanıyorsanız yayınlama sürecinizi otomatikleştirmek için bir görev yapılandırabilirsiniz. Bu, sürüm APK'nızı veya AAB'nizi oluşturmakla sınırlı değildir. Ayrıca, derleme yapılarını Google Play Console'a otomatik olarak yükleyecek şekilde de yapılandırabilirsiniz.

Android Studio ile Oluşturun

Android Studio ile entegre olan Gradle derleme sistemini kullanarak özel anahtarınızla imzalanmış ve optimize edilmiş, kullanıma hazır bir APK dosyası oluşturabilirsiniz. Android Studio'da derlemeleri nasıl ayarlayacağınızı ve çalıştıracağınızı öğrenmek için Uygulamanızı derleme ve çalıştırma başlıklı makaleyi inceleyin.

Derleme işlemi, uygulamanızı imzalamaya uygun bir sertifikanız ve özel anahtarınız olduğunu varsayar. Uygun bir sertifikanız ve özel anahtarınız yoksa Android Studio, bunları oluşturmanıza yardımcı olabilir. İmzalama süreci hakkında daha fazla bilgi için Uygulamanızı imzalama başlıklı makaleyi inceleyin.

Harici sunucuları ve kaynakları hazırlama

Uygulamanız uzak bir sunucu kullanıyorsa sunucunun güvenli olduğundan ve üretimde kullanılmak üzere yapılandırıldığından emin olun. Bu, özellikle uygulamanızda uygulama içi faturalandırma uyguluyorsanız ve imza doğrulama adımını uzak bir sunucuda gerçekleştiriyorsanız önemlidir.

Ayrıca, uygulamanız uzak bir sunucudan veya gerçek zamanlı bir hizmetten (ör. içerik feed'i) içerik getiriyorsa sağladığınız içeriğin güncel ve üretime hazır olduğundan emin olun.

Uygulamanızı yayınlamadan önce test etme

Uygulamanızın yayınlanan sürümünü test etmek, uygulamanızın gerçekçi cihaz ve ağ koşullarında düzgün çalıştığından emin olmanıza yardımcı olur. İdeal olarak, kullanıcı arayüzü öğelerinizin doğru boyutlandırıldığını ve uygulamanızın performansının ve pil verimliliğinin kabul edilebilir olduğunu doğrulamak için uygulamanızı en az bir telefon boyutunda cihazda ve bir tablet boyutunda cihazda test edin. Firebase Test Lab, çeşitli cihazlarda ve Android OS sürümlerinde test yapmak için de kullanılabilir.

Test için başlangıç noktası olarak Temel uygulama kalitesi bölümüne bakın. Testi tamamlayıp uygulamanızın yayınlanan sürümünün doğru şekilde çalıştığından emin olduktan sonra uygulamanızı kullanıcılara yayınlayabilirsiniz. Daha fazla bilgi için Uygulamanızı kullanıcılara yayınlama başlıklı makaleyi inceleyin.