WindowManager
Update Terbaru | Rilis Stabil | Kandidat Rilis | Rilis Beta | Rilis Alfa |
---|---|---|---|---|
22 Februari 2023 | 1.0.0 | - | - | 1.1.0-alpha06 |
Mendeklarasikan dependensi
Untuk menambahkan dependensi pada Window Manager, Anda harus menambahkan repositori Maven Google ke project Anda. Baca repositori Maven Google untuk informasi selengkapnya.
Tambahkan dependensi untuk artefak yang diperlukan dalam file build.gradle
bagi
aplikasi atau modul Anda:
Groovy
dependencies { implementation "androidx.window:window:1.0.0" // For Java-friendly APIs to register and unregister callbacks implementation "androidx.window:window-java:1.0.0" // For RxJava2 integration implementation "androidx.window:window-rxjava2:1.0.0" // For RxJava3 integration implementation "androidx.window:window-rxjava3:1.0.0" // For testing implementation "androidx.window:window-testing:1.0.0" }
Kotlin
dependencies { implementation("androidx.window:window:1.0.0") // For Java-friendly APIs to register and unregister callbacks implementation("androidx.window:window-java:1.0.0") // For RxJava2 integration implementation("androidx.window:window-rxjava2:1.0.0") // For RxJava3 integration implementation("androidx.window:window-rxjava3:1.0.0") // For testing implementation("androidx.window:window-testing:1.0.0") }
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.1
Versi 1.1.0-alpha06
22 Februari 2023
androidx.window:window-*:1.1.0-alpha06
dirilis. Versi 1.1.0-alpha06 berisi commit ini.
Fitur Baru
- Mengekspos versi eksperimental untuk mendapatkan
WindowLayoutInfo
dari konteks UI.
Perubahan API
- Menambahkan
splitSupportStatus
untuk menunjukkan apakah penyematan Aktivitas tersedia. (I10024) - Membuat Konteks UI
WindowLayoutInfo
API sebagai eksperimental. (I58ee0) - Memperkenalkan
WindowAreaController
dan API untuk mengaktifkan ModeRearDisplay
guna memindahkan jendela saat ini ke layar yang sejajar dengan kamera belakang. (Iffcbf) - Memperbarui warna latar belakang default. (I1ac1b)
- Menambahkan parameter
SplitAttributes
. (I18bdd) - Menambahkan API untuk
SplitRule
,SplitAttributes
,SplitAttributesCalculator
. (I92d23) - Meningkatkan API terkait
maxAspectRatio
:- Mengganti
alwaysAllow()
danalwaysDisallow()
denganALWAYS_ALLOW
danALWAYS_DISALLOW
. - Memperbarui dokumentasi API @see dengan dokumentasi mandiri. (I3057b)
- Mengganti
- Konstruktor berikut dihapus dari API publik karena seharusnya tidak dipanggil oleh aplikasi.
- Konstruktor
SplitInfo
- Konstruktor
ActivityStack
(Ide534)
- Konstruktor
SplitRule
kini menggunakanmaxAspectRatioInPortrait/Landscape
. Hal ini hanya memungkinkan pemisahan aktivitas jika rasio aspek batas induk lebih kecil atau sama denganmaxAspectRatio
yang diminta. (Ia5990)- Mengubah
RuleController#parseRules
menjadi statis (I785df) - Meningkatkan API terkait ActivityEmbedding
- Menyelaraskan penamaan API - Menggunakan tambahkan/hapus untuk beberapa instance:
registerRule
berubah menjadiaddRule
unregisterRule
berubah menjadiremoveRule
- Mengganti
getSplitRules
dengangetRules
karenaActivityRule
bukan aturan pemisahan - Menambahkan
RuleController#setRules
untuk menetapkan sekumpulan aturan - Mengekstrak API terkait aturan dari
SplitController
keRuleController
singleton. API tersebut adalah: addRule
removeRule
getRules
setRules
clearRules
parseRules
- Mengekstrak
#isActivityEmbedded
dariSplitController
keActivityEmbeddingController
singleton. API tersebut adalah: isActivityEmbedded
- Menghapus
SplitController#initialize
. Untuk menetapkan aturan dari file XML, gunakanRuleController#parseRules
dan#setRules
. Sebelum perubahan ini:SplitController.initialize(context, R.xml.static_rules)
Setelah perubahan ini:val ruleController = RuleController.getInstance(context) val rules = ruleController.parseRules(R.xml.static_rules) ruleController.setRules(rules)
- Kita tidak lagi membedakan aturan statis dengan aturan runtime. Meskipun demikian, memanggil hasil
#clearRules
akan menghapus semua aturan, terlepas dari aturan tersebut terdaftar dengan definisi aturan XML statis atau saat runtime. Untuk mempertahankan perilaku lamaSplitController#clearRegisteredRules
, panggilRuleController#parseRules
dengan ID resource XML dan panggilRuleController#setRules
untuk menetapkan kembali aturan. Sebelum perubahan ini:SplitController.getInstance(context).clearRegisteredRules()
Setelah perubahan ini:val ruleController = RuleController.getInstance(context) val rules = ruleController.parseRules(R.xml.static_rules) ruleController.setRules(rules)
(Ib3967)
- Meningkatkan SplitRule API:
- Menggunakan dimensi min dalam DP, bukan piksel untuk
SplitRule
. - Memfaktorkan ulang untuk
SplitRule
Builder agar menggunakan dimensi min sebagai opsional. (I95f17)
- Menggunakan dimensi min dalam DP, bukan piksel untuk
- Meneruskan Konteks untuk melakukan inisialisasi
SplitController
(I42549) - Mengganti nama
SplitRule#layoutDir
menjadi#layoutDirection
, danSplitRule Builder#setLayoutDir
menjadiBuilder#setLayoutDirection
. (I3f6d1)
Versi 1.1.0-alpha04
9 November 2022
androidx.window:window-*:1.1.0-alpha04
dirilis. Versi 1.1.0-alpha04 berisi commit ini.
Fitur Baru
- Mengekspos metode untuk menentukan apakah
ActivityStack
kosong untukActivityEmbedding
. - Menghapus tag API eksperimental dari
ActivityEmbedding
API. - Menyembunyikan konstruktor
ActivityRule
karenaBuilder
adalah cara yang direkomendasikan untuk membuat. - Menambahkan metode eksperimental untuk mendapatkan
WindowInsets
diWindowMetrics
. - Mengupdate
SplitPlaceholderFinishBehavior
agar placeholder tidak diselesaikan. Menyelesaikan placeholder yang menyebabkan beberapa perilaku membingungkan.
Perubahan API
- Membuat val
isEmpty
menjadi publik untuk menggantikan funisEmpty
. - Mengganti nama aktivitas parameter
ActivityStack
menjadiactivitiesInProcess
. (Ia5055) - Menghapus
ActivityFilter#matchesClassName
danActivityFilter#matchesClassNameOrWildCard
karena keduanya membingungkan. - Menambahkan
ActivityFilter#componentName
abdActivityFilter#intentAction
untuk memungkinkan pemanggil membedakan filter yang berbeda (I41f22) - Menghapus API
@Deprecated
dari API eksperimental (I216b3) - Menghapus
@ExperimentalWindowApi
untuk Activity Embedding API (I69ebe) - Menyembunyikan konstruktor
ActivityRule
dan menggunakan Builder sebagai gantinya. (If4eb6) - Menambahkan API untuk memeriksa apakah Aktivitas merupakan bagian dari
ActivityFilter
. (Ia43cf) - Mengupdate file API untuk menunjukkan perubahan di class
WindowMetrics
danWindowMetricsCalculatorCompat
(I667fe) - Mengupdate
ActivityEmbedding
Properti Javadoc dan nama class (Ia1386) - Menambahkan nama tag properti
ActivityEmbedding
yang akan digunakan di AndroidManifest.xml (Id1ad4) - Menambahkan API baru
SplitPlaceholderFinishBehavior
danSplitPlaceholderRule.finishPrimaryWithPlaceholder
yang menggantikanSplitPlaceholderRule.finishPrimaryWithSecondary
lama yang menentukan kapan aktivitas placeholder selesai dan bagaimana aktivitas terkait dalam Penyematan Aktivitas harus berperilaku. (I64647)
Perbaikan Bug
- Memperkenalkan
WindowAreaController
dan API untuk mengaktifkan ModeRearDisplay
guna memindahkan jendela saat ini ke layar yang sejajar dengan kamera belakang. (I388ab)
Versi 1.1.0-alpha03
27 Juli 2022
androidx.window:window-*:1.1.0-alpha03
dirilis. Versi 1.1.0-alpha03 berisi commit ini.
Fitur Baru
- Memperbarui nilai default untuk aturan penyematan.
Perubahan API
- Memperbarui nilai default untuk properti aturan penyematan. (Ic4d35)
Versi 1.1.0-alpha02
11 Mei 2022
androidx.window:window-*:1.1.0-alpha02
dirilis. Versi 1.1.0-alpha02 berisi commit ini.
Fitur Baru
- Merilis library adaptor untuk mendukung Java dan RxJava.
Versi 1.1.0-alpha01
11 Mei 2022
androidx.window:window-*:1.1.0-alpha01
dirilis. Versi 1.1.0-alpha01 berisi commit ini.
Fitur Baru
- Merilis adaptor untuk mendukung Java dan RxJava
Versi 1.1.0-alpha01
20 April 2022
androidx.window:window:1.1.0-alpha01
dirilis. Versi 1.1.0-alpha01 berisi commit ini.
Fitur Baru
- Memperbaiki bug yang menyebabkan latar belakang aplikasi berhenti memunculkan fitur lipat.
- Memperluas pada API ActivityEmbedding eksperimental.
Perubahan API
- API publik untuk memeriksa apakah aktivitas sedang disematkan. (I39eb7)
Perbaikan Bug
- Menambahkan API yang menyesuaikan perilaku penyelesaian untuk penampung dalam pemisahan aktivitas (I1a1e4)
- Menambahkan opsi konfigurasi baru untuk aturan pemisahan aktivitas. (Iec6af)
Versi 1.0
Versi 1.0.0
26 Januari 2022
androidx.window:window-*:1.0.0
dirilis. Versi 1.0.0 berisi commit ini.
Fitur utama 1.0.0
- Dukungan untuk ponsel foldable melalui
WindowInfoTracker
danFoldingFeature
.WindowMetricsCalculator
untuk membantu menghitung WindowMetrics saat ini.
Versi 1.0.0-rc01
15 Desember 2021
androidx.window:window-*:1.0.0-rc01
dirilis. Versi 1.0.0-rc01 berisi commit berikut ini.
Fitur Baru
- Menambahkan dukungan untuk ponsel lipat melalui
WindowInfoTracker
. - Menambahkan metode untuk menghitung
WindowMetrics
saat ini dan maksimum. - Menambahkan API pengujian pendukung.
Versi 1.0.0-beta04
17 November 2021
androidx.window:window-*:1.0.0-beta04
dirilis. Versi 1.0.0-beta04 berisi commit berikut ini.
Fitur Baru
- Mengganti nama WindowInfoRepository menjadi WindowInfoTracker.
- Membuat Aktivitas menjadi dependensi metode eksplisit untuk WindowInfoTracker.
- Menambahkan TestRule sederhana untuk WindowMetricsCalculator guna mendukung developer menggunakan Robolectric.
Perubahan API
- Mengekstrak ekstensi (I25a5f)
- Menambahkan isEmpty di ActivityStack (I5a4e6)
- Mengganti nama WindowInfoRepository menjadi WindowInfoTracker.
- Mengupdate dependensi java/rxjava/testing agar sesuai. (I0da63)
- Menambahkan aturan pengujian untuk WindowMetricsCalculator sederhana. (Ibacdb)
Versi 1.0.0-beta03
27 Oktober 2021
androidx.window:window-*:1.0.0-beta03
dirilis. Versi 1.0.0-beta03 berisi commit berikut ini.
Fitur Baru
- Menambahkan Activity Embedding API eksperimental. Versi tata letak awal ini memungkinkan tampilan dua Aktivitas secara berdampingan.
Perubahan API
- Menghapus currentWindowMetrics API karena kami tidak dapat menyediakannya secara akurat. Sebagai gantinya, gunakan WindowMetricsCalculator (Icda5f)
- Memperbarui api ekstensi. (Ica92b)
- Menambahkan antarmuka untuk fitur baru yang memungkinkan penyematan aktivitas dan menampilkannya secara berdampingan dalam jendela tugas induk. (I5711d)
- Menyembunyikan konstruktor untuk WindowMetrics dan WindowLayoutInfo, dan sebagai gantinya harap gunakan API pengujian. (I5a1b5)
- Menambahkan API untuk membuat objek WindowLayoutInfo palsu. (I4a2fd)
Perbaikan Bug
- Memperbaiki kebocoran memori. (I3fc79, b/202989046)
Versi 1.0.0-beta02
1 September 2021
androidx.window:window-*:1.0.0-beta02
dirilis. Versi 1.0.0-beta02 berisi commit ini.
Fitur Baru
- Menambahkan anotasi eksperimental untuk memberi anotasi pada API eksperimental. (I9f1b6)
- Menambahkan metode pengujian untuk membuat FoldingFeature pengujian yang menerima Rect. Hal ini akan mempermudah pengujian saat menggunakan Robolectric dibandingkan dengan Aktivitas yang sebenarnya. (Id1cca)
Versi 1.0.0-beta01
18 Agustus 2021
androidx.window:window-*:1.0.0-beta01
dirilis. Versi 1.0.0-beta01 berisi commit ini.
Fitur Baru
- Menghapus konstanta lama dan membuat
FoldingFeature
menjadi antarmuka.
Perubahan API
- Menghapus konstanta lama dan menjadikan FoldFeature sebagai antarmuka. (I9a2d5)
Perbaikan Bug
- Library yang bergantung pada library
Test Core
telah diupgrade ke versi1.4.0
dan kini akan berfungsi dengan platform Android versi S. (I88b72, b/189353863)
Versi 1.0.0-alpha10
4 Agustus 2021
androidx.window:window-*:1.0.0-alpha10
dirilis. Versi 1.0.0-alpha10 berisi commit berikut.
Fitur Baru
- Mengganti nama WindowInfoRepo menjadi WindowInfoRepository dan menyesuaikan class/file yang sesuai.
- Mengonversi metrik jendela saat ini menjadi Flow di WindowInfoRepository karena nilainya berubah dari waktu ke waktu.
- Mengganti nama WindowInfoRepoJavaAdapter menjadi WindowInfoRepoCallbackAdapter
- Menambahkan metode helper untuk membuat objek FoldingFeature pengujian
- Mengupdate paket ke class grup berdasarkan fitur yang didukungnya.
Perubahan API
- Mengganti Nama ActivityExt menjadi ActivityExtensions Perubahan dari Repo ke Repository. (I61a16)
- Mengupdate paket untuk class. (I23ae2)
- Menghapus WindowMetrics dari WindowInfoRepo (I24663)
- Menghapus WindowManager dan menggunakan WindowInfoRepo
- Menjadikan WindowBackend secara internal. (I06d9a)
- Mengonversi metrik jendela ke Alur.
- Mengganti nama adaptor Java menjadi WindowInfoRepoCallbackAdapter
- Menghapus callbackFlow sehingga tidak ada lagi API eksperimental yang sedang digunakan. (Ia4d15)
- Menambahkan metode helper untuk membuat fitur tampilan pengujian.
- Mengubah occlusionMode ke occlusionType (If4cff)
Perbaikan Bug
- Memperbaiki error proguard saat library inti dihapus.
- Memperbaiki error saat WindowLayoutInfo tidak dikirimkan ke pelanggan tambahan.
- Memperbaiki error saat perubahan konfigurasi tidak akan memicu update fitur lipat.
Versi 1.0.0-alpha09
30 Juni 2021
androidx.window:window-*:1.0.0-alpha09
dirilis. Versi 1.0.0-alpha09 berisi commit berikut ini.
Fitur Baru
- Mengubah dari konstanta bilangan bulat menjadi enum tidak terbatas.
- Menambahkan utilitas pengujian untuk membuat fitur pengujian lipat.
Perubahan API
- Menambahkan metode helper untuk membuat fitur tampilan pengujian. (I3cf54)
- Mengubah dari
occlusionMode
menjadiocclusionType
.
- Mengubah dari
Perbaikan Bug
- Membuat nilai awal saat menambahkan beberapa konsumen aliran data.
Versi 1.0.0-alpha08
16 Juni 2021
androidx.window:window-*:1.0.0-alpha08
dirilis. Versi 1.0.0-alpha08 berisi commit ini.
Fitur Baru
- Merilis artefak pengujian untuk mempermudah pengujian saat menggunakan WindowInfoRepository. Menggunakan WindowInfoRepository untuk mendapatkan informasi tentang DisplayFeatures dan WindowMetrics. (I57f66, Ida620)
Versi 1.0.0-alpha07
2 Juni 2021
androidx.window:window-*:1.0.0-alpha07
dirilis. Versi 1.0.0-alpha07 berisi commit ini.
Fitur Baru
- Memigrasikan library jendela inti ke Kotlin. Akan menggunakan coroutine dan fungsi penangguhan untuk menampilkan data asinkron ke depannya.
- Menambahkan WindowInfoRepo sebagai titik interaksi utama untuk mendapatkan WindowMetrics dan aliran data WindowLayoutInfo.
- Artefak
window-java
baru untuk menampilkan API yang cocok untuk Java guna mendaftarkan dan membatalkan pendaftaran callback. - Artefak
window-rxjava2
danwindow-rxjava3
baru untuk menampilkan API yang disesuaikan dengan RxJava.
Perubahan API
- Menambahkan
WindowServices
untuk memberikan dependensi secara seragam.- Menambahkan API berbasis coroutine untuk menggunakan info tata letak jendela. (Iab70f)
- Memigrasikan library pengelola jendela inti ke Kotlin. (Icca34)
Perbaikan Bug
- Menambahkan class data baru untuk mewakili batasan fitur. (I6dcd1)
Versi 1.0.0-alpha06
5 Mei 2021
androidx.window:window:1.0.0-alpha06
dirilis. Versi 1.0.0-alpha06 berisi commit ini.
Fitur Baru
- Kami telah memulai migrasi ke Kotlin dan akan selesai pada rilis berikutnya.
- DeviceState telah dihapus dari API publik. Gunakan FoldingFeature sebagai gantinya.
- Kami telah menghapus
STATE_FLIPPED
dari status FoldingFeature karena saat ini tidak didukung oleh kasus penggunaan apa pun. - Kami juga telah menghapus API lain yang sudah tidak digunakan lagi.
Perubahan API
- Menambahkan Kotlin sebagai dependensi.
- Memigrasikan library inti ke Kotlin. (Idd995)
- Menghapus builder
DisplayFeature
. (I61fa4) - Menghapus
DeviceState
dari API publik. GunakanFoldingFeature
sebagai gantinya. (Id6079) - Menghapus callback status perangkat dari ekstensi. (I5ea83)
- Menghapus
STATE_FLIPPED
dari FoldingFeature. (I9c4e1) - Menghapus metode pendaftaran yang tidak digunakan lagi. (Ib381b)
Versi 1.0.0-alpha05
24 Maret 2021
androidx.window:window:1.0.0-alpha05
dirilis. Versi 1.0.0-alpha05 berisi commit ini.
Fitur Baru
Kami telah menambahkan metode praktis ke FoldingFeature agar aplikasi dapat mengetahui apakah fitur tersebut memisahkan, menutupi, dan menentukan orientasi engsel. Kami juga menyembunyikan jenis engsel sehingga
Kami menghapus metode pembacaan sinkron dari WindowManager. Metode pembacaan sinkron rentan terhadap error karena ada kondisi race implisit. Daftarkan pemroses dan callback untuk menerima update pada WindowLayoutInfo.
Perubahan API
- Menambahkan metode praktis agar berfungsi dengan FoldingFeatures (Ie733f)
- Menghapus metode pembacaan sinkron dari WindowManager (I96fd4)
Version 1.0.0-alpha04
10 Maret 2021
androidx.window:window:1.0.0-alpha04
dirilis. Versi 1.0.0-alpha04 berisi commit ini.
Fitur Baru
- Memperbaiki bug saat tidak ada WindowLayoutInfo yang dimunculkan jika tidak ada implementasi OEM. Kini kami memunculkan WIndowLayoutInfo kosong.
- Memperbaiki bug yang statusnya tidak akan diperbarui dengan benar jika status engsel berubah saat aplikasi di latar belakang. Status kini harus konsisten.
- Memperbarui file proguard untuk mengabaikan peringatan dari dependensi runtime.
Perbaikan Bug
- Memberikan nilai kosong saat library OEM tidak ada. (Ide935)
Versi 1.0.0-alpha03
18 Februari 2021
androidx.window:window:1.0.0-alpha03
dirilis. Versi 1.0.0-alpha03 berisi commit ini.
Fitur Baru
- Memberikan nilai kosong untuk WindowLayoutInfo saat implementasi OEM kosong. Ini akan memudahkan penggunaan library di lebih banyak perangkat. Karena API bersifat asinkron, aplikasi tetap disarankan untuk menulis beberapa kode defensif dan memberikan nilai default setelah waktu tunggu. Kami tidak memiliki jaminan apa pun terkait implementasi OEM dan nilai awal mungkin tertunda.
Perbaikan Bug
- Memberikan nilai kosong saat library OEM tidak ada. (Ide935)
Versi 1.0.0-alpha02
27 Januari 2021
androidx.window:window:1.0.0-alpha02
dirilis. Versi 1.0.0-alpha02 berisi commit ini.
Fitur Baru
Kami tidak lagi menggunakan beberapa API untuk membantu menyederhanakan API dan mengurangi kesalahan. Beberapa contoh utama adalah menghapus operasi pembacaan sinkron dari WindowsManager dan tidak menggunakan DeviceState. Operasi pembacaan sinkron dapat menyebabkan kondisi race dan memiliki UI yang salah.
Kami telah mengonversi DisplayFeature ke antarmuka yang akan diterapkan fitur lainnya di masa mendatang. Fitur pertama kami adalah FoldingFeature yang kini merupakan representasi lipatan layar atau engsel. Fitur ini juga berisi status engsel yang menggantikan DeviceState.
WindowMetrics diperkenalkan di Android 11 untuk memberikan cara mudah kepada developer dalam mengkueri metrik tentang jendela, misalnya posisi dan ukurannya di layar dan inset sistem. Kami telah melakukan backporting API dalam rilis ini agar developer dapat memanfaatkan WindowMetrics dan terus mendukung versi Android yang lebih lama. WindowMetrics dapat diperoleh melalui
WindowManager#getCurrentWindowMetrics()
dan API WindowManager#getMaximumWindowMetrics().
Perubahan API
- Tidak lagi menggunakan API yang akan dihapus di alfa berikutnya (Ib7cc4)
- Mengupdate
ExtensionInterface
untuk menerima referensi Aktivitas eksplisit. (I07ded) - Memperkenalkan WindowMetrics API. (I3ccee)
- Menghapus metode pembacaan sinkron dari WindowManager (I69983)
- Membuat paket ExtensionWindowBackend terlindungi. (Ied208)
Perbaikan Bug
- Mengupdate API
ExtensionInterface
untuk menerima konteks visual. (I8e827)
Kontribusi Eksternal
- Menggabungkan DeviceState and WindowLayoutInfo agar lebih mudah mengakses data. (Id34f4)
Versi 1.0.0-alpha01
27 Februari 2020
androidx.window:window:1.0.0-alpha01
dan androidx.window:window-extensions:1.0.0-alpha01
dirilis. Versi 1.0.0-alpha01 berisi commit berikut ini.
Ini adalah rilis pertama library Window Manager.
Fitur baru
DisplayFeature
: API baru ini akan mengidentifikasi gangguan di permukaan layar datar dengan tampilan yang diperluas, misalnya engsel atau lipatanDeviceState
: API baru ini akan memberitahukan posisi ponsel saat ini dari daftar posisi yang telah ditentukan (Misalnya,CLOSED
,OPENED
,HALF_OPENED
, dll.)