المتصفح

تحديد الاعتماديات

لإضافة اعتمادية على Browser، يجب تضمين مستودع Google Maven في مشروعك. اطّلِع على مستودع Maven من Google لمزيد من المعلومات.

أضِف الاعتماديات الخاصة بالعناصر التي تحتاج إليها في ملف build.gradle لتطبيقك أو وحدتك:

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

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)
  • تمت إضافة @IntDefs إلى طرق 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 من المتصفّح.