Menambahkan Link Aplikasi Android

Link Aplikasi Android adalah URL HTTP yang mengarahkan pengguna secara langsung ke konten tertentu dalam aplikasi Android Anda. Link Aplikasi Android dapat menaikkan traffic ke aplikasi, membantu Anda menemukan konten aplikasi mana yang paling banyak digunakan, serta memudahkan pengguna membagikan dan menemukan konten dalam aplikasi yang diinstal.

Untuk menambahkan dukungan bagi Link Aplikasi Android:

  1. Buat filter intent dalam manifes.
  2. Tambahkan kode ke aktivitas aplikasi untuk menangani link yang masuk.
  3. Kaitkan aplikasi dan situs Anda dengan Digital Asset Links.

App Links Assistant di Android Studio 2.3 dan yang lebih tinggi menyederhanakan proses dalam wizard langkah demi langkah, seperti yang dijelaskan di bawah ini.

Untuk mengetahui informasi selengkapnya tentang cara kerja link aplikasi dan manfaat yang ditawarkannya, baca Menangani Link Aplikasi Android.

Menambahkan filter intent

App Links Assistant di Android Studio dapat membantu Anda membuat filter intent dalam manifes dan memetakan URL yang ada dari situs Anda ke aktivitas dalam aplikasi. App Links Assistant juga menambahkan kode Java template dalam setiap aktivitas yang terkait untuk menangani intent tersebut.

Untuk menambahkan filter intent dan penanganan URL, ikuti langkah berikut:

  1. Pilih Tools > App Links Assistant.
  2. Klik Open URL Mapping Editor, lalu klik Add di bagian bawah daftar URL Mapping untuk menambahkan pemetaan URL baru.
  3. Tambahkan detail untuk pemetaan URL yang baru:
    Asisten Link Aplikasi memandu Anda melalui pemetaan URL dasar

    Gambar 1. Menambahkan detail dasar tentang struktur link situs Anda untuk memetakan URL ke aktivitas dalam aplikasi.

    1. Masukkan URL situs di kolom Host.
    2. Tambahkan path, pathPrefix, atau pathPattern untuk URL yang ingin dipetakan. Misalnya, jika Anda memiliki aplikasi untuk berbagi resep, dengan semua resep tersedia dalam aktivitas yang sama, dan semua resep di situs terkait berada dalam direktori /recipe yang sama, gunakan pathPrefix dan masukkan /recipe. Dengan demikian, URL http://www.recipe-app.com/recipe/grilled-potato-salad akan mengarah ke aktivitas yang dipilih pada langkah berikutnya.
    3. Pilih Activity yang akan menjadi tujuan pengguna dari URL.
    4. Klik OK.
  4. App Links Assistant menambahkan filter intent berdasarkan pemetaan URL ke file AndroidManifest.xml, dan menyorotnya di kolom Preview. Jika ingin melakukan perubahan, klik Open AndroidManifest.xml untuk mengedit filter intent. (Pelajari filter intent di Android lebih lanjut.)

    Catatan: Untuk mendukung lebih banyak link tanpa harus mengupdate aplikasi, tentukan pemetaan URL yang mendukung URL yang akan ditambahkan nantinya. Selain itu, harap diingat juga untuk menyertakan URL bagi layar utama aplikasi sehingga layar disertakan di hasil penelusuran.

  5. Untuk memastikan pemetaan URL berfungsi dengan benar, masukkan URL di kolom Check URL Mapping, lalu klik Check Mapping. Jika sudah berfungsi dengan benar, pesan sukses akan menunjukkan bahwa URL yang dimasukkan mengarah ke aktivitas yang dipilih.

Menangani link yang masuk

Setelah memastikan bahwa pemetaan URL sudah berfungsi dengan benar, tambahkan logika untuk menangani intent yang telah dibuat.

  1. Klik Select Activity dari App Links Assistant.
  2. Pilih aktivitas dari daftar, lalu klik Insert Code.

App Links Assistant menambahkan kode seperti berikut ini ke file Java aktivitas Anda (Harap perhatikan: Saat ini, App Links Assistant tidak mendukung Kotlin sehingga Anda perlu menambahkan kode ini secara manual):

Kotlin

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)

        val appLinkIntent = intent
        val appLinkAction = appLinkIntent.action
        val appLinkData = appLinkIntent.data

    }
    

Java

    // ATTENTION: This was auto-generated to handle app links.
    Intent appLinkIntent = getIntent();
    String appLinkAction = appLinkIntent.getAction();
    Uri appLinkData = appLinkIntent.getData();
    

Namun, kode ini tidak selesai dengan sendirinya. Sekarang, Anda harus mengambil tindakan berdasarkan URI di appLinkData, misalnya menampilkan konten yang sesuai. Misalnya, untuk aplikasi berbagi resep, kode Anda mungkin terlihat seperti contoh berikut:

Kotlin

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        ...
        handleIntent(intent)
    }

    override fun onNewIntent(intent: Intent) {
        super.onNewIntent(intent)
        handleIntent(intent)
    }

    private fun handleIntent(intent: Intent) {
        val appLinkAction = intent.action
        val appLinkData: Uri? = intent.data
        if (Intent.ACTION_VIEW == appLinkAction) {
            appLinkData?.lastPathSegment?.also { recipeId ->
                Uri.parse("content://com.recipe_app/recipe/")
                        .buildUpon()
                        .appendPath(recipeId)
                        .build().also { appData ->
                            showRecipe(appData)
                        }
            }
        }
    }
    

Java

    protected void onCreate(Bundle savedInstanceState) {
      super.onCreate(savedInstanceState);
      ...
      handleIntent(getIntent());
    }

    protected void onNewIntent(Intent intent) {
      super.onNewIntent(intent);
      handleIntent(intent);
    }

    private void handleIntent(Intent intent) {
        String appLinkAction = intent.getAction();
        Uri appLinkData = intent.getData();
        if (Intent.ACTION_VIEW.equals(appLinkAction) && appLinkData != null){
            String recipeId = appLinkData.getLastPathSegment();
            Uri appData = Uri.parse("content://com.recipe_app/recipe/").buildUpon()
                .appendPath(recipeId).build();
            showRecipe(appData);
        }
    }
    

Mengaitkan aplikasi dengan situs Anda

Setelah menyiapkan dukungan URL untuk aplikasi, App Links Assistant akan membuat file Digital Asset Links yang dapat digunakan untuk mengaitkan situs dengan aplikasi Anda.

Selain menggunakan file Digital Asset Links, Anda dapat mengaitkan situs dan aplikasi di Search Console.

Untuk mengaitkan aplikasi dan situs menggunakan App Links Assistant, klik Open Digital Asset Links File Generator dari App Links Assistant dan ikuti langkah berikut:

Asisten Link Aplikasi memandu Anda melalui pemetaan URL dasar

Gambar 2. Memasukkan detail tentang situs dan aplikasi Anda untuk menghasilkan file Digital Asset Links.

  1. Masukkan Domain situs dan ID Aplikasi Anda.
  2. Untuk menyertakan dukungan dalam file Digital Asset Links bagi Smart Lock untuk Sandi, pilih Support sharing credentials between the app and the website, lalu masukkan URL login situs Anda. Tindakan ini akan menambahkan string berikut ini ke file Digital Asset Links, mendeklarasikan bahwa aplikasi dan situs Anda memiliki kredensial login yang sama: delegate_permission/common.get_login_creds. Pelajari cara mendukung Smart Lock untuk Sandi di aplikasi Anda lebih lanjut.
  3. Tentukan konfigurasi penandatanganan atau pilih file keystore. Pastikan untuk memilih konfigurasi atau file keystore yang tepat bagi build rilis atau build debug aplikasi Anda. Jika ingin menyiapkan build produksi, gunakan konfigurasi rilis. Jika ingin menguji build, gunakan konfigurasi debug.
  4. Klik Generate Digital Asset Links file.
  5. Setelah Android Studio membuat file, klik Save file untuk mendownloadnya.
  6. Upload file assetlinks.json ke situs Anda, dengan akses baca untuk semua orang, di https://<yoursite>/.well-known/assetlinks.json.

    Penting: Sistem akan memverifikasi file Digital Asset Links melalui protokol HTTPS terenkripsi. Pastikan file assetlinks.json bisa diakses melalui koneksi HTTPS, terlepas apakah filter intent aplikasi Anda menyertakan https atau tidak.

  7. Klik Link and Verify untuk mengonfirmasi bahwa Anda telah mengupload file Digital Asset Links yang benar ke lokasi yang benar.

Pelajari cara mengaitkan situs dengan aplikasi Anda melalui file Digital Asset Links dalam Mendeklarasikan Pengaitan Situs lebih lanjut.

Menguji Link Aplikasi Anda

Untuk memastikan link Anda membuka aktivitas yang benar, ikuti langkah berikut:

  1. Klik Test App Links dalam App Links Assistant.
  2. Masukkan URL yang ingin diuji di kolom URL, misalnya http://recipe-app.com/recipe/grilled-potato-salad.
  3. Gambar 3. App Links Assistant menampilkan pesan sukses dan membuka aplikasi ke konten yang ditentukan saat URL yang diuji berhasil dipetakan ke aktivitas dalam aplikasi Anda.

  4. Klik Run Test.
  5. Jika pemetaan URL tidak disetel dengan benar atau tidak ada, pesan error akan muncul di bawah URL di jendela Test App Links . Jika pemetaan URL sudah ada, Android Studio akan meluncurkan aplikasi di perangkat atau emulator pada aktivitas yang ditentukan tanpa menampilkan dialog disambiguasi ("pemilih" aplikasi), dan menampilkan pesan sukses di jendela App Link Testing. Jika Android Studio tidak berhasil meluncurkan aplikasi, pesan error akan muncul di jendela Run Android Studio.

Untuk menguji Link Aplikasi Android melalui Asisten Link Aplikasi, Anda harus memiliki perangkat yang terhubung atau perangkat virtual yang tersedia dan menjalankan Android 6.0 (API level 23) atau lebih tinggi. Untuk mengetahui informasi selengkapnya, lihat cara menghubungkan perangkat atau membuat AVD .

Menambahkan Pengindeksan Aplikasi Firebase

Setelah menambahkan Link Aplikasi Android ke aplikasi, Anda dapat menambahkan kode Pengindeksan Aplikasi Firebase ke aktivitas untuk mendapatkan interaksi kembali ke aplikasi dari fitur tambahan Google Penelusuran, termasuk saran pelengkapan otomatis dan penelusuran Dalam Aplikasi. Pelajari Pengindeksan Aplikasi Firebase dalam Dokumentasi Pengindeksan Aplikasi Firebase lebih lanjut.

Untuk menambahkan Pengindeksan Aplikasi Firebase ke aplikasi Anda, gunakan Firebase Assistant di Android Studio dan perluas bagian App Indexing untuk mendapatkan petunjuk langkah demi langkah.