المتصفح
androidx.browser.browseractions
androidx.browser.customtabs
androidx.browser.trusted
آخر الأخبار | الإصدار الثابت | إصدار محتمل | الإصدار التجريبي | الإصدار الأوّلي |
---|---|---|---|---|
8 أكتوبر 2025 | 1.9.0 | - | - | 1.10.0-alpha02 |
تحديد الاعتماديات
لإضافة اعتمادية على Browser، يجب تضمين مستودع Google Maven في مشروعك. اطّلِع على مستودع Maven من Google لمزيد من المعلومات.
أضِف الاعتماديات الخاصة بالعناصر التي تحتاج إليها في ملف build.gradle
لتطبيقك أو وحدتك:
Groovy
dependencies { implementation "androidx.browser:browser:1.9.0" }
Kotlin
dependencies { implementation("androidx.browser:browser:1.9.0") }
لمزيد من المعلومات حول الاعتماديات، يُرجى الاطّلاع على إضافة اعتماديات البناء.
الملاحظات
تساعدنا ملاحظاتك في تحسين Jetpack. يُرجى إعلامنا إذا اكتشفت مشاكل جديدة أو كانت لديك أفكار لتحسين هذه المكتبة. يُرجى الاطّلاع على المشاكل الحالية في هذه المكتبة قبل إنشاء مشكلة جديدة. يمكنك إضافة صوتك إلى مشكلة حالية من خلال النقر على زر النجمة.
يُرجى الاطّلاع على مستندات Issue Tracker للحصول على مزيد من المعلومات.
الإصدار 1.10
الإصدار 1.10.0-alpha02
8 أكتوبر 2025
تم طرح androidx.browser:browser:1.10.0-alpha02
. يتضمّن الإصدار 1.10.0-alpha02 هذه التعديلات.
تغييرات واجهة برمجة التطبيقات
- تمت إتاحة
AuthTabIntent.AuthenticateUserResultContract
للجميع (I1e598، b/425405218) - أعِد تسمية وضع عرض تراكب عناصر التحكّم في النافذة ليكون متوافقًا مع الأوضاع الأخرى. (I10b67)
الإصدار 1.10.0-alpha01
13 أغسطس 2025
تم طرح androidx.browser:browser:1.10.0-alpha01
. يتضمّن الإصدار 1.10.0-alpha01 هذه التعديلات.
تغييرات واجهة برمجة التطبيقات
- تمت إضافة دعم لسمة بيان
display_override
لتطبيقات الويب المتوافقة مع الأجهزة الجوّالة (Ib036b) - إزالة التعليقات التوضيحية القديمة
@RequiresApi(21)
(Ic4792) - إزالة التعليقات التوضيحية القديمة
@RequiresApi(21)
(I9103b) - السماح بقيمة فارغة لـ
pageUrl
فيContentActionSelectedData
(Ifed54) - تمت إضافة Intent للسماح بفتح عنوان URL الأوّلي في تطبيق خارجي (Id9349)
- إضافة Intent للسماح بفتح عنوان URL الأوّلي في تطبيق خارجي (Ifed54)
إصلاح الأخطاء
- نقل القيمة التلقائية
minSdk
من المستوى 21 إلى المستوى 23 من واجهة برمجة التطبيقات (Ibdfca، b/380448311، b/435705964، b/435705223) - السماح بقيمة فارغة لـ
pageUrl
فيContentActionSelectedData
(Id9349)
الإصدار 1.9
الإصدار 1.9.0
30 يوليو 2025
تم طرح androidx.browser:browser:1.9.0
. يتضمّن الإصدار 1.9.0 هذه التعديلات.
الإصدار 1.9.0-rc01
16 يوليو 2025
تم طرح androidx.browser:browser:1.9.0-rc01
. يتضمّن الإصدار 1.9.0-rc01 هذه التعديلات.
تغييرات واجهة برمجة التطبيقات
- تمت إضافة "عناصر قائمة السياق" لعلامات التبويب المخصّصة (Iab7d0)
إصلاح الأخطاء
- تم تعديل JavaDocs لـ
setOpenInBrowserButtonState
من أجل (Iae1f2)
الإصدار 1.9.0-beta01
2 يوليو 2022
تم طرح androidx.browser:browser:1.9.0-beta01
. لا يتضمّن الإصدار 1.9.0-beta01 أي تغييرات منذ إصدار ألفا السابق.
الإصدار 1.9.0-alpha05
18 يونيو 2025
تم طرح androidx.browser:browser:1.9.0-alpha05
. يتضمّن الإصدار 1.9.0-alpha05 هذه التعديلات.
تغييرات واجهة برمجة التطبيقات
- إزالة التعليق التوضيحي التجريبي من واجهة برمجة التطبيقات للتصفّح المؤقت (If8b1b)
الإصدار 1.9.0-alpha04
20 مايو 2025
تم طرح androidx.browser:browser:1.9.0-alpha04
. يتضمّن الإصدار 1.9.0-alpha04 هذه التعديلات.
تغييرات واجهة برمجة التطبيقات
- تمت إضافة بيانات إضافية جديدة خاصة بالأهداف لعلامات التبويب المخصّصة (I911e0)
- تمّت إضافة الوضعَين "
Browser
" و"MiminalUi
" إلى "TWADisplayMode
" (I230b5) - تمت إضافة واجهة برمجة تطبيقات للتحقّق من إمكانية استخدام ميزة "التصفّح المؤقت" (I17d42)
- إزالة التعليق التوضيحي التجريبي لواجهة برمجة التطبيقات
PendingSession
(Id6fe3) - تمت إضافة واجهة برمجة تطبيقات للتحقّق من إمكانية استخدام علامة التبويب "المصادقة" (Ifc029)
- تمت إزالة التعليق التوضيحي التجريبي لإشارات تصغير علامة التبويب المخصّصة (If2b44)
الإصدار 1.9.0-alpha03
23 أبريل 2025
تم طرح androidx.browser:browser:1.9.0-alpha03
. يتضمّن الإصدار 1.9.0-alpha03 هذه التعديلات.
تغييرات واجهة برمجة التطبيقات
- تمت إزالة التعليق التوضيحي التجريبي من علامة التبويب "المصادقة". (I786ff)
الإصدار 1.9.0-alpha02
9 أبريل 2025
تم طرح androidx.browser:browser:1.9.0-alpha02
. يتضمّن الإصدار 1.9.0-alpha02 هذه التعديلات.
الميزات الجديدة
- تمت إضافة دعم لواجهات برمجة تطبيقات متعددة لتطبيقات الويب التقدّمية، مثل Launch Handler وProtocol Handler وFile Handler
تغييرات واجهة برمجة التطبيقات
- تمت إضافة عمليات تحميل زائدة للرمز
CustomTabsClient#createPendingAuthTabSession
. (I71c3a) - تعديل على واجهات برمجة التطبيقات في علامة التبويب "المصادقة" (Iaf9b1)
- يتضمّن
TrustedWebActivityIntent
الآن وضع عميل Launch Handler API الذي يتيح للمتصفّح استخدام واجهة برمجة التطبيقات هذه. (Ifc95c) - يتضمّن
TrustedWebActivityIntent
الآن عناوين URI للملفات التي تم فتحها من خلال فلاتر الأهداف المسجّلة في التطبيق، ويمنح المتصفّح أذونات القراءة والكتابة لهذه الملفات. (I2134a) - تتضمّن
TrustedWebActivityIntent
الآن عنوان URL الذي تم إطلاقه في الأصل في الإضافات، ما يوفّر سياقًا للمتصفّح عند استخدامه من قِبل معالجات البروتوكول. (I3759a) - تمت إضافة واجهة برمجة تطبيقات جديدة لتفعيل/إيقاف زر الإغلاق في علامات التبويب المخصّصة. (I35acd)
- تمت إضافة إمكانية تخصيص رمز زر الإغلاق إلى علامة التبويب "المصادقة" (Iaf877)
الإصدار 1.9.0-alpha01
29 يناير 2025
تم طرح androidx.browser:browser:1.9.0-alpha01
. يتضمّن الإصدار 1.9.0-alpha01 هذه التعديلات.
تغييرات واجهة برمجة التطبيقات
- تمت إضافة إمكانية ربط المتصفّح/الجلسة إلى علامة التبويب "المصادقة". (I6e47b)
- تمت إضافة واجهة برمجة تطبيقات جديدة
CustomTabsSession#isEphemeralBrowsingSupported
تحدّد ما إذا كان التصفّح المؤقت متاحًا أم لا (Ie4dea، b/384548523) - تمت إضافة إمكانية استخدام مَعلمات نظام الألوان إلى واجهات برمجة التطبيقات الخاصة بعلامة التبويب "المصادقة". (I630e1)
- تمت إضافة خيار التصفّح المؤقت التجريبي إلى علامات التبويب المخصّصة (I9549d)
- تعديل على واجهات برمجة التطبيقات التجريبية لعلامة التبويب "المصادقة" (I8b674)
- إضافة واجهة برمجة تطبيقات جديدة للتحقّق مما إذا كان موفّر علامات التبويب المخصّصة يتيح استخدام شبكات متعددة (I4307a)
- إضافة فئة فلتر أهداف خدمة جديدة لتوفير إمكانية استخدام شبكات متعددة (I4354a)
- إضافة واجهة برمجة تطبيقات جديدة لضبط الشبكة المرتبطة أو الحصول عليها عند فتح عنوان URL في علامة تبويب مخصّصة (I493e1)
- تمت إضافة واجهات برمجة تطبيقات تجريبية لعلامة التبويب "المصادقة" (I9b4d4)
- واجهات برمجة تطبيقات تجريبية جديدة لـ
PendingSession
(Ib40e5)
إصلاح الأخطاء
- تعديل مستندات Javadoc الخاصة بفئة AuthTabIntent (I2490c)
- إصلاح مشكلة الجلسة الثابتة في علامة التبويب "المصادقة" (I4e280)
- تستخدم هذه المكتبة الآن تعليقات توضيحية بشأن القيم الخالية من JSpecify، وهي تعليقات توضيحية خاصة باستخدام النوع. على مطوّري Kotlin استخدام وسيطة المترجم البرمجي التالية لفرض الاستخدام الصحيح:
-Xjspecify-annotations=strict
(هذه هي القيمة التلقائية بدءًا من الإصدار 2.1.0 من مترجم Kotlin البرمجي). (Ic7bf5، b/326456246) - تمت إزالة التحديد اليدوي لإمكانية الوصول إلى واجهات برمجة التطبيقات الجديدة للمنصة لأنّ ذلك يحدث تلقائيًا من خلال تصميم واجهة برمجة التطبيقات عند استخدام R8 مع الإصدار 7.3 أو إصدار أحدث من "مكوّن Android الإضافي في Gradle" (مثل الإصدار 3.3 من R8) وجميع عمليات الإنشاء عند استخدام الإصدار 8.1 أو إصدار أحدث من "مكوّن Android الإضافي في Gradle" (مثل الإصدار 8.1 من D8). ننصح العملاء الذين لا يستخدمون AGP بالتحديث إلى الإصدار 8.1 أو إصدار أحدث من D8. يُرجى مراجعة هذه المقالة للاطّلاع على مزيد من التفاصيل. (I9496c، b/345472586)
المساهمة الخارجية
- إضافة طلب جديد للاتصال بين العمليات
ICustomTabsService#prefetchWithMultipleUrls
لتجنُّب طلبات الاتصال المتعددة بين العمليات لعناوين URL الفردية (Ie5025) - اجعل
CustomTabsSession#prefetch
ينقل جلسةCustomTabsSession
(id(mID)
) إلىCustomTabsService
. (I4ec7b) - إضافة واجهة برمجة تطبيقات تجريبية جديدة
CustomTabsSession#prefetch(List<Uri>, PrefetchOptions)
، والتي تحلّ محل واجهة برمجة التطبيقات الحالية لقبول عناوين URL متعددة (I54f35) - إضافة واجهة برمجة تطبيقات تجريبية جديدة
CustomTabsSession#prefetch(Uri, PrefetchOptions)
تحاول جلب الصفحة الرئيسية مسبقًا (بدون موارد فرعية) لعمليات التنقّل المستقبلية (I340cf)
الإصدار 1.8
الإصدار 1.8.0
6 مارس 2024
تم طرح androidx.browser:browser:1.8.0
. يتضمّن الإصدار 1.8.0 هذه التعديلات.
التغييرات المهمة منذ الإصدار 1.7.0
- تمت إضافة
CustomTabsIntent.Builder#setInitialActivityWidthPx
التي تتيح للمطوّرين تحديد العرض الأوّلي عند تشغيل علامة تبويب مخصّصة. (I443f6) - تمت إضافة
CustomTabsIntent.Builder#setActivitySideSheetPosition
التي تتيح للمطوّرين تحديد موضع علامة التبويب المخصّصة عند عملها كلوحة جانبية. (I443f6) - تمت إضافة
CustomTabsIntent.Builder#setActivitySideSheetDecorationType
التي تتيح للمطوّرين تحديد نوع الزخرفة لعلامة التبويب المخصّصة عندما تعمل كلوحة جانبية. (I443f6) - تمت إضافة
CustomTabsIntent.Builder#setActivitySideSheetRoundedCornersPosition
التي تتيح للمطوّرين تحديد موضع الزوايا الدائرية عندما تعمل علامة التبويب المخصّصة كلوحة جانبية. (I443f6) - تمت إضافة
CustomTabsIntent.Builder#setActivitySideSheetMaximizationEnabled
التي تتيح للمطوّرين تفعيل زر التكبير أو إيقافه عندما تعمل علامة التبويب المخصّصة كلوحة جانبية. (Ie3564) - تمت إضافة طريقة معاودة الاتصال
onActivityLayout
إلى الواجهةCustomTabsCallback
لإعلام المطوّرين بإحداثيات المساحة التي تشغلها علامة التبويب المخصّصة والحالة التي يتم عرضها بها. سيتم استدعاء هذه الطريقة عند عرض علامة التبويب المخصّصة لأول مرة على الشاشة وفي كل مرة تتغير فيها المساحة المستخدَمة. (I443f6) - تمت إضافة طريقة معاودة الاتصال
onWarmupCompleted
إلى الواجهةCustomTabsCallback
لإعلام المطوّرين عند بدء عمليةCustomTabsClient#warmupfinishes
لتسخين عملية المتصفّح. (I107cf) - تمت إضافة معرّف الجلسة إلى الإضافات في
CustomTabsSession#setEngagementSignalsCallback
وCustomTabsSession#isEngagementSignalsApiAvailable
. (Iba7f1) - تمت إضافة دعم تجريبي لواجهات برمجة التطبيقات الخاصة بعلامات التبويب المخصّصة المصغّرة. (I67f2d)
الإصدار 1.8.0-rc01
21 فبراير 2024
تم إصدار androidx.browser:browser:1.8.0-rc01
بدون أي تغييرات منذ الإصدار 1.8.0-beta02. يتضمّن الإصدار 1.8.0-rc01 هذه التعديلات.
الإصدار 1.8.0-beta02
7 فبراير 2024
تم طرح androidx.browser:browser:1.8.0-beta02
. يتضمّن الإصدار 1.8.0-beta02 هذه التعديلات.
تغييرات واجهة برمجة التطبيقات
- تمت إعادة تسمية
CustomTabsIntent.Builder#setActivitySideSheetEnableMaximization
إلىCustomTabsIntent Builder#setActivitySideSheetMaximizationEnabled
وإتاحتها للجميع. تتيح هذه السمة للمطوّرين تفعيل زر التكبير أو إيقافه عندما تعمل علامة التبويب المخصّصة كلوحة جانبية. (Ie3564)
الإصدار 1.8.0-beta01
29 نوفمبر 2023
تم طرح androidx.browser:browser:1.8.0-beta01
. يتضمّن الإصدار 1.8.0-beta01 هذه التعديلات.
الميزات الجديدة
- إضافة دعم تجريبي لواجهات برمجة التطبيقات الخاصة بعلامات التبويب المخصّصة المصغّرة (I67f2d)
الإصدار 1.8.0-alpha01
15 تشرين الثاني (نوفمبر) 2023
تم طرح androidx.browser:browser:1.8.0-alpha01
. يتضمّن الإصدار 1.8.0-alpha01 هذه التعديلات.
الميزات الجديدة
- تمت إضافة
CustomTabsIntent.Builder#setInitialActivityWidthPx
التي تتيح للمطوّرين تحديد العرض الأوّلي عند تشغيل علامة تبويب مخصّصة. (I443f6) - تمت إضافة
CustomTabsIntent.Builder#setActivitySideSheetBreakpointDp
التي تتيح للمطوّرين تحديد الحد الأدنى لعرض نافذة علامات التبويب المخصّصة لتعمل كلوحة جانبية. (I443f6) - تمت إضافة
CustomTabsIntent.Builder#setActivitySideSheetPosition
التي تتيح للمطوّرين تحديد موضع علامة التبويب المخصّصة عند عملها كلوحة جانبية. (I443f6) - تمت إضافة
CustomTabsIntent.Builder#setActivitySideSheetEnableMaximization
التي تتيح للمطوّرين تفعيل زر التكبير أو إيقافه عندما تعمل علامة التبويب المخصّصة كلوحة جانبية. (I443f6) - تمت إضافة
CustomTabsIntent.Builder#setActivitySideSheetDecorationType
التي تتيح للمطوّرين تحديد نوع الزخرفة لعلامة التبويب المخصّصة عندما تعمل كلوحة جانبية. (I443f6) - تمت إضافة
CustomTabsIntent.Builder#setActivitySideSheetRoundedCornersPosition
التي تتيح للمطوّرين تحديد موضع الزوايا الدائرية عندما تعمل علامة التبويب المخصّصة كلوحة جانبية. (I443f6) - تمت إضافة طريقة معاودة الاتصال
onActivityLayout
إلى الواجهةCustomTabsCallback
لإعلام المطوّرين بإحداثيات المساحة التي تشغلها علامة التبويب المخصّصة والحالة التي يتم عرضها بها. سيتم استدعاء هذه الطريقة عند عرض علامة التبويب المخصّصة لأول مرة على الشاشة وفي كل مرة تتغير فيها المساحة المستخدَمة. (I443f6) - تمت إضافة طريقة معاودة الاتصال
onWarmupCompleted
إلى الواجهةCustomTabsCallback
لإعلام المطوّرين عند انتهاءCustomTabsClient#warmup
من عملية تهيئة عملية المتصفّح. (I107cf)
إصلاح الأخطاء
- تمت إضافة معرّف الجلسة إلى الإضافات في
CustomTabsSession#setEngagementSignalsCallback
وCustomTabsSession#isEngagementSignalsApiAvailable
. (Iba7f1)
الإصدار 1.7
الإصدار 1.7.0
15 تشرين الثاني (نوفمبر) 2023
تم طرح androidx.browser:browser:1.7.0
. يتضمّن الإصدار 1.7.0 هذه التعديلات.
التغييرات المهمة منذ الإصدار 1.6.0
- تمت إضافة
CustomTabsIntent.Builder#setBookmarksButtonEnabled
التي تتيح زر الإشارات المرجعية في القائمة الكاملة. (Ia792e) - تمت إضافة
CustomTabsIntent.Builder#setDownloadButtonEnabled
التي تفعّل زر التنزيل في القائمة الكاملة. (Ia792e) - تمت إضافة
CustomTabsIntent.Builder#setSendToExtraDefaultHandlerEnabled
التي تتيح إرسال عناوين URL الأولية إلى تطبيقات المعالجة الخارجية. (Ia792e) - تمت إضافة
CustomTabsIntent.Builder#setTranslateLanguage
التي تحدّد اللغة المستهدَفة التي يجب أن يتم تشغيل واجهة مستخدم "ترجمة Google" بها. (Ia792e) - تمت إضافة
CustomTabsIntent.Builder#setBackgroundInteractionEnabled
التي تتيح التفاعل مع التطبيق الذي يعمل في الخلفية عند تشغيل علامة تبويب مخصّصة جزئية. (Ia792e) - تمت إضافة
CustomTabsIntent.Builder#setShareIdentityEnabled
التي تسمح لعلامات التبويب المخصّصة بالحصول على هوية المتصل. (I7bf2b) - تمت إضافة
CustomTabsIntent.Builder#setSecondaryToolbarSwipeUpGesture
الذي يضبطPendingIntent
ليتم إرساله عندما يمرّر المستخدم سريعًا للأعلى من شريط الأدوات السفلي. (Id42a2)
الإصدار 1.7.0-rc01
1 نوفمبر 2023
تم إصدار androidx.browser:browser:1.7.0-rc01
بدون أي تغييرات. يتضمّن الإصدار 1.7.0-rc01 هذه التعديلات.
- لم يتم إجراء أي تغييرات منذ الإصدار alpha-01
الإصدار 1.7.0-beta01
18 أكتوبر 2023
تم إصدار androidx.browser:browser:1.7.0-beta01
بدون أي تغييرات. يتضمّن الإصدار 1.7.0-beta01 هذه التعديلات.
الإصدار 1.7.0-alpha01
4 أكتوبر 2023
تم طرح androidx.browser:browser:1.7.0-alpha01
. يتضمّن الإصدار 1.7.0-alpha01 هذه التعديلات.
الميزات الجديدة
- تمت إضافة
CustomTabsIntent.Builder#setBookmarksButtonEnabled
التي تتيح زر الإشارات المرجعية في القائمة الكاملة. (Ia792e) - تمت إضافة
CustomTabsIntent.Builder#setDownloadButtonEnabled
التي تفعّل زر التنزيل في القائمة الكاملة. (Ia792e) - تمت إضافة
CustomTabsIntent.Builder#setSendToExtraDefaultHandlerEnabled
التي تتيح إرسال عناوين URL الأولية إلى تطبيقات المعالجة الخارجية. (Ia792e) - تمت إضافة
CustomTabsIntent.Builder#setTranslateLanguage
التي تحدّد اللغة المستهدَفة التي يجب أن يتم تشغيل واجهة مستخدم "ترجمة Google" بها. (Ia792e) - تمت إضافة
CustomTabsIntent.Builder#setBackgroundInteractionEnabled
التي تتيح التفاعل مع التطبيق الذي يعمل في الخلفية عند تشغيل علامة تبويب مخصّصة جزئية. (Ia792e) - تمت إضافة
CustomTabsIntent.Builder#setShareIdentityEnabled
التي تسمح لعلامات التبويب المخصّصة بالحصول على هوية المتصل. (I7bf2b) - تمت إضافة
CustomTabsIntent.Builder#setSecondaryToolbarSwipeUpGesture
الذي يضبطPendingIntent
ليتم إرساله عندما يمرّر المستخدم سريعًا للأعلى من شريط الأدوات السفلي. (Id42a2)
الإصدار 1.6
الإصدار 1.6.0
9 أغسطس 2023
تم إصدار androidx.browser:browser:1.6.0
بدون أي تغييرات منذ الإصدار 1.6.0-rc01. يتضمّن الإصدار 1.6.0 هذه التعديلات.
الإصدار 1.6.0-rc01
26 يوليو 2023
تم إصدار androidx.browser:browser:1.6.0-rc01
بدون أي تغييرات منذ الإصدار 1.6.0-beta01. يتضمّن الإصدار 1.6.0-rc01 هذه التعديلات.
الإصدار 1.6.0-beta01
21 حزيران (يونيو) 2023
تم إصدار androidx.browser:browser:1.6.0-beta01
بدون أي تغييرات منذ الإصدار 1.6.0-alpha02. يتضمّن الإصدار 1.6.0-beta01 هذه التعديلات.
الإصدار 1.6.0-alpha02
7 يونيو 2023
تم طرح androidx.browser:browser:1.6.0-alpha02
. يتضمّن الإصدار 1.6.0-alpha02 هذه التعديلات.
تغييرات واجهة برمجة التطبيقات
- تمت إزالة
CustomTabsSession#getGreatestScrollPercentage
. (I6c5ba) - تمت إضافة واجهة برمجة تطبيقات
requestPostMessageChannel
جديدة تتيح تحديد المصدر المستهدف. وهذا يعني أنّ المستخدمين يمكنهم التأكّد من أنّ رسائلهم يتم تسليمها فقط إلى الموقع الإلكتروني الذي يتوقعونه. (Id5b7f)
إصلاح الأخطاء
- تم تعديل مستندات
EngagementSignalsCallback
. (Ie833c)
الإصدار 1.6.0-alpha01
3 مايو 2023
تم طرح androidx.browser:browser:1.6.0-alpha01
. يتضمّن الإصدار 1.6.0-alpha01 هذه التعديلات.
الميزات الجديدة
- تمّت إضافة واجهة برمجة التطبيقات Engagement Signals API التي تتيح للمطوّرين تلقّي عمليات ردّ لطلبات المستخدمين بشأن تفاعلاتهم على صفحة الويب، مثل عمليات التمرير. (I835e6)
تغييرات واجهة برمجة التطبيقات
- تم تعديل واجهة برمجة التطبيقات Engagement Signals API لتبسيط مساحة واجهة برمجة التطبيقات من جهة تنفيذ علامات التبويب المخصّصة. (Iaa6dc)
الإصدار 1.5
الإصدار 1.5.0
8 شباط (فبراير) 2023
تم طرح androidx.browser:browser:1.5.0
. يتضمّن الإصدار 1.5.0 هذه التعديلات.
التغييرات المهمة منذ الإصدار 1.4.0
- تمت إضافة
CustomTabsIntent.Builder#setInitialActivityHeightPx
، ما يتيح للمطوّرين تحديد الارتفاع الأوّلي الذي يتم به إطلاق علامة تبويب مخصّصة، ويمكنهم أيضًا تحديد سلوك تغيير الحجم (ثابت أو قابل لتغيير الحجم). (I48bd3) - تمت إضافة
CustomTabsIntent.Builder#setToolbarCornerRadiusDp
الذي يتيح للمطوّرين تحديد نصف قطر الزاوية العلوية لشريط الأدوات. (I48bd3) - تمت إضافة
CustomTabsIntent.Builder#setCloseButtonPosition
الذي يتيح للمطوّرين ضبط موضع زر الإغلاق على شريط الأدوات. (I48bd3) - تمت إضافة طريقة معاودة الاتصال
onActivityResized
إلى الواجهةCustomTabsCallback
لإعلام المطوّرين عند تغيير حجم علامة التبويب المخصّصة. (Ic864e) - اجعل أجزاء من واجهات برمجة التطبيقات
CustomTabsCallback
غير متزامنة. (Ic86df) - يتم تلقائيًا ملء لغة التطبيق الحالية في Accept-Language لتتوافق مع تجربة اللغة المحددة لكل تطبيق في Android. (I3d1d7)
- تمت إضافة
@RequiresPermission
إلى واجهات برمجة التطبيقات التي تتطلّب منح الإذنPOST_NOTIFICATIONS
على الإصدار 33 من حزمة تطوير البرامج (SDK) والإصدارات الأحدث. تم تطوير هذه الميزة في فرع داخلي. b/238790278 هو المرجع.
الإصدار 1.5.0-rc01
25 كانون الثاني (يناير) 2023
تم طرح androidx.browser:browser:1.5.0-rc01
. يتضمّن الإصدار 1.5.0-rc01 هذه التعديلات.
- لم يتم إجراء أي تغييرات منذ الإصدار 1.5.0-beta01.
الإصدار 1.5.0-beta01
11 يناير 2023
تم طرح androidx.browser:browser:1.5.0-beta01
. يتضمّن الإصدار 1.5.0-beta01 هذه التعديلات.
- لم يتم إجراء أي تغييرات منذ الإصدار 1.5.0-alpha02
الإصدار 1.5.0-alpha02
7 كانون الأول (ديسمبر) 2022
تم طرح androidx.browser:browser:1.5.0-alpha02
. يتضمّن الإصدار 1.5.0-alpha02 هذه التعديلات.
تغييرات واجهة برمجة التطبيقات
- تم تغيير سلوك
CustomTabsCallback#onActivityResized
وإضافة مَعلمات جديدة إليه. - تمت إعادة تسمية
EXTRA_ACTIVITY_RESIZE_BEHAVIOR
إلىEXTRA_ACTIVITY_RESIZE_HEIGHT_BEHAVIOR
لتوضيح أنّه خاص بالارتفاع. (Ic864e) - اجعل أجزاء من واجهات برمجة التطبيقات
CustomTabsCallback
غير متزامنة. (Ic86df)
الإصدار 1.5.0-alpha01
24 أكتوبر 2022
تم طرح androidx.browser:browser:1.5.0-alpha01
. يتضمّن الإصدار 1.5.0-alpha01 هذه التعديلات.
الميزات الجديدة
- تمت إضافة
CustomTabsIntent.Builder#setInitialActivityHeightPx
، ما يتيح للمطوّرين تحديد الارتفاع الأوّلي الذي يتم به إطلاق علامة تبويب مخصّصة، ويمكنهم أيضًا تحديد سلوك تغيير الحجم (ثابت أو قابل لتغيير الحجم). (I48bd3) - تمت إضافة
CustomTabsIntent.Builder#setToolbarCornerRadiusDp
الذي يتيح للمطوّرين تحديد نصف قطر الزاوية العلوية لشريط الأدوات. (I48bd3) - تمت إضافة
CustomTabsIntent.Builder#setCloseButtonPosition
الذي يتيح للمطوّرين ضبط موضع زر الإغلاق على شريط الأدوات. (I48bd3) - تمت إضافة طريقة معاودة الاتصال
onActivityResized
إلى واجهة CustomTabsCallback لإعلام المطوّرين عند تغيير حجم علامة تبويب مخصّصة (توسيعها إلى الارتفاع الكامل أو تصغيرها إلى ارتفاع الإطلاق الأولي). (Id99ce) - يتم تلقائيًا ملء لغة التطبيق الحالية في Accept-Language لتتوافق مع تجربة اللغة المحددة لكل تطبيق في Android. (I3d1d7)
تغييرات واجهة برمجة التطبيقات
- تمت إضافة
@RequiresPermission
إلى واجهات برمجة التطبيقات التي تتطلّب منح الإذنPOST_NOTIFICATIONS
على الإصدار 33 من حزمة تطوير البرامج (SDK) والإصدارات الأحدث. تم تطوير هذه الميزة في فرع داخلي. b/238790278 هو المرجع.
الإصدار 1.4.0
الإصدار 1.4.0
3 نوفمبر 2021
تم طرح androidx.browser:browser:1.4.0
. يتضمّن الإصدار 1.4.0 هذه التعديلات.
التغييرات المهمة منذ الإصدار 1.3.0
- وضع علامة PendingIntent.FLAG_IMMUTABLE على رموز PendingIntent لتحقيق التوافق مع Android 12
الإصدار 1.4.0-rc01
13 أكتوبر 2021
تم إصدار androidx.browser:browser:1.4.0-rc01
بدون أي تغييرات منذ الإصدار 1.4.0-beta01. يتضمّن الإصدار 1.4.0-rc01 هذه التعديلات.
الإصدار 1.4.0-beta01
29 سبتمبر 2021
تم إصدار androidx.browser:browser:1.4.0-beta01
بدون أي تغيير منذ 1.4.0-alpha01
. يتضمّن الإصدار 1.4.0-beta01 هذه التعديلات.
الإصدار 1.4.0-alpha01
15 سبتمبر 2021
تم طرح androidx.browser:browser:1.4.0-alpha01
. يتضمّن الإصدار 1.4.0-alpha01 هذه التعديلات.
إصلاح الأخطاء
- ضَع علامة
PendingIntent.FLAG_IMMUTABLE
على PendingIntent لضمان التوافق مع Android 12.
الإصدار 1.3.0
الإصدار 1.3.0
2 ديسمبر 2020
تم طرح androidx.browser:browser:1.3.0
. يتضمّن الإصدار 1.3.0 هذه التعديلات.
الميزات الرئيسية منذ الإصدار 1.2.0
- يمكن تمرير أوامر النموذج الحر من المتصفّح إلى عميل "نشاط الويب الموثوق به" من خلال استدعاء
TrustedWebActivityServiceConnection#sendExtraCommand
. يمكن للعميل التعامل مع هذه المشاكل فيTrustedWebActivityService#onExtraCommand
. - تمت إضافة واجهة
TrustedWebActivityCallback
يمكن أن يستخدمها عميل "نشاط الويب الموثوق به" لإرجاع البيانات إلى المتصفّح. - تمت إضافة
CustomTabsIntent#setShareState
، ما يتيح للمطوّرين تحديد ما إذا كان سيتم عرض خيار المشاركة أم لا (أو ترك الأمر للمتصفّح). - يمكن للمطوّرين الآن ضبط اتجاه تلقائي للشاشة باستخدام طريقة
setScreenOrientation
فيTrustedWebActivityIntentBuilder
- تمت إضافة طريقة
setNavigationBarDividerColor
إلىCustomTabColorSchemeParams
لإتاحة تغيير لون فاصل شريط التنقّل. - تمت إضافة
CustomTabsIntent.Builder#setDefaultColorSchemeParams
لاستبدال الطرق المتوقّفة نهائيًا#setNavigationBarColor
و#setNavigationBarDividerColor
و#setToolbarColor
و#setSecondaryToolbarColor
- تمت إضافة الطريقة
CustomTabsClient#bindCustomTabsServicePreservePriority
، ما يتيح الاتصال بخدمة علامات التبويب المخصّصة بدون استخدام العلامةContext.BIND_WAIVE_PRIORITY
.
الإصدار 1.3.0-rc01
11 نوفمبر 2020
تم إصدار androidx.browser:browser:1.3.0-rc01
بدون أي تغييرات منذ 1.3.0-beta01
. يتضمّن الإصدار 1.3.0-rc01 هذه التعديلات.
الإصدار 1.3.0-beta01
28 أكتوبر 2020
تم طرح androidx.browser:browser:1.3.0-beta01
. يتضمّن الإصدار 1.3.0-beta01 هذه التعديلات.
تغييرات واجهة برمجة التطبيقات
- تمت إعادة تسمية
bindCustomTabServicePreservePriority
إلىbindCustomTabsServicePreservePriority
(I29ac1)
إصلاح الأخطاء
- تم تفعيل فحص API lint للإصدار
MissingGetterMatchingBuilder
من androidx (I4bbea، b/138602561)
الإصدار 1.3.0-alpha06
1 تشرين الأول (أكتوبر) 2020
تم طرح androidx.browser:browser:1.3.0-alpha06
. يتضمّن الإصدار 1.3.0-alpha06 هذه التعديلات.
الميزات الجديدة
- تضيف هذه السمة CustomTabsIntent#setShareState التي تتيح للمطوّر ضبط حالة المشاركة على "مفعَّلة" أو "غير مفعَّلة" أو تركها للمتصفّح. (I153fe)
- تضيف هذه السمة CustomTabsIntent.Builder#setDefaultColorSchemeParams التي يجب استخدامها بدلاً من الطرق التي تم إيقافها نهائيًا، وهي #setNavigationBarColor و#setNavigationBarDividerColor و#setToolbarColor و#setSecondaryToolbarColor.(I09012)
تغييرات واجهة برمجة التطبيقات
- تم تفعيل عملية التحقّق من أخطاء واجهة برمجة التطبيقات في أداة lint لفئة StaticFinalBuilder في حزمة androidx (I2b11b، b/138602561)
- تضيف هذه السمة CustomTabsService#KEY_SUCCESS وTrustedWebActivityService#KEY_SUCCESS اللتين يمكن استخدامهما للإشارة إلى أنّ extraCommand ناجح. (I6f7b5)
الإصدار 1.3.0-alpha05
5 آب (أغسطس) 2020
تم طرح androidx.browser:browser:1.3.0-alpha05
. يتضمّن الإصدار 1.3.0-alpha05 هذه التعديلات.
الميزات الجديدة
- تسمح هذه السمة بضبط اتجاه "أنشطة الويب الموثوقة" التي يتم تشغيلها.
- السماح بضبط لون فاصل شريط التنقّل في "أنشطة الويب الموثوقة" و"علامات التبويب المخصّصة"
تغييرات واجهة برمجة التطبيقات
- تمت إضافة طريقة
setScreenOrientation
فيTrustedWebActivityIntentBuilder
. - تمت إضافة
@IntDef
لـScreenOrientation.LockType
لتمثيل نوع القفل (I802d2) - تمت إضافة طريقة
setNavigationBarDividerColor
إلىTrustedWebActivityIntentBuilder
وCustomTabColorSchemeParams
. (Ia04dd)- تمت إضافة
@IntDef
s إلى طرقTrustedWebActivityIntentBuilder
التي تستخدم نظام ألوان.
- تمت إضافة
الإصدار 1.3.0-alpha04
24 يونيو 2020
تم طرح androidx.browser:browser:1.3.0-alpha04
. يتضمّن الإصدار 1.3.0-alpha04 هذه التعديلات.
الميزات الجديدة
- تمت إضافة الطريقة
CustomTabsClient#bindCustomTabServicePreservePriority
، ما يتيح الاتصال بخدمة علامات التبويب المخصّصة بدون استخدام العلامةContext.BIND_WAIVE_PRIORITY
.
الإصدار 1.3.0-alpha03
10 يونيو 2020
تم طرح androidx.browser:browser:1.3.0-alpha03
. يتضمّن الإصدار 1.3.0-alpha03 هذه التعديلات.
الميزات الجديدة
- تمت إضافة واجهة
TrustedWebActivityCallback
يمكن أن يستخدمها عميل "نشاط الويب الموثوق به" لإرجاع البيانات إلى المتصفّح. (I64dbb)
تغييرات واجهة برمجة التطبيقات
- تتضمّن الدالة
TrustedWebActivityServiceConnection.extraCommand
الآن أيضًا المَعلمة@Nullable
TrustedWebActivityCallback
. تم الآن وضع علامة@NonNull
على مَعلمة الحزمة بدلاً من@Nullable
. (I64dbb) - تمت إعادة تسمية الطريقة
TrustedWebActivityServiceConnection.extraCommand
إلىsendExtraCommand
(Id29a8) - تم إيقاف العمل بـ "
CustomTabsIntent.Builder#addDefaultShareMenuItem()
" نهائيًا واستبداله بـ "#setDefaultShareMenuItemEnabled(boolean)
" الجديد، كما تم إيقاف العمل بـ "CustomTabsIntent.Builder#enableUrlBarHiding()
" نهائيًا واستبداله بـ "#setUrlBarHidingEnabled(boolean)
" الجديد. (Iad702)
الإصدار 1.3.0-alpha01
8 كانون الثاني (يناير) 2020
تم طرح androidx.browser:browser:1.3.0-alpha01
. يتضمّن الإصدار 1.3.0-alpha01 هذه التعديلات.
الميزات الجديدة
- يمكن تمرير أوامر النموذج الحر من المتصفّح إلى عميل "نشاط الويب الموثوق به" من خلال استدعاء
TrustedWebActivityServiceConnection#extraCommand
. يمكن للعميل التعامل مع هذه المشاكل فيTrustedWebActivityService#onExtraCommand
.
تغييرات واجهة برمجة التطبيقات
- تمت إزالة عنوان URL الذي تم تقديمه إلى
CustomTabsSession#mayLauncherUrl
وتم تلقّيه فيCustomTabsService#mayLaunchUrl
.@Nullable
الإصدار 1.2.0
الإصدار 1.2.0
18 كانون الأول (ديسمبر) 2019
تم إصدار androidx.browser:browser:1.2.0
بدون أي تغييرات منذ 1.2.0-rc01
. يتضمّن الإصدار 1.2.0 هذه التعديلات.
التغييرات الرئيسية منذ الإصدار 1.0.0
- النشاط الموثوق به على الويب
- أصبحت ميزة النشاط الموثوق به على الويب متاحة الآن بشكل ثابت.
- يمكن استخدام
TrustedWebActivityIntentBuilder
لتخصيصTrustedWebActivityIntent
وإنشائه، وذلك لتشغيل نشاط الويب الموثوق. - يمكن تضمين
TrustedWebActivityService
أو توسيعه للسماح للعملاء بعرض إشعارات الدفع على الويب التي يقدّمها لهم المتصفّح. - يمكن للمتصفّحات استخدام
TrustedWebActivityServiceConnectionPool
للاتصال بـTrustedWebActivityService
في برامج العملاء. يمثّلTrustedWebActivityServiceConnection
هذا النوع من الاتصال. - يمكن تشغيل "الأنشطة الموثوق بها على الويب" من خلال تقديم معلومات إلى "هدف المشاركة على الويب".
- المظهر الداكن
- يمكن للمطوّرين توفير (من خلال
CustomTabColorSchemeParams
) ألوان مختلفة للمظهر لاستخدامها عندما يكون الجهاز في الوضع الفاتح أو الداكن. - يمكن للمطوّرين طلب أن يكون المتصفّح نفسه في الوضع الفاتح أو الداكن.
- يمكن للمطوّرين توفير (من خلال
- استئناف الجلسة
- يمكن إنشاء
CustomTabsSession
باستخدام معرّف، ما يسمح بدمج عمليات تشغيل "علامات التبويب المخصّصة" اللاحقة من العميل والمعرّف نفسهما.
- يمكن إنشاء
- يمكن تحديد لون شريط التنقّل في علامات التبويب المخصّصة.
- تم وضع علامة على الفئات ذات الصلة بميزة "إجراءات المتصفّح" باعتبارها متوقّفة نهائيًا بسبب قلة استخدام الميزة بشكل كبير، وستتم إزالتها في إصدار مستقبلي من المكتبة.
الإصدار 1.2.0-rc01
4 كانون الأول (ديسمبر) 2019
تم طرح androidx.browser:browser:1.2.0-rc01
. يتضمّن الإصدار 1.2.0-rc01 هذه التعديلات.
إصلاح الأخطاء
- تم إصلاح تنسيق Javadoc لعينات التعليمات البرمجية.
الإصدار 1.2.0-beta01
20 تشرين الثاني (نوفمبر) 2019
تم إصدار androidx.browser:browser:1.2.0-beta01
بدون أي تغييرات منذ 1.2.0-alpha09
. يتضمّن الإصدار 1.2.0-beta01 هذه التعديلات.
الإصدار 1.2.0-alpha09
23 تشرين الأول (أكتوبر) 2019
تم طرح androidx.browser:browser:1.2.0-alpha09
. يتضمّن الإصدار 1.2.0-alpha09 هذه التعديلات.
الميزات الجديدة
- يمكن استخدام الفئة
Token
لتمثيل هوية الحزمة، وهي تحتوي على اسم الحزمة وتوقيع شهادة توقيع الحزمة.- تم تصميمه ليتم تسلسله إلى byte[] من أجل الثبات.
- يستخدمه
TrustedWebActivityService
لتحديد موفّر تطبيقات الويب التلقائية الذي يُسمح له بالاتصال به. - يستخدمها
TrustedWebActivityConnectionPool
من خلال موفّر تطبيقات الويب المتوافقة مع الأجهزة الجوّالة لتحديد الحِزم الصالحة للاتصال.
- يستخدم
TrustedWebActivityService
الآن واجهةTokenStore
لتحديد التطبيق المسموح له بالاتصال بها.- يقع على عاتق العميل الاتصال بـ
TokenStore#store
، ولا تحمّلTrustedWebActivityService
الرموز المميزة إلا بعد ذلك.
- يقع على عاتق العميل الاتصال بـ
- لم يعُد
TrustedWebActivityServiceConnectionPool
(الذي كان يُعرف سابقًا باسم TrustedWebActivityServiceConnectionManager) يخزِّن مجموعة الحِزم التي تم التحقّق منها:- تمت الآن إزالة
registerClient
وgetVerifiedPackages
. - يتم الآن تقديم مجموعة الحِزم التي تم التحقّق منها يدويًا إلى
execute
(connect
سابقًا) وserviceExistsForScope
.
- تمت الآن إزالة
- يتم تفويض
TrustedWebActivityService
إلى الفئة المتجاوزة لتخزين المزوّد الذي تم التحقّق منه.- تمت إزالة
setVerifiedProvider
. - يجب أن ينفّذ العميل
getTokenStore
الذي يعرضTokenStore
يمكن استخدامه لتخزينToken
واسترداده.
- تمت إزالة
تغييرات واجهة برمجة التطبيقات
- الصف
TrustedWebActivityServiceConnectionManager
:- يُعرف هذا الحقل الآن باسم
TrustedWebActivityServiceConnectionPool
. - أصبحت الآن نهائية.
- يتم إنشاؤه باستخدام الطريقة الثابتة
create
بدلاً من أداة إنشاء عامة.
- يُعرف هذا الحقل الآن باسم
- الصف
TrustedWebActivityService
:- يحتوي على تعليقات توضيحية لسلسلة التعليمات البرمجية حول الطرق القابلة للتجاهل.
- الصف
TrustedWebActivityServiceWrapper
:- يُعرف هذا الحقل الآن باسم
TrustedWebActivityServiceConnection
. - أصبح نهائيًا.
- تعرض الآن RemoteException غير معدَّلة بدلاً من تضمينها في RuntimeException.
- يُعرف هذا الحقل الآن باسم
- أصبح الصف
ShareTarget#FileFormField
نهائيًا الآن. - تمت إعادة تسمية الطريقة
TrustedWebUtils#splashScreensAreSupported
إلىareSplashScreensSupported
. - تمت إعادة تسمية الطريقة
TrustedWebActivityIntentBuilder#getUrl
إلىTrustedWebActivityIntentBuilder#getUri
. - تمت إضافة البادئة
KEY_
إلى الحقول الثابتةSplashScreenParamKey
.
الإصدار 1.2.0-alpha08
18 أيلول (سبتمبر) 2019
تم طرح androidx.browser:browser:1.2.0-alpha08
. يتضمّن الإصدار 1.2.0-alpha08 هذه التعديلات.
الميزات الجديدة
- تم طرح واجهات برمجة تطبيقات جديدة لاستهداف المشاركة في "الأنشطة الموثوق بها على الويب". يمكن للتطبيقات التي تستخدم أنشطة الويب الموثوقة الآن إرسال البيانات إلى Web Share Target، الذي يحدّده البروتوكول https://wicg.github.io/web-share-target/level-2/ (aosp/I47b93 وaosp/I0ec3e).
تغييرات واجهة برمجة التطبيقات
- تمت إضافة دالة رد الاتصال
extraCallbackWithResult
إلىICustomTabsCallback
(aosp/Ic2cc2) - تم وضع علامة Nullable أو NonNull على بعض مَعلمات طريقة
CustomTabsSession
(aosp/Iec460) - تنشئ
TrustedWebActivityIntentBuilder
الآنTrustedWebActivityIntent
بدلاً من هدف أولي (aosp/I03fb6)
إصلاح الأخطاء
- يستخدم
CustomTabsClient
الآن الإصدار القديمrequestPostMessageChannel
عند الحاجة (aosp/Ibb324) - تم إصلاح الخطأ
CustomTabsSessionToken#equals
(aosp/I7f249) - يستخدم
CustomTabsClient
الآنnewSession
القديم إذا كان ذلك ممكنًا (aosp/Ie27dc)
المساهمة الخارجية
- تم تفعيل فحص API lint لـ MinMaxConstant في androidx (aosp/I29b78) (b/138602561)
الإصدار 1.2.0-alpha07
7 آب (أغسطس) 2019
تم طرح androidx.browser:browser:1.2.0-alpha07
. يمكنك الاطّلاع على التعديلات في هذا الإصدار هنا.
الميزات الجديدة
المظهر الداكن
- يمكن للمطوّرين توفير ألوان للسمات لاستخدامها عندما يكون الجهاز في "الوضع الداكن".
- يمكن للمطوّرين أيضًا تجاهل ما إذا كان يجب أن يكون المتصفّح الذي تم إطلاقه في الوضع الداكن أو الفاتح.
- يمكن تحديد لون شريط التنقّل في علامات التبويب المخصّصة.
النشاط الموثوق به على الويب
- يمكن استخدام
TrustedWebActivityBuilder
لإنشاء أنشطة الويب الموثوقة وتشغيلها بسهولة. - يمكن استخدام
TrustedWebActivityService
والفئات ذات الصلة للتواصل مع مقدّم الخدمة، أي قبول الإشعارات الفورية على الويب للموقع الإلكتروني المرتبط وعرضها من تطبيق العميل. هذا الجزء من واجهة برمجة التطبيقات عرضة للتغيير.
- يمكن استخدام
معرّفات جلسات علامات التبويب المخصّصة
- يمكن الآن إنشاء جلسات علامات التبويب المخصّصة باستخدام أرقام التعريف، ما يتيح دمج جلستَين تم إطلاقهما من خلال التطبيق نفسه باستخدام رقم التعريف نفسه.
تغييرات واجهة برمجة التطبيقات
- تم وضع علامة "متوقّف نهائيًا" على الفئات والطرق ذات الصلة بـ "إجراءات المتصفّح". مع أنّنا كنّا نعقد آمالاً كبيرة على هذه الميزة، لم يستخدمها سوى عدد قليل جدًا من الأشخاص، ولم يتوافق معها سوى متصفّح واحد. سنوقفها نهائيًا للحفاظ على بساطة الرمز وواجهة برمجة التطبيقات.
الإصدار 1.0.0
الإصدار 1.0.0
21 سبتمبر 2018
تم طرح الإصدار 1.0.0 من المتصفّح.