Membuat app bundle yang diaktifkan secara instan

Anda membuat pengalaman Google Play Instan dengan menyertakannya sebagai bagian dari Android App Bundle. Paket tersebut disebut sebagai app bundle yang diaktifkan secara instan. Dokumen ini menunjukkan cara menyiapkan lingkungan pengembangan untuk app bundle yang diaktifkan secara instan, serta cara mengonfigurasi, membuat, menguji, dan memublikasikan app bundle yang diaktifkan secara instan.

Jika Anda sudah memiliki project aplikasi instan yang menggunakan plugin fitur yang tidak digunakan lagi (com.android.feature), pelajari cara memigrasikan aplikasi instan untuk mendukung Android App Bundle.

Menyiapkan lingkungan pengembangan

Untuk memberikan pengalaman instan dalam app bundle, Anda memerlukan akses ke Google Play Instant Development SDK. Anda dapat menginstal SDK tersebut dengan salah satu metode berikut:

  • Menginstal Android Studio 3.3 atau versi yang lebih baru. Setelah membuka Android Studio, download Google Play Instant Development SDK dari tab SDK Tools di SDK Manager.
  • Menginstal dari command line:

        cd path/to/android/sdk/tools/bin && \
          ./sdkmanager 'extras;google;instantapps'
        

Selain itu, jika Anda ingin menguji pengalaman instan secara lokal, dapatkan akses ke perangkat fisik atau virtual.

Mengonfigurasikan project Anda untuk pengalaman instan

Agar kompatibel dengan Google Play Instan, Anda harus mengonfigurasi beberapa aspek app bundle yang diaktifkan secara instan dengan cermat. Bagian berikut akan menjelaskan pertimbangan ini.

Modul aplikasi yang diaktifkan secara instan

Anda dapat menyatakan bahwa app bundle Anda mendukung pengalaman instan dengan salah satu metode berikut:

  • Jika Anda membuat project baru di Android Studio, dalam langkah Konfigurasi project, centang kotak Project ini akan mendukung aplikasi instan.
  • Jika Anda memiliki app bundle yang sudah ada dan hanya berisi modul dasar, Anda dapat mengaktifkan secara instan app bundle tersebut dengan menambahkan pernyataan berikut ke manifes modul:

    <manifest ... xmlns:dist="http://schemas.android.com/apk/distribution">
            <dist:module dist:instant="true" />
            ...
        </manifest>
        
  • Jika Anda memiliki app bundle yang sudah ada yang berisi beberapa modul, Anda dapat Membuat modul fitur dinamis yang diaktifkan secara instan. Proses ini juga mengaktifkan modul dasar aplikasi Anda secara instan, sehingga Anda memiliki opsi untuk mendukung beberapa titik masuk instan dalam aplikasi.

Izin yang didukung

App bundle yang diaktifkan secara instan hanya dapat menggunakan izin dari daftar berikut:

Akses ke aplikasi terinstal

Saat mengembangkan pengalaman instan, perlu diingat bahwa aplikasi tidak dapat berinteraksi dengan aplikasi terinstal di suatu perangkat kecuali jika salah satu dari hal berikut benar:

  • Satu atau beberapa aktivitas dalam aplikasi terinstal telah menetapkan android:visibleToInstantApps ke nilai true - Elemen ini tersedia untuk aplikasi yang menjalankan Android 8.0 (API level 26) atau versi yang lebih baru.
  • Aplikasi terinstal berisi filter intent yang menyertakan CATEGORY_BROWSABLE.
  • Pengalaman instan mengirimkan intent menggunakan tindakan ACTION_SEND, ACTION_SENDTO, atau ACTION_SEND_MULTIPLE.

Lingkungan eksekusi

Untuk keamanan tambahan, Google Play Instan menjalankan app bundle yang diaktifkan secara instan dalam jenis sandbox SELinux khusus. Agar kompatibel dengan lingkungan ini, Anda harus membuat konfigurasi berikut dalam app bundle yang diaktifkan secara instan:

Membuat app bundle

Anda dapat menggunakan Android Studio atau antarmuka command line untuk membuat app bundle yang diaktifkan secara instan.

Android Studio

Dengan Android Studio, Anda dapat membuat app bundle dengan memilih Build > Build Bundle (s) / APK (s) > Build Bundle. Untuk mengetahui informasi selengkapnya tentang pembuatan project, lihat Membuat project.

Antarmuka command line

Anda juga dapat membuat app bundle dari command line menggunakan Gradle. Setelah melakukan build ini, lakukan pemeriksaan pengalaman instan dengan menjalankan perintah berikut:

    ia check app-artifact
    

Artefak aplikasi dapat berupa file ZIP, app bundle, atau daftar APK yang berisi minimal satu pengalaman instan.

Menguji pengalaman instan

Sebelum memublikasikan app bundle yang diaktifkan secara instan, Anda dapat menguji pengalaman instan dari salah satu lokasi berikut untuk memverifikasi fungsi:

Android Studio

Untuk menguji pengalaman instan aplikasi Anda di komputer lokal dengan Android Studio, selesaikan langkah-langkah berikut:

  1. Jika Anda telah menginstal versi aplikasi di perangkat uji coba, uninstal aplikasi tersebut.
  2. Di Android Studio, dari opsi penginstalan yang muncul di tab General dari dialog Run/Debug configurations, aktifkan kotak centang Deploy as instant app.
  3. Pilih Run > Run di panel menu, atau klik Run di toolbar, lalu pilih perangkat tempat Anda ingin menguji pengalaman instan aplikasi. Pengalaman instan aplikasi akan dimuat di perangkat uji yang Anda pilih.

Antarmuka command line

Untuk menguji pengalaman instan aplikasi Anda di komputer lokal dengan Android Studio, selesaikan langkah-langkah berikut:

  1. Jika Anda telah menginstal versi aplikasi di perangkat uji coba, uninstal aplikasi tersebut.
  2. Sideload dan jalankan aplikasi instan Anda di perangkat uji dengan memasukkan perintah berikut:
    ia run output-from-build-command
    

Track pengujian internal

Untuk menguji pengalaman instan aplikasi Anda dari Play Store atau banner di situs Anda, publikasikan aplikasi ke track pengujian internal di Konsol Play. Caranya, ikuti langkah-langkah berikut:

  1. Upload app bundle Anda dengan mengikuti langkah-langkah dalam panduan Upload app bundle Anda ke Konsol Play.
  2. Siapkan bundle yang diupload untuk rilis ke track pengujian internal. Untuk mengetahui informasi lebih lanjut, lihat artikel dukungan tentang cara Menyiapkan & meluncurkan rilis.
  3. Login ke akun penguji internal di perangkat, lalu luncurkan pengalaman instan Anda dari salah satu menu berikut:

    • Tombol Coba Sekarang dari listingan Play Store aplikasi Anda.
    • Link dari banner di situs aplikasi Anda.

Memublikasikan app bundle ke track produksi

Untuk memublikasikan app bundle yang diaktifkan secara instan, selesaikan langkah-langkah berikut:

  1. Jika belum, tanda tangani app bundle dengan kunci rilis dan upload app bundle ke Konsol Play.
  2. Di Konsol Play, buka Pengelolaan rilis > Aplikasi Instan Android, lalu navigasikan ke track produksi aplikasi instan.
  3. Pilih Update dari Library, lalu pilih app bundle yang diaktifkan secara instan, yang telah diupload.

Referensi lainnya

Untuk mempelajari lebih lanjut cara membuat pengalaman instan dan Android App Bundle, lihat referensi berikut:

Video: Mem-bundle Aplikasi secara Instan
Pelajari cara menambahkan pengalaman instan ke Android App Bundle di sesi ini dari Android Dev Summit '18.
Video: Memublikasikan aplikasi yang lebih kecil dengan Android App Bundle
Pelajari cara app bundle membantu Anda mengembangkan aplikasi lebih cepat dan membuat APK yang lebih kecil untuk pengguna Anda.
Codelab: Android App Bundle Pertama Anda
Panduan langkah demi langkah untuk membuat Android App Bundle dan menambahkan fitur ke dalamnya.
Format Android App Bundle
Pelajari lebih lanjut cara program command line bundletool mengatur app bundle dari kode dan resource aplikasi Anda.