Android App Bundle'ınızı derleme ve test etme

Android App Bundle, birden fazla cihaz yapılandırmasında uygulamanızı oluşturmak, yayınlamak ve dağıtmak için önerilen yöntemdir. Uygulama paketleri; Play Feature Delivery, Play Asset Delivery ve hazır uygulama deneyimleri gibi gelişmiş özellikleri de etkinleştirir. İster uygulama paketlerini kullanmaya yeni başlıyor ister daha ileri düzey kullanım alanları için uygulama geliştiriyor olun, bu sayfada, geliştirme sürecinin her aşamasında uygulamanızı test etmek için kullanabileceğiniz çeşitli stratejilere genel bir bakış sunulmaktadır.

Uygulama paketlerini kullanmaya yeni başladıysanız Android Uygulama Paketleri hakkında başlıklı makaleyi okuyun.

Android Studio'yu kullanarak uygulama paketi oluşturma

Android Studio kullanıyorsanız sadece birkaç tıklamayla projenizi imzalı bir uygulama paketi olarak oluşturabilirsiniz. IDE kullanmıyorsanız komut satırından bir uygulama paketi oluşturabilirsiniz. Ardından, uygulamanızı test etmek veya yayınlamak için Play Console'a uygulama paketinizi yükleyin.

Uygulama paketleri oluşturmak için aşağıdaki adımları uygulayın:

  1. Android Studio 3.2 veya sonraki bir sürümü indirin. Bu, özellik modülleri eklemenin ve uygulama paketleri oluşturmanın en kolay yoludur.

  2. Android Studio'yu kullanarak Android App Bundle oluşturun. Ayrıca, çalışma/hata ayıklama yapılandırmanızı değiştirerek ve APK'yı uygulama paketinden dağıtma seçeneğini belirleyerek uygulamanızı bir uygulama paketinden bağlı bir cihaza dağıtabilirsiniz. Yalnızca APK oluşturup dağıtmaya kıyasla bu seçeneğin kullanılması, derleme sürelerinin daha uzun olmasını sağlar.

  3. Bir cihaza dağıtacağınız APK'ları oluşturmak için kullanarak Android App Bundle'ınızı dağıtın.

  4. Uygulama Play Uygulama İmzalama'ya kaydolun. Aksi takdirde, uygulama paketinizi Play Console'a yükleyemezsiniz.

  5. Uygulama paketinizi Google Play'de yayınlayın.

Android Studio ile uygulama paketlerini kullanarak dağıtma

Uygulamanızı Android App Bundle olarak derleyip doğrudan IDE üzerinden bağlı bir cihaza dağıtabilirsiniz. IDE ve Google Play, bir cihaza APK çıkarmak ve yüklemek için aynı araçları kullandığından bu yerel test stratejisi aşağıdakileri doğrulamanıza yardımcı olur:

  • Uygulamanızı bir uygulama paketi olarak oluşturabilirsiniz.
  • IDE, uygulama paketinden hedef cihaz yapılandırması için APK'ları çıkarabilir.
  • Özellik modüllerine ayırdığınız özellikler, uygulamanızın temel modülüyle uyumludur.
  • Uygulamanız hedef cihazda beklediğiniz gibi çalışıyor.

Varsayılan olarak, uygulamanızı Android Studio'dan bağlı bir cihaza dağıttığınızda IDE, hedef cihaz yapılandırmasına uygun APK'lar oluşturup dağıtır. Bunun nedeni, belirli bir cihaz yapılandırmasına göre APK oluşturmak, uygulamanızın desteklediği tüm cihaz yapılandırmaları için uygulama paketi oluşturmaktan daha hızlı olmasıdır.

Uygulamanızı bir uygulama paketi olarak derlemeyi test etmek ve ardından APK'ları bu uygulama paketinden bağlı cihazınıza dağıtmak istiyorsanız varsayılan Çalıştır/Hata Ayıklama yapılandırmasını aşağıdaki şekilde düzenlemeniz gerekir:

  1. Menü çubuğundan Çalıştır > Yapılandırmaları Düzenle'yi seçin.
  2. Sol bölmeden bir çalıştırma/hata ayıklama yapılandırması seçin.
  3. Sağ bölmede Genel sekmesini seçin.
  4. Dağıt'ın yanındaki açılır menüden Uygulama paketinden APK'yı seçin.
  5. Uygulamanızda test etmek istediğiniz bir hazır uygulama deneyimi varsa Hazır uygulama olarak dağıt'ın yanındaki kutuyu işaretleyin.
  6. Uygulamanızda özellik modülleri varsa her bir modülün yanındaki kutuyu işaretleyerek dağıtmak istediğiniz modülleri seçebilirsiniz. Android Studio, varsayılan olarak tüm özellik modüllerini dağıtır ve her zaman temel uygulama modülünü dağıtır.
  7. Uygula'yı veya Tamam'ı tıklayın.

Menü çubuğundan Çalıştır > Çalıştır'ı seçtiğinizde Android Studio bir uygulama paketi oluşturur ve bunu yalnızca seçtiğiniz bağlı cihaz ve özellik modüllerinin gerektirdiği APK'ları dağıtmak için kullanır.

Komut satırından derleme ve test etme

Android Studio ve Google Play'in uygulama paketinizi oluşturmak ve APK'lara dönüştürmek için kullandığı araçları komut satırından kullanabilirsiniz. Yani uygulamanızı bir Android App Bundle'dan yerel olarak derleyip dağıtmak için bu araçları komut satırından çağırabilirsiniz.

Bu yerel test araçları aşağıdakiler için yararlıdır:

  • Uygulama paketlerinin yapılandırılabilir derlemelerini, Sürekli Entegrasyon (CI) sunucunuza veya başka özel derleme ortamınıza entegre etme.
  • Uygulamanızın bir uygulama paketinden bir veya daha fazla bağlı test cihazına dağıtılmasını otomatikleştirme.
  • Uygulamanızın Google Play'den bağlı bir cihaza indirilmesi.

Komut satırından uygulama paketi oluşturma

Uygulama paketinizi komut satırından oluşturmak istiyorsanız bundletool veya Android Gradle eklentisini kullanabilirsiniz.

Android Gradle eklentisi: Google tarafından oluşturulan bu eklenti, Android Studio ile birlikte paket halinde gelir ve Maven deposu olarak da kullanılabilir. Eklenti, uygulama paketi oluşturmak için komut satırından çalıştırabileceğiniz komutları tanımlar. Eklenti, uygulama paketinizi oluşturmak için en kolay yöntemi sunsa da uygulamanızı bir test cihazına dağıtmak için bundletool aracılığıyla bu yöntemi kullanmanız gerekir.

bundletool: Bu komut satırı aracı, hem Android Gradle eklentisi hem de Google Play'in uygulamanızı uygulama paketi olarak oluşturmak için kullandığı araçtır ve GitHub'dan ulaşılabilir. Uygulama paketinizi oluşturmak için bundletool kullanmanın, eklentiyi kullanarak sadece bir Gradle görevi yürütmekten çok daha karmaşık olduğunu unutmayın. Bunun nedeni, eklentinin uygulama paketi oluşturmayla ilgili belirli ön koşulları otomatikleştirmesidir. Ancak bu araç, CI iş akışlarında uygulama paketi yapıları oluşturmak isteyen geliştiriciler için kullanışlıdır.

Her iki yaklaşımla da uygulama paketinizi oluşturmaya başlamak için Uygulamanızı komut satırından derleme başlıklı makaleyi okuyun.

Uygulamanızı komut satırından dağıtma

Android Gradle eklentisi, uygulama paketinizi komut satırından oluşturmanın en kolay yolu olsa da, uygulamanızı bir uygulama paketinden bağlı bir cihaza dağıtmak için bundletool kullanmanız gerekir. Bunun nedeni, bundletool uygulamasının uygulama paketinizi test etmenize ve Google Play üzerinden dağıtımı emüle etmenize yardımcı olmak için özel olarak tasarlanmış komutlar sağlamasıdır.

Aşağıda, bundletool kullanarak test edebileceğiniz farklı senaryo türleri verilmiştir:

  • Uygulamanızın desteklediği tüm cihaz yapılandırmaları için bölünmüş APK'ları içeren bir APK grubu oluşturun. bundletool tarafından uygulamanızı bağlı bir cihaza dağıtabilmek için genellikle APK grubu oluşturmanız gerekir.
  • Uygulamanızı bağlı bir cihaza ayarlanmış bir APK'dan dağıtın. bundletool, her cihaz yapılandırması için gereken bölünmüş APK'ları belirlemek amacıyla adb kullanır ve cihaza yalnızca bu APK'ları dağıtır. Birden fazla cihazınız varsa belirli bir cihazı hedeflemek için cihaz kimliğini bundletool adlı iş ortağına da iletebilirsiniz.
  • Özellik sunma seçeneklerini yerel olarak test edin. Uygulamanızı Play Console'da yayınlamadan cihazınızın Google Play'den özellik modüllerini indirip yüklemesini emüle etmek için bundletool kullanabilirsiniz. Uygulamanızın isteğe bağlı modül indirme isteklerini ve hatalarını ele alma şeklini yerel olarak test etmek istiyorsanız bu yöntem faydalı olacaktır.
  • Belirli bir cihaz yapılandırması için uygulamanızın indirme boyutunu tahmin edin. Bu, kullanıcıların uygulamanızı indirme deneyimini daha iyi anlamak ve uygulamanızın, uygulama paketleri veya hazır sürüm deneyimlerini etkinleştirme için sıkıştırılmış indirme boyutu kısıtlamasına uyup uymadığını kontrol etmek açısından faydalıdır.

Uygulama paketinizi Play'de test etme

Bu sayfada açıklanan diğer test stratejileri uygulamanızı Play'e yüklemenizi gerektirmese de, Play Console'u kullanarak test etmek kullanıcı deneyimini en doğru şekilde temsil eder. Uygulamanızı ister dahili paydaşlarınızla, dahili KG ekibinizle, kapalı bir alfa test kullanıcıları grubuyla veya daha geniş bir beta test kullanıcısı kitlesiyle paylaşmak isteyin, Play Console size çeşitli test stratejileri sunar.

Uygulamanızı aşağıdaki nedenlerden dolayı test etmek için Play Console'u kullanın:

  • Uygulamanızı indirme ve isteğe bağlı olarak özellikleri isteğe bağlı yükleme ile ilgili kullanıcı deneyiminin en doğru temsilini sağlamak istersiniz.
  • Bir test kullanıcısı grubuna kolay erişim sağlamak istiyorsunuz.
  • Testleri KG, alfa ve beta test kullanıcılarına sunmak istiyorsunuz.
  • Cihazda test edebileceğiniz uygulama yükleme geçmişine erişmek istiyorsunuz. Örneğin, performans regresyonları için sürümleri karşılaştırmak isteyebilirsiniz.

Uygulamanızı bir URL ile hızlıca paylaşın

Play Console test kanalları, uygulamanızı resmi test aşamalarından geçmek için bir yöntem sunsa da bazen uygulamanızı, e-posta veya kısa mesaj gibi daha az resmi kanallar üzerinden güvenilir test kullanıcılarıyla hızlı bir şekilde paylaşmak isteyebilirsiniz.

Uygulama paketinizi Play Console hızlı paylaşım sayfasına yükleyerek başkalarıyla kolayca paylaşabileceğiniz bir URL oluşturabilirsiniz. Uygulamanızı bu şekilde paylaşmak şu avantajları sağlar:

  • Ekibinizdeki herkese Play Console'daki uygulamanıza erişim izni vermeden test derlemelerini yükleme yetkisi verin.
  • Test kullanıcıları, uygulamanızın yalnızca kendileriyle paylaşılan belirli test sürümüne erişim elde ederler.
  • Test derlemeleri herhangi bir anahtarla imzalanabilir veya imzalanmayabilir. Bu nedenle yükleyicilerin de üretim veya yükleme anahtarınıza erişmesi gerekmez.
  • Sürüm kodlarının benzersiz olması gerekmez. Bu nedenle, mevcut bir sürüm kodunu yeniden kullanabilirsiniz ve yüklemek için kodu artırmanız gerekmez.
  • Özellikleri isteğe bağlı olarak indirme ve uygulama içi güncellemeler gibi özel yayınlama seçeneklerini test edin.
  • Uygulamanızın hata ayıklaması yapılabilir bir sürümünü paylaşarak önemli verileri ve günlükleri yakalayın.

Kullanıcılar Android cihazlarından URL'yi tıkladıklarında cihaz, uygulamanızın test sürümünü indirmek için Google Play Store'u otomatik olarak açar. Başlamak ve bu test stratejisinin özellikleri ve kısıtlamaları hakkında daha fazla bilgi edinmek için Uygulamanızı URL ile paylaşma bölümüne bakın veya aşağıdaki videoyu izleyin.

Uygulamanızın geçmiş sürümlerini indirme

Siz ve test kullanıcılarınız, uygulamanızın üretim veya test kanalına yüklediğiniz geçmiş sürümlerini de indirebilirsiniz. Örneğin, performans regresyonlarını kontrol etmek için uygulamanızın önceki bir sürümünü hızlı bir şekilde test etmek isterseniz bu özellik yararlı olabilir.

Play Console uygulama paketi gezgini sayfasını ziyaret edin ve yükleme bağlantısını kopyalamak için indirmek istediğiniz sürümün indirme sekmesine gidin. Alternatif olarak, test etmek istediğiniz uygulamanızın sürümünün paket adını ve sürüm kodunu biliyorsanız test cihazınızdan şu bağlantıyı ziyaret edebilirsiniz:

https://play.google.com/apps/test/package-name/version-code

Uygulamanızı bir test kanalına yükleyin

Uygulamanızı yükleyip Play Console'da bir sürüm oluşturduğunuzda, sürümünüzü üretime aktarmadan önce birden çok test aşamasından ilerleyebilirsiniz:

  • Dahili test: Uygulamanızı dahili test ve kalite güvencesi kontrolleri için hızlıca dağıtmak istiyorsanız dahili test sürümü oluşturun.
  • Kapalı: Uygulamanızın yayın öncesi sürümlerini daha geniş bir test kullanıcısı grubuyla test etmek için kapalı bir sürüm oluşturun. Daha küçük bir çalışan grubu veya güvenilir kullanıcılarla test yaptıktan sonra, testinizi açık sürüme genişletebilirsiniz. Uygulama sürümleri sayfanızda, ilk kapalı testiniz olarak bir Alfa kanalı olacaktır. Gerekirse başka kapalı kanallar da oluşturup ad verebilirsiniz.
  • Açık: Kapalı bir sürümü test ettikten sonra açık bir sürüm oluşturun. Açık sürümünüz, uygulamanızın üretim sürümünde yayınlanmasından önce test etmek için daha geniş bir kullanıcı yelpazesini içerebilir.

Uygulamanızı bu test aşamalarından her birinde ilerletmek, uygulamanızı üretim kanalına yayınlamadan önce daha geniş test kullanıcısı kitlelerine açmanıza olanak tanır. Play Console test kanalları hakkında daha fazla bilgi edinmek için Açık, kapalı veya dahili test oluşturma konusuna gidin.

Sorunları tanımlamak için lansman öncesi raporlarını kullanma

Açık veya kapalı kanala bir APK ya da uygulama paketi yüklediğinizde, Android'in farklı sürümlerini çalıştıran pek çok farklı cihazda sorunları belirleyebilirsiniz.

Play Console'daki lansman öncesi rapor, aşağıdakilerle ilgili olası sorunları belirlemenize yardımcı olur:

  • Kararlılık
  • Android uyumluluğu
  • Performans
  • Erişilebilirlik
  • Güvenlik açıkları

Uygulama paketinizi yükledikten sonra test cihazları otomatik olarak başlatılır ve uygulamanızı birkaç dakika boyunca tarar. Tarama, birkaç saniyede bir uygulamanızda yazma, dokunma ve kaydırma gibi işlemler gerçekleştirir.

Testler tamamlandıktan sonra, sonuçlarınızı Play Console'unuzun lansman öncesi rapor bölümünde bulabilirsiniz. Daha fazla bilgi edinmek için Sorunları tanımlamak için lansman öncesi raporları kullanma ile ilgili Play Console yardım konusuna bakın.

Belirli cihaz yapılandırmaları için APK'lara göz atıp bunları indirin

Uygulama paketinizi yüklediğinizde Play Console, uygulamanızın desteklediği tüm cihaz yapılandırmaları için otomatik olarak bölünmüş APK'lar ve çoklu APK'lar oluşturur. Play Console'da, Google Play'in oluşturduğu tüm APK yapılarını görmek, desteklenen cihazlar ve uygulamanızın yayınlama yapılandırması gibi verileri incelemek ve oluşturulan APK'ları indirerek yerel olarak dağıtıp test etmek için uygulama paketi gezginini kullanabilirsiniz.

Daha fazla bilgi edinmek için Uygulama paketi ayrıntılarınızı inceleme ile ilgili Play Console yardım konusunu okuyun.

Uygulama paketinizi Firebase App Distribution ile test edin

Firebase App Distribution, uygulamanızın yayın öncesi sürümlerini güvenilir test kullanıcılarına dağıtmayı kolaylaştırır. Böylece lansmandan önce değerli geri bildirimler alabilirsiniz.

App Distribution, tüm yayın öncesi derlemelerinizi merkezi bir merkezde yönetmenize olanak tanır ve bu derlemeleri doğrudan konsoldan veya halihazırda iş akışınızın bir parçası olan komut satırı araçlarını kullanarak dağıtma esnekliği sağlar.

Projenizi Firebase App Distribution için etkinleştirmek üzere uygulamanız gereken birkaç adım vardır. Firebase belgelerinin Başlamadan önce bölümüne göz atın. Projenizi oluşturduktan sonra App Distribution'ı iş akışınıza nasıl entegre etmek istediğinizi seçin: