Browser
Update Terbaru | Rilis Stabil | Kandidat Rilis | Rilis Beta | Rilis Alfa |
---|---|---|---|---|
8 Februari 2023 | 1.5.0 | - | - | - |
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:
Groovy
dependencies { implementation "androidx.browser:browser:1.5.0" }
Kotlin
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.
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 antarmukaCustomTabsCallback
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 izinPOST_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
menjadiEXTRA_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 izinPOST_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 dalamTrustedWebActivityService#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
diTrustedWebActivityIntentBuilder
- Menambahkan metode
setNavigationBarDividerColor
keCustomTabColorSchemeParams
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 tandaContext.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
menjadibindCustomTabsServicePreservePriority
(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
diTrustedWebActivityIntentBuilder
. - Menambahkan
@IntDef
untukScreenOrientation.LockType
guna merepresentasikan jenis kunci (I802d2) - Menambahkan metode
setNavigationBarDividerColor
keTrustedWebActivityIntentBuilder
danCustomTabColorSchemeParams
. (Ia04dd)- Menambahkan
@IntDef
ke metodeTrustedWebActivityIntentBuilder
yang menggunakan skema warna.
- Menambahkan
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 tandaContext.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 menjadisendExtraCommand
(Id29a8) CustomTabsIntent.Builder#addDefaultShareMenuItem()
tidak digunakan lagi dan diganti dengan#setDefaultShareMenuItemEnabled(boolean)
baru, sertaCustomTabsIntent.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 dalamTrustedWebActivityService#onExtraCommand
.
Perubahan API
- URL yang diberikan ke
CustomTabsSession#mayLauncherUrl
dan diterima diCustomTabsService#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 membuatTrustedWebActivityIntent
, 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 keTrustedWebActivityService
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.
- Developer dapat memberi (melalui
- 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 olehTrustedWebActivityService
untuk menentukan aplikasi yang diizinkan terhubung ke sana.- Klien menentukan pemanggilan
TokenStore#store
;TrustedWebActivityService
hanya memuat Token.
- Klien menentukan pemanggilan
TrustedWebActivityServiceConnectionPool
(sebelumnya TrustedWebActivityServiceConnectionManager) tidak lagi menyimpan kumpulan paket terverifikasi:registerClient
dangetVerifiedPackages
sekarang telah dihapus.- Kumpulan paket terverifikasi kini disediakan secara manual ke
execute
(sebelumnyaconnect
) danserviceExistsForScope
.
TrustedWebActivityService
didelegasikan ke class pengganti untuk menyimpan penyedia terverifikasi.setVerifiedProvider
telah dihapus- Klien harus mengimplementasikan
getTokenStore
yang menampilkanTokenStore
yang dapat digunakan untuk menyimpan dan mengambilToken
.
Perubahan API
- Class
TrustedWebActivityServiceConnectionManager
:- Sekarang disebut
TrustedWebActivityServiceConnectionPool
. - Sekarang sudah final.
- Dibuat oleh metode
create
statis, bukan konstruktor publik.
- Sekarang disebut
- 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.
- Sekarang disebut
- Class
ShareTarget#FileFormField
sekarang sudah final. - Metode
TrustedWebUtils#splashScreensAreSupported
telah diganti namanya menjadiareSplashScreensSupported
. - Metode
TrustedWebActivityIntentBuilder#getUrl
telah diganti namanya menjadiTrustedWebActivityIntentBuilder#getUri
. - Kolom statis
SplashScreenParamKey
diberi awalan denganKEY_
.
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
keICustomTabsCallback
(aosp/Ic2cc2) - Menandai beberapa parameter metode
CustomTabsSession
sebagai Nullable atau NonNull (aosp/Iec460) TrustedWebActivityIntentBuilder
sekarang membuatTrustedWebActivityIntent
, bukan intent mentah (aosp/I03fb6)
Perbaikan bug
CustomTabsClient
sekarang menggunakanrequestPostMessageChannel
lama jika diperlukan (aosp/Ibb324)- Memperbaiki
CustomTabsSessionToken#equals
(aosp/I7f249) CustomTabsClient
sekarang menggunakannewSession
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.