Ada banyak ekosistem seputar Aktivitas Web Tepercaya dan bisa sangat sulit untuk melihat bagaimana segala sesuatu berhubungan dan apa yang harus Anda gunakan. Artikel ini bertujuan untuk membahas hal tersebut.
Jika Anda baru mengenal Aktivitas Web Tepercaya atau hanya mencari rangkaian alat yang direkomendasikan yang gunakan saat ini, berikut hal yang perlu Anda ketahui:
- Bubblewrap: alat NodeJS yang memungkinkan developer membuat dan membangun APK Android yang menggabungkan PWA yang sudah ada. Aplikasi yang dihasilkan didukung oleh Aktivitas Web Tepercaya, tetapi hal ini transparan terhadap developer. Tidak diperlukan pengalaman pengembangan Android. Lihat dokumentasi Bubblewrap untuk memulai.
- android-browser-helper: Library Android yang merangkum Aktivitas Web Tepercaya dan berperforma tinggi karena merupakan protokol biner. Direkomendasikan untuk developer yang sudah memahami pengembangan Android dan ingin menggunakan Web Tepercaya Aktivitas sebagai salah satu Aktivitas di Aplikasi Android mereka atau melakukan penyesuaian yang tidak didukung oleh Bubblewrap. Untuk mulai menggunakan android-browser-helper, lihat dokumentasi dan demo kami.
Bagian berikutnya memberikan ringkasan singkat tentang semua project yang saling terkait. Terakhir (bagi yang penasaran) ada bagian sejarah untuk menunjukkan bagaimana kami sampai di sini dan di mana yang rencananya akan kami hadiri dalam waktu dekat.
Ringkasan library
Berikut adalah ringkasan kalimat singkat dari setiap library yang mungkin Anda gunakan:
- androidx.browser, library Android untuk berinteraksi dengan browser yang diinstal di perangkat seluler.
- Bantuan Browser Android, library yang dibuat di androidx.browser untuk Aktivitas Web Tepercaya klien yang menyediakan metode praktis dan {i>default<i} yang masuk akal.
- Bubblewrap, alat untuk membuat Aktivitas Web Tepercaya dari PWA tanpa menyentuh Java apa pun pada kode sumber.
Selain itu, masing-masing library/alat ini menggantikan yang lama:
- androidx.browser menggantikan Support Library Tab Kustom.
- Yang harus digunakan adalah Bantuan Browser Android, bukan custom-tabs-client.
- Gunakan Bubblewrap, bukan svgomg-twa.
Histori
Android Support Library
Android Support Library memperluas platform Android dengan API dan kompatibilitas baru baru. Library ini dibagi menjadi beberapa paket, dengan Custom Tabs Support Library yang berisi fungsi untuk berinteraksi dengan {i>browser<i} di sistem pengguna. Pengembangan Support Library Custom Tabs terutama dilakukan di custom-tabs-client Repositori GitHub, dengan perubahan yang di-upstream kembali ke Android Support Library.
Tab Khusus adalah Aktivitas Android yang menggunakan browser untuk menampilkan halaman web. Manfaat utama bagi developer adalah bahwa game ini dapat diberi tema dan memiliki tombol tutup, sehingga pengguna masih ada di aplikasi developer (bukan keluar dari aplikasi dan membuka halaman penjelajahan pengalaman). Sebagai Android API, Tab Khusus dapat didukung oleh browser apa pun dan akan menggunakan tab default pengguna browser Anda (meskipun ini dapat diganti oleh developer).
Karena Aktivitas Web Tepercaya dibuat di Tab Khusus, pengguna memulai hidup mereka di library custom-tabs-client ini. Aktivitas Web Tepercaya menghapus panel atas Tab Khusus saat pengguna menjelajahi situs milik aplikasi Anda. Hal ini akan membuka pintu untuk integrasi situs Anda yang lancar dalam aplikasi Android native, dan dapat digunakan untuk membuat aplikasi yang semua fungsinya disediakan oleh web.
AndroidX
Android Support Library kemudian berganti nama menjadi AndroidX, yang merupakan bagian dari upaya yang lebih besar untuk meningkatkan pengalaman developer yang disebut JetPack. Jadi, Tab Khusus dan Aktivitas Web Tepercaya harus dipindahkan dari Pustaka Dukungan Tab Khusus ke androidx.browser baru.
Beberapa kode yang telah kami tulis di custom-tabs-client sesuai untuk library Class helper Aktivitas Web, tetapi bukan untuk Android API. Kode yang menangani pemeriksaan versi Chrome yang sudah tidak berlaku dan meminta pengguna untuk mengupdate atau membuat keputusan tentang bagaimana data seharusnya disimpan tidak dapat dipindahkan ke AndroidX. Oleh karena itu, kami membuat library alternatif untuk menampung bagian-bagian custom-tabs-client yang tidak dapat membuka androidx.browser, sehingga lahirlah Bantuan Browser Android.
Bantuan Browser Android dibuat untuk memuat kode yang dapat spesifik untuk browser (bukan khusus Chrome, kami terbuka terhadap kode khusus untuk browser lain) dan dapat membuat keputusan konkret yang tidak seharusnya dilakukan library. Kami mengambil kesempatan ini untuk secara umum memisahkan peran kedua library ini:
- androidx.browser berisi elemen penyusun dasar untuk berinteraksi dengan browser di sistem pengguna.
- Bantuan Browser Android berisi penerapan default yang mudah digunakan dan masuk akal.
Bootstrap
Developer adalah orang-orang yang sibuk, dengan banyak pekerjaan yang harus dilakukan dan tenggat waktu yang harus disesuaikan. Untuk membantu hal ini, kami membuat dua alat yang memungkinkan pengguna mem-bootstrap Aktivitas Web Tepercaya mereka.
Yang pertama (dan terlama) adalah svgomg-twa, yang merupakan Project Android yang dihosting GitHub yang meluncurkan Aktivitas Web Tepercaya. Awalnya ini dirancang untuk menjadi proyek demo yang berkembang menjadi lebih dari {i>template<i}. Pengguna dapat meng-clone repo tersebut dan mengubah file build.gradle agar mengarah ke situs mereka sendiri, membangunnya dan menghasilkan Aktivitas Web Tepercaya tanpa menyentuh kode Java apa pun. (Untuk memverifikasi Digital Asset Links memang memerlukan usaha lebih, baca selengkapnya di sini.)
svgomg-twa dimulai bergantung pada tab-kustom-client, tetapi kemudian beralih ke Android Bantuan Browser (dan androidx.browser secara transitif).
Alat terbaru dan paling ringkas adalah Bubblewrap, yaitu alat Node.js yang akan memanfaatkan Aplikasi Web Anda Membuat manifes dan membuat Aktivitas Web Tepercaya untuk Anda. Ini adalah cara termudah untuk membuat Aktivitas Web Tepercaya dari PWA yang ada dan tidak memerlukan pengetahuan pengembangan Android.
Dalam Waktu Dekat
Kami akan menghentikan penggunaan svgomg-twa karena dua alasan:
- Bubblewrap pada dasarnya menghasilkan svgomg-twa yang diisi untuk developer. Ia melakukannya secara interaktif dan dapat mengambil konfigurasi dari manifes Aplikasi Web (yang disebut kemungkinan besar sudah Anda miliki).
- Jika developer menginginkan referensi tentang cara memulai project Aktivitas Web Tepercaya mereka sendiri dari awal, mereka dapat melihat direktori demo Bantuan Browser Android.
Sebagai gantinya, developer baru sebaiknya menggunakan Bubblewrap untuk membuat project mereka. Jika sudah menggunakan svgomg-twa dan telah membuat beberapa modifikasi berat, Anda dapat melakukan terus melakukannya, tetapi tidak akan mendapatkan pembaruan.
Kami berencana untuk membuat Bubblewrap sebaik mungkin, jadi jika ada fitur yang jelas hilang atau Anda menemukan bug, jangan ragu untuk mengajukan masalah.