Bangun dan Jalankan App Android Anda

Android Studio menyiapkan proyek baru untuk diterapkan ke Android Emulator atau perangkat yang terhubung hanya dengan beberapa klik. Setelah aplikasi Anda terinstal, Instant Run memungkinkan Anda untuk mendorong perubahan kode tanpa membangun APK baru.
Untuk membangun dan menjalankan aplikasi Anda, pilih Run> Run di bilah menu (atau klik Run  di toolbar). Jika ini pertama kalinya menjalankan aplikasi, Android Studio meminta Anda untuk memilih target penerapan seperti yang ditunjukkan pada gambar 1. Pilih perangkat untuk menginstal dan menjalankan aplikasi Anda.


Gambar 1. Dialog Target Penyebaran Pilih menunjukkan perangkat yang tersedia
Jika dialog mengatakan, "Tidak ada perangkat USB atau emulator yang terdeteksi," maka Anda perlu mengatur dan menghubungkan perangkat Anda atau meluncurkan emulator dengan mengklik perangkat yang terdaftar di bawah Available Virtual Devices . Jika tidak ada perangkat virtual yang terdaftar, klik Buat Perangkat Virtual Baru dan ikuti wizard Konfigurasi Perangkat Virtual (lihat Membuat dan Mengelola Perangkat Virtual ).
Untuk menampilkan dialog Select Deployment Target , hapus pilihan Gunakan perangkat yang sama untuk peluncuran di masa mendatang atau hentikan aplikasi dengan aplikasi Run> Stop atau Stop  , lalu mulai lagi.
Catatan: Anda juga dapat menerapkan aplikasi Anda dalam mode debug dengan mengeklik Debug  . Menjalankan aplikasi Anda dalam mode debug memungkinkan Anda menyetel titik balik dalam kode Anda, memeriksa variabel dan mengevaluasi ekspresi pada waktu berjalan, dan menjalankan alat debugging. Untuk mempelajari lebih lanjut, lihat Debug Your App .

Ubah konfigurasi run / debug


Saat menjalankan aplikasi untuk pertama kalinya, Android Studio menggunakan konfigurasi default. Konfigurasi run menentukan modul yang akan dijalankan, paket yang akan digunakan, aktivitas untuk memulai, perangkat target, pengaturan emulator, opsi logger, dan lainnya.
Konfigurasi run / debug default meluncurkan aktivitas proyek default dan menggunakan dialog Select Deployment Target untuk pemilihan perangkat target. Jika pengaturan default tidak sesuai dengan proyek atau modul Anda, Anda dapat menyesuaikan konfigurasi run / debug, atau bahkan membuat yang baru, di proyek, default, dan tingkat modul. Untuk mengedit konfigurasi run / debug, pilih Run> Edit Configurations . Untuk informasi lebih lanjut, lihat Membuat dan Mengedit Konfigurasi Run / Debug .

Ubah varian build


Secara default, Android Studio membuat versi debug aplikasi Anda, yang ditujukan hanya untuk penggunaan selama pengembangan, saat Anda mengeklik Jalankan .
Untuk mengubah varian varian yang digunakan Android Studio, pilih Build > Select Build Varian pada bilah menu (atau klik Build Varians)  di tool windows bar), lalu pilih varian build dari menu drop-down. Secara default, proyek baru disiapkan dengan dua varian: varian debug dan pelepasan. Anda perlu membuat varian rilis untuk menyiapkan aplikasi Anda untuk rilis publik .
Untuk membuat variasi lain dari aplikasi Anda, masing-masing dengan berbagai fitur atau persyaratan perangkat, Anda dapat menentukan varian bangunan tambahan .

Bangun proyek Anda


Lari  tombol mengkompilasi dan menginstal APK, namun ada pilihan lain di menu Bangun yang mungkin ingin Anda gunakan untuk mengkompilasi bagian atau semua proyek Anda. Sebelum memilih salah satu opsi pembuatan yang tercantum dalam tabel 1, Anda perlu memilih varian buid yang ingin Anda bangun.
Tabel 1. Buat opsi di menu Bangun .
Item menuDeskripsi
Buat ModulKompilasi semua file sumber dalam modul yang dipilih yang telah dimodifikasi sejak terakhir dibangun, dan semua modul modul yang dipilih tergantung pada rekursif. Kompilasi mencakup file sumber dependen dan tugas membangun terkait. Anda dapat memilih modul untuk dibangun dengan memilih salah satu nama modul atau salah satu dari file-nya di jendela Project . Perintah ini tidak menghasilkan APK.
Buat ProyekMembuat semua modul
Proyek BersihMenghapus semua file build antara / cache.
Rebuild ProjectRuns Clean Project untuk varian build terpilih dan menghasilkan APK.
Bangun APK
Bangun APK dari semua modul aplikasi dalam proyek saat ini untuk varian pilihan mereka. Saat pembuatan selesai, pemberitahuan konfirmasi muncul, memberikan tautan ke file APK dan tautan untuk membukanya di APK Analyzer .
Jika varian build yang Anda pilih adalah jenis debug build, maka APK akan masuk dengan kunci debug dan siap untuk menginstal. Jika Anda telah memilih varian rilis, maka secara default, APK tidak ditandatangani dan Anda harus menandatangani APK secara manual. Namun, Anda malah dapat mengkonfigurasi proses pembuatan untuk secara otomatis masuk ke APK Anda .
Semua APK yang dibangun disimpan dalam project-name / module-name /build/outputs/apk/ .
Hasilkan APK TertandaMembawa dialog dengan wizard untuk membuat konfigurasi penandatanganan baru. Untuk informasi lebih lanjut, lihat Masuk APK .
Catatan: Jalankan  Tombol membuat APK dengan testOnly="true" , yang berarti APK hanya dapat dipasang melalui adb (yang menggunakan Android Studio). Jika Anda menginginkan APK yang dapat diunduh yang tidak dapat dipasang tanpa adb, pilih varian debug Anda dan klik Build> Build APK (s) .
Untuk rincian tentang langkah grader yang diambil untuk setiap perintah, buka Gradle Console . Untuk informasi lebih lanjut tentang proses gradual dan build, lihat Configure Your Build .

Pantau proses pembuatannya


Anda dapat melihat rincian tentang proses pembuatan dengan mengklik View> Tool Windows> Gradle Console (atau dengan mengklik Gradle Console  di panel alat bar). Konsol menampilkan setiap tugas yang dijalankan Gradle untuk membangun aplikasi Anda, seperti yang ditunjukkan pada gambar 2.

Gambar 2. The Gradle Console di Android Studio
Jika varian build Anda menggunakan rasa produk, Gradle juga meminta tugas untuk membangun rasa produk tersebut. Untuk melihat daftar semua tugas pembuatan yang tersedia, klik View> Tool Windows> Gradle (atau klik Gradle  di panel alat bar).
Jika terjadi kesalahan selama proses pembuatan, jendela Messages muncul untuk menjelaskan masalahnya. Gradle dapat merekomendasikan beberapa opsi baris perintah untuk membantu Anda menyelesaikan masalah, seperti --stacktrace or --debug . Untuk menggunakan opsi baris perintah dengan proses pembuatan Anda:
  1. Buka dialog Pengaturan atau Preferensi :
    • Pada Windows atau Linux, pilih File > Settings dari menu bar.
    • Di Mac OSX, pilih Android Studio > Preferences dari bilah menu.
  2. Navigasikan ke Build, Execution, Deployment > Compiler .
  3. Di kolom teks di sebelah Opsi Baris Perintah , masukkan opsi baris perintah Anda.
  4. Klik OK untuk menyimpan dan keluar.
Gradle akan menerapkan opsi baris perintah ini saat Anda mencoba membangun aplikasi Anda lagi.

Tentang Instan Jalankan


Di Android Studio 2.3 dan yang lebih tinggi, Instant Run secara signifikan mengurangi waktu yang dibutuhkan untuk memperbarui aplikasi Anda dengan perubahan kode dan sumber daya. Setelah menerapkan aplikasi Anda ke perangkat target yang menjalankan Android 5.0 (tingkat API 21) atau lebih tinggi, Anda dapat mengeklik Terapkan Perubahan  untuk mendorong perubahan kode dan sumber daya tertentu ke aplikasi yang sedang berjalan tanpa membangun APK baru-dan, dalam beberapa kasus, bahkan tidak memulai aktivitas saat ini. Lari  dan Debug  tombol selalu tersedia untuk Anda saat Anda ingin mendorong perubahan dan memaksa ulang aplikasi. Namun, Anda mungkin menemukan bahwa menggunakan Terapkan Perubahan  tombol menyediakan alur kerja yang lebih cepat untuk sebagian besar perubahan tambahan pada aplikasi Anda.
Tip: Anda juga dapat menekan Control + F10 (atau Control + Command + R on Mac) untuk menerapkan perubahan dengan Instant Run.
Terapkan Perubahan  Tindakan hanya tersedia bila Anda memenuhi persyaratan berikut:
  • Bangun aplikasi Anda menggunakan varian debug build.
  • Gunakan plugin Android untuk versi Gradle 2.3.0 atau lebih tinggi.
  • Tetapkan minSdkVersion ke 15 atau lebih tinggi di file build.gradle tingkat modul aplikasi Anda.
  • Terapkan aplikasi Anda ke perangkat target yang menjalankan Android 5.0 (tingkat API 21) dan yang lebih tinggi.
Untuk informasi lebih lanjut tentang mengaktifkan Instant Run, buka bagian tentang konfigurasi proyek Anda .
Instant Run mendorong perubahan Anda dengan melakukan hot swap , swap hangat , atau cold swap - jenis swap yang dilakukan tergantung pada jenis perubahan yang Anda lakukan. Saat Anda mengklik Apply Changes  Setelah membuat kode atau perubahan sumber daya ke aplikasi yang Anda jalankan, Instant Run secara otomatis menentukan cara terbaik untuk mendorong perubahan Anda ke perangkat target, seperti yang dijelaskan pada tabel berikut.
Mengklik Jalankan  (atau Debug  ) memaksa cold swap dan sebuah aplikasi restart. Jika Anda membuat perubahan pada manifes aplikasi atau sumber yang dirujuk oleh manifes, Android Studio selalu mendorong perubahan Anda dengan penginstalan ulang APK penuh.
Perubahan kodeMenerapkan perubahan  Tingkah laku
  • Ubah kode implementasi dari metode yang ada
Lakukan hot swap : Ini adalah jenis swap tercepat dan membuat perubahan terlihat jauh lebih cepat. Aplikasi Anda terus berjalan dan metode rintisan dengan penerapan baru digunakan saat metode dipanggil.
Hot swaps tidak menginisialisasi ulang objek dalam aplikasi yang sedang berjalan. Sebelum Anda melihat pembaruan tertentu, Anda mungkin perlu me-restart aktivitas saat ini, dengan memilih Run> Restart Activity , atau restart aplikasi Anda, dengan mengklik Run  (atau Debug  ). Secara default, Android Studio secara otomatis me-restart aktivitas saat ini setelah melakukan hot swap. Jika Anda tidak menginginkan perilaku ini, Anda dapat menonaktifkan aktivitas otomatis yang dimulai ulang .
  • Mengubah atau menghapus sumber daya yang ada
Lakukan swap hangat : Swap ini masih sangat cepat, namun Instant Run harus memulai kembali aktivitas saat ini saat mendorong sumber daya yang berubah ke aplikasi Anda. Aplikasi Anda tetap berjalan, namun kilasan kecil mungkin muncul di layar saat aktivitas dimulai ulang-ini normal.
Perubahan kode struktural, seperti:
  • Tambahkan, hapus, atau ubah:
    • anotasi
    • sebuah lapangan contoh
    • medan statis
    • tanda tangan metode statis
    • sebuah contoh metode tanda tangan
  • Ubah kelas induk mana yang mewarisi kelas sekarang
  • Ubah daftar antarmuka yang diimplementasikan
  • Ubah penginisialisasi statis kelas
  • Susun ulang elemen tata letak yang menggunakan ID sumber daya dinamis
Lakukan cold swap : Swap ini sedikit lebih lambat karena, walaupun APK baru tidak diperlukan, Instant Run harus memulai ulang keseluruhan aplikasi saat ini mendorong perubahan kode struktural.
  • Ubah manifes aplikasi
  • Ubah sumber daya yang dirujuk oleh manifes aplikasi
  • Ubah elemen UI sistem Android, seperti widget atau notifikasi
Saat membuat perubahan pada manifes atau sumber aplikasi yang diacu oleh manifes, klik Apply Changes  redeploys membangun penuh aplikasi Anda dengan perubahan tersebut. Ini karena informasi tertentu tentang aplikasi, seperti namanya, sumber ikon aplikasi, dan filter niat, ditentukan dari manifes saat APK terinstal pada perangkat.
Jika proses build Anda secara otomatis memperbarui bagian dari manifes aplikasi, seperti mengulangi versionName atau versionName secara otomatis, Anda tidak akan bisa mendapatkan keuntungan dari kinerja penuh Instant Run. Saat menggunakan Jalankan Instan, Anda harus menonaktifkan pembaruan otomatis ke bagian mana pun dalam manifes aplikasi di varian debug build Anda.
Saat memperbarui elemen UI sistem Android, seperti widget atau notifikasi, Anda perlu mengeklik Jalankan  (atau Debug  ).
Catatan: Jika Anda perlu me-restart aplikasi Anda setelah mengalami kecelakaan, jangan meluncurkannya dari perangkat target Anda. Mulai ulang aplikasi Anda dari perangkat target Anda tidak menerapkan perubahan kode Anda sejak cold swap terakhir atau penambahan build . Untuk meluncurkan aplikasi Anda dengan semua perubahan terakhir Anda, klik Jalankan  (atau Debug  ) dari Android Studio.

Nonaktifkan aktivitas otomatis restart

Saat melakukan hot swap, aplikasi Anda tetap berjalan namun Android Studio secara otomatis me-restart aktivitas saat ini. Untuk menonaktifkan pengaturan standar ini:
  1. Buka dialog Pengaturan atau Preferensi :
    • Pada Windows atau Linux, pilih File > Settings dari menu bar.
    • Di Mac OSX, pilih Android Studio > Preferences dari bilah menu.
  2. Navigasikan ke Build, Execution, Deployment > Instant Run .
  3. Hapus centang pada kotak di samping Aktivitas mulai ulang pada perubahan kode .
Jika aktivitas otomatis restart dinonaktifkan, Anda dapat secara manual me-restart aktivitas saat ini dari bilah menu dengan memilih Run > Restart Activity .

Konfigurasikan proyek Anda untuk Jalankan Instan

Android Studio memungkinkan Instant Run secara default untuk proyek yang dibuat menggunakan plugin Android untuk Gradle 2.3.0 dan yang lebih tinggi.
Untuk memperbarui proyek yang ada dengan versi terbaru plugin:
  1. Buka dialog Pengaturan atau Preferensi .
  2. Arahkan ke Build, Execution, Deployment > Instant Run dan klik Update Project , seperti yang ditunjukkan pada gambar 3.
    Jika opsi untuk memperbarui proyek tidak muncul, ini sudah up-to-date dengan plugin Android terbaru untuk Gradle. Tapi pastikan kotak di sebelah Enable Instant Run dicentang.
    Gambar 3. Memperbarui plugin Android untuk Gradle untuk proyek yang ada
Untuk mulai menggunakan Jalankan Instan, Anda juga perlu mengubah varian bangunan ke versi debug aplikasi Anda dan menerapkannya ke perangkat target yang menjalankan Android 5.0 (tingkat API 21) atau lebih tinggi. Untuk mempelajari lebih banyak teknik yang mempercepat pengembangan Anda, baca Optimalkan Kecepatan Bangun Anda

Kecualikan proyek Anda dari Windows Defender

Pada sistem Windows, Windows Defender dapat menyebabkan kemunduran saat menggunakan Instant Run. Jika Anda menggunakan Windows Defender, Anda harus mengecualikan folder proyek Android Studio Anda dari pemindaian Windows Defender .

Perbaiki build times saat menggunakan Crashlytics

Jika versi plugin Fabric Gradle Anda lebih rendah dari 1,21,6, Crashlytics dapat menyebabkan waktu build lebih lambat. Untuk meningkatkan kinerja pembuatan saat mengembangkan aplikasi Anda, Anda dapat memperbarui plugin ke versi terbaru atau menonaktifkan Crashlytics untuk varian debug build Anda .

Keterbatasan Instant Run

Instant Run dirancang untuk mempercepat proses build dan deploy dalam kebanyakan situasi. Namun, ada beberapa aspek untuk menggunakan Jalankan Instan yang dapat memengaruhi perilakunya dan kompatibilitasnya dengan aplikasi Anda. Jika Anda mengalami masalah lain saat menggunakan Jalankan Instan, aktifkan pembalakan ekstra dan laporkan bug .

Aplikasi tidak diluncurkan di beberapa perangkat fisik

Beberapa produsen perangkat memblokir aplikasi agar tidak diluncurkan secara otomatis setelah diinstal pada perangkat. Saat menggelar aplikasi Anda ke perangkat fisik menggunakan Android Studio 2.3, pembatasan ini akan mematahkan perilaku Instan Jalankan dan menyebabkan kesalahan berikut: Error: Not found; no service started Error: Not found; no service started Untuk memperbaiki masalah ini, perbarui Android Studio menjadi 2.3.1 atau lebih tinggi .

Modus Debug selalu menggunakan cold swaps

Di Android Studio 2.3, jika Anda menerapkan aplikasi dengan mengeklik Debug  , mendorong perubahan kode berikutnya dengan mengklik Apply Changes  selalu menghasilkan cold swap. Untuk mempelajari lebih lanjut, buka edisi # 234401 .

Menyebarkan ke beberapa perangkat

Instant Run menggunakan teknik yang berbeda untuk melakukan swap panas, hangat, dan dingin yang khusus untuk tingkat API dari perangkat target. Untuk alasan ini, saat menggelar aplikasi ke beberapa perangkat sekaligus, Android Studio menonaktifkan Jalankan Instan secara temporer.

Multidexing aplikasi Anda

Jika minSdkVersion diatur ke 21 atau lebih tinggi, Instant Run akan secara otomatis mengonfigurasi aplikasi Anda untuk multidex. Karena Instant Run hanya bekerja dengan versi debug aplikasi Anda, Anda mungkin perlu mengonfigurasi aplikasi untuk multidex saat menerapkan varian peluncuran rilis.

Menjalankan tes instrumentasi dan profiler kinerja

Uji instruksional memuat APK debug dan APK uji ke dalam proses yang sama pada perangkat uji, yang memungkinkan metode kontrol untuk menggantikan siklus hidup aplikasi yang normal dan melakukan tes. Saat menjalankan atau melakukan debug tes instrumentasi, Android Studio tidak menyuntikkan metode tambahan yang diperlukan untuk Jalankan Instan dan mematikan fitur ini.
Saat membuat profil aplikasi, Anda harus menonaktifkan Jalankan Instan. Ada dampak kinerja kecil saat menggunakan Instant Run dan dampak yang sedikit lebih besar saat metode utama dengan hot swap. Dampak kinerja ini dapat mengganggu informasi yang diberikan oleh alat profil kinerja. Selain itu, metode rintisan yang dihasilkan dengan setiap hot swap dapat mempersulit jejak stack.

Menggunakan plugin pihak ketiga

Android Studio sementara menonaktifkan Java Code Coverage Library (JaCoCo) dan ProGuard saat menggunakan Instant Run. Karena Instant Run hanya bekerja dengan debug build, ini tidak mempengaruhi rilis build anda.
Plugin pihak ketiga tertentu yang melakukan peningkatan kualitas bytecode dapat menyebabkan masalah dengan bagaimana instrumen Instan Jalankan aplikasi Anda. Jika Anda mengalami masalah ini, namun ingin terus menggunakan Instant Run, Anda harus menonaktifkan plugin tersebut untuk varian debug build Anda. Anda juga dapat membantu meningkatkan kompatibilitas dengan plugin pihak ketiga dengan mengajukan bug .

Mendorong perubahan ke aplikasi multi proses

Instan Jalankan hanya instrumen proses utama aplikasi Anda untuk melakukan hot swaps dan swapping hangat. Saat mendorong perubahan kode pada proses aplikasi lainnya, seperti perubahan pada penerapan metode atau sumber daya yang ada, Instant Run melakukan cold swap .

Meluncurkan aplikasi Anda di profil Kerja

Jika Anda menjalankan aplikasi Anda dengan Jalankan Instan dan membuka aplikasi Anda menggunakan profil Kerja (atau profil sekunder lainnya), aplikasi Anda akan mogok karena file DEX yang digunakan oleh Instan dijalankan hanya dapat diakses dari ruang pengguna profil utama.
Jika Anda ingin terus menggunakan Instant Run, hindari membuka aplikasi Anda dengan profil Kerja dan pastikan konfigurasi run Anda tidak menggunakan - --user user_id .
Jika Anda perlu menggunakan aplikasi Anda dengan profil Kerja, kami sarankan Anda membuat konfigurasi run baru yang mencakup - --user user_idflag pengguna, menentukan ID pengguna profil kerja. Anda dapat menemukan user ID dengan menjalankan pengguna adb shell pm list users dari command line. Bila Anda menggunakan flag --user , Android Studio menonaktifkan Instant Run hanya untuk penempatan itu; Instant Run akan bekerja kembali saat Anda beralih ke konfigurasi tanpa flag --user .

Nonaktifkan Jalankan Instan

Untuk menonaktifkan Instant Run:
  1. Buka dialog Pengaturan atau Preferensi .
  2. Navigasikan ke Build, Execution, Deployment > Instant Run .
  3. Hapus centang pada kotak di sebelah Enable Instant Run .

Komentar