Membangun aplikasi Java untuk Android
Penting
Visual Studio App Center dijadwalkan untuk dihentikan pada 31 Maret 2025. Meskipun Anda dapat terus menggunakan Visual Studio App Center hingga sepenuhnya dihentikan, ada beberapa alternatif yang direkomendasikan yang mungkin Anda pertimbangkan untuk bermigrasi.
Pelajari selengkapnya tentang garis waktu dukungan dan alternatif.
Untuk membuat aplikasi Android pertama Anda, ikuti langkah-langkah berikut:
- Sambungkan ke akun layanan repositori Anda (GitHub, Bitbucket, VSTS, Azure DevOps).
- Pilih repositori dan cabang tempat aplikasi Anda berada.
- Pilih proyek Android yang ingin Anda buat.
- Siapkan build pertama Anda.
Catatan
Agar aplikasi berjalan pada perangkat nyata, build harus ditandatangani kode dengan sertifikat yang valid.
Catatan
App Center melacak proyek dengan mencari file direktori gradle (dan gradlew) proyek Android. Jangan sertakan file-file ini dalam proyek .gitignore karena App Center Build tidak akan dapat menemukannya.
Peringatan
Karena penonaktifan JCenter baru-baru ini, aplikasi tertentu mungkin mengalami kegagalan Tugas Gradle saat membangun dengan App Center. Lihat panduan migrasi yang disediakan oleh Gradle. Sebagai solusinya, semua instans jcenter()
dapat dihapus dari build.gradle
file, dan diganti dengan jcenter { url "http://jcenter.bintray.com/"}
. Baca selengkapnya tentang JCenter Shutdown di sini.
Anda harus tersambung ke akun layanan repositori Anda jika Anda belum melakukannya. Setelah akun Anda tersambung, pilih repositori tempat proyek Android Anda berada. Untuk menyiapkan build untuk repositori, Anda memerlukan admin dan izin penarikan untuk repositori tersebut.
Setelah memilih repositori, pilih cabang yang ingin Anda bangun. Secara default, semua cabang aktif akan dicantumkan.
Sebelum build pertama Anda, proyek Android perlu dikonfigurasi.
Secara default, build baru dipicu setiap kali pengembang mendorong ke cabang yang dikonfigurasi. Ini disebut sebagai "Integrasi Berkelanjutan". Jika Anda lebih suka memicu build baru secara manual, Anda dapat mengubah pengaturan ini di panel konfigurasi.
Varian build yang tersedia akan diisi dari Jenis Build dan Ragam Produk yang ditentukan dalam file build.gradle (tingkat aplikasi). Pilih varian build mana yang harus dibuat.
Catatan
App Center Build mendukung penemuan varian build sebagai kombinasi Jenis Build (debug, rilis, atau kustom yang ditentukan) dan salah satu Ragam Produk yang dideklarasikan gradle Anda. Deteksi Dimensi Rasa (kombinasi beberapa ragam produk) tidak didukung saat ini.
Android App Bundle adalah format distribusi yang diunggah ke Play Store dan digunakan untuk menghasilkan APK yang dioptimalkan untuk perangkat tertentu. Anda dapat mengetahui lebih lanjut tentang Android App Bundle dalam dokumentasi Android resmi.
Alihkan opsi untuk Android App Bundle untuk menghasilkan .aab
selain .apk
. build.gradle
Jika file (tingkat aplikasi) berisi android.bundle
blok, opsi ini akan sudah aktif.
Saat diaktifkan, kode versi di AndroidManifest.xml aplikasi Anda secara otomatis meningkat untuk setiap build. Perubahan terjadi selama build aktual dan tidak akan diterapkan ke repositori Anda.
Build yang .apk
berhasil akan menghasilkan file dan file tambahan .aab
jika diaktifkan. Untuk merilis build ke Play Store, build perlu ditandatangani dengan sertifikat yang valid yang disimpan di keystore. Untuk menandatangani build yang dihasilkan dari cabang, aktifkan penandatanganan kode di panel konfigurasi, unggah keystore Anda ke repositori Anda, dan berikan kredensial yang relevan di panel konfigurasi. Anda dapat membaca selengkapnya tentang penandatanganan kode di dokumentasi penandatanganan kode Android App Center. .aab
akan ditandatangani menggunakan kredensial yang sama dengan .apk
.
Gunakan file APK yang baru diproduksi untuk menguji apakah aplikasi Anda dimulai pada perangkat nyata. Ini menambahkan sekitar 10 menit lagi ke total waktu build. Baca selengkapnya tentang cara mengonfigurasi pengujian peluncuran.
3.7. Mengonfigurasi dari File build.gradle (tingkat aplikasi)
Informasi spesifik tentang build Anda akan dikumpulkan dari file Gradle Anda termasuk dependensi, versi alat build, jenis build, dan ragam produk.
Anda dapat mengonfigurasi setiap build yang berhasil dari cabang untuk didistribusikan ke grup distribusi yang dibuat sebelumnya atau tujuan penyimpanan. Anda dapat menambahkan grup distribusi baru atau mengonfigurasi koneksi penyimpanan dari dalam layanan Distribusikan. Selalu ada grup distribusi default yang disebut "Kolaborator" yang mencakup semua pengguna yang memiliki akses ke aplikasi.
Catatan
Jika mendistribusikan ke Google Play Store, Android App Bundle (.aab
) lebih disukai dan akan didistribusikan jika diaktifkan. Untuk grup distribusi App Center dan tujuan penyimpanan Intune, reguler .apk
akan digunakan bahkan jika juga .aab
dihasilkan.
Setelah build dipicu, build dapat berada di status ini:
- diantrekan - build dalam antrean menunggu sumber daya dibebaskan.
- building - aplikasi sedang membangun dan menjalankan tugas terkait.
- berhasil - build berhasil diselesaikan.
- gagal - build selesai, tetapi gagal. Anda dapat mengunduh dan memeriksa log build untuk pemecahan masalah.
- dibatalkan - build dibatalkan oleh tindakan pengguna, atau waktunya habis.
Untuk build yang telah selesai (berhasil atau gagal), unduh log untuk memahami lebih lanjut tentang bagaimana build berjalan. App Center menyediakan arsip dengan file berikut:
|-- 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)
Log khusus langkah build (terletak di direktori build/arsip) sangat membantu untuk pemecahan masalah dan pemahaman dalam langkah apa dan mengapa build gagal.
APK adalah paket yang berisi aplikasi dan aset Android. Jika build ditandatangani dengan benar, APK dapat diinstal pada perangkat nyata dan disebarkan ke Play Store. Jika build belum ditandatangani, APK dapat dijalankan pada emulator atau digunakan untuk tujuan lain.
Jika konfigurasi aplikasi Anda membangun beberapa APK, Anda juga perlu membuat APK universal. Sistem build kami bekerja dengan satu file APK utama dan akan mengabaikan semua APK khusus untuk ABI CPU atau kepadatan layar tertentu. Untuk mempelajari lebih lanjut tentang pemisahan APK dan membangun APK universal, baca panduan pemisahan ABI.
File mapping.txt
berisi informasi tentang cara memetakan jejak tumpukan yang dikaburkan untuk aplikasi kembali ke kelas asli dan nama metode.
- Jika sebelumnya Anda telah mengintegrasikan App Center SDK di aplikasi Anda dengan modul pelaporan crash yang diaktifkan dan menggunakan Proguard atau R8 untuk mengecilkan dan mengaburkan biner aplikasi, layanan pelaporan crash memerlukan file ini
mapping.txt
agar build dapat menampilkan laporan crash yang dapat dibaca manusia (deobfuscated). - Jika sebelumnya Anda telah mengintegrasikan SDK lain untuk tujuan pelaporan crash di aplikasi Anda (misalnya, HockeyApp SDK), layanan terkait memerlukan
mapping.txt
file untuk menampilkan laporan crash yang dapat dibaca.
Versi minimum yang didukung untuk membuat aplikasi Android adalah 7.0 (API level 24). Aplikasi Android dapat memiliki tingkat API minimum yang lebih rendah yang diperlukan untuk dijalankan, tetapi harus menargetkan setidaknya API level 24.
Aplikasi harus dibuat dengan Gradle dan plugin Android Gradle untuk dikonfigurasi dengan benar. Repositori Anda perlu menyertakan pembungkus Gradle.
Lihat juga: Informasi Cloud Build Machine