Android için Java uygulamaları oluşturma

  • Makale

Ö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 hizmet 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 imzalanması gerekir.

Not

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

Uyarı

JCenter'ın yakın bir zaman ö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 Shutdown 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 izni gerekir.

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 değişkenleri build.gradle (uygulama düzeyi) dosyasında belirtilen Derleme Türleri ve Ürün Tatları'ndan doldurulur. Hangi derleme değişkeninin derlenmesi gerektiğini seçin.

Not

App Center Derlemesi, Derleme Türü (hata ayıklama, sürüm 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) oluşturma

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. Android Uygulama Paketi hakkında daha fazla bilgi için resmi Android belgelerinde bulabilirsiniz.

Uygulamasına ek olarak .apkbir .aab oluşturmak için Android Uygulama Paketi seçeneğini değiştirin. 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, etkinse 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 tatları dahil olmak üzere Gradle dosyanızdan belirli 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 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şturulsa bile normal .apk bir .aab değer 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.
  • oluşturma - 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 için (başarılı veya başarısız), 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 gidermeye ve anlamanıza yardımcı olur.

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 apk de oluşturmanız gerekir. Derleme sistemimiz bir ana APK dosyasıyla çalışır ve belirli bir CPU ABI veya ekran yoğunluğuna özgü tüm API'leri yoksayar. APK bölmeleri ve evrensel apk oluşturma hakkında daha fazla bilgi edinmek için ABI bölme kılavuzunu okuyun.

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

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

  • Uygulamanızda app Center SDK'sını 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 derleme için bu mapping.txt dosyanın okunabilir (engelsiz) kilitlenme raporlarını görüntülemesini 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 API düzeyi 24'e hedeflenmelidir.

Uygulamaların doğru yapılandırılabilmesi 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