Mengonfigurasi pengiriman instan

Google Play Instan memungkinkan pengguna untuk berinteraksi dengan aplikasi Anda tanpa perlu menginstal APK di perangkat mereka. Pengguna dapat mencoba aplikasi Anda melalui tombol "Coba Sekarang" di Google Play Store atau URL yang Anda buat. Format pengiriman konten ini memudahkan Anda untuk meningkatkan interaksi pengguna dengan aplikasi Anda.

Anda dapat mengaktifkan fitur hanya jika Anda juga mengaktifkan modul dasar aplikasi. Hal itu karena, jika pengguna ingin mencoba salah satu modul fitur yang diaktifkan untuk versi instan aplikasi, perangkat mereka juga harus mendownload modul dasar aplikasi untuk kode dan resource umum. Perlu diingat, untuk mendukung Google Play Instan, download untuk modul dasar dan fitur harus memenuhi beberapa kriteria:

Jika Anda membuat modul fitur yang diaktifkan untuk versi instan menggunakan Android Studio 3.5 atau yang lebih baru, seperti dijelaskan di bagian ini, IDE akan otomatis mengaktifkan modul dasar dan modul fitur untuk versi instan dengan menyertakan kode berikut ke dalam manifes setiap modul:

<manifest xmlns:dist="http://schemas.android.com/apk/distribution"
    ... >
    <dist:module dist:instant="true" />
    ...

Selain itu, saat aplikasi didownload dan diinstal, modul fitur yang diaktifkan untuk versi instan akan otomatis didownload dan diinstal bersama APK dasar aplikasi. Jadi, IDE juga menyertakan kode berikut dalam modul fitur yang diaktifkan untuk versi instan.

    <dist:module ...>
        <dist:delivery>
            <dist:install-time />
        </dist:delivery>
    </dist:module>

Perilaku ini berarti bahwa jika Anda menetapkan dist:instant="true", Anda tidak akan dapat menyertakan <dist:on-demand />. Namun, Anda dapat meminta modul yang diaktifkan secara instan dengan cara on-demand dalam pengalaman instan Anda menggunakan Library Play Feature Delivery.

Mengonfigurasi modul baru untuk pengiriman instan

Untuk menambahkan modul fitur yang diaktifkan untuk versi instan ke project aplikasi menggunakan Android Studio, lakukan langkah-langkah berikut:

  1. Buka project aplikasi Anda di IDE jika belum melakukannya.
  2. Dari panel menu, pilih File > New > New Module
  3. Dalam dialog Create New Module, pilih Instant Dynamic Feature Module, lalu klik Next.
  4. Pada bagian Configure your new module, lakukan langkah-langkah berikut:

    1. Dari menu drop-down, pilih Base application module untuk project aplikasi Anda.
    2. Tentukan Module name. IDE menggunakan nama ini untuk mengidentifikasi modul sebagai subproject Gradle dalam file setelan Gradle Anda. Jika Anda membuat app bundle, Gradle akan menggunakan elemen terakhir dari nama subproject untuk memasukkan atribut <manifest split> dalam manifes modul fitur.
    3. Tentukan package name modul. Secara default, Android Studio menyarankan nama paket dengan menggabungkan nama paket root modul dasar dan nama modul yang Anda tentukan di langkah sebelumnya.
    4. Pilih Level API minimum yang Anda inginkan untuk didukung modul. Nilai ini harus cocok dengan yang ada di modul dasar.
    5. Tentukan Module title maksimum 50 karakter. Platform menggunakan judul ini untuk mengidentifikasi modul kepada pengguna. Karena alasan ini, modul dasar aplikasi Anda harus menyertakan judul modul sebagai resource string, yang dapat Anda terjemahkan. Saat membuat modul menggunakan Android Studio, IDE akan menambahkan resource string ke modul dasar dan memasukkan entri berikut dalam manifes modul fitur:

      <dist:module
          ...
          dist:title="@string/feature_title">
      </dist:module>
      
    6. Centang kotak di sebelah Fusing jika Anda ingin modul ini tersedia untuk perangkat yang menjalankan Android 4.4 (API level 20) atau yang lebih rendah dan termasuk dalam multi-APK. Android Studio memasukkan kode berikut ke dalam manifes modul untuk merefleksikan pilihan Anda:

      <dist:module>
          <dist:fusing dist:include="true" />
      </dist:module>
      
  5. Klik Finish.

Setelah Android Studio selesai membuat modul Anda, periksa sendiri kontennya dari panel Project (pilih View > Tool Windows > Project dari panel menu). Kode, resource, dan organisasi default harus serupa dengan yang ada di modul aplikasi standar.

Setelah Anda menerapkan fitur yang ingin didownload secara on demand, pelajari cara memintanya menggunakan Library Play Feature Delivery.

Men-deploy aplikasi

Saat mengembangkan aplikasi yang mendukung modul fitur, Anda dapat men-deploy aplikasi Anda ke perangkat yang terhubung seperti biasanya dengan memilih Run > Run dari panel menu (atau dengan mengklik Run di toolbar).

Jika project aplikasi Anda menyertakan satu atau beberapa modul fitur, Anda dapat memilih fitur yang akan disertakan saat men-deploy aplikasi dengan mengubah konfigurasi run/debug yang ada sebagai berikut:

  1. Dari panel menu, pilih Run > Edit Configurations.
  2. Dari panel kiri dialog Run/Debug Configurations, pilih konfigurasi Android App yang Anda inginkan.
  3. Di bagian Dynamic features to deploy di tab General, centang kotak di samping setiap modul fitur yang ingin Anda sertakan saat men-deploy aplikasi.
  4. Klik OK.

Secara default, Android Studio tidak men-deploy modul yang diaktifkan untuk versi instan sebagai pengalaman instan atau menggunakan app bundle untuk men-deploy aplikasi Anda. Alih-alih, IDE membuat dan menginstal APK ke perangkat yang dioptimalkan untuk kecepatan deployment, bukan ukuran APK. Untuk mengonfigurasi Android Studio agar dapat membuat dan men-deploy APK dan pengalaman instan dari app bundle, modifikasi konfigurasi run/debug Anda.