Aktivitas Web Tepercaya mungkin agak sulit disiapkan, terutama jika Anda hanya ingin menampilkan situs. Panduan ini akan membawa Anda dalam membuat proyek dasar yang menggunakan Aktivitas Web Tepercaya, yang mencakup semua hal yang dapat dipelajari.
Di akhir panduan ini, Anda akan:
- Telah menggunakan Bubblewrap untuk membuat aplikasi yang menggunakan Aktivitas Web Tepercaya dan lulus verifikasi.
- Memahami kapan kunci penandatanganan Anda digunakan.
- Dapat menentukan tanda tangan yang digunakan untuk mem-build Aplikasi Android Anda.
- Mengetahui cara membuat file Digital Asset Links dasar.
Untuk mengikuti panduan ini, Anda memerlukan:
- Node.js 10 atau yang lebih baru diinstal di komputer pengembangan
- Ponsel atau emulator Android yang terhubung dan disiapkan untuk pengembangan (Aktifkan proses debug USB jika Anda menggunakan ponsel fisik)
- Browser yang mendukung Aktivitas Web Tepercaya di ponsel pengembangan Anda
- Situs yang ingin Anda lihat di Aktivitas Web Tepercaya
Aktivitas Web Tepercaya memungkinkan Aplikasi Android Anda meluncurkan Tab Browser layar penuh tanpa UI browser. Kemampuan ini dibatasi untuk situs yang Anda miliki, dan Anda membuktikannya dengan menyiapkan Digital Asset Links. Kita akan membahasnya lebih lanjut nanti.
Saat Anda meluncurkan Aktivitas Web Tepercaya, browser akan memeriksa apakah Digital Asset Links sudah diverifikasi, yang disebut verifikasi. Jika verifikasi gagal, browser akan kembali menampilkan situs Anda sebagai Tab Kustom.
Menginstal dan mengonfigurasi Bubblewrap
Bubblewrap adalah kumpulan library dan alat command line (CLI) untuk Node.js yang membantu developer membuat, mem-build, dan menjalankan Progressive Web App di dalam aplikasi Android, menggunakan Aktivitas Web Tepercaya.
CLI dapat diinstal dengan perintah berikut:
Menyiapkan Lingkungan
Saat dijalankan untuk pertama kalinya, Bubblewrap akan menawarkan untuk mendownload dan menginstal dependensi eksternal yang diperlukan secara otomatis. Sebaiknya izinkan alat ini melakukannya, karena hal ini menjamin bahwa dependensi dikonfigurasi dengan benar. Periksa dokumentasi Bubblewrap untuk menggunakan penginstalan alat command line Android atau Java Development Kit (JDK) yang sudah ada.
Menginisialisasi dan mem-build project
Melakukan inisialisasi project Android yang menggabungkan PWA dilakukan dengan menjalankan perintah init:
Bubblewrap akan membaca Manifes Web, meminta developer untuk mengonfirmasi nilai yang akan digunakan dalam project Android, dan membuat project menggunakan nilai tersebut. Setelah project dibuat, buat APK dengan menjalankan:
Jalankan
Langkah build akan menghasilkan file bernama app-release-signed.apk
. File ini dapat diinstal di perangkat pengembangan untuk pengujian atau diupload ke Play Store untuk rilis.
Bubblewrap menyediakan perintah untuk menginstal dan menguji aplikasi di perangkat lokal. Setelah perangkat pengembangan terhubung ke komputer, jalankan:
Atau, alat adb dapat digunakan.
Catatan: alat command line **adb**
terletak di dalam alat command line Android di **android_sdk/platform-tools/**
.
Aplikasi kini tersedia di peluncur perangkat. Saat membuka aplikasi, Anda akan melihat bahwa situs Anda diluncurkan sebagai Tab Kustom, bukan Aktivitas Web Tepercaya. Hal ini karena kami belum menyiapkan validasi Digital Asset Links, tetapi pertama-tama...
Alternatif Antarmuka Pengguna Grafis (GUI) untuk Bubblewrap
PWA Builder menyediakan antarmuka GUI yang menggunakan library Bubblewrap untuk mendukung pembuatan project Aktivitas Web Tepercaya. Temukan petunjuk selengkapnya tentang cara menggunakan PWA Builder untuk membuat Aplikasi Android yang membuka PWA Anda di postingan blog ini.
Catatan tentang kunci penandatanganan
Digital Asset Links mempertimbangkan kunci yang digunakan untuk menandatangani APK dan penyebab umum kegagalan verifikasi adalah penggunaan tanda tangan yang salah. (Ingat, verifikasi yang gagal berarti Anda akan meluncurkan situs sebagai Tab Kustom dengan UI browser di bagian atas halaman.) Saat Bubblewrap membangun aplikasi, APK akan dibuat dengan penyiapan kunci selama langkah init
. Namun, saat Anda memublikasikan aplikasi di Google Play, kunci lain dapat dibuat untuk Anda, bergantung pada cara Anda memilih untuk menangani kunci penandatanganan. Pelajari lebih lanjut kunci penandatanganan dan hubungannya dengan Bubblewrap dan Google Play.
Menyiapkan file link aset
Digital Asset Links pada dasarnya terdiri dari file di situs Anda yang mengarah ke aplikasi dan beberapa metadata di aplikasi yang mengarah ke situs Anda.
Setelah membuat file assetlinks.json
, upload file tersebut ke situs Anda di .well-known/assetlinks.json
relatif terhadap root) sehingga aplikasi Anda dapat diverifikasi dengan benar oleh browser. Lihat pembahasan mendalam tentang Digital Asset Links untuk mengetahui informasi selengkapnya tentang kaitannya dengan kunci penandatanganan Anda.
Memeriksa browser Anda
Aktivitas Web Tepercaya akan mencoba mematuhi pilihan browser default pengguna. Jika browser default pengguna mendukung Aktivitas Web Tepercaya, browser tersebut akan diluncurkan. Jika tidak, browser yang diinstal yang mendukung Aktivitas Web Tepercaya akan dipilih. Akhirnya, perilaku default adalah kembali ke mode Tab Khusus.
Artinya, jika Anda men-debug sesuatu yang berkaitan dengan Aktivitas Web Tepercaya, Anda harus memastikan bahwa Anda menggunakan browser yang Anda pikir Anda gunakan. Anda dapat menggunakan perintah berikut untuk memeriksa browser yang digunakan:
Langkah Berikutnya
Semoga, jika telah mengikuti panduan ini, Anda akan memiliki Aktivitas Web Tepercaya yang berfungsi dan memiliki pengetahuan yang cukup untuk men-debug masalah yang terjadi saat verifikasi gagal. Jika belum, lihat konsep Android lainnya untuk developer web atau laporkan masalah GitHub terkait dokumen ini.
Untuk langkah berikutnya, sebaiknya mulailah dengan membuat ikon untuk aplikasi Anda. Setelah itu, Anda dapat mempertimbangkan untuk men-deploy aplikasi ke Play Store.