Browser

Mendeklarasikan dependensi

Untuk menambahkan dependensi pada Browser, Anda harus menambahkan repositori Maven Google ke project Anda. Baca repositori Maven Google untuk mengetahui informasi selengkapnya.

Tambahkan dependensi untuk artefak yang diperlukan dalam file build.gradle bagi aplikasi atau modul Anda:

dependencies {
    implementation "androidx.browser:browser:1.5.0"
}

dependencies {
    implementation("androidx.browser:browser:1.5.0")
}

Untuk informasi dependensi selengkapnya, lihat Menambahkan dependensi build.

Masukan

Masukan Anda membantu meningkatkan kualitas Jetpack. Beri tahu kami jika Anda menemukan masalah baru atau mempunyai masukan untuk meningkatkan kualitas library ini. Harap periksa masalah yang sudah diketahui dalam library ini sebelum membuat laporan baru. Anda dapat memberikan suara untuk masalah yang sudah diketahui dengan mengklik tombol bintang.

Laporkan masalah baru

Lihat dokumentasi Issue Tracker untuk informasi selengkapnya.

Versi 1.5

Versi 1.5.0

8 Februari 2023

androidx.browser:browser:1.5.0 dirilis. Versi 1.5.0 berisi commit ini.

Perubahan penting sejak versi 1.4.0

• Menambahkan CustomTabsIntent.Builder#setInitialActivityHeightPx, yang memungkinkan developer menentukan tinggi peluncuran awal Tab Khusus, dan secara opsional perilaku perubahan ukuran (tetap atau dapat diubah ukurannya). (I48bd3)
• Menambahkan CustomTabsIntent.Builder#setToolbarCornerRadiusDp yang memungkinkan developer menentukan radius sudut atas toolbar. (I48bd3)
• Menambahkan CustomTabsIntent.Builder#setCloseButtonPosition yang memungkinkan developer menetapkan posisi tombol tutup pada toolbar. (I48bd3)
• Menambahkan metode callback onActivityResized ke antarmuka CustomTabsCallback untuk memberi tahu developer saat Tab Khusus berubah ukuran. (Ic864e)
• Menjadikan bagian-bagian dari CustomTabsCallback API asinkron. (Ic86df)
• Mengisi bahasa aplikasi saat ini dalam Accept-Language secara default agar sesuai dengan pengalaman bahasa per aplikasi Android. (I3d1d7)
• Menambahkan @RequiresPermission ke API yang memerlukan pemberian izin POST_NOTIFICATIONS di SDK 33 dan yang lebih baru. Ini dikembangkan di cabang internal. b/238790278 sebagai referensi.

Versi 1.5.0-rc01

25 Januari 2023

androidx.browser:browser:1.5.0-rc01 dirilis. Versi 1.5.0-rc01 berisi commit ini.

• Tidak ada perubahan sejak versi 1.5.0-beta01.

Versi 1.5.0-beta01

11 Januari 2023

androidx.browser:browser:1.5.0-beta01 dirilis. Versi 1.5.0-beta01 berisi commit ini.

• Tidak ada perubahan sejak versi 1.5.0-alpha02

Versi 1.5.0-alpha02

7 Desember 2022

androidx.browser:browser:1.5.0-alpha02 dirilis. Versi 1.5.0-alpha02 berisi commit ini.

Perubahan API

• Mengubah perilaku CustomTabsCallback#onActivityResized dan menambahkan parameter baru ke dalamnya.
• Mengganti nama EXTRA_ACTIVITY_RESIZE_BEHAVIOR menjadi EXTRA_ACTIVITY_RESIZE_HEIGHT_BEHAVIOR untuk lebih mencerminkan bahwa kode ini khusus untuk tinggi. (Ic864e)
• Menjadikan bagian-bagian dari CustomTabsCallback API asinkron. (Ic86df)

Versi 1.5.0-alpha01

24 Oktober 2022

androidx.browser:browser:1.5.0-alpha01 dirilis. Versi 1.5.0-alpha01 berisi commit ini.

Fitur Baru

• Menambahkan CustomTabsIntent.Builder#setInitialActivityHeightPx, yang memungkinkan developer menentukan tinggi peluncuran awal Tab Khusus, dan secara opsional perilaku perubahan ukuran (tetap atau dapat diubah ukurannya). (I48bd3)
• Menambahkan CustomTabsIntent.Builder#setToolbarCornerRadiusDp yang memungkinkan developer menentukan radius sudut atas toolbar. (I48bd3)
• Menambahkan CustomTabsIntent.Builder#setCloseButtonPosition yang memungkinkan developer menetapkan posisi tombol tutup pada toolbar. (I48bd3)
• Menambahkan metode callback onActivityResized ke antarmuka CustomTabsCallback untuk memberi tahu developer saat Tab Khusus diubah ukurannya (diperluas ke ketinggian penuh atau diperkecil kembali ke tinggi peluncuran awal). (Id99ce)
• Mengisi bahasa aplikasi saat ini dalam Accept-Language secara default agar sesuai dengan pengalaman bahasa per aplikasi Android. (I3d1d7)

Perubahan API

• Menambahkan @RequiresPermission ke API yang memerlukan pemberian izin POST_NOTIFICATIONS di SDK 33 dan yang lebih baru. Ini dikembangkan di cabang internal. b/238790278 sebagai referensi.

Versi 1.4.0

Versi 1.4.0

3 November 2021

androidx.browser:browser:1.4.0 dirilis. Versi 1.4.0 berisi commit ini.

Perubahan penting sejak versi 1.3.0

• Menandai PendingIntent sebagai PendingIntent.FLAG_IMMUTABLE untuk kompatibilitas Android 12.

Versi 1.4.0-rc01

13 Oktober 2021

androidx.browser:browser:1.4.0-rc01 dirilis tanpa perubahan sejak versi 1.4.0-beta01. Versi 1.4.0-rc01 berisi commit ini.

Versi 1.4.0-beta01

29 September 2021

androidx.browser:browser:1.4.0-beta01 dirilis tanpa perubahan sejak 1.4.0-alpha01. Versi 1.4.0-beta01 berisi commit ini.

Versi 1.4.0-alpha01

15 September 2021

androidx.browser:browser:1.4.0-alpha01 dirilis. Versi 1.4.0-alpha01 berisi commit ini.

Perbaikan Bug

• Menandai PendingIntent sebagai PendingIntent.FLAG_IMMUTABLE untuk kompatibilitas Android 12.

Versi 1.3.0

Versi 1.3.0

2 Desember 2020

androidx.browser:browser:1.3.0 dirilis. Versi 1.3.0 berisi commit ini.

Fitur utama sejak versi 1.2.0

• Perintah bentuk bebas dapat diteruskan dari browser ke klien Aktivitas Web Tepercaya dengan memanggil TrustedWebActivityServiceConnection#sendExtraCommand. Klien dapat menangani perintah tersebut dalam TrustedWebActivityService#onExtraCommand
• Menambahkan antarmuka TrustedWebActivityCallback yang dapat digunakan oleh klien Aktivitas Web Tepercaya untuk mengembalikan data ke browser.
• Menambahkan CustomTabsIntent#setShareState, yang memungkinkan developer menentukan apakah akan menampilkan opsi berbagi atau tidak (atau menyerahkannya pada browser).
• Developer sekarang dapat menetapkan orientasi layar default dengan metode setScreenOrientation di TrustedWebActivityIntentBuilder
• Menambahkan metode setNavigationBarDividerColor ke CustomTabColorSchemeParams untuk mendukung perubahan warna pemisah menu navigasi.
• Menambahkan CustomTabsIntent.Builder#setDefaultColorSchemeParams untuk menggantikan metode #setNavigationBarColor, #setNavigationBarDividerColor, #setToolbarColor, dan #setSecondaryToolbarColor yang sekarang tidak digunakan lagi
• Menambahkan metode CustomTabsClient#bindCustomTabsServicePreservePriority, yang memungkinkan hubungan ke Layanan Tab Khusus tanpa menggunakan tanda Context.BIND_WAIVE_PRIORITY.

Versi 1.3.0-rc01

11 November 2020

androidx.browser:browser:1.3.0-rc01 dirilis tanpa perubahan sejak 1.3.0-beta01. Versi 1.3.0-rc01 berisi commit ini.

Versi 1.3.0-beta01

28 Oktober 2020

androidx.browser:browser:1.3.0-beta01 dirilis. Versi 1.3.0-beta01 berisi commit ini.

Perubahan API

• Mengganti nama bindCustomTabServicePreservePriority menjadi bindCustomTabsServicePreservePriority (I29ac1)

Perbaikan Bug

• Pemeriksaan lint API untuk MissingGetterMatchingBuilder diaktifkan untuk androidx (I4bbea, b/138602561)

Versi 1.3.0-alpha06

1 Oktober 2020

androidx.browser:browser:1.3.0-alpha06 dirilis. Versi 1.3.0-alpha06 berisi commit ini.

Fitur Baru

• Menambahkan CustomTabsIntent#setShareState yang memungkinkan developer menetapkan status berbagi ke aktif, nonaktif, atau menyerahkannya pada browser. (I153fe)
• Menambahkan CustomTabsIntent.Builder#setDefaultColorSchemeParams yang akan digunakan sebagai pengganti metode #setNavigationBarColor, #setNavigationBarDividerColor, #setToolbarColor, #setSecondaryToolbarColor yang sudah tidak digunakan lagi. (I09012)

Perubahan API

• Pemeriksaan lint API untuk StaticFinalBuilder diaktifkan untuk androidx (I2b11b, b/138602561)
• Menambahkan CustomTabsService#KEY_SUCCESS dan TrustedWebActivityService#KEY_SUCCESS yang dapat digunakan untuk menunjukkan extraCommand berhasil. (I6f7b5)

Versi 1.3.0-alpha05

5 Agustus 2020

androidx.browser:browser:1.3.0-alpha05 dirilis. Versi 1.3.0-alpha05 berisi commit ini.

Fitur Baru

• Mengizinkan setelan orientasi Aktivitas Web Tepercaya yang diluncurkan.
• Mengizinkan setelan warna pembagi menu navigasi untuk Aktivitas Web Tepercaya dan Tab Khusus.

Perubahan API

• Menambahkan metode setScreenOrientation di TrustedWebActivityIntentBuilder.
• Menambahkan @IntDef untuk ScreenOrientation.LockType guna merepresentasikan jenis kunci (I802d2)
• Menambahkan metode setNavigationBarDividerColor ke TrustedWebActivityIntentBuilder dan CustomTabColorSchemeParams. (Ia04dd)
  • Menambahkan @IntDef ke metode TrustedWebActivityIntentBuilder yang menggunakan skema warna.

Versi 1.3.0-alpha04

24 Juni 2020

androidx.browser:browser:1.3.0-alpha04 dirilis. Versi 1.3.0-alpha04 berisi commit ini.

Fitur Baru

• Menambahkan metode CustomTabsClient#bindCustomTabServicePreservePriority, yang memungkinkan hubungan ke Layanan Tab Khusus tanpa menggunakan tanda Context.BIND_WAIVE_PRIORITY.

Versi 1.3.0-alpha03

10 Juni 2020

androidx.browser:browser:1.3.0-alpha03 dirilis. Versi 1.3.0-alpha03 berisi commit ini.

Fitur Baru

• Menambahkan antarmuka TrustedWebActivityCallback yang dapat digunakan oleh klien Aktivitas Web Tepercaya untuk mengembalikan data ke browser. (I64dbb)

Perubahan API

• TrustedWebActivityServiceConnection.extraCommand kini juga menggunakan parameter @Nullable TrustedWebActivityCallback. Parameter paket kini ditandai sebagai @NonNull, bukan @Nullable. (I64dbb)
• Metode TrustedWebActivityServiceConnection.extraCommand telah diganti namanya menjadi sendExtraCommand (Id29a8)
• CustomTabsIntent.Builder#addDefaultShareMenuItem() tidak digunakan lagi dan diganti dengan #setDefaultShareMenuItemEnabled(boolean) baru, serta CustomTabsIntent.Builder#enableUrlBarHiding() tidak digunakan lagi dan diganti dengan #setUrlBarHidingEnabled(boolean) baru. (Iad702)

Versi 1.3.0-alpha01

8 Januari 2020

androidx.browser:browser:1.3.0-alpha01 dirilis. Versi 1.3.0-alpha01 berisi commit ini.

Fitur baru

• Perintah bentuk bebas dapat diteruskan dari browser ke klien Aktivitas Web Tepercaya dengan memanggil TrustedWebActivityServiceConnection#extraCommand. Klien dapat menangani hal ini dalam TrustedWebActivityService#onExtraCommand.

Perubahan API

• URL yang diberikan ke CustomTabsSession#mayLauncherUrl dan diterima di CustomTabsService#mayLaunchUrl telah dibuat @Nullable.

Versi 1.2.0

Versi 1.2.0

18 Desember 2019

androidx.browser:browser:1.2.0 dirilis tanpa perubahan sejak 1.2.0-rc01. Versi 1.2.0 berisi commit ini.

Perubahan utama sejak versi 1.0.0

• Aktivitas Web Tepercaya
  • Dukungan untuk Aktivitas Web Tepercaya sekarang sudah dalam versi stabil.
  • TrustedWebActivityIntentBuilder dapat digunakan untuk menyesuaikan dan membuat TrustedWebActivityIntent, guna meluncurkan Aktivitas Web Tepercaya.
  • TrustedWebActivityService dapat disertakan atau diperluas untuk memungkinkan klien menampilkan notifikasi push web yang diserahkan kepadanya oleh browser.
  • TrustedWebActivityServiceConnectionPool dapat digunakan oleh browser untuk terhubung ke TrustedWebActivityService dalam klien. TrustedWebActivityServiceConnection menunjukkan koneksi semacam itu.
  • Aktivitas Web Tepercaya dapat diluncurkan untuk memberikan informasi ke Web Share Target.
• Tema Gelap
  • Developer dapat memberi (melalui CustomTabColorSchemeParams) warna tema berbeda yang akan digunakan saat perangkat dalam mode terang atau gelap.
  • Developer dapat meminta browser untuk menampilkan mode terang atau gelap.
• Pelanjutan sesi
  • CustomTabsSession dapat dibuat dengan id, memungkinkan Tab Khusus berikutnya diluncurkan dari klien dan id yang sama untuk digabungkan.
• Warna menu navigasi dapat ditentukan untuk Tab Khusus.
• Class terkait Tindakan Browser ditandai sebagai tidak digunakan lagi karena penggunaan fitur yang sangat rendah dan akan dihapus pada versi library berikutnya.

Versi 1.2.0-rc01

4 Desember 2019

androidx.browser:browser:1.2.0-rc01 dirilis. Versi 1.2.0-rc01 berisi commit ini.

Perbaikan bug

• Pemformatan Javadoc untuk contoh kode telah diperbaiki.

Versi 1.2.0-beta01

20 November 2019

androidx.browser:browser:1.2.0-beta01 dirilis tanpa perubahan sejak 1.2.0-alpha09. Versi 1.2.0-beta01 berisi commit ini.

Versi 1.2.0-alpha09

23 Oktober 2019

androidx.browser:browser:1.2.0-alpha09 dirilis. Versi 1.2.0-alpha09 berisi commit ini.

Fitur baru

• Class Token dapat digunakan untuk menunjukkan identitas paket. Class ini berisi nama paket dan tanda tangan dari sertifikat penandatanganan paket.
  • Dirancang untuk diserialkan dengan byte[] untuk persistensi.
  • Digunakan oleh TrustedWebActivityService untuk menentukan penyedia TWA yang diizinkan terhubung ke sana.
  • Digunakan oleh TrustedWebActivityConnectionPool penyedia TWA untuk menentukan paket yang valid untuk dihubungkan.
• Antarmuka TokenStore sekarang digunakan oleh TrustedWebActivityService untuk menentukan aplikasi yang diizinkan terhubung ke sana.
  • Klien menentukan pemanggilan TokenStore#store; TrustedWebActivityService hanya memuat Token.
• TrustedWebActivityServiceConnectionPool (sebelumnya TrustedWebActivityServiceConnectionManager) tidak lagi menyimpan kumpulan paket terverifikasi:
  • registerClient dan getVerifiedPackages sekarang telah dihapus.
  • Kumpulan paket terverifikasi kini disediakan secara manual ke execute (sebelumnya connect) dan serviceExistsForScope.
• TrustedWebActivityService didelegasikan ke class pengganti untuk menyimpan penyedia terverifikasi.
  • setVerifiedProvider telah dihapus
  • Klien harus mengimplementasikan getTokenStore yang menampilkan TokenStore yang dapat digunakan untuk menyimpan dan mengambil Token.

Perubahan API

• Class TrustedWebActivityServiceConnectionManager:
  • Sekarang disebut TrustedWebActivityServiceConnectionPool.
  • Sekarang sudah final.
  • Dibuat oleh metode create statis, bukan konstruktor publik.
• Class TrustedWebActivityService:
  • Memiliki anotasi thread pada metode yang dapat diganti.
• Class TrustedWebActivityServiceWrapper:
  • Sekarang disebut TrustedWebActivityServiceConnection.
  • Sekarang sudah final.
  • Sekarang menampilkan RemoteExceptions mentah, bukan menggabungkannya dalam RuntimeExceptions.
• Class ShareTarget#FileFormField sekarang sudah final.
• Metode TrustedWebUtils#splashScreensAreSupported telah diganti namanya menjadi areSplashScreensSupported.
• Metode TrustedWebActivityIntentBuilder#getUrl telah diganti namanya menjadi TrustedWebActivityIntentBuilder#getUri.
• Kolom statis SplashScreenParamKey diberi awalan dengan KEY_.

Versi 1.2.0-alpha08

18 September 2019

androidx.browser:browser:1.2.0-alpha08 dirilis. Versi 1.2.0-alpha08 berisi commit ini.

Fitur baru

• Memperkenalkan Share Target API baru untuk Aktivitas Web Tepercaya. Aplikasi yang menggunakan Aktivitas Web Tepercaya sekarang dapat mengirim data ke Web Share Target, yang ditentukan oleh protokol https://wicg.github.io/web-share-target/level-2/ (aosp/I47b93, aosp/I0ec3e)

Perubahan API

• Menambahkan callback extraCallbackWithResult ke ICustomTabsCallback (aosp/Ic2cc2)
• Menandai beberapa parameter metode CustomTabsSession sebagai Nullable atau NonNull (aosp/Iec460)
• TrustedWebActivityIntentBuilder sekarang membuat TrustedWebActivityIntent, bukan intent mentah (aosp/I03fb6)

Perbaikan bug

• CustomTabsClient sekarang menggunakan requestPostMessageChannel lama jika diperlukan (aosp/Ibb324)
• Memperbaiki CustomTabsSessionToken#equals (aosp/I7f249)
• CustomTabsClient sekarang menggunakan newSession lama jika memungkinkan (aosp/Ie27dc)

Kontribusi eksternal

• Pemeriksaan lint API untuk MinMaxConstant diaktifkan untuk androidx (aosp/I29b78) (b/138602561)

Versi 1.2.0-alpha07

7 Agustus 2019

androidx.browser:browser:1.2.0-alpha07 dirilis. Commit yang disertakan dalam versi ini dapat dilihat di sini.

Fitur baru

• Tema Gelap

  • Developer dapat memberi warna tema untuk digunakan saat perangkat dalam mode gelap.
  • Developer juga dapat mengganti apakah browser yang diluncurkan harus dalam mode gelap atau terang.
  • Warna menu navigasi dapat ditentukan untuk Tab Khusus.

• Aktivitas Web Tepercaya

  • TrustedWebActivityBuilder dapat digunakan untuk membuat dan meluncurkan Aktivitas Web Tepercaya dengan mudah.
  • Class TrustedWebActivityService dan yang terkait dapat digunakan untuk berkomunikasi dengan penyedia, menerima notifikasi push web untuk situs yang ditautkan, dan menampilkannya dari aplikasi klien. Bagian API ini dapat mengalami perubahan.

• ID Sesi Tab Khusus

  • Sesi Tab Khusus kini dapat dibuat dengan id, sehingga memungkinkan penggabungan dua sesi yang diluncurkan oleh aplikasi serupa dengan id yang sama.

Perubahan API

• Class dan metode terkait Tindakan Browser telah ditandai tidak digunakan lagi. Sayangnya, ketika kami memiliki harapan tinggi pada fitur ini, hampir tidak ada yang menggunakannya dan hanya satu browser yang akhirnya memberikan dukungan untuk itu. Kami tidak lagi menggunakannya agar kode dan API tetap sederhana.

Versi 1.0.0

Versi 1.0.0

21 September 2018

browser-1.0.0 dirilis.