WindowManager
آخر الأخبار | الإصدار الثابت | إصدار محتمل | الإصدار التجريبي | الإصدار الأوّلي |
---|---|---|---|---|
2 يوليو 2025 | 1.4.0 | - | 1.5.0-beta01 | - |
تعريف التبعيات
لإضافة تبعية في WindowManager، عليك إضافة مستودع Google Maven إلى مشروعك. يمكنك الاطّلاع على مستودع Maven من Google لمزيد من المعلومات.
أضِف التبعيات الخاصة بالعناصر التي تحتاج إليها في ملف build.gradle
لتطبيقك أو وحدتك:
رائع
dependencies { implementation "androidx.window:window:1.4.0" // For Java-friendly APIs to register and unregister callbacks implementation "androidx.window:window-java:1.4.0" // For RxJava2 integration implementation "androidx.window:window-rxjava2:1.4.0" // For RxJava3 integration implementation "androidx.window:window-rxjava3:1.4.0" // For testing implementation "androidx.window:window-testing:1.4.0" }
Kotlin
dependencies { implementation("androidx.window:window:1.4.0") // For Java-friendly APIs to register and unregister callbacks implementation("androidx.window:window-java:1.4.0") // For RxJava2 integration implementation("androidx.window:window-rxjava2:1.4.0") // For RxJava3 integration implementation("androidx.window:window-rxjava3:1.4.0") // For testing implementation("androidx.window:window-testing:1.4.0") }
الملاحظات
تساعدنا ملاحظاتك في تحسين Jetpack. يُرجى إعلامنا إذا اكتشفت مشاكل جديدة أو كانت لديك أفكار لتحسين هذه المكتبة. يُرجى الاطّلاع على المشاكل الحالية في هذه المكتبة قبل إنشاء مشكلة جديدة. يمكنك إضافة صوتك إلى مشكلة حالية من خلال النقر على زر النجمة.
يُرجى الاطّلاع على مستندات Issue Tracker للحصول على مزيد من المعلومات.
الإصدار 1.5
الإصدار 1.5.0-beta01
2 يوليو 2025
تم طرح androidx.window:window-*:1.5.0-beta01
. يحتوي الإصدار 1.5.0-beta01 على عمليات الإيداع هذه.
الإصدار 1.5.0-alpha02
7 مايو 2025
تم طرح androidx.window:window-*:1.5.0-alpha02
. يحتوي الإصدار 1.5.0-alpha02 على عمليات الدمج هذه.
تغييرات واجهة برمجة التطبيقات
- أضِف نقاط توقّف
WindowSizeClass
للمقاسين الكبير جدًا والكبير. (I40d85) - توسيع نطاق حساب
WindowMetrics
ليشمل "سياق التطبيق" (I8eeeb، b/360934048) - Provider a Getter to enable direct access to
WindowLayoutInfo
(Ie9513) - إضافة واجهة برمجة تطبيقات لحفظ حالة التضمين تلقائيًا واستعادتها تلقائيًا عند إعادة تشغيل عملية التطبيق (Ie0295)
- أزِل واجهة برمجة التطبيقات التجريبية
WindowInsets
. (I68a71) - إخفاء بعض الشركات المصنِّعة (I87b8d)
إصلاح الأخطاء
- تم إصلاح مشكلة عرض
EmbeddingRule
مختلف عنhashCode
في بعض الحالات. (I748cc)
الإصدار 1.5.0-alpha01
12 مارس 2025
تم طرح androidx.window:window-*:1.5.0-alpha01
. يحتوي الإصدار 1.5.0-alpha01 على عمليات الدمج هذه.
الميزات الجديدة
- الإصدار الأوّلي من الإصدار 1.5.0 التالي
الإصدار 1.4
الإصدار 1.4.0
20 مايو 2025
تم طرح androidx.window:window-*:1.4.0
. يحتوي الإصدار 1.4.0 على عمليات الدمج هذه.
التغييرات المهمة منذ الإصدار 1.3.0
- تضمين الأنشطة
- واجهة برمجة التطبيقات لتخصيص الصور المتحركة عند التشغيل
- الخط الفاصل التفاعلي
ActivityStack
التثبيت- تعتيم مربّع الحوار بملء الشاشة
- Embedded Activity Window Info Callback
- تحسين إدارة
ActivityStack
- إطلاق نشاط في
ActivityStack
محدّد
WindowMetricsCalculator
- تحسين إمكانية الاختبار
WindowMetrics
- طُرق سهلة لاحتساب
withDp
وheightDp
- تعديل عملية التحقّق من الحدود إلى
isAtLeast
واستخدام الحدود الدنيا للسماح بإضافة قيم جديدة
- طُرق سهلة لاحتساب
WindowSizeClass
- إضافة طريقة احتساب من
WindowMetrics
- إضافة طريقة احتساب من
WindowInfoTracker
- إضافة واجهة برمجة تطبيقات لرصد أوضاع الجهاز المتوافقة
الإصدار 1.4.0-rc02
23 أبريل 2025
تم طرح androidx.window:window-*:1.4.0-rc02
. يحتوي الإصدار 1.4.0-rc02 على عمليات الدمج هذه.
إصلاح الأخطاء
- إصلاح عُطل Proguard في
ActivityEmbedding
الإصدار 1.4.0-rc01
12 مارس 2025
تم طرح androidx.window:window-*:1.4.0-rc01
. يحتوي الإصدار 1.4.0-rc01 على عمليات الدمج هذه.
الميزات الجديدة
- تعديلات على واجهة برمجة التطبيقات
WindowSizeClass
- تعديلات على واجهات برمجة التطبيقات الخاصة بتضمين الأنشطة
الإصدار 1.4.0-beta02
12 فبراير 2025
تم طرح androidx.window:window-*:1.4.0-beta02
. يحتوي الإصدار 1.4.0-beta02 على عمليات الإيداع هذه.
الميزات الجديدة
- إصلاح تعليق توضيحي كان متوفّرًا فقط في السمة وليس في الدالة getter
الإصدار 1.4.0-beta01
15 يناير 2025
تم طرح androidx.window:window-*:1.4.0-beta01
. يحتوي الإصدار 1.4.0-beta01 على عمليات الإيداع هذه.
الميزات الجديدة
- إضافة واجهة برمجة تطبيقات للسماح بتخصيص
ActivityEmbedding
الصور المتحركة - توسيع نطاق واجهات برمجة التطبيقات
WindowMetricsCalculator
التجريبية للسماح بتزييف مقاييس النافذة
تغييرات واجهة برمجة التطبيقات
- إخفاء بعض الشركات المصنِّعة (I87b8d)
- السماح للتطبيقات بتخصيص الصور المتحركة
ActivityEmbedding
(If31a8) - إضافة دعم لاستهداف
watchosDeviceArm64
KMP واستهداف الإصدار 1.9 من Kotlin (Icf15d، b/364652024) - عرض واجهات برمجة تطبيقات
WindowMetricsCalculator
(I1cebf)
إصلاح الأخطاء
- تستخدم هذه المكتبة الآن تعليقات توضيحية بشأن القيم الخالية في JSpecify، وهي تعليقات توضيحية خاصة بالاستخدام. على مطوّري Kotlin استخدام وسيطة المترجم البرمجي التالية لفرض الاستخدام الصحيح:
-Xjspecify-annotations=strict
(هذه هي القيمة التلقائية بدءًا من الإصدار 2.1.0 من المترجم البرمجي للغة Kotlin). (Ie69ac، b/326456246)
الإصدار 1.4.0-alpha05
16 أكتوبر 2024
تم طرح androidx.window:window-*:1.4.0-alpha05
. يحتوي الإصدار 1.4.0-alpha05 على عمليات الإيداع هذه.
الميزات الجديدة
- أضِف دوالاً مناسبة للحصول على
widthDp
وheightDp
منWindowMetrics
.
تغييرات واجهة برمجة التطبيقات
- أضِف
widthDp
وheightDp
إلىWindowMetrics
. (Ide026) - أزِل واجهة برمجة التطبيقات التجريبية
WindowInsets
. (I68a71) - تعديل أسماء طرق التحقّق من الحدود إلى
isAtLeast
(Ib0ab7)
الإصدار 1.4.0-alpha04
2 أكتوبر 2024
تم طرح androidx.window:window-*:1.4.0-alpha04
. يحتوي الإصدار 1.4.0-alpha04 على عمليات الدمج هذه.
تغييرات واجهة برمجة التطبيقات
- تمت إضافة طريقة لاحتساب
WindowSizeClass
منWindowMetrics
. (874dba) - تغيير طرق
WindowSizeClass
إلىcontainsWidthDp
وcontainsHeightDp
وcontainsWindowSizeDp
لتوضيحها (fa760d) - تحويل
WindowAreaController
إلى فئة أساسية مجرّدة (I90893)
إصلاح الأخطاء
- توفير إمكانية استخدام الحدود النسبية عند إنشاء اختبار
FoldingFeature
(2e6b3e) - إصلاح الأخطاء العامة عند اختيار
WindowSizeClass
الإصدار 1.4.0-alpha03
18 سبتمبر 2024
تم طرح androidx.window:window-*:1.4.0-alpha03
. يحتوي الإصدار 1.4.0-alpha03 على عمليات الدمج هذه.
الميزات الجديدة
- أضِف طريقة مساعدة للحصول على
WindowSizeClass
منWindowMetrics
. (I83f1f) - أعِد تسمية
isAtLeast
إلىcontainsBreakpoint
. (I85b47) - أضِف حمولة زائدة إلى
computeWindowSizeClass
باستخدام أرقام الفاصلة العائمة. (I3dcb2، b/364677934، b/364677802، b/364680886)
إصلاح الأخطاء
- أضِف نقاط الإيقاف الناقصة إلى
WindowSizeClass
مجموعة نقاط الإيقاف التلقائية. - تم إصلاح الخطأ الذي كان يتسبّب في عدم اختيار الأبعاد المضغوطة بشكلٍ صحيح في بعض الحالات.
الإصدار 1.4.0-alpha02
4 سبتمبر 2024
تم طرح androidx.window:window-*:1.4.0-alpha02
. يحتوي الإصدار 1.4.0-alpha02 على عمليات الدمج هذه.
الميزات الجديدة
إتاحة استخدام WindowSizeClass
مخصّص.
- افتح الدالة الإنشائية لـ
WindowSizeClass
حتى يتمكّن المطوّرون من استخدام الدالة الخاصة بهم. - أضِف طرقًا مساعدة
isAtLeast
لكي يتمكّن المطوّرون من معالجة مجموعة من قيمWindowSizeClass
. - أضِف دالة ملحقة إلى
Set<WindowSizeClass>
لاحتساب أفضل تطابق من المجموعة. - إضافة ثوابت لنقاط الإيقاف المقترَحة في Android
- أضِف مجموعة نقاط الإيقاف التي تتوافق مع نقاط الإيقاف المقترَحة في Android.
تغييرات واجهة برمجة التطبيقات
- تعديل أسماء طرق الحدود لـ
WindowSizeClass
(If89a6) - تعديل واجهة برمجة التطبيقات
WindowSizeClass
لإتاحة إضافة قيم نقاط توقّف جديدة في المستقبل بدلاً من استخدام حدود مطلقة، نستخدِم الحدود الدنيا وننصح المطوّرين باستخدام عمليات التحقّق من الحدود الدنيا عند معالجةWindowSizeClass
. سيتم إيقافWindowWidthSizeClass
وWindowHeightSizeClass
نهائيًا لأنّه لن يتم تطويرهما أكثر من ذلك. (I014ce)
الإصدار 1.4.0-alpha01
7 أغسطس 2024
تم طرح androidx.window:window-*:1.4.0-alpha01
. يحتوي الإصدار 1.4.0-alpha01 على عمليات الدمج هذه.
الميزات الجديدة
- تتيح ميزة تثبيت ActivityStack للتطبيقات تثبيت المحتوى في حاوية واحدة وعزل التنقّل فيها عن الحاوية الأخرى.
- يتيح الفاصل التفاعلي للتطبيقات عرض فاصل ثابت أو قابل للسحب بين النشاطَين في عرض مقسّم.
- تتيح ميزة تعتيم مربّع الحوار بملء الشاشة للتطبيقات تحديد منطقة تعتيم مربّع الحوار، إما لتعتيم نافذة المهمة بأكملها أو لتعتيم الحاوية التي تعرض مربّع الحوار فقط.
- تتيح وظيفة رد الاتصال الخاصة بمعلومات نافذة النشاط المضمّنة للتطبيقات تلقّي تحديثات مستمرة لنافذة النشاط المضمّنة.
- تتيح ميزة تضمين خلفية الحركة للتطبيقات تحديد خلفية الحركة، ما يؤدي إلى تحسين جودة الحركة الانتقالية عند استخدام
ActivityEmbedding
. - تتيح إدارة ActivityStack المحسّنة للتطبيقات المزيد من التحكّم في
ActivityStacks
عند استخدامActivityEmbedding
، بما في ذلك: - إطلاق نشاط في
ActivityStack
محدّد - إنهاء
ActivityStack
تغييرات واجهة برمجة التطبيقات
واجهة برمجة تطبيقات جديدة
WindowInfoTracker#supportedPostures
:- واجهة برمجة تطبيقات لتحديد ما إذا كان الجهاز يتيح استخدام وضع "السطح المستوي" للأجهزة القابلة للطي. إضافة WindowAreaSessionPresenter#getWindow
أضِف واجهات برمجة التطبيقات التالية لتفعيل ميزة
ActivityStack
التثبيت:- الصف
SplitPinRule
SplitController#pinTopActivityStack
SplitController#unpinTopActivityStack
- الصف
إضافة واجهات برمجة التطبيقات لتفعيل الفاصل التفاعلي وضبطه
- الصف
DividerAttributes
SplitAttributes.Builder#setDividerAttributes
- الصف
إضافة واجهات برمجة التطبيقات لضبط
EmbeddingConfiguration
وDimAreaBehavior
لمربّعات الحوار- الصف
EmbeddingConfiguration
- الصف
DimAreaBehavior
ActivityEmbeddingController#setEmbeddingConfiguration
- الصف
إضافة واجهات برمجة التطبيقات لتلقّي آخر الأخبار عن نافذة النشاط المضمّن
- الصف
EmbeddedActivityWindowInfo
ActivityEmbeddingController#embeddedActivityWindowInfo
- الصف
إضافة واجهات برمجة تطبيقات لضبط خلفية الرسوم المتحركة للتضمين
EmbeddingAnimationBackground
SplitAttributes.Builder#setAnimationBackground
إضافة واجهات برمجة التطبيقات لإنهاء
ActivityStacks
ActivityEmbeddingController#finishActivityStacks
إضافة واجهات برمجة التطبيقات لضبط عملية الإطلاق
ActivityStack
ActivityEmbeddingOptions#setLaunchingActivityStack
إنّ واجهات برمجة التطبيقات التالية ثابتة ولم تعُد تجريبية:
ActivityEmbeddingController#invalidateVisibleActivityStacks
(تم نقلها من SplitController#invalidateTopVisibleSplitAttributes)ActivityEmbeddingController#getActivityStack
SplitController#updateSplitAttributes
إضافة واجهات برمجة التطبيقات للإصدار 1.4 (I56774)
إصلاح الأخطاء
- تم إصلاح الخطأ الذي كان يؤدي إلى عرض UNAVAILABLE بدلاً من ACTIVE على بعض الأجهزة عندما تكون الجلسة نشطة.
- تمت إزالة إمكانية استخدام
transferActivityToWindowArea
على الأجهزة التي تحمل مستوى واجهة برمجة التطبيقاتvendorApiLevel
البالغ 2 بسبب عدم استقرار واجهة برمجة التطبيقات. - إضافة واجهة برمجة تطبيقات لتفعيل ميزة السحب إلى وضع ملء الشاشة في أداة تقسيم قابلة للسحب في ميزة "تضمين الأنشطة" (I645c9)
- السماح للتطبيقات بإيقاف الصور المتحركة
ActivityEmbedding
من خلال مَعلمات الصور المتحركة فيSplitAttributes
(Idc01a) - تمت إزالة التحديد اليدوي لإمكانية الوصول إلى واجهات برمجة التطبيقات الجديدة للمنصة لأنّ ذلك يحدث تلقائيًا من خلال تصميم واجهة برمجة التطبيقات عند استخدام R8 مع الإصدار 7.3 أو إصدار أحدث من "مكوّن Android الإضافي" (مثل الإصدار 3.3 من R8)، وجميع عمليات الإنشاء عند استخدام الإصدار 8.1 أو إصدار أحدث من "مكوّن Android الإضافي" (مثل الإصدار 8.1 من D8). ننصح العملاء الذين لا يستخدمون AGP بالترقية إلى الإصدار 8.1 أو إصدار أحدث من D8. يُرجى مراجعة هذه المقالة للاطّلاع على مزيد من التفاصيل. (Ia60e0، b/345472586)
- السماح للإضافات بأخذ مَعلمات الرسوم المتحركة لـ
SplitAttributes
حتى يتمكّن الجهاز من استخدامها في انتقالات الرسوم المتحركة (Iede00) - واجهات برمجة التطبيقات لإخفاء التراكب (Ic4251)
- إضافة واجهات برمجة تطبيقات لضبط الفاصل الثابت أو القابل للسحب في التقسيم (Ia7a78)
- تمت إضافة الكثافة إلى
WindowMetrics
(Id6723) - أضِف واجهة برمجة التطبيقات للحصول على
SupportedPostures
. (If557a) - إزالة
setLaunchingActivityStack
من واجهة برمجة التطبيقات التجريبية (I191cf) - تقديم
ActivityEmbeddingController#embeddedActivityWindowInfo
(I24312) - إيقاف
#getToken
وإضافة#getActivityStackToken
(Ie0471) - إضافة محوّل معاودة الاتصال لواجهة برمجة التطبيقات الخاصة بسير عمل
embeddedActivityWindowInfo
(Ida77f) - إضافة أداة ربط ردّ الاتصال لواجهة برمجة التطبيقات overlayInfo flow (I7264f)
- أدخِل
WindowSdkExtensionsRule
لتجاوزextensionsVersion
لأغراض الاختبار. (Ifb928) - - نقل
#setLaunchingActivityStack
إلى حزمة لتتوافق مع استخداماتActivityOptionsCompat
- على المستخدمين إدخال
activityOptions.toBundle
بدلاً منActvityOptions
. - إزالة
#setLaunchingActivityStack(Activity)
على المستخدمين نقل البيانات لاستخدامActivityEmbeddingController#getActivityStac(Activity)
للحصول علىActivityStack
، ثم تمريرActivityStack
إلى#setLaunchingActivityStack
. (Ie0ccc)
- على المستخدمين إدخال
- - تقديم
ActivityStack.Token
وSpltInfo.Token
كمعرّف للتواصل بين WM Jetpack والإضافات- إيقاف/استبدال واجهات برمجة التطبيقات لاستخدام/عرض الرمز المميز بدلاً من IBinder (I12b24)
- - تقديم
ActivityEmbeddingController#invalidateVisibleActivityStacks
- إزالة
SplitController#invalidateTopVisibleSplitAttributes
لأنّ الميزة سيتم دمجها في#invalidateVisibleActivityStacks
(I02ef5)
- إزالة
- - إضافة واجهة برمجة تطبيقات لضبط إعدادات التضمين (I59a4a)
- - إضافة واجهات برمجة التطبيقات
ActivityStack
androidx.Window
الخاصة بتثبيت/إلغاء تثبيت التطبيقات في أعلى الشاشة- تعديل التطبيق التجريبي للسماح بتثبيت/إلغاء تثبيت التطبيق في أعلى الشاشة
ActivityStack
(I24dd3)
- تعديل التطبيق التجريبي للسماح بتثبيت/إلغاء تثبيت التطبيق في أعلى الشاشة
- إعادة إضافة
#finishActivityStacks
وActivityEmbeddingOptions
(Ic1ab3) - إزالة واجهات برمجة التطبيقات غير الثابتة (Ibc534، b/302380585)
الإصدار 1.3
الإصدار 1.3.0
29 مايو 2024
تم طرح androidx.window:window-*:1.3.0
. يحتوي الإصدار 1.3.0 على عمليات الدمج هذه.
التغييرات المهمة منذ الإصدار 1.2.0
- إتاحة استخدام Kotlin Multiplatform مع فئات حجم النافذة
الإصدار 1.3.0-rc01
14 مايو 2024
WindowManager
يتيح الإصدار 1.3 من Jetpack استخدام Kotlin Multiplatform في ميزات WindowSizeClass
، بالإضافة إلى إصلاح العديد من الأخطاء.
تم طرح androidx.window:window-*:1.3.0-rc01
. يحتوي الإصدار 1.3.0-rc01 على عمليات الإيداع هذه.
الإصدار 1.3.0-beta02
1 مايو 2024
تم طرح androidx.window:window-*:1.3.0-beta02
. يحتوي الإصدار 1.3.0-beta02 على عمليات الدمج هذه.
تغييرات واجهة برمجة التطبيقات
- إزالة إمكانية إنشاء واستخدام
WindowSizeClass
مخصّصة (Id1143)
إصلاح الأخطاء
- إصلاح الخطأ
KotlinReflectionInternalError
الذي حدث بسبب إزالة بعض الملفات من خلال أداة Proguard على بعض عمليات تنفيذ الأجهزة (I01b02)
الإصدار 1.3.0-beta01
3 أبريل 2024
تم طرح androidx.window:window-*:1.3.0-beta01
. يحتوي الإصدار 1.3.0-beta01 على عمليات الإيداع هذه.
الإصدار 1.3.0-alpha03
6 مارس 2024
تم طرح androidx.window:window-*:1.3.0-alpha03
. يحتوي الإصدار 1.3.0-alpha03 على عمليات الإيداع هذه.
تغييرات واجهة برمجة التطبيقات
- قسِّم
WindowSizeClassUtil
إلى طرق أكثر تركيزًا. (Ie9292) - استعادة
WindowSizeClass#compute
(I21355، b/324293374)
إصلاح الأخطاء
- تم إصلاح عُطل كان يحدث بسبب عدم فك تغليف السياق المقدَّم بشكلٍ صحيح. (94d10ce , b/318787482)
الإصدار 1.3.0-alpha02
7 فبراير 2024
تم طرح androidx.window:window-*:1.3.0-alpha02
. يحتوي الإصدار 1.3.0-alpha02 على عمليات الإيداع هذه.
الميزات الجديدة
- تم إجراء تعديلات على مساحة واجهة برمجة التطبيقات Window Size Class API لتحسين المرونة للمطوّرين الذين يريدون استخدام فئات الحجم الخاصة بهم.
تغييرات واجهة برمجة التطبيقات
- أضِف قيود الارتفاع إلى أداة اختيار العرض. (I23393)
- أضِف دوالاً مساعدة لاختيار
WindowSizeClass
من مجموعة. إضافة دوال تسجيل تجريبية ليتمكّن المطوّرون من كتابة أدوات الاختيار الخاصة بهم أضِف دالة إضافة أداة اختيار لاختيار أوسعWindowSizeClass
ضمن حدود معيّنة. (I0c944) - افتح الدالة الإنشائية
WindowSizeClass
حتى يمكن إضافة نقاط توقّف مخصّصة. (Ic1ff3) - إضافة دالة ملائمة لإنشاء فئة الحجم من العرض والارتفاع والكثافة (If67f4)
إصلاح الأخطاء
- تم إصلاح الخطأ الذي يحدث عند اقتطاع قيمة عدد عشري إلى 0. (272ffac)
الإصدار 1.3.0-alpha01
15 تشرين الثاني (نوفمبر) 2023
تم طرح androidx.window:window-*:1.3.0-alpha01
. يحتوي الإصدار 1.3.0-alpha01 على عمليات الإيداع هذه.
الميزات الجديدة
- عرض واجهات برمجة تطبيقات تجريبية للوصول إلى الشاشة الخلفية
- أصبحت واجهات برمجة التطبيقات التجريبية لإنشاء
FoldingFeature
ثابتة الآن. - أصبحت واجهات برمجة التطبيقات التجريبية لإعداد قيم
ActivityEmbedding
وهمية ثابتة الآن. - تعرض السمة
WindowLayoutInfoPublisherRule
الآن عملية التجاوز عند الحصول على قيمة منUiContext
. - تضيف ميزة طيّ التقارير بيانات إلى المَعلمتَين
UiContext
.WindowInfoTracker
- عرض إصدار الإضافات على الجهاز
- ثوابت
WindowProperties
لعمليات الإلغاء على مستوى التطبيق لكل مستخدم:-
PROPERTY_COMPAT_ALLOW_USER_ASPECT_RATIO_OVERRIDE
: لإعلام النظام بأنّ التطبيق أوقف إمكانية تجاهل إعدادات التوافق مع نسبة العرض إلى الارتفاع المخصّصة للمستخدمين. PROPERTY_COMPAT_ALLOW_USER_ASPECT_RATIO_FULLSCREEN_OVERRIDE
— لإعلام النظام بأنّ التطبيق قد أوقف خيار ملء الشاشة في إعدادات تجاوز توافق نسبة العرض إلى الارتفاع
-
الإصدار 1.2
الإصدار 1.2.0
15 تشرين الثاني (نوفمبر) 2023
تم طرح androidx.window:window-*:1.2.0
. يتضمّن الإصدار 1.2.0 عمليات الإيداع هذه.
التغييرات المهمة منذ الإصدار 1.1.0
- عرض واجهات برمجة تطبيقات تجريبية للوصول إلى الشاشة الخلفية
- أصبحت واجهات برمجة التطبيقات التجريبية لإنشاء
FoldingFeature
ثابتة الآن. - أصبحت واجهات برمجة التطبيقات التجريبية لإعداد قيم
ActivityEmbedding
وهمية ثابتة الآن. - تعرض السمة
WindowLayoutInfoPublisherRule
الآن عملية التجاوز عند الحصول على قيمة منUiContext
. - تضيف ميزة طيّ التقارير بيانات إلى المَعلمتَين
UiContext
.WindowInfoTracker
- عرض إصدار الإضافات على الجهاز
الإصدار 1.2.0-rc01
1 نوفمبر 2023
تم طرح androidx.window:window-*:1.2.0-rc01
. يحتوي الإصدار 1.2.0-rc01 على عمليات الإيداع هذه.
الميزات الجديدة
- عرض واجهات برمجة تطبيقات تجريبية للوصول إلى الشاشة الخلفية
- أصبحت واجهات برمجة التطبيقات التجريبية لإنشاء
FoldingFeature
ثابتة الآن. - أصبحت واجهات برمجة التطبيقات التجريبية لإعداد قيم
ActivityEmbedding
وهمية ثابتة الآن. - تعرض السمة
WindowLayoutInfoPublisherRule
الآن عملية التجاوز عند الحصول على قيمة منUiContext
. - تضيف ميزة طيّ التقارير بيانات إلى المَعلمتَين
UiContext
.WindowInfoTracker
- عرض إصدار الإضافات على الجهاز
الإصدار 1.2.0-beta04
18 أكتوبر 2023
تم طرح androidx.window:window-*:1.2.0-beta04
. يحتوي الإصدار 1.2.0-beta04 على عمليات الإيداع هذه.
تغييرات واجهة برمجة التطبيقات
- إزالة واجهات برمجة التطبيقات غير الثابتة (Ibc534، b/302380585)
الإصدار 1.2.0-beta03
20 سبتمبر 2023
تم طرح androidx.window:window-*:1.2.0-beta03
. يحتوي الإصدار 1.2.0-beta03 على عمليات الإيداع هذه.
الميزات الجديدة
- أضِف عمليات التحقّق
RequiresApi
لواجهات برمجة التطبيقات التي تحتاج إلى إصدار معيّن من الإضافات لتعمل بشكلٍ صحيح. - أضِف واجهة برمجة تطبيقات لعرض إصدار الإضافات على الجهاز.
تغييرات واجهة برمجة التطبيقات
- إضافة تعليقات توضيحية إلى واجهات برمجة التطبيقات العامة بشأن إصدار إضافة حزمة تطوير البرامج (SDK) المطلوبة لنظام التشغيل Windows
- أزِل
isXXXSupported
في مكوّن "تضمين النشاط". (Ie3dae)
- أزِل
- أضِف
WindowSdkExtensions
للإبلاغ عن إصدار الإضافة على الجهاز.- إضافة
RequiresWindowSdkExtension
لتوضيح الحد الأدنى المطلوب لإصدار الإضافة (I05fd4)
- إضافة
- يجعل
WindowAreaInfo#getCapability
غير قابل للقيم الفارغة. (I17048)
الإصدار 1.2.0-beta01
26 يوليو 2023
تم طرح androidx.window:window-*:1.2.0-beta01
. يحتوي الإصدار 1.2.0-beta01 على عمليات الإيداع هذه.
الميزات الجديدة
- عرض واجهات برمجة تطبيقات تجريبية للوصول إلى الشاشة الخلفية
- أصبحت واجهات برمجة التطبيقات التجريبية لإنشاء
FoldingFeature
ثابتة الآن. - أصبحت واجهات برمجة التطبيقات التجريبية لإعداد قيم
ActivityEmbedding
وهمية ثابتة الآن. - تعرض السمة
WindowLayoutInfoPublisherRule
الآن عملية التجاوز عند الحصول على قيمة منUiContext
. - تضيف ميزة طيّ التقارير بيانات إلى المَعلمتَين
UiContext
.WindowInfoTracker
تغييرات واجهة برمجة التطبيقات
- وضع علامة "تجريبية" على واجهة برمجة التطبيقات
WindowArea
للسماح بمواصلة إجراء تغييرات على واجهة برمجة التطبيقات لإصدار ثابت في الإصدار 1.3 (I857f5) - تم تعديل ملفات واجهة برمجة التطبيقات لإضافة تعليقات توضيحية بشأن إيقاف التوافق (I8e87a، b/287516207)
الإصدار 1.2.0-alpha03
21 حزيران (يونيو) 2023
تم طرح androidx.window:window-*:1.2.0-alpha03
. يحتوي الإصدار 1.2.0-alpha03 على عمليات الإيداع هذه.
الميزات الجديدة
- إزالة واجهات برمجة التطبيقات المتوقّفة نهائيًا من مساحة واجهة برمجة التطبيقات
- إضافة واجهات برمجة تطبيقات لدعم العروض المتزامنة
- أضِف سمة لإيقاف التجاوز الإجباري لتغيير الحجم.
- أضِف السمة لإيقاف تجاهل الحدّ الأدنى لنسبة العرض إلى الارتفاع.
- تثبيت
ActivityEmbeddingRule
لتوفير اختبارات الوحدات حول ميزة "تضمين الأنشطة"
تغييرات واجهة برمجة التطبيقات
إصلاح الأخطاء
- إضافة سمة التوافق مع إيقاف الاشتراك لإلغاء تغيير الحجم بالقوة (Ie7ab1)
- يزيل
SESSION_STATE_CONTENT_INVISIBLE
من واجهة الإضافات. (I6ed19) - تثبيت
ActivityEmbeddingRule
لتوفير اختبارات الوحدات حول ميزة "تضمين النشاط" (I8d6b6) - إضافة سمة توافق لإيقاف الحدّ الأدنى لنسبة العرض إلى الارتفاع (I66390)
- إزالة واجهات برمجة التطبيقات WindowArea API التي تم إيقافها نهائيًا (Ieb67c)
- إعادة تسمية السمة "تكرار طلب الاتجاه" إلى
PROPERTY_COMPAT_ALLOW_IGNORING_ORIENTATION_REQUEST_WHEN_LOOP_DETECTED
(Ie2fbd) - تعديل أسماء الثوابت الخاصة بجلسة منطقة النافذة (I83675)
- إضافة سمة توافق لإيقاف التدوير تتجاهل حلقة طلب التدوير عند رصدها (I0a7a2)
- أضِف
WindowAreaComponent#STATUS_ACTIVE
للإشارة إلى أنّ الميزة مفعّلة حاليًا. (I62bc3) - إضافة واجهات برمجة التطبيقات
RearDisplayPresentationMode
(I0401c) - إزالة واجهة برمجة التطبيقات الخاصة بإزالة لون الخلفية من الإصدار الثابت (I34c3e)
- واجهات برمجة التطبيقات الخاصة بإخفاء مساحة النافذة (I39de0)
- أضِف طرقًا لتجاوز
SplitInfo
فيSplitController
. أضِف طرق اختبار لإنشاء عنصر بديل للرمزSplitInfo
وActivityStack
. (Icd69f) - اجعل العلامة اختيارية للحقل
ActivityRule.Builder
. (Ib0b44) - إزالة
RatioSplitType
وExpandContainersSplit
وHingeSplitType
وهيSplitType
الآن.- استبدال
#splitEqually()
و#expandContainers()
و#splitByHinge
بالقيم الثابتةSplitType SPLIT_TYPE_EQUAL
وSPLIT_TYPE_EXPAND
وSPLIT_TYPE_HINGE
- إزالة وظيفة ضبط النوع الاحتياطي لنوع التقسيم عند طي الجهاز إذا تعذّر تطبيق نوع تقسيم المفصلة بسبب حالة الجهاز أو النافذة الحالية، سيتم تقسيم حاوية المهمة الرئيسية بالتساوي. استخدِم
SplitController#setSplitAttributesCalculator
لتخصيص نوع التقسيم الاحتياطي. (Ifcc59)
- استبدال
- إيقاف
add
/removeSplitCallback
- نقل
add
/removeSplitCallback
إلىSplitControllerCallbackAdapter
- إضافة دعم
Flow
للحصول على قائمةSplitInfo
(I7f1b6)
- نقل
- إضافة قاعدة اختبارية لـ
ActivityEmbeddingController
(I42e9b) - إعادة تسمية
ActivityOptionsCompat
إلىActivityEmbeddingOptions
(I89301) - أضِف
splitSupportStatus
للإشارة إلى ما إذا كانت ميزة "تضمين النشاط" متاحة. (I10024) - أدخِل
SplitAttributes.BackgroundColor
لتمثيل قيمةDEFAULT
بشكل أفضل. توضيح أنّه لا يمكن استخدام لون خلفية متحركة غير معتم، وبالتالي سيتم التعامل مع أي ألوان غير معتمة على أنّها الإعداد التلقائي، ما يعني استخدام لون خلفية نافذة المظهر الحالي (Ic6b95) - استبدِل
alwaysAllow()
وalwaysDisallow()
بـALWAYS_ALLOW
وALWAYS_DISALLOW
. (I3057b) - أضِف واجهات برمجة التطبيقات الخاصة بـ
SplitRule
وSplitAttributes
وSplitAttributesCalculator
. (I92d23) - أضِف
TestActivityStack
لإنشاءActivityStack
للاختبار- أضِف
TestSplitInfo
لإنشاءSplitInfo
بغرض الاختبار. (I8e779)
- أضِف
- إضافة طريقة لإنشاء
SplitAttributesCalculatorParams
مزيّف حتى يتمكّن المطوّرون من التحقّق منSplitAttributesCalculator
المخصّص (Id4a6e) - إضافة
WindowMetricsCalculator#computeCurrentWindowMetrics(@UiContext context: Context)
وWindowMetricsCalculator#computeMaximumWindowMetrics(@UiContext context: Context)
(I66c7f)
الإصدار 1.2.0-alpha02
7 يونيو 2023
تم طرح androidx.window:window-*:1.2.0-alpha02
. يحتوي الإصدار 1.2.0-alpha02 على عمليات الإيداع هذه.
الميزات الجديدة
- تعديل واجهة برمجة التطبيقات الاختبارية لتتضمّن ثابتًا للميزات غير المحدّدة للأجهزة القابلة للطي
- سيؤدي استخدام
WindowLayoutInfoPublishRule
إلى إلغاء جميع قيمwindowLayoutInfo
، بما في ذلك واجهة برمجة التطبيقات المستندة إلى السياق.
تغييرات واجهة برمجة التطبيقات
- إضافة ثابت لميزة الطي في المنتصف غير المحدّدة (I7530c)
إصلاح الأخطاء
- تعديل
WindowLayoutInfoPublishRule
للسماح بتجاهلContext
استنادًا إلىWindowLayoutInfo
(I2037a)
الإصدار 1.2.0-alpha01
24 مايو 2023
تم طرح androidx.window:window-*:1.2.0-alpha01
. يحتوي الإصدار 1.2.0-alpha01 على عمليات الإيداع هذه.
الميزات الجديدة
تثبيت واجهات برمجة التطبيقات الاختبارية حول ميزة "تضمين الأنشطة" وWindowLayoutInfoTracker
تمت ترقية ActivityEmbeddingRule
إلى الإصدار الثابت.
تمت ترقية WindowMetricsCalculatorRule
إلى الإصدار الثابت.
تمت ترقية دوال الأداة المساعدة لإنشاء FoldingFeature
للاختبار إلى إصدار ثابت.
تغييرات واجهة برمجة التطبيقات
- تثبيت
ActivityEmbeddingRule
لتوفير اختبارات الوحدات حول ميزة "تضمين النشاط" (I8d6b6) WindowMetrisCalculatorTestRule
ثابتة، ما يسمح باستخدام مقاييس وهمية لاختبارات آلة جافا الافتراضية (JVM). ننصح باستخدام محاكي للحصول على نتائج دقيقة.- تثبيت واجهات برمجة التطبيقات التجريبية في
WindowLayoutInfo
لتوفير إمكانية الاختبار على آلة جافا الافتراضية (Ie036e) - أضِف
IntRange
لقيم ميزة الطي التجريبية. (I69f7d)
الإصدار 1.1
الإصدار 1.1.0
7 يونيو 2023
تم طرح androidx.window:window-*:1.1.0
. يحتوي الإصدار 1.1.0 على عمليات الإيداع هذه.
التغييرات المهمة منذ الإصدار 1.0.0
تضمين النشاط
- تمت إضافة
PROPERTY_ACTIVITY_EMBEDDING_SPLITS_ENABLED
كسمة منطقية للعلامة<application>
في بيان التطبيق. - تم إيقاف
isSplitSupported
نهائيًا واستبداله بـsplitSupportStatus
لتوفير معلومات أكثر تفصيلاً حول سبب عدم توفّر ميزة التقسيم. - تمت إضافة الفئة الفرعية
SplitController.SplitSupportStatus
لتوفير ثوابت الحالة للسمةsplitSupportStatus
. - تمت إعادة تصميم
SplitController
إلى عدة وحدات:- وحدة
ActivityEmbeddingController
لواجهات برمجة التطبيقات ذات الصلة بـActivity
أوActivityStack
- تم نقل
isActivityEmbedded
منSplitController
إلىActivityEmbeddingController
. - وحدة
RuleController
للعمليات ذات الصلة بـEmbeddingRule
: - تمت إزالة واجهات برمجة التطبيقات التالية:
SplitController
clearRegisteredRules()
getSplitRules()
initialize()
registerRule()
unregisterRule()
- تمت إضافة واجهات برمجة التطبيقات
RuleController
التالية: addRule()
: لإضافة قاعدة أو تعديل القاعدة التي تحمل العلامة نفسها-
removeRule()
: لإزالة قاعدة من مجموعة القواعد المسجّلة setRules()
: تحدّد مجموعة من القواعد.clearRules()
: لإزالة جميع القواعد المسجَّلةparseRules()
: يحلّل القواعد من تعريفات قواعد XML.
- وحدة
- تتطلّب جميع الوحدات سياقًا يتم إعداده باستخدام طريقة
#getInstance()
، بما في ذلك:ActivityEmbeddingController#getInstance(Context)
SplitController#getInstance(Context)
RuleController#getInstance(Context)
- تمت إضافة الفئة
EmbeddingAspectRatio
لتحديد الثوابت التي تتضمّن سلوكًا مشابهًا للتعداد والمتعلّقة بنسبة العرض إلى الارتفاع. - تمت إضافة الفئة
SplitAttributes
لتحديد التنسيق المقسّم. - تمت إضافة وظائف الآلة الحاسبة
SplitAttributes
إلىSplitController
لتخصيص تنسيقات الشاشة المقسّمة:setSplitAttributesCalculator(Function)
clearSplitAttributesCalculator()
isSplitAttributesCalculatorSupported()
للتحقّق مما إذا كانت واجهات برمجة التطبيقاتSplitAttributesCalculator
متوافقة مع الجهاز
- تمت إضافة الحقل
EmbeddingRule#tag
. - تحديثات واجهة برمجة التطبيقات في
SplitRule
:- تمت إضافة
defaultSplitAttributes
: تحدّد هذه السمة التنسيق التلقائي للتقسيم، وهي تحلّ محلّsplitRatio
وlayoutDirection
. - تمت إضافة ترجمة لسمتَي XML
splitRatio
وsplitLayoutDirection
إلىdefaultSplitAttributes
. - تم تغيير تعريفات الحد الأدنى للأبعاد لاستخدام وحدات بكسل مستقلة الكثافة (dp) بدلاً من وحدات البكسل.
- تمت إضافة
minHeightDp
بالقيمة التلقائية 600dp. - تم تغيير
minWidth
إلىminWidthDp
بالقيمة التلقائية 600dp. - تم تغيير
minSmallestWidth
إلىminSmallestWidthDp
بالقيمة التلقائية 600dp. - تمت إضافة
maxAspectRatioInHorizontal
بالقيمة التلقائيةALWAYS_ALLOW
. - تمت إضافة
maxAspectRatioInPortrait
بالقيمة التلقائية 1.4. - تم تحديد فئة متداخلة
FinishBehavior
لاستبدال ثوابت سلوك الإنهاء. - تم تطبيق تغييرات الموقع على فئة Builder المدمَجة في
SplitPairRule
وSplitPlaceholderRule
.
- تمت إضافة
- تم استبدال
SplitInfo#getSplitRatio()
بـSplitInfo#getSplitAttributes()
لتقديم معلومات إضافية ذات صلة بالتقسيم.
WindowLayout
- تمت إضافة دعم سياق واجهة المستخدم التجريبية غير النشطة إلى
WindowInfoTracker
. - تمت إضافة سياق تجريبي لواجهة المستخدم غير النشطة إلى
WindowMetricsCalculator
.
خطوات نقل البيانات
- لتفعيل ميزة تضمين الأنشطة وعرضها في شاشات مقسّمة، يجب أن تضيف التطبيقات السمة
PROPERTY_ACTIVITY_EMBEDDING_SPLITS_ENABLED
إلى علامة<application>
في ملف البيان:xml <property android:name="android.window.PROPERTY_ACTIVITY_EMBEDDING_SPLITS_ENABLED" android:value="true" />
يسمح ذلك للنظام بتحسين سلوكيات التقسيم لتطبيق ما مسبقًا. SplitInfo
نسبة- تحقَّق مما إذا كان الانقسام الحالي مكدّسًا:
kotlin SplitInfo.splitAttributes.splitType is SplitAttributes.SplitType.ExpandContainersSplitType
- تحقَّق من النسبة الحالية:
kotlin if (SplitInfo.splitAttributes.splitType is SplitAttributes.SplitType.RatioSplitType) { val ratio = splitInfo.splitAttributes.splitType.ratio } else { // Ratio is meaningless for other types. }
- تحقَّق مما إذا كان الانقسام الحالي مكدّسًا:
- عمليات نقل SplitController:
- تغيير
SplitController.getInstance()
إلىSplitController.getInstance(Context)
- تغيير
SplitController.initialize(Context, @ResId int)
إلىRuleController.getInstance(Context).setRules(RuleController.parse(Context, @ResId int))
- تغيير
SplitController.getInstance().isActivityEmbedded(Activity)
إلىActivityEmbeddingController.getInstance(Context).isActivityEmbedded(Activity)
- تغيير
SplitController.getInstance().registerRule(rule)
إلىRuleController.getInstance(Context).addRule(rule)
- تغيير
SplitController.getInstance().unregisterRule(rule)
إلىRuleController.getInstance(Context).removeRule(rule)
- تغيير
SplitController.getInstance().clearRegisteredRules()
إلىRuleController.getInstance(Context).clearRules()
- تغيير
SplitController.getInstance().getSplitRules()
إلىRuleController.getInstance(Context).getRules()
- تغيير
- عمليات نقل بيانات المواقع
SplitRule
:- تستخدِم السمتان
minWidth
وminSmallestWidth
الآن وحدات dp بدلاً من وحدات البكسل. يمكن للتطبيقات استخدام الاستدعاء التالي:kotlin TypedValue.applyDimension( COMPLEX_UNIT_DIP, minWidthInPixels, resources.displayMetrics )
أو ببساطة تقسيمminWith
بالبكسل علىdisplayMetrics#density
.
- تستخدِم السمتان
- يجب نقل ثوابت سلوك الإنهاء إلى ثوابت فئة تشبه التعداد
FinishBehavior
:- تغيير
FINISH_NEVER
إلىFinishBehavior.NEVER
- تغيير
FINISH_ALWAYS
إلىFinishBehavior.ALWAYS
- تغيير
FINISH_ADJACENT
إلىFinishBehavior.ADJACENT
- تغيير
- يجب نقل اتجاه التنسيق إلى
SplitAttributes.LayoutDirection
:- تغيير
ltr
إلىSplitAttributes.LayoutDirection.LEFT_TO_RIGHT
- تغيير
rtl
إلىSplitAttributes.LayoutDirection.RIGHT_TO_LEFT
- تغيير
locale
إلىSplitAttributes.LayoutDirection.LOCALE
- يجب نقل
splitRatio
إلىSplitAttributes.SplitType.ratio(splitRatio)
.
- تغيير
- عمليات نقل البيانات
SplitPairRule.Builder
:- تغيير
SplitPairRule.Builder(filters, minWidth, minSmallestWidth)
إلىkotlin SplitPairRule.Builder(filters) .setMinWidthDp(minWidthInDp) // Optional if minWidthInDp is 600. .setMinSmallestWidthDp(minSmallestWidthDp) // Optional if minSmallestWidthInDp is 600.
- تغييرات
setLayoutDirection(layoutDirection)
وsetSplitRatio(ratio)
إلىkotlin setDefaultSplitAttributes( SplitAttributes.Builder() .setLayoutDirection(layoutDirection) .setSplitType(SplitAttributes.SplitType.ratio(ratio)) .build() )
- تأخذ الدالتان
setFinishPrimaryWithSecondary
وsetFinishSecondaryWithPrimary
الثوابت الشبيهة بالتعدادFinishBehavior
. راجِع "عمليات نقل بيانات SplitRule" للاطّلاع على التفاصيل. - استخدِم
setMaxAspectRatioInPortrait(EmbeddingAspectRatio.ALWAYS_ALLOW)
لعرض عمليات التقسيم على الأجهزة في الوضع العمودي.
- تغيير
- عمليات نقل البيانات
SplitPlaceholder.Builder
:- يحتوي على المَعلمتَين
filters
وplaceholderIntent
فقط. يتم نقل السمات الأخرى إلى دوال الضبط. راجِع "عمليات نقل بيانات SplitPairRule.Builder" للحصول على التفاصيل. - تأخذ السمة
setFinishPrimaryWithPlaceholder
الثوابت المشابهة للتعدادFinishBehavior
. راجِع "عمليات نقل بيانات SplitRule" للاطّلاع على التفاصيل. - تتغيّر قيمة
setLayoutDirection(layoutDirection)
وsetSplitRatio(ratio)
إلى:kotlin setDefaultSplitAttributes( SplitAttributes.Builder() .setLayoutDirection(layoutDirection) .setSplitType(SplitAttributes.SplitType.ratio(ratio)) .build() )
- استخدِم
setMaxAspectRatioInPortrait(EmbeddingAspectRatio.ALWAYS_ALLOW)
لعرض عمليات التقسيم على الأجهزة في الوضع العمودي.
- يحتوي على المَعلمتَين
الإصدار 1.1.0-rc01
10 مايو 2023
تم طرح androidx.window:window-*:1.1.0-rc01
. يحتوي الإصدار 1.1.0-rc01 على عمليات الإيداع هذه.
الميزات الجديدة
- إصدار
ActivityEmbedding
كواجهة برمجة تطبيقات ثابتة - إصلاحات أخطاء متنوّعة.
الإصدار 1.1.0-beta02
5 أبريل 2023
تم طرح androidx.window:window-*:1.1.0-beta02
. يحتوي الإصدار 1.1.0-beta02 على عمليات الإيداع هذه.
الميزات الجديدة
- إصلاحات داخلية وتنظيف
الإصدار 1.1.0-beta01
22 مارس 2023
تم طرح androidx.window:window-*:1.1.0-beta01
. يحتوي الإصدار 1.1.0-beta01 على عمليات الإيداع هذه.
تضمين النشاط
- تمت إضافة
PROPERTY_ACTIVITY_EMBEDDING_SPLITS_ENABLED
كسمة منطقية للعلامة<application>
في بيان التطبيق. - تم إيقاف
isSplitSupported
نهائيًا واستبداله بـsplitSupportStatus
لتوفير معلومات أكثر تفصيلاً حول سبب عدم توفّر ميزة التقسيم. - تمت إضافة الفئة الفرعية
SplitController.SplitSupportStatus
لتوفير ثوابت الحالة للسمةsplitSupportStatus
. - تمت إعادة تصميم
SplitController
إلى عدة وحدات:- وحدة
ActivityEmbeddingController
لواجهات برمجة التطبيقات ذات الصلة بـActivity
أوActivityStack
- تم نقل
isActivityEmbedded
منSplitController
إلىActivityEmbeddingController
. - وحدة
RuleController
للعمليات ذات الصلة بـEmbeddingRule
: - تمت إزالة واجهات برمجة التطبيقات
SplitController
التالية:clearRegisteredRules()
getSplitRules()
initialize()
registerRule()
unregisterRule()
- تمت إضافة واجهات برمجة التطبيقات
RuleController
التالية:addRule()
: لإضافة قاعدة أو تعديل القاعدة التي تحمل العلامة نفسها-
removeRule()
: لإزالة قاعدة من مجموعة القواعد المسجّلة setRules()
: تحدّد مجموعة من القواعد.clearRules()
: لإزالة جميع القواعد المسجَّلة- `parseRules(): تحلّل القواعد من تعريفات قواعد XML.
- وحدة
- تتطلّب جميع الوحدات سياقًا يتم إعداده باستخدام طريقة
#getInstance()
، بما في ذلك:ActivityEmbeddingController#getInstance(Context)
SplitController#getInstance(Context)
RuleController#getInstance(Context)
- تمت إضافة الفئة
EmbeddingAspectRatio
لتحديد الثوابت التي تتضمّن سلوكًا مشابهًا للتعداد والمتعلّقة بنسبة العرض إلى الارتفاع. - تمت إضافة الفئة
SplitAttributes
لتحديد التنسيق المقسّم. - تمت إضافة وظائف الآلة الحاسبة
SplitAttributes
إلىSplitController
لتخصيص تنسيقات الشاشة المقسّمة:setSplitAttributesCalculator(Function)
clearSplitAttributesCalculator()
isSplitAttributesCalculatorSupported()
للتحقّق مما إذا كانت واجهات برمجة التطبيقات SplitAttributesCalculator متوافقة مع الجهاز
- تمت إضافة الحقل
EmbeddingRule#tag
. - تحديثات واجهة برمجة التطبيقات في
SplitRule
:- تمت إضافة
defaultSplitAttributes
: تحدّد هذه السمة التنسيق التلقائي للتقسيم، وهي تحلّ محلّsplitRatio
وlayoutDirection
. - تمت إضافة ترجمة لسمتَي XML
splitRatio
وsplitLayoutDirection
إلىdefaultSplitAttributes
. - تم تغيير تعريفات الحد الأدنى للأبعاد لاستخدام وحدات بكسل مستقلة الكثافة (dp) بدلاً من وحدات البكسل.
- تمت إضافة
minHeightDp
بالقيمة التلقائية 600dp. - تم تغيير
minWidth
إلىminWidthDp
بالقيمة التلقائية 600dp. - تم تغيير
minSmallestWidth
إلىminSmallestWidthDp
بالقيمة التلقائية 600dp. - تمت إضافة
maxAspectRatioInHorizontal
بالقيمة التلقائيةALWAYS_ALLOW
. - تمت إضافة
maxAspectRatioInPortrait
بالقيمة التلقائية1.4
. - تم تحديد فئة متداخلة
FinishBehavior
لاستبدال ثوابت سلوك الإنهاء. - تم تطبيق تغييرات السمة على الفئة المضمّنة
Builder
فيSplitPairRule
وSplitPlaceholderRule
.
- تمت إضافة
- تم استبدال
SplitInfo#getSplitRatio()
بـSplitInfo#getSplitAttributes()
لتقديم معلومات إضافية ذات صلة بالتقسيم.
WindowLayout
- تمت إضافة إمكانية استخدام سياق واجهة المستخدم غير النشطة إلى
WindowInfoTracker
. - تمت إضافة سياق واجهة مستخدم غير متعلق بالنشاط إلى
WindowMetricsCalculator
.
خطوات نقل البيانات
- لتفعيل ميزة تضمين الأنشطة وعرضها في شاشات مقسّمة، يجب أن تضيف التطبيقات السمة
PROPERTY_ACTIVITY_EMBEDDING_SPLITS_ENABLED
إلى علامة<application>
في ملف البيان:xml <property android:name="android.window.PROPERTY_ACTIVITY_EMBEDDING_SPLITS_ENABLED" android:value="true" />
يسمح ذلك للنظام بتحسين سلوكيات التقسيم لتطبيق ما مسبقًا. SplitInfo
نسبة- تحقَّق مما إذا كان الانقسام الحالي مكدّسًا:
kotlin SplitInfo.splitAttributes.splitType is SplitAttributes.SplitType.ExpandContainersSplitType
- تحقَّق من النسبة الحالية:
kotlin if (SplitInfo.splitAttributes.splitType is SplitAttributes.SplitType.RatioSplitType) { val ratio = splitInfo.splitAttributes.splitType.ratio } else { // Ratio is meaningless for other types. }
- تحقَّق مما إذا كان الانقسام الحالي مكدّسًا:
- عمليات نقل البيانات
SplitController
:- تغيير
SplitController.getInstance()
إلىSplitController.getInstance(Context)
- تغيير
SplitController.initialize(Context, @ResId int)
إلىRuleController.getInstance(Context).setRules(RuleController.parse(Context, @ResId int))
- تغيير
SplitController.getInstance().isActivityEmbedded(Activity)
إلىActivityEmbeddingController.getInstance(Context).isActivityEmbedded(Activity)
- تغيير
SplitController.getInstance().registerRule(rule)
إلىRuleController.getInstance(Context).addRule(rule)
- تغيير
SplitController.getInstance().unregisterRule(rule)
إلىRuleController.getInstance(Context).removeRule(rule)
- تغيير
SplitController.getInstance().clearRegisteredRules()
إلىRuleController.getInstance(Context).clearRules()
- تغيير
SplitController.getInstance().getSplitRules()
إلىRuleController.getInstance(Context).getRules()
- تغيير
- عمليات نقل بيانات المواقع
SplitRule
:- تستخدِم السمتان
minWidth
وminSmallestWidth
الآن وحدات dp بدلاً من وحدات البكسل. يمكن للتطبيقات استخدام الاستدعاء التالي:kotlin TypedValue.applyDimension( COMPLEX_UNIT_DIP, minWidthInPixels, resources.displayMetrics )
أو ببساطة تقسيمminWith
بالبكسل علىdisplayMetrics#density
.
- تستخدِم السمتان
- يجب نقل ثوابت سلوك الإنهاء إلى ثوابت فئة تشبه التعداد
FinishBehavior
:- تغيير
FINISH_NEVER
إلىFinishBehavior.NEVER
- تغيير
FINISH_ALWAYS
إلىFinishBehavior.ALWAYS
- تغيير
FINISH_ADJACENT
إلىFinishBehavior.ADJACENT
- تغيير
- يجب نقل اتجاه التنسيق إلى
SplitAttributes.LayoutDirection
:- تغيير
ltr
إلىSplitAttributes.LayoutDirection.LEFT_TO_RIGHT
- تغيير
rtl
إلىSplitAttributes.LayoutDirection.RIGHT_TO_LEFT
- تغيير
locale
إلىSplitAttributes.LayoutDirection.LOCALE
- يجب نقل
splitRatio
إلىSplitAttributes.SplitType.ratio(splitRatio)
.
- تغيير
- عمليات نقل البيانات
SplitPairRule.Builder
:- تغيير
SplitPairRule.Builder(filters, minWidth, minSmallestWidth)
إلىkotlin SplitPairRule.Builder(filters) .setMinWidthDp(minWidthInDp) // Optional if minWidthInDp is 600. .setMinSmallestWidthDp(minSmallestWidthDp) // Optional if minSmallestWidthInDp is 600.
- تغيير
setLayoutDirection(layoutDirection)
وsetSplitRatio(ratio)
إلىkotlin setDefaultSplitAttributes( SplitAttributes.Builder() .setLayoutDirection(layoutDirection) .setSplitType(SplitAttributes.SplitType.ratio(ratio)) .build() )
- تأخذ الدالتان
setFinishPrimaryWithSecondary
وsetFinishSecondaryWithPrimary
الثوابت الشبيهة بالتعدادFinishBehavior
. راجِع "عمليات نقل بيانات SplitRule" للاطّلاع على التفاصيل. - استخدِم
setMaxAspectRatioInPortrait(EmbeddingAspectRatio.ALWAYS_ALLOW)
لعرض عمليات التقسيم على الأجهزة في الوضع العمودي.
- تغيير
- عمليات نقل البيانات
SplitPlaceholder.Builder
:- يحتوي على المَعلمتَين
filters
وplaceholderIntent
فقط. يتم نقل السمات الأخرى إلى دوال الضبط. راجِع "عمليات نقل بيانات SplitPairRule.Builder" للحصول على التفاصيل. - تأخذ السمة
setFinishPrimaryWithPlaceholder
الثوابت المشابهة للتعدادFinishBehavior
. راجِع "عمليات نقل بيانات SplitRule" للاطّلاع على التفاصيل. - تتغيّر قيمة
setLayoutDirection(layoutDirection)
وsetSplitRatio(ratio)
إلى:kotlin setDefaultSplitAttributes( SplitAttributes.Builder() .setLayoutDirection(layoutDirection) .setSplitType(SplitAttributes.SplitType.ratio(ratio)) .build() )
- استخدِم
setMaxAspectRatioInPortrait(EmbeddingAspectRatio.ALWAYS_ALLOW)
لعرض عمليات التقسيم على الأجهزة في الوضع العمودي.
- يحتوي على المَعلمتَين
الإصدار 1.1.0-alpha06
22 فبراير 2023
تم طرح androidx.window:window-*:1.1.0-alpha06
. يحتوي الإصدار 1.1.0-alpha06 على عمليات الإيداع هذه.
الميزات الجديدة
- عرض نسخة تجريبية من الحصول على
WindowLayoutInfo
من سياق واجهة المستخدم
تغييرات واجهة برمجة التطبيقات
- أضِف
splitSupportStatus
للإشارة إلى ما إذا كانت ميزة "تضمين النشاط" متاحة. (I10024) - جعل واجهة برمجة التطبيقات
WindowLayoutInfo
UI Context تجريبية (I58ee0) - تضيف هذه الحزمة
WindowAreaController
وواجهات برمجة التطبيقات لتفعيل "وضعRearDisplay
" لنقل النافذة الحالية إلى الشاشة التي تتوافق مع الكاميرا الخلفية. (Iffcbf) - تعديل لون الخلفية التلقائي (I1ac1b)
- أضِف مَعلمات
SplitAttributes
. (I18bdd) - أضِف واجهات برمجة التطبيقات الخاصة بـ
SplitRule
وSplitAttributes
وSplitAttributesCalculator
. (I92d23) - تحسين واجهات برمجة التطبيقات حول
maxAspectRatio
:- استبدِل
alwaysAllow()
وalwaysDisallow()
بـALWAYS_ALLOW
وALWAYS_DISALLOW
. - تعديل مستندات واجهة برمجة التطبيقات الخاصة بالوسم @see لتتضمّن مستندات مستقلة (I3057b)
- استبدِل
- تمت إزالة الدوال الإنشائية التالية من واجهات برمجة التطبيقات العامة لأنّه من المفترض ألا يتم استدعاؤها من خلال التطبيقات.
SplitInfo
constructorActivityStack
constructor (Ide534)
- تتوفّر الآن خدمة
maxAspectRatioInPortrait/Landscape
في "SplitRule
". لا يسمح إلا بتقسيم الأنشطة عندما تكون نسبة العرض إلى الارتفاع للحدود الرئيسية أصغر منmaxAspectRatio
المطلوبة أو تساويها. (Ia5990) - تغيير
RuleController#parseRules
إلى قيمة ثابتة (I785df) - تحسين واجهات برمجة التطبيقات المتعلقة بـ ActivityEmbedding
- تنسيق أسماء واجهات برمجة التطبيقات - استخدام add/remove للعديد من الحالات:
- تغيير
registerRule
إلىaddRule
- تغيير
unregisterRule
إلىremoveRule
- استبدِل
getSplitRules
بـgetRules
لأنّActivityRule
ليس قاعدة تقسيم. - أضِف
RuleController#setRules
لضبط مجموعة من القواعد - استخرِج واجهات برمجة التطبيقات ذات الصلة بقاعدة الاستخراج من
SplitController
إلى العنصر الفرديRuleController
. وهم: addRule
removeRule
getRules
setRules
clearRules
parseRules
- استخرِج
#isActivityEmbedded
منSplitController
إلى العنصر الفرديActivityEmbeddingController
. وهم: isActivityEmbedded
- إزالة
SplitController#initialize
لضبط القواعد من ملف XML، يُرجى استخدامRuleController#parseRules
و#setRules
. قبل هذا التغيير:SplitController.initialize(context, R.xml.static_rules)
بعد هذا التغيير:val ruleController = RuleController.getInstance(context) val rules = ruleController.parseRules(R.xml.static_rules) ruleController.setRules(rules)
- لم نعد نفرّق بين القواعد الثابتة وقواعد وقت التشغيل. ومع ذلك، يؤدي طلب
#clearRules
إلى محو جميع القواعد بغض النظر عمّا إذا كانت مسجّلة بتعريفات قواعد XML ثابتة أو في وقت التشغيل. للحصول على السلوك القديم لـSplitController#clearRegisteredRules
، يُرجى الاتصال بـRuleController#parseRules
باستخدام معرّف موارد XML والاتصال بـRuleController#setRules
لإعادة ضبط القواعد. قبل هذا التغيير:SplitController.getInstance(context).clearRegisteredRules()
بعد هذا التغيير:val ruleController = RuleController.getInstance(context) val rules = ruleController.parseRules(R.xml.static_rules) ruleController.setRules(rules)
(Ib3967)
- تحسين واجهات برمجة التطبيقات SplitRule:
- استخدام الحد الأدنى للأبعاد بوحدات مستقلة عن الكثافة بدلاً من البكسل في
SplitRule
- إعادة تصميم
SplitRule
Builder لتصبح السمة min dimensions اختيارية (I95f17)
- استخدام الحد الأدنى للأبعاد بوحدات مستقلة عن الكثافة بدلاً من البكسل في
- تمرير Context لتهيئة
SplitController
(I42549) - تمت إعادة تسمية "
SplitRule#layoutDir
" إلى "#layoutDirection
" و"SplitRule Builder#setLayoutDir
" إلى "Builder#setLayoutDirection
". (I3f6d1)
الإصدار 1.1.0-alpha04
9 نوفمبر 2022
تم طرح androidx.window:window-*:1.1.0-alpha04
. يحتوي الإصدار 1.1.0-alpha04 على عمليات الإيداع هذه.
الميزات الجديدة
- عرض طريقة لتحديد ما إذا كان
ActivityStack
فارغًا بالنسبة إلىActivityEmbedding
- تمت إزالة علامات واجهة برمجة التطبيقات التجريبية من واجهات برمجة التطبيقات
ActivityEmbedding
. - إخفاء الدالة الإنشائية
ActivityRule
لأنّBuilder
هي الطريقة المفضّلة للإنشاء - أضِف طريقة تجريبية للحصول على
WindowInsets
فيWindowMetrics
. - يجب تعديل
SplitPlaceholderFinishBehavior
لمنع إكمال العنصر النائب. وقد أدّى إنهاء العنصر النائب إلى حدوث بعض السلوكيات المربكة.
تغييرات واجهة برمجة التطبيقات
- اجعل قيمة
isEmpty
عامة لاستبدال الدالةisEmpty
. - أعِد تسمية أنشطة المَعلمة
ActivityStack
إلىactivitiesInProcess
. (Ia5055) - أزِل
ActivityFilter#matchesClassName
وActivityFilter#matchesClassNameOrWildCard
لأنّهما يسبّبان التباسًا. - أضِف
ActivityFilter#componentName
وActivityFilter#intentAction
للسماح للمتصل بتمييز الفلاتر المختلفة (I41f22) - إزالة واجهات برمجة التطبيقات
@Deprecated
من واجهة برمجة التطبيقات التجريبية (I216b3) - إزالة
@ExperimentalWindowApi
لواجهات برمجة التطبيقات الخاصة بتضمين الأنشطة (I69ebe) - إخفاء أداة إنشاء
ActivityRule
، واستخدام أداة إنشاء بدلاً منها (If4eb6) - إضافة واجهات برمجة تطبيقات للتحقّق مما إذا كان أحد الأنشطة جزءًا من
ActivityFilter
(Ia43cf) - تعديل ملفات واجهة برمجة التطبيقات لتعكس التغييرات في الفئتين
WindowMetrics
وWindowMetricsCalculatorCompat
(I667fe) - تعديل
ActivityEmbedding
Javadoc الخاص بالخاصية واسم الفئة (Ia1386) - إضافة أسماء علامات السمة
ActivityEmbedding
لاستخدامها في ملف AndroidManifest.xml (Id1ad4) - تمت إضافة واجهتَي برمجة التطبيقات الجديدتَين
SplitPlaceholderFinishBehavior
وSplitPlaceholderRule.finishPrimaryWithPlaceholder
، وهذا يحلّ محلّSplitPlaceholderRule.finishPrimaryWithSecondary
الحالية التي تحدّد وقت انتهاء الأنشطة النائبة وكيفية عمل الأنشطة المرتبطة في "تضمين الأنشطة". (I64647)
إصلاح الأخطاء
- تضيف هذه الحزمة
WindowAreaController
وواجهات برمجة التطبيقات لتفعيل "وضعRearDisplay
" لنقل النافذة الحالية إلى الشاشة التي تتوافق مع الكاميرا الخلفية. (I388ab)
الإصدار 1.1.0-alpha03
27 يوليو 2022
تم طرح androidx.window:window-*:1.1.0-alpha03
. يحتوي الإصدار 1.1.0-alpha03 على عمليات الإيداع هذه.
الميزات الجديدة
- عدِّل القيم التلقائية لقواعد التضمين.
تغييرات واجهة برمجة التطبيقات
- تعديل القيم التلقائية لخصائص قاعدة التضمين (Ic4d35)
الإصدار 1.1.0-alpha02
11 مايو 2022
تم طرح androidx.window:window-*:1.1.0-alpha02
. يحتوي الإصدار 1.1.0-alpha02 على عمليات الإيداع هذه.
الميزات الجديدة
- إصدار مكتبات المحوّل لتتوافق مع Java وRxJava
الإصدار 1.1.0-alpha01
11 مايو 2022
تم طرح androidx.window:window-*:1.1.0-alpha01
. يحتوي الإصدار 1.1.0-alpha01 على عمليات الإيداع هذه.
الميزات الجديدة
- إصدار محوّلات لتوافقها مع Java وRxJava
الإصدار 1.1.0-alpha01
20 أبريل 2022
تم طرح androidx.window:window:1.1.0-alpha01
. يحتوي الإصدار 1.1.0-alpha01 على عمليات الإيداع هذه.
الميزات الجديدة
- إصلاح الخطأ الذي يتسبّب في توقُّف ميزات الطي عند تشغيل تطبيق في الخلفية
- توسيع نطاق واجهة برمجة التطبيقات التجريبية ActivityEmbedding API
تغييرات واجهة برمجة التطبيقات
- واجهة برمجة تطبيقات عامة للتحقّق مما إذا كان يتم تضمين نشاط. (I39eb7)
إصلاح الأخطاء
- إضافة واجهات برمجة تطبيقات تخصّص سلوك الإنهاء للحاويات في تقسيمات الأنشطة (I1a1e4)
- تمت إضافة خيار إعداد جديد لقواعد تقسيم الأنشطة. (Iec6af)
الإصدار 1.0
الإصدار 1.0.0
26 يناير 2022
تم طرح androidx.window:window-*:1.0.0
. يتضمّن الإصدار 1.0.0 عمليات الدمج هذه.
الميزات الرئيسية في الإصدار 1.0.0
- إتاحة استخدام الهواتف القابلة للطي من خلال الإصدارين
WindowInfoTracker
وFoldingFeature
WindowMetricsCalculator
للمساعدة في احتساب WindowMetrics الحالية.
الإصدار 1.0.0-rc01
15 كانون الأول (ديسمبر) 2021
تم طرح androidx.window:window-*:1.0.0-rc01
. يحتوي الإصدار 1.0.0-rc01 على عمليات الإيداع هذه.
الميزات الجديدة
- أضفنا إمكانية استخدام الهواتف القابلة للطي من خلال
WindowInfoTracker
. - أضِف طرقًا لاحتساب
WindowMetrics
الحالي والأقصى. - أضِف واجهات برمجة تطبيقات اختبار داعمة.
الإصدار 1.0.0-beta04
17 نوفمبر 2021
تم طرح androidx.window:window-*:1.0.0-beta04
. يحتوي الإصدار 1.0.0-beta04 على عمليات الإيداع هذه.
الميزات الجديدة
- إعادة تسمية WindowInfoRepository إلى WindowInfoTracker
- اجعل النشاط من التبعيات الصريحة لطريقة WindowInfoTracker.
- أضِف TestRule بسيطًا إلى WindowMetricsCalculator لمساعدة المطوّرين الذين يستخدمون Robolectric.
تغييرات واجهة برمجة التطبيقات
- استخراج الإضافات (I25a5f)
- إضافة isEmpty في ActivityStack (I5a4e6)
- إعادة تسمية WindowInfoRepository إلى WindowInfoTracker
- تعديل تبعيات java/rxjava/testing لتتطابق مع الإصدارات. (I0da63)
- أضِف قاعدة اختبار لـ WindowMetricsCalculator بسيط. (Ibacdb)
الإصدار 1.0.0-beta03
27 أكتوبر 2021
تم طرح androidx.window:window-*:1.0.0-beta03
. يحتوي الإصدار 1.0.0-beta03 على عمليات الإيداع هذه.
الميزات الجديدة
- إضافة واجهات برمجة تطبيقات تجريبية لدمج الأنشطة يتيح إصدار التصميم الأولي هذا عرض نشاطَين جنبًا إلى جنب.
تغييرات واجهة برمجة التطبيقات
- تمت إزالة واجهة برمجة التطبيقات currentWindowMetrics لأنّنا لا يمكننا توفيرها بدقة. يُرجى استخدام WindowMetricsCalculator بدلاً من ذلك (Icda5f).
- تم تعديل واجهة برمجة التطبيقات الخاصة بالإضافات. (Ica92b)
- تمت إضافة واجهة لميزة جديدة تتيح تضمين الأنشطة وعرضها جنبًا إلى جنب ضمن نافذة المهمة الرئيسية. (I5711d)
- تم إخفاء دوال الإنشاء الخاصة بفئتَي WindowMetrics وWindowLayoutInfo، يُرجى استخدام واجهات برمجة التطبيقات الخاصة بالاختبار بدلاً من ذلك. (I5a1b5)
- أضِف واجهة برمجة تطبيقات لإنشاء عناصر WindowLayoutInfo وهمية. (I4a2fd)
إصلاح الأخطاء
- تم إصلاح مشكلة تسرّب الذاكرة. (I3fc79، b/202989046)
الإصدار 1.0.0-beta02
1 سبتمبر 2021
تم طرح androidx.window:window-*:1.0.0-beta02
. يحتوي الإصدار 1.0.0-beta02 على عمليات الإيداع هذه.
الميزات الجديدة
- أضِف تعليقًا توضيحيًا تجريبيًا لإضافة تعليقات توضيحية إلى واجهات برمجة التطبيقات التجريبية. (I9f1b6)
- أضِف طريقة اختبار لإنشاء FoldingFeature اختبارية تقبل Rect. سيؤدي ذلك إلى تسهيل الاختبار عند استخدام Robolectric بدلاً من Activity الفعلي. (Id1cca)
الإصدار 1.0.0-beta01
18 أغسطس 2021
تم طرح androidx.window:window-*:1.0.0-beta01
. يحتوي الإصدار 1.0.0-beta01 على عمليات الإيداع هذه.
الميزات الجديدة
- تمت إزالة الثوابت القديمة وتحويل
FoldingFeature
إلى واجهة.
تغييرات واجهة برمجة التطبيقات
- إزالة الثوابت القديمة وتحويل FoldFeature إلى واجهة (I9a2d5)
إصلاح الأخطاء
- تمت ترقية المكتبات التي تعتمد على المكتبة
Test Core
إلى الإصدار1.4.0
، وستعمل الآن مع الإصدار S من نظام التشغيل Android. (I88b72، b/189353863)
الإصدار 1.0.0-alpha10
4 أغسطس 2021
تم طرح androidx.window:window-*:1.0.0-alpha10
. يحتوي الإصدار 1.0.0-alpha10 على عمليات الإيداع هذه.
الميزات الجديدة
- أعِد تسمية WindowInfoRepo إلى WindowInfoRepository وعدِّل الفئات / الملفات ذات الصلة.
- تحويل مقاييس النافذة الحالية إلى Flow في WindowInfoRepository لأنّ القيمة تتغيّر بمرور الوقت
- إعادة تسمية WindowInfoRepoJavaAdapter إلى WindowInfoRepoCallbackAdapter
- إضافة طريقة مساعدة لإنشاء عناصر FoldingFeature للاختبار
- تعديل الحِزم لتجميع الفئات استنادًا إلى الميزة التي تدعمها
تغييرات واجهة برمجة التطبيقات
- إعادة تسمية ActivityExt إلى ActivityExtensions تغيير Repo إلى Repository (I61a16)
- تعديل حِزم الصفوف (I23ae2)
- إزالة WindowMetrics من WindowInfoRepo (I24663)
- إزالة WindowManager واستخدام WindowInfoRepo
- جعل WindowBackend داخليًا (I06d9a)
- تحويل مقاييس فترة الإحالة الناجحة إلى "مسار"
- إعادة تسمية محوّل Java إلى WindowInfoRepoCallbackAdapter
- أزِل callbackFlow حتى لا يتم استخدام أي واجهات برمجة تطبيقات تجريبية أخرى. (Ia4d15)
- إضافة طريقة مساعدة لإنشاء ميزات العرض التجريبية
- التغيير من occlusionMode إلى occlusionType (If4cff)
إصلاح الأخطاء
- تم إصلاح خطأ Proguard الذي كان يؤدي إلى إزالة المكتبة الأساسية.
- تم إصلاح الخطأ الذي لم يتم فيه إرسال WindowLayoutInfo إلى المشتركين الإضافيين.
- تم إصلاح الخطأ الذي كان يؤدي إلى عدم تفعيل تحديثات ميزة الطي عند إجراء تغييرات في الإعدادات.
الإصدار 1.0.0-alpha09
30 حزيران (يونيو) 2021
تم طرح androidx.window:window-*:1.0.0-alpha09
. يحتوي الإصدار 1.0.0-alpha09 على عمليات الإيداع هذه.
الميزات الجديدة
- تغيير من الثوابت الصحيحة إلى تعدادات غير محدودة
- إضافة أداة اختبار لإنشاء ميزات الطي الاختبارية
تغييرات واجهة برمجة التطبيقات
- إضافة طريقة مساعدة لإنشاء ميزات العرض التجريبية (I3cf54)
- تغيير من
occlusionMode
إلىocclusionType
- تغيير من
إصلاح الأخطاء
- إصدار القيمة الأولية عند إضافة مستهلكين متعدّدين لعمليات بث البيانات
الإصدار 1.0.0-alpha08
16 حزيران (يونيو) 2021
تم طرح androidx.window:window-*:1.0.0-alpha08
. يحتوي الإصدار 1.0.0-alpha08 على عمليات الإيداع هذه.
الميزات الجديدة
- تم إصدار عنصر اختبار لتسهيل الاختبار عند استخدام WindowInfoRepository. استخدِم WindowInfoRepository للحصول على معلومات حول DisplayFeatures وWindowMetrics. (I57f66، Ida620)
الإصدار 1.0.0-alpha07
2 حزيران (يونيو) 2021
تم طرح androidx.window:window-*:1.0.0-alpha07
. يحتوي الإصدار 1.0.0-alpha07 على عمليات الإيداع هذه.
الميزات الجديدة
- نقل مكتبة النوافذ الأساسية إلى Kotlin سنستخدم إجراءات فرعية ودوال تعليق لعرض البيانات غير المتزامنة من الآن فصاعدًا.
- أضِف WindowInfoRepo كنقطة التفاعل الرئيسية للحصول على WindowMetrics ودفق WindowLayoutInfo.
- عنصر
window-java
جديد لعرض واجهات برمجة تطبيقات متوافقة مع Java لتسجيل عمليات رد الاتصال وإلغاء تسجيلها. - عنصرا
window-rxjava2
وwindow-rxjava3
جديدان لعرض واجهات برمجة التطبيقات المتوافقة مع RxJava
تغييرات واجهة برمجة التطبيقات
- أضِف
WindowServices
لتوفير التبعيات بشكل موحّد.- إضافة واجهة برمجة تطبيقات مستندة إلى إجراءات روتينية مشتركة لاستهلاك معلومات تنسيق النافذة (Iab70f)
- نقل مكتبة "مدير النوافذ الأساسي" إلى Kotlin (Icca34)
إصلاح الأخطاء
- أضِف فئة بيانات جديدة لتمثيل حدود الميزة. (I6dcd1)
الإصدار 1.0.0-alpha06
5 أيار (مايو) 2021
تم طرح androidx.window:window:1.0.0-alpha06
. يحتوي الإصدار 1.0.0-alpha06 على عمليات الإيداع هذه.
الميزات الجديدة
- لقد بدأنا عملية نقل البيانات إلى Kotlin وسننتهي منها في الإصدار التالي.
- تمت إزالة DeviceState من واجهة برمجة التطبيقات العامة، لذا يُرجى استخدام FoldingFeature بدلاً منها.
- لقد أزلنا
STATE_FLIPPED
من حالات FoldingFeature لأنّها غير متوافقة مع أي حالة استخدام في الوقت الحالي. - لقد أزلنا أيضًا واجهات برمجة تطبيقات أخرى تم إيقافها نهائيًا.
تغييرات واجهة برمجة التطبيقات
- إضافة Kotlin كعنصر تابع
- نقل المكتبة الأساسية إلى Kotlin (Idd995)
- تمت إزالة أداة إنشاء
DisplayFeature
. (I61fa4) - تمت إزالة
DeviceState
من واجهة برمجة التطبيقات العامة، لذا يُرجى استخدامFoldingFeature
بدلاً منها. (Id6079) - إزالة معاودة الاتصال بحالة الجهاز من الإضافات (I5ea83)
- إزالة
STATE_FLIPPED
من FoldingFeature (I9c4e1) - إزالة طرق التسجيل التي تم إيقافها نهائيًا (Ib381b)
الإصدار 1.0.0-alpha05
24 مارس 2021
تم طرح androidx.window:window:1.0.0-alpha05
. يحتوي الإصدار 1.0.0-alpha05 على عمليات الإيداع هذه.
الميزات الجديدة
أضفنا طرقًا سهلة الاستخدام إلى FoldingFeature لكي تتمكّن التطبيقات من معرفة ما إذا كانت الميزة تفصل بين الشاشتين أو تحجبهما، وتحديد اتجاه المفصلة. نخفي أيضًا نوع المفصلة حتى
نعمل على إزالة طرق القراءة المتزامنة من WindowManager. إنّ طرق القراءة المتزامنة معرَّضة لحدوث أخطاء لأنّ هناك حالة سباق ضمنية. تسجيل أدوات المعالجة وعمليات رد الاتصال لتلقّي آخر المعلومات عن WindowLayoutInfo
تغييرات واجهة برمجة التطبيقات
- إضافة طرق سهلة الاستخدام للتعامل مع FoldingFeatures (Ie733f)
- إزالة طرق القراءة المتزامنة من WindowManager (I96fd4)
الإصدار 1.0.0-alpha04
10 مارس 2021
تم طرح androidx.window:window:1.0.0-alpha04
. يحتوي الإصدار 1.0.0-alpha04 على عمليات الإيداع هذه.
الميزات الجديدة
- تم إصلاح الخطأ الذي لا يتم فيه إصدار WindowLayoutInfo إذا لم يكن هناك تنفيذ من الشركة المصنّعة للجهاز الأصلي. الآن، نرسل WindowLayoutInfo فارغًا.
- تم إصلاح خلل تعذُّر تعديل الحالة بشكل صحيح إذا تغيّرت حالة المفصلة أثناء تشغيل التطبيق في الخلفية. يجب أن تكون الحالة متسقة الآن.
- تعديل ملفات Proguard لتجاهل التحذيرات من التبعيات في وقت التشغيل
إصلاح الأخطاء
- إصدار قيمة فارغة عند عدم توفّر مكتبة الشركة المصنّعة للجهاز الأصلي (Ide935)
الإصدار 1.0.0-alpha03
18 شباط (فبراير) 2021
تم طرح androidx.window:window:1.0.0-alpha03
. يحتوي الإصدار 1.0.0-alpha03 على عمليات الإيداع هذه.
الميزات الجديدة
- إصدار قيمة فارغة لـ WindowLayoutInfo عندما يكون تنفيذ الشركة المصنّعة للمعدّات الأصلية فارغًا من المفترض أن يسهّل ذلك استخدام المكتبة على المزيد من الأجهزة. بما أنّ واجهات برمجة التطبيقات غير متزامنة، لا يزال يُنصح بأن تكتب التطبيقات بعض الرموز البرمجية الدفاعية وأن تصدر قيمة تلقائية بعد انتهاء المهلة. ليس لدينا أي ضمانات بشأن عمليات التنفيذ من قِبل الشركات المصنّعة للمعدات الأصلية، وقد يتأخر ظهور القيمة الأولية.
إصلاح الأخطاء
- إصدار قيمة فارغة عند عدم توفّر مكتبة الشركة المصنّعة للجهاز الأصلي (Ide935)
الإصدار 1.0.0-alpha02
27 يناير 2021
تم طرح androidx.window:window:1.0.0-alpha02
. يحتوي الإصدار 1.0.0-alpha02 على عمليات الإيداع هذه.
الميزات الجديدة
لقد أوقفنا بعض واجهات برمجة التطبيقات نهائيًا للمساعدة في تبسيطها وتقليل الأخطاء. وتتضمّن بعض الأمثلة البارزة إزالة عمليات القراءة المتزامنة من WindowManager وإيقاف DeviceState نهائيًا. يمكن أن تؤدي عمليات القراءة المتزامنة إلى حدوث حالات تعارض وعرض واجهة مستخدم غير صحيحة.
لقد حوّلنا DisplayFeature إلى واجهة ستنفّذها الميزات الأخرى من الآن فصاعدًا. الميزة الأولى هي FoldingFeature التي تمثّل الآن طي الشاشة أو المفصلة. يحتوي هذا العنصر أيضًا على حالة المفصلة التي تحلّ محل DeviceState.
تم طرح WindowMetrics في نظام التشغيل Android 11 لتزويد المطوّرين بطريقة بسيطة للاستعلام عن مقاييس حول نافذة، مثل موضعها وحجمها على الشاشة وأي حواف داخلية للنظام. لقد أعدنا توفير واجهة برمجة التطبيقات في هذا الإصدار لكي يتمكّن المطوّرون من الاستفادة من WindowMetrics ومواصلة توفير الدعم لإصدارات Android القديمة. يمكن الحصول على WindowMetrics من خلال واجهتَي برمجة التطبيقات
WindowManager#getCurrentWindowMetrics()
وWindowManager#getMaximumWindowMetrics().
تغييرات واجهة برمجة التطبيقات
- إيقاف واجهات برمجة التطبيقات التي ستتم إزالتها في الإصدار الأولي التالي (Ib7cc4)
- تعديل
ExtensionInterface
لقبول مراجع Activity الصريحة. (I07ded) - تعرِّف هذه الصفحة على WindowMetrics API. (I3ccee)
- إزالة طرق القراءة المتزامنة من WindowManager (I69983)
- جعل حزمة ExtensionWindowBackend محمية (Ied208)
إصلاح الأخطاء
- تعديل واجهات برمجة التطبيقات
ExtensionInterface
لقبول السياقات المرئية (I8e827)
المساهمة الخارجية
- دمج DeviceState وWindowLayoutInfo لتسهيل الوصول إلى البيانات (Id34f4)
الإصدار 1.0.0-alpha01
27 شباط (فبراير) 2020
تم طرح androidx.window:window:1.0.0-alpha01
وandroidx.window:window-extensions:1.0.0-alpha01
. يحتوي الإصدار 1.0.0-alpha01 على عمليات الدمج التالية.
هذا هو الإصدار الأول من مكتبة Window Manager.
الميزات الجديدة
DisplayFeature
: تحدّد واجهة برمجة التطبيقات الجديدة هذه أي انقطاعات في أسطح الشاشة المسطّحة المتواصلة، مثل المفصّلات أو الطيّات.-
DeviceState
: توفّر واجهة برمجة التطبيقات الجديدة هذه الوضع الحالي للهاتف من قائمة أوضاع محدّدة (على سبيل المثال،CLOSED
وOPENED
وHALF_OPENED
وما إلى ذلك).