Android için Java uygulamaları geliştirme

İlk Android uygulamanızı oluşturmak için şu adımları izleyin:

  1. Bağlan hizmeti hesabınıza (GitHub, Bitbucket, VSTS, Azure DevOps).
  2. Bir depo ve uygulamanın bulunduğu bir dal seçin.
  3. Oluşturmak istediğiniz Android projesini seçin.
  4. İlk derlemenizi ayarlayın.

Not

Uygulamanın gerçek bir cihazda çalışması için derlemenin geçerli bir sertifikayla imzalanmış kod olması gerekir.

Uyarı

JCenter'ın son kapatması nedeniyle, bazı uygulamalar, Gradle Görev hataları ile birlikte App Center. Lütfen Gradle tarafından sağlanan geçiş kılavuzunu görüntüleme. Geçici bir çözüm olarak, tüm jcenter() örnekleri dosyasından build.gradle kaldırılabilir ve ile jcenter { url "http://jcenter.bintray.com/"} değiştirilebilir. Burada JCenter Shutdown hakkında daha fazla bilgi okuyun.

1. Depoyu bağlama

Henüz bağlanmadıysanız depo hizmeti hesabınıza bağlanmanız gerekir. Hesabınız bağlandıktan sonra Android projenizin bulunduğu depoyu seçin. Depo için derleme ayarlamak üzere yönetici ve çekme iznine sahip olmak gerekir.

2. Dal seçme

Depoyu seçdikten sonra oluşturmak istediğiniz dalı seçin. Varsayılan olarak tüm etkin dallar listelenir.

3. İlk derlemenizi ayarlama

İlk derlemeden önce Android projesinin yapılandırılması gerekir.

3.1. Derleme tetikleyicileri

Varsayılan olarak, bir geliştirici yapılandırılan bir dala her itişişte yeni bir derleme tetiklenir. Bu, "Sürekli Tümleştirme" olarak adlandırılır. Yeni bir derlemeyi el ile tetiklemeyi tercih ederseniz yapılandırma bölmesinde bu ayarı değiştirebilirsiniz.

3.2. Derleme varyantı

Kullanılabilir derleme varyantları build.gradle (uygulama düzeyi) dosyasında belirtilen Derleme Türleri ve Ürün Aromaları'dan dolar. Hangi derleme varyantının derlemesi gerektiğini seçin.

Not

App Center Derleme, derleme türü (hata ayıklama, yayın veya özel tanımlı) ve gradle tarafından bildirilen Ürün Aromalarından birinin birleşimi olarak derleme çeşitlerini bulmayı destekler. Flavor Dimensions'ın (birden çok ürün aroması bileşimi) algılanması şu anda desteklenmiyor.

3.3. Android Uygulama Paketi Derleme (.aab)

Android Uygulama Paketi, Play Store cihazlar için iyileştirilmiş APK'ler oluşturmak için kullanılan bir dağıtım biçimidir. Android Uygulama Paketi hakkında daha fazla bilgi için resmi Android belgelerine bakın.

android uygulama paketine ek olarak bir üretmek için .aab seçeneğini açıp .apk açın. build.gradle (uygulama düzeyi) dosyası bloğu android.bundle içeriyorsa, bu seçenek zaten açık olur.

3.4. Artımlı sürüm numarası

Etkinleştirildiğinde, uygulamanın veri AndroidManifest.xml her derleme için otomatik olarak artırılır. Bu değişiklik gerçek derleme sırasında gerçekleşir ve depoya iş değişmez.

3.5. Kod imzalama

Başarılı bir derleme, etkinleştirilirse .apk bir dosya ve ek dosya .aab üretir. Derlemeyi Play Store için anahtar deposuna depolanmış geçerli bir sertifikayla imzalanmış olması gerekir. Daldan üretilen derlemeleri imzalamak için yapılandırma bölmesinde kod imzalamayı etkinleştirin, anahtar deponuza yükleyin ve yapılandırma bölmesinde ilgili kimlik bilgilerini girin. Kod imzalama hakkında daha fazla bilgi için App Center Android kod imzalama belgelerinde bulabilirsiniz. .aab, ile aynı kimlik bilgileri kullanılarak imzalanacak. .apk

3.6. Başarılı derlemenizi gerçek bir cihazda başlatma

Yeni oluşturulan APK dosyanızı kullanarak, uygulamanın gerçek bir cihazda başlatılap başlamay olduğunu test edin. Bu, toplam derleme süresine yaklaşık 10 dakika daha ekler. Başlatma testlerini yapılandırma hakkında daha fazla bilgi okuyun.

3.7. build.gradle (uygulama düzeyi) Dosyasından yapılandırma

Derlemeniz hakkında bağımlılıklar, derleme araçları sürümü, derleme türleri ve ürün türleri dahil olmak üzere Gradle dosyanıza özgü bilgiler toplanır.

3.8. Derlemeyi dağıtma

Bir daldan her başarılı derlemeyi, daha önce oluşturulmuş bir dağıtım grubuna veya depo hedefine dağıtılacak şekilde yapılandırarak. Dağıt hizmetinin içinde yeni bir dağıtım grubu ekleyebilir veya bir mağaza bağlantısı yapılandırabilirsiniz. Her zaman uygulamaya erişimi olan tüm kullanıcıları içeren "Ortak Çalışanlar" adlı bir varsayılan dağıtım grubu vardır.

Not

Dağıtım paketine Google Play Store, bir Android Uygulama Paketi ( .aab ) tercih edilir ve etkinleştirilirse dağıtılır. Dağıtım App Center ve Intune mağaza hedeflerini oluşturmak için, bir de .apk oluşturulsa .aab bile normal bir kullanılır.

4. Derleme sonuçları

Bir derleme tetiklendiğinde şu durumlarda olabilir:

  • kuyruğa alınan - derleme bir kuyrukta, kaynakların serbest bırakılana kadar beklemesi.
  • building - uygulama ilgili görevleri oluşturma ve çalıştırma.
  • başarılı - derleme başarıyla tamamlandı.
  • başarısız - derleme tamamlandı ama başarısız oldu. Sorun giderme için derleme günlüğünü indirip inceebilirsiniz.
  • iptal edildi - derleme kullanıcı eylemi tarafından iptal edildi veya zaman aldı.

4.1. Derleme günlükleri

Tamamlanmış bir derleme için (başarılı veya başarısız) derlemenin nasıl gittiğini daha iyi anlamak için günlükleri indirin. App Center aşağıdaki dosyaları bir arşiv sağlar:

|-- 1_build.txt (this is the general build log)
|-- build (this folder contains a separate log file for each build step)
    |-- <build-step-1>
    |-- <build-step-2>
    |--
    |-- <build-step-n> (e.g. n_Post Job Cleanup.txt)

Derleme adımına özgü günlükler (arşivin derleme/ dizininde bulunur), hangi adımda sorun giderme ve derlemenin başarısız olduğunu anlamada yardımcı olur.

4.2. Uygulama paketi (APK)

APK, Android uygulamasını ve varlıklarını içeren bir pakettir. Derleme doğru şekilde imzalandıysa, APK gerçek bir cihaza yükılabilir ve Play Store. Derleme imzalandı ise APK bir öykünücü üzerinde çalışır veya başka amaçlar için kullanılabilir.

4.3. Birden çok APK'sı bina

Uygulama yapılandırmanız birden çok APK derlemesi varsa, bir evrensel APK da derlemeniz gerekir. Derleme sistemimiz bir ana APK dosyasıyla çalışır ve belirli bir CPU ABI'ye veya ekran yoğunluğuna özgü tüm APK'ları yoksayacak. APK bölmeleri ve evrensel APK'ler hakkında daha fazla bilgi edinmek için ABI bölme kılavuzunu okuyun.

4.4. Deobfuscation-mapping dosyası (mapping.txt)

dosyası, uygulama için karartılmış yığın izlemelerini özgün sınıf ve yöntem adlarına geri eşleme mapping.txt hakkında bilgi içerir.

  • App Center SDK'yı uygulamanıza daha önce kilitlenme raporlama modülü etkinleştirilmiş olarak tümleştirdiyseniz ve uygulama ikili dosyasını en iyi şekilde görüntülemek ve karartmak için Proguard veya R8'i kullandıysanız, kilitlenme raporlama hizmeti bir derlemenin insan tarafından okunabilir (karartılan) kilitlenme raporlarını görüntülemesi için bu dosyayı mapping.txt gerektirir.
  • Daha önce uygulamanıza kilitlenme raporlama amacıyla başka bir SDK'yı tümleştiriyorsanız (hockeyApp SDK gibi), ilgili hizmet dosyanın okunabilir kilitlenme raporlarını mapping.txt görüntülemesi gerekir.

5. Desteklenen sürümler ve gereksinimler

Android uygulamaları derlemek için desteklenen en düşük sürüm 7.0'dır (API düzeyi 24). Android uygulamalarının çalışması için gereken en düşük API düzeyi daha düşük olabilir, ancak en az API düzeyi 24'ü hedeflemesi gerekir.

Uygulamaların doğru yapılandırılması için Gradle ve Android Gradle eklentisiyle derlemesi gerekir. Deponun bir Gradle sarmalayıcı içermesi gerekir.

Ayrıca bkz. Bulut Derleme Makinesi bilgileri