Baca dalam bahasa Inggris

Bagikan melalui


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:

  1. Sambungkan ke akun layanan repositori Anda (GitHub, Bitbucket, VSTS, Azure DevOps).
  2. Pilih repositori dan cabang tempat aplikasi Anda berada.
  3. Pilih proyek Android yang ingin Anda buat.
  4. 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.

1. Menautkan repositori Anda

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.

2. Memilih cabang

Setelah memilih repositori, pilih cabang yang ingin Anda bangun. Secara default, semua cabang aktif akan dicantumkan.

3. Menyiapkan build pertama Anda

Sebelum build pertama Anda, proyek Android perlu dikonfigurasi.

3.1. Membangun pemicu

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.

3.2. Varian build

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.

3.3. Build Android App Bundle (.aab)

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.

3.4. Nomor versi kenaikan

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.

3.5. Penandatanganan kode

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.

3.6. Luncurkan build anda yang sukses pada perangkat nyata

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.

3.8. Mendistribusikan build

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.

4. Hasil build

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.

4.1. Log build

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.

4.2. Paket aplikasi (APK)

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.

4.3. Membangun beberapa APK

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.

4.4. File pemetaan deobfuscation (mapping.txt)

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.

5. Versi dan persyaratan yang didukung

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