Membangun aplikasi React Native untuk Android

  • Artikel

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 dapat Anda pertimbangkan untuk bermigrasi.

Pelajari selengkapnya tentang garis waktu dukungan dan alternatif.

App Center dapat membuat aplikasi React Native menggunakan React Native versi 0.34 atau yang lebih baru.

Untuk mulai membangun aplikasi Android React Native pertama, Anda harus:

  1. Sambungkan ke akun layanan repositori Anda (GitHub, Bitbucket, VSTS, Azure DevOps).
  2. Pilih repositori dan cabang tempat aplikasi Anda berada.
  3. Pilih proyek package.json yang ingin Anda bangun.
  4. Siapkan build pertama Anda.

Catatan

Agar aplikasi berjalan pada perangkat nyata, build harus ditandatangani kode dengan sertifikat yang valid.

1. Menautkan repositori Anda

Jika sebelumnya Anda belum tersambung ke akun layanan repositori, Anda harus melakukan ini terlebih dahulu. Setelah akun Anda tersambung, pilih repositori tempat proyek React Native Anda berada. Anda harus memiliki admin dan menarik izin untuk menyiapkan build untuk repositori.

2. Memilih cabang

Setelah memilih repositori, pilih cabang yang ingin Anda bangun. Secara default, App Center mencantumkan semua cabang aktif.

3. Menyiapkan build pertama Anda

Sebelum build pertama, Anda harus mengonfigurasi proyek React Native.

3.1. Project

Pilih proyek package.jsonAnda. App Center akan secara otomatis mengekstrak informasi dari file build.gradle (tingkat aplikasi) terkait, termasuk dependensi, versi alat build, jenis build, dan ragam produk.

Catatan

Untuk performa terbaik, analisis saat ini terbatas pada empat tingkat direktori termasuk akar repositori Anda.

3.2. Varian build

Varian build yang tersedia akan diisi dari Jenis Build dan Ragam Produk yang ditentukan dalam file build.gradle (tingkat aplikasi) proyek. Pilih varian build mana yang harus dibuat.

Catatan

App Center Build mendukung penemuan varian build sebagai kombinasi Jenis Build (debug, rilis, atau ditentukan khusus) dan satu Ragam Produk opsional. Mendeteksi kombinasi beberapa ragam produk tidak didukung saat ini.

3.3. versi Node.js

Pilih versi Node.js yang akan digunakan untuk build Baca selengkapnya tentang cara memilih versi Node.js

3.4. 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 bisa mengubah pengaturan ini di panel konfigurasi.

3.5. Build Android App Bundle (.aab)

Android App Bundle adalah format distribusi yang dapat diunggah ke Play Store. Ini digunakan untuk menghasilkan APK yang dioptimalkan untuk perangkat tertentu. Anda dapat mengetahui lebih lanjut tentang Android App Bundle dalam dokumentasi resmi Android, yang juga membantu Anda memahami apakah Anda ingin membuat bundel bersama dengan reguler Anda .apk.

Alihkan opsi untuk Android App Bundle untuk menghasilkan .aab selain .apk. build.gradle Jika file (tingkat aplikasi) berisi android.bundle blok, opsi ini akan secara otomatis diaktifkan.

3.6. 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 pada repositori Anda.

3.7. Luncurkan build sukses Anda pada perangkat nyata

Gunakan file APK yang baru diproduksi untuk menguji apakah aplikasi Anda dimulai pada perangkat nyata. Pengujian peluncuran akan menambahkan sekitar 10 menit lagi ke total waktu build. Baca selengkapnya tentang cara mengonfigurasi pengujian peluncuran.

3.8. Penandatanganan kode

Build yang .apk berhasil akan menghasilkan file dan file tambahan .aab jika diaktifkan. Untuk merilis build ke Play Store, build harus 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 nilai yang relevan di panel konfigurasi. Anda dapat membaca selengkapnya tentang kode Android yang menandatangani dokumentasi penandatanganan kode Android App Center. .aab akan ditandatangani menggunakan kredensial yang sama dengan .apk.

3.9. 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 Distribusi. 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 Intune tujuan penyimpanan, reguler .apk akan digunakan bahkan jika .aab juga dihasilkan.

4. Hasil build

Setelah build memicu, build akan berada di salah satu status berikut:

  • diantrekan - build dalam antrean menunggu sumber daya dibebaskan
  • building - build menjalankan tugas yang telah ditentukan sebelumnya
  • berhasil - build selesai dan berhasil
  • gagal - build telah selesai tetapi gagal; Anda dapat memecahkan masalah apa yang salah dengan mengunduh dan memeriksa log build
  • dibatalkan - build telah 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 cara 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 build/ direktori arsip) sangat membantu untuk pemecahan masalah dan pemahaman dalam langkah apa dan mengapa build gagal.

4.2. Aplikasi (.apk)

File .apk adalah file paket aplikasi Android yang menyimpan aplikasi Android. Jika build telah ditandatangani dengan benar, aplikasi dapat diinstal pada perangkat nyata dan disebarkan ke Play Store. Jika build belum ditandatangani, aplikasi dapat berjalan di emulator atau digunakan untuk tujuan lain.

5. Versi dan persyaratan yang didukung

Versi minimum yang didukung untuk membuat aplikasi Android adalah 5.0 (API level 21). Aplikasi Android dapat memiliki tingkat API minimum yang lebih rendah yang diperlukan untuk dijalankan, tetapi harus menargetkan setidaknya API level 21.

6. Buat tips

6.1. Yarn

Manajer paket Yarn adalah pengganti yang lebih cepat dan lebih deterministik untuk npm. yarn.lock Jika file ada di repositori Anda di samping package.json, maka App Center akan menggunakan Yarn, lakukan yarn install di awal build. Jika tidak, itu akan melakukan npm install.

6.2. Skrip build kustom

Ada beberapa opsi untuk menjalankan skrip sebelum perintah build default App Center dijalankan.

  • Buat skrip postinstall di file proyek package.json Anda. Skrip ini akan secara otomatis dijalankan setelah dependensi Anda diinstal.

      "scripts": {
    ...
    "postinstall" : "npx jetify" // other examples: "node ./postinstall.js" or "./postinstall.sh"
  },

  • Tulis skrip shell menggunakan fungsionalitas skrip build kustom App Center.

    #!/usr/bin/env bash

# Example: Authenticate with private NPM registry
echo "//registry.npmjs.org/:_authToken=$NPM_AUTH_TOKEN" > ~/.npmrc

# Example: Add your signing key file (from base64 encoded environment variable)
base64 -d <<< "$ANDROID_JSON_KEY_FILE" > android/keystores/json_key_file.json

6.3. Membangun beberapa APK

Untuk React Native di Android, pembuatan APK universal dinonaktifkan secara default. Jika konfigurasi aplikasi Anda disiapkan untuk membuat beberapa APK, misalnya yang berbeda per arsitektur CPU atau konfigurasi layar, Anda perlu memastikan APK universal juga dibuat. Sistem build App Center bekerja dengan satu file APK utama dan akan mengabaikan semua APK khusus untuk CPU/ABI atau kepadatan layar tertentu.

Untuk mempelajari lebih lanjut tentang pemisahan APK dan cara membangun APK universal, baca panduan pengembang Android yang sesuai. Akibatnya, pastikan diatur universalApk ke untuk true konfigurasi build React Native Anda.