Android için Java uygulamaları oluşturma

Önemli

Visual Studio App Center 31 Mart 2025'te kullanımdan kaldırılıyor. Tamamen kullanımdan kaldırılana kadar Visual Studio App Center'ı kullanmaya devam edebilirsiniz ancak geçiş yapmayı düşünebileceğiniz birkaç önerilen alternatif vardır.

Destek zaman çizelgeleri ve alternatifleri hakkında daha fazla bilgi edinin.

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

1. Depo hizmeti hesabınıza (GitHub, Bitbucket, VSTS, Azure DevOps) bağlanın.
2. Bir depo ve uygulamanızı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 kod imzalanması gerekir.

Not

App Center, Android projesinin gradle (ve gradlew) dizin dosyalarını arayarak projeyi izler. App Center Derlemesi bunları bulamayacağından lütfen bu dosyaları .gitignore projesine eklemeyin.

Uyarı

JCenter'ın yakın bir süre önce kapatılması nedeniyle, bazı uygulamalar App Center ile derleme sırasında Gradle Görevi hatalarıyla karşılaşabilir. Lütfen Gradle tarafından sağlanan geçiş kılavuzunu görüntüleyin. Geçici bir çözüm olarak, tüm örnekleri jcenter() dosyasından build.gradle kaldırılabilir ve ile jcenter { url "http://jcenter.bintray.com/"}değiştirilebilir. JCenter Kapatma hakkında daha fazla bilgiyi burada bulabilirsiniz.

1. Deponuzu bağlama

Henüz yapmadıysanız depo hizmet hesabınıza bağlanmanız gerekir. Hesabınız bağlandıktan sonra Android projenizin bulunduğu depoyu seçin. Bir depo için derleme ayarlamak için yönetici ve çekme iznine ihtiyacınız vardır.

2. Dal seçme

Bir depo seçtikten sonra, oluşturmak istediğiniz dalı seçin. Varsayılan olarak, tüm etkin dallar listelenir.

3. İlk derlemenizi ayarlama

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

3.1. Derleme tetikleyicileri

Varsayılan olarak, bir geliştirici yapılandırılmış bir dala her gönderildiğinde yeni bir derleme tetiklenir. Buna "Sürekli Tümleştirme" denir. Yeni bir derlemeyi el ile tetiklemek isterseniz, yapılandırma bölmesinde bu ayarı değiştirebilirsiniz.

3.2. Derleme değişkeni

Kullanılabilir derleme varyantları build.gradle (uygulama düzeyi) dosyasında belirtilen Derleme Türleri ve Ürün Türleri'nden doldurulur. Hangi derleme değişkeninin derlenmesi gerektiğini seçin.

Not

App Center Derlemesi, Derleme Türü (hata ayıklama, yayın veya özel tanımlı) ile gradle bildirilen Ürün Tatlarınızdan birinin birleşimi olarak derleme değişkenlerini bulmayı destekler. Flavor Dimensions'ın (birden çok ürün çeşidinin birleşimi) algılanması şu anda desteklenmemektedir.

3.3. Android Uygulama Paketi (.aab) derleme

Android Uygulama Paketi, Play Store'a yüklenen ve belirli cihazlar için iyileştirilmiş API'ler oluşturmak için kullanılan bir dağıtım biçimidir. Resmi Android belgelerinde Android Uygulama Paketi hakkında daha fazla bilgi edinebilirsiniz.

Android Uygulama Paketi seçeneğini değiştirerek öğesine ek olarak .apkbir .aab de oluşturun. build.gradle(uygulama düzeyi) dosyası bloğu içeriyorsaandroid.bundle, bu seçenek zaten açık olacaktır.

3.4. Sürüm numarasını artırma

Etkinleştirildiğinde, uygulamanızın AndroidManifest.xml sürüm kodu her derleme için otomatik olarak artar. Değişiklik gerçek derleme sırasında gerçekleşir ve deponuza işlenmez.

3.5. Kod imzalama

Başarılı bir derleme, etkinleştirilirse bir .apk dosya ve ek .aab bir dosya oluşturur. Derlemeyi Play Store'a yayınlamak için bir anahtar deposunda depolanan geçerli bir sertifikayla imzalanması gerekir. Bir daldan oluşturulan derlemeleri imzalamak için yapılandırma bölmesinde kod imzalamayı etkinleştirin, anahtar deponuzu deponuza yükleyin ve yapılandırma bölmesinde ilgili kimlik bilgilerini sağlayın. App Center'ın Android kod imzalama belgelerinde kod imzalama hakkında daha fazla bilgi edinebilirsiniz. ile .aab aynı kimlik bilgileri .apkkullanılarak imzalanır.

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

Uygulamanızın gerçek bir cihazda başlayıp başlamadiğini test etmek için yeni üretilen APK dosyanızı kullanın. Bu, toplam derleme süresine yaklaşık 10 dakika daha ekler. Başlatma testlerini yapılandırma hakkında daha fazla bilgi edinin.

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

Derlemenizle ilgili bağımlılıklar, derleme araçları sürümü, derleme türleri ve ürün türleri gibi belirli bilgiler Gradle dosyanızdan toplanır.

3.8. Derlemeyi dağıtma

Bir daldan her başarılı derlemeyi, önceden oluşturulmuş bir dağıtım grubuna veya bir depo hedefine dağıtılacak şekilde yapılandırabilirsiniz. Dağıtım hizmetinin içinden 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

Google Play Store'a dağıtılıyorsa bir Android Uygulama Paketi (.aab) tercih edilir ve etkinleştirilirse dağıtılır. App Center dağıtım grupları ve Intune depolama hedefleri için, bir de oluşturulmuş olsa .aab bile bir normal .apk kullanılır.

4. Derleme sonuçları

Bir derleme tetiklendikten sonra şu durumlarda olabilir:

• kuyruğa alındı - derleme, kaynakların boşaltılması için bekleyen bir kuyruktadır.
• derleme - uygulama ilgili görevleri derleyip çalıştırıyor.
• başarılı - derleme başarıyla tamamlandı.
• başarısız oldu - derleme tamamlandı, ancak başarısız oldu. Sorun giderme için derleme günlüğünü indirebilir ve inceleyebilirsiniz.
• iptal edildi - derleme kullanıcı eylemi tarafından iptal edildi veya zaman aşımına uğradı.

4.1. Derleme günlükleri

Tamamlanmış bir derleme (başarılı veya başarısız) için derlemenin nasıl gittiği hakkında daha fazla bilgi edinmek için günlükleri indirin. App Center aşağıdaki dosyaları içeren 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 derlemesinde/dizininde bulunur), derlemenin hangi adımda ve neden başarısız olduğunu anlamak için sorun giderme ve anlama açısından yararlıdır.

4.2. Uygulama paketi (APK)

APK, Android uygulamasını ve varlıklarını içeren bir pakettir. Derleme doğru şekilde imzalanmışsa APK gerçek bir cihaza yüklenebilir ve Play Store'a dağıtılabilir. Derleme imzalanmamışsa APK bir öykünücü üzerinde çalıştırılabilir veya başka amaçlarla kullanılabilir.

4.3. Birden çok API oluşturma

Uygulama yapılandırmanız birden çok API oluşturuyorsa, evrensel bir APK de oluşturmanız gerekir. Derleme sistemimiz bir ana APK dosyası ile çalışır ve belirli bir CPU ABI veya ekran yoğunluğuna özgü tüm API'leri yoksayar. APK bölmeleri ve evrensel bir APK oluşturma hakkında daha fazla bilgi edinmek için ABI split kılavuzunu okuyun.

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

dosyası, mapping.txt uygulama için karartılmış yığın izlemelerinin özgün sınıf ve yöntem adlarına nasıl eşlenmesiyle ilgili bilgiler içerir.

• App Center SDK'sını uygulamanıza daha önce kilitlenme raporlama modülü etkin olarak tümleştirdiyseniz ve uygulama ikili dosyasını küçültmek ve karartmak için Proguard veya R8 kullandıysanız, kilitlenme raporlama hizmeti bir derlemenin insanlar tarafından okunabilir (engelsiz) kilitlenme raporlarını görüntülemesi için bu mapping.txt dosyayı gerektirir.
• Daha önce uygulamanızda kilitlenme raporlama amacıyla başka bir SDK'yı tümleştirdiyseniz (örneğin HockeyApp SDK), ilgili hizmet dosyanın okunabilir kilitlenme raporlarını görüntülemesini gerektirir mapping.txt .

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 24 API düzeyini hedeflemesi gerekir.

Uygulamaların doğru yapılandırılması için Gradle ve Android Gradle eklentisiyle derlenmiş olması gerekir. Deponuzun bir Gradle sarmalayıcı içermesi gerekir.

Ayrıca bkz: Bulut Derleme Makinesi bilgileri