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

Android App Bundle, uygulamanızı birden fazla cihaz yapılandırmasında oluşturmak, yayınlamak ve dağıtmak için önerilen yöntemdir. Uygulama paketleri, Play Özellik Dağıtımı, Play Asset Delivery ve hazır uygulama deneyimleri gibi gelişmiş özellikleri de etkinleştirir. Uygulama paketlerini kullanmaya yeni başlıyor veya daha gelişmiş kullanım alanları için geliştirme yapıyor olsanız da bu sayfada, uygulamanızı geliştirmenin her aşamasında test etmek için kullanabileceğiniz çeşitli stratejilere genel bir bakış sunulmaktadır.

Uygulama paketlerini kullanmaya yeni başladıysanız Android App Bundle'lar hakkında başlıklı makaleyi okuyun.

Android Studio'yu kullanarak uygulama paketi oluşturma

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

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

  1. Android Studio 3.2 veya sonraki sürümleri indirin. Özellik modülleri eklemenin ve uygulama paketleri oluşturmanın en kolay yolu budur.

  2. Android Studio'yu kullanarak Android App Bundle oluşturun. Ayrıca, çalıştırma/hata ayıklama yapılandırmanızı değiştirerek ve uygulama paketinden APK dağıtma seçeneğini belirleyerek uygulamanızı bir uygulama paketinden bağlı bir cihaza dağıtabilirsiniz. Bu seçeneğin kullanılmasının, yalnızca bir APK oluşturmaya ve dağıtmaya kıyasla daha uzun derleme sürelerine neden olacağını unutmayın.

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

  4. Uygulamayı Play Uygulama İmzalama'ya kaydedin. 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 derleyebilir ve doğrudan IDE'den bağlı bir cihaza dağıtabilirsiniz. IDE ve Google Play, APK'ları cihaza ayıklamak 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ı uygulama paketi olarak oluşturabilirsiniz.
  • IDE, uygulama paketinden hedef cihaz yapılandırması için APK'ları ayıklayabilir.
  • Özellik modüllerine ayırdığınız özellikler, uygulamanızın temel modülüyle uyumludur.
  • Uygulamanız, hedef cihazda beklediğiniz gibi çalışır.

Varsayılan olarak, uygulamanızı Android Studio'dan bağlı bir cihaza dağıttığınızda IDE, hedef cihaz yapılandırması için APK'ları oluşturur ve dağıtır. Bunun nedeni, belirli bir cihaz yapılandırması için APK oluşturmanın, 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ı uygulama paketi olarak derleyip ardından bu uygulama paketindeki APK'ları bağlı cihazınıza dağıtmayı test etmek istiyorsanız varsayılan çalıştırma/hata ayıklama yapılandırmasını aşağıdaki gibi 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. Yayınla'nı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 seçeneğinin yanındaki kutuyu işaretleyin.
  6. Uygulamanız özellik modülleri içeriyorsa her 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 ve her zaman temel uygulama modülünü dağıtır.
  7. Uygula 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 yalnızca bağlı cihazın ve seçtiğiniz özellik modüllerinin gerektirdiği APK'ları dağıtmak için kullanır.

Komut satırından oluşturma 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 diğer özel derleme ortamlarına entegre etme.
  • Uygulamanızı bir uygulama paketinden bir veya daha fazla bağlı test cihazına dağıtmayı otomatikleştirme
  • Uygulamanızın Google Play'den bağlı bir cihaza indirilmesini taklit etme.

Komut satırından uygulama paketi oluşturma

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

Android Gradle eklentisi: Google tarafından yazılan bu eklenti, Android Studio ile birlikte gelir ve Maven deposu olarak da kullanılabilir. Bu eklenti, uygulama paketi oluşturmak için komut satırından yürütebileceğiniz komutları tanımlar. Bu eklenti, uygulama paketinizi oluşturmanın en kolay yöntemini sunsa da uygulamanızı bir test cihazına dağıtmak için bundletool üzerinden kullanmanız gerekir.

bundletool: Bu komut satırı aracı, hem Android Gradle eklentisi hem de Google Play'in uygulamanızı uygulama paketi olarak derlemek için kullandığı araçtır ve GitHub'dan edinilebilir. Uygulama paketinizi oluşturmak için bundletool kullanmanın, eklentiyi kullanarak bir Gradle görevini çalıştırmaktan ç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ışında uygulama paketi yapıları oluşturmak isteyen geliştiriciler için kullanışlıdır.

Uygulama paketinizi bu iki yaklaşımdan biriyle oluşturmaya başlamak için Uygulamanızı komut satırından oluşturma başlıklı makaleyi okuyun.

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

Android Gradle eklentisi, uygulama paketinizi komut satırından derlemenin 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'ün uygulama paketinizi test etmenize ve Google Play üzerinden dağıtımı taklit etmenize yardımcı olmak için özel olarak tasarlanmış komutlar sunmasıdır.

bundletool'ü kullanarak test edebileceğiniz farklı senaryo türleri şunlardır:

  • 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'ün uygulamanızı bağlı bir cihaza dağıtabilmesi için genellikle bir APK grubu oluşturmanız gerekir.
  • APK grubundan bağlı bir cihaza uygulamanızı dağıtın. bundletool, her cihaz yapılandırması için gereken bölünmüş APK'ları belirlemek üzere adb'yi 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'e iletebilirsiniz.
  • Özellik yayınlama seçeneklerini yerel olarak test edin. Uygulamanızı Play Console'da yayınlamadan, cihazınızın Google Play'den özellik modülleri indirip yüklemesini taklit etmek için bundletool'ü kullanabilirsiniz. Bu, uygulamanızın seç-izle modülü indirme isteklerini ve hatalarını nasıl işlediğini yerel olarak test etmek istiyorsanız yararlıdır.
  • Belirli bir cihaz yapılandırması için uygulamanızın indirme boyutunu tahmin edin. Bu, uygulamanızın indirilmesiyle ilgili kullanıcı deneyimini daha iyi anlamanıza ve uygulamanızın uygulama paketleri için sıkıştırılmış indirme boyutu kısıtlamasını karşılayıp karşılamadığını kontrol etmenize veya anında deneyimleri etkinleştirmenize yardımcı olur.

Uygulama paketinizi Play'de test etme

Bu sayfada açıklanan diğer test stratejileri için uygulamanızı Play'e yüklemeniz gerekmez. Ancak Play Console'u kullanarak test yapmak, kullanıcı deneyimini en doğru şekilde yansıtır. Uygulamanızı dahili paydaşlarınızla, dahili QA ekibinizle, kapalı bir alfa test kullanıcısı grubuyla veya daha geniş bir beta test kullanıcısı kitlesiyle paylaşmak isterseniz Play Console size çeşitli test stratejileri sunar.

Uygulamanızı test etmek için Play Console'u aşağıdaki nedenlerle kullanabilirsiniz:

  • Uygulamanızın indirilmesi ve isteğe bağlı olarak özelliklerinin yüklenmesi sırasındaki kullanıcı deneyiminin en doğru şekilde gösterilmesini istiyorsunuz.
  • Bir test kullanıcısı grubuna kolay erişim sağlamak istiyorsanız
  • Testleri kalite güvencesi, alfa ve beta test kullanıcılarını kapsayacak şekilde kapsamlandırmak istiyorsunuz.
  • Bir cihazda test edebileceğiniz uygulama yükleme geçmişine erişmek istiyorsunuz. Örneğin, performanstaki gerilemeler için sürümleri karşılaştırmak istiyorsanız.

Uygulamanızı URL ile hızlıca paylaşma

Play Console test kanalları, uygulamanızı resmi test aşamalarından geçirmenin bir yöntemini 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şmanın avantajları:

  • Ekibinizdeki herhangi bir kullanıcıya, Play Console'da uygulamanıza erişim izni vermeden test derlemeleri yükleme yetkisi verebilirsiniz.
  • Test kullanıcıları, uygulamanızın yalnızca kendileriyle paylaşılan test sürümüne erişebilir.
  • Test derlemeleri herhangi bir anahtarla veya hiç imzalanmadan oluşturulabilir. Bu nedenle, yükleyicilerin üretim veya yükleme anahtarınıza erişmesi de gerekmez.
  • Sürüm kodlarının benzersiz olması gerekmez. Bu nedenle, mevcut bir sürüm kodunu yeniden kullanabilir ve yüklemek için kodu artırmanız gerekmez.
  • İsteğe bağlı olarak indirilen özellikler ve uygulama içi güncellemeler gibi özel yayınlama seçeneklerini test edin.
  • Uygulamanızın hata ayıklama yapılabilir bir sürümünü paylaşarak önemli verileri ve günlükleri yakalayabilirsiniz.

Kullanıcılar Android cihazlarından URL'yi tıkladığında cihaz, uygulamanızın test sürümünü indirmek için otomatik olarak Google Play Store'u 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 başlıklı makaleyi inceleyin 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, performansta gerileme olup olmadığını kontrol etmek için uygulamanızın önceki bir sürümünü hızlıca test etmek istiyorsanız bu özellikten yararlanabilirsiniz.

Play Console'un En son sürümler ve paketler sayfasını ziyaret edin ve indirmek istediğiniz sürümün indirme sekmesine giderek yükleme bağlantısını kopyalayın. Alternatif olarak, test etmek istediğiniz uygulama sürümünün paket adını ve sürüm kodunu biliyorsanız test cihazınızdan aşağıdaki bağlantıyı ziyaret edebilirsiniz:

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

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

Uygulamanızı yükleyip Play Console'da bir sürüm oluşturduğunuzda, sürümünüzü üretime göndermeden önce birden fazla test aşamasından geçirebilirsiniz:

  • 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ı grubu ile 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ının her birinde ilerletmek, uygulamanızı üretime sunmadan önce daha geniş test kullanıcısı kitlelerine açmanız anlamına gelir. Play Console test kanalları hakkında daha fazla bilgi için Açık, kapalı veya dahili test oluşturma başlıklı makaleyi inceleyin.

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

Açık veya kapalı kanala 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'unuzdaki 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 hızlıca 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ı belirlemek amacıyla lansman öncesi raporları kullanma başlıklı Play Console yardım konusuna göz atın.

Belirli cihaz yapılandırmalarına ait APK'lara göz atma ve indirme

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ı yerel olarak dağıtmak ve test etmek için En son sürümler ve paketler'i 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 etme

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, uygulamanızı yayınlamadan önce değerli geri bildirimler alabilirsiniz.

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

Projenizi Firebase Uygulama Dağıtımı için etkinleştirmek üzere uygulamanız gereken birkaç adım vardır. Firebase dokümanlarının Başlamadan önce bölümüne göz atın. Projenizi oluşturduktan sonra uygulama dağıtımını iş akışınıza nasıl entegre etmek istediğinizi seçin: