Google berkomitmen untuk mendorong terwujudnya keadilan ras bagi komunitas Kulit Hitam. Lihat caranya.

Menambahkan Link Aplikasi Android

Link Aplikasi Android adalah URL HTTP yang mengarahkan pengguna langsung ke konten tertentu di aplikasi Android. Link Aplikasi Android dapat mendorong lebih banyak traffic ke aplikasi Anda, membantu menemukan konten aplikasi mana yang paling sering digunakan, dan memudahkan pengguna untuk berbagi dan menemukan konten di aplikasi terinstal.

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, sebagaimana 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 ke aktivitas di aplikasi. App Links Assistant juga menambahkan kode Java template dalam setiap aktivitas 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 baru:
    App Links Assistant 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 Aktivitas 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 menandainya di kolom Pratinjau. 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

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

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:

App Links Assistant memandu Anda melalui pemetaan URL dasar

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

  1. Masukkan Domain situs dan ID Aplikasi.
  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. Tindakan ini akan menambahkan string berikut 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 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 dari aplikasi Anda. Jika Anda 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 bahwa file assetlinks.json dapat diakses melalui sambungan HTTPS, terlepas apakah filter intent aplikasi Anda menyertakan https.

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

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

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 dalam 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 ("chooser" 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 App Links Assistant, Anda harus menghubungkan perangkat atau menyediakan perangkat virtual dan menjalankan Android 6.0 (API level 23) atau yang lebih tinggi. Untuk mengetahui informasi lebih lanjut, lihat cara menghubungkan perangkat atau membuat AVD.

Menambahkan Firebase App Indexing

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

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