المتصفح

عرض صفحات الويب في المتصفّح التلقائي للمستخدم
آخر تعديل الإصدار الثابت إصدار محتمل الإصدار التجريبي الإصدار الأولي
20 أيار (مايو) 2025 1.8.0 - - 1.9.0-alpha04

تحديد التبعيات

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

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

Groovy

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

Kotlin

dependencies {
    implementation("androidx.browser:browser:1.8.0")
}

لمزيد من المعلومات عن العناصر الاعتمادية، اطّلِع على مقالة إضافة عناصر الاعتماد الخاصة بالإصدار.

الملاحظات

تساعدنا ملاحظاتك في تحسين Jetpack. يُرجى إعلامنا إذا واجهت مشاكل جديدة أو كان لديك أفكار لتحسين هذه المكتبة. يُرجى الاطّلاع على المشاكل الحالية في هذه المكتبة قبل إنشاء مكتبة جديدة. يمكنك إضافة صوتك إلى مشكلة حالية من خلال النقر على زر النجمة.

إنشاء مشكلة جديدة

اطّلِع على مستندات أداة تتبُّع المشاكل لمزيد من المعلومات.

الإصدار 1.9

الإصدار 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 عمليات الربط هذه.

الميزات الجديدة

تغييرات واجهة برمجة التطبيقات

  • تمت إضافة حالات الحمولة الزائدة لـ CustomTabsClient#createPendingAuthTabSession. (I71c3a)
  • واجهات برمجة تطبيقات علامة التبويب "المصادقة" المعدَّلة (Iaf9b1)
  • يتضمّن TrustedWebActivityIntent الآن وضع عميل Launch Handler API الذي يسمح للمتصفّح باستخدام واجهة برمجة التطبيقات هذه. (Ifc95c)
  • يتضمّن TrustedWebActivityIntent الآن عناوين URL للملفات التي يتم فتحها من خلال فلاتر الأهداف المسجّلة للتطبيق، ويمنح المتصفّح أذونات القراءة والكتابة لهذه الملفات. (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 مع AGP 7.3 أو إصدار أحدث (مثل R8 الإصدار 3.3) ولجميع الإصدارات عند استخدام AGP 8.1 أو إصدار أحدث (مثل D8 الإصدار 8.1). ننصح العملاء الذين لا يستخدمون AGP بالتحديث إلى الإصدار 8.1 من D8 أو إصدار أحدث. يُرجى مراجعة هذه المقالة للاطّلاع على مزيد من التفاصيل. (I9496c، b/345472586)

المساهمة الخارجية

  • تقديم طلب IPC جديد ICustomTabsService#prefetchWithMultipleUrls لتجنُّب إجراء عدة طلبات IPC لعناوين 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 لتحديد اللغة المستهدفة التي يجب تفعيل واجهة مستخدم "الترجمة" بها. (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 لتحديد اللغة المستهدفة التي يجب تفعيل واجهة مستخدم "الترجمة" بها. (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 في حزمة تطوير البرامج (SDK) 33 والإصدارات الأحدث. تم تطوير هذا الإصدار في فرع داخلي. يُرجى الرجوع إلى 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 في حزمة تطوير البرامج (SDK) 33 والإصدارات الأحدث. تم تطوير هذا الإصدار في فرع داخلي. يُرجى الرجوع إلى 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 على PendingIntents لضمان توافقها مع 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 على PendingIntents لضمان توافقها مع 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)

إصلاح الأخطاء

  • تم تفعيل فحص 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 إلى 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.

تغييرات واجهة برمجة التطبيقات

  • تم @Nullable عنوان URL الذي تم تقديمه إلى CustomTabsSession#mayLauncherUrl واستلامه في CustomTabsService#mayLaunchUrl.

الإصدار 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 لتمثيل هوية حزمة، فهي تحتوي على اسم الحزمة وتوقيع شهادة توقيع الحزمة.
    • تم تصميمه لتسلسله إلى سلسلة بايت[] للحفاظ عليه.
    • ويستخدمه TrustedWebActivityService لتحديد مقدّم TWA المسموح له بالاتصال به.
    • ويستخدمه مقدّم TWA لتحديد الحِزم الصالحة للاتصال بها.TrustedWebActivityConnectionPool
  • يستخدم TrustedWebActivityService الآن واجهة TokenStore لتحديد التطبيق المسموح له بالاتصال به.
    • يعود الأمر إلى العميل في طلب TokenStore#store، ولا تحمّل TrustedWebActivityService سوى الرموز المميّزة.
  • لم يعُد TrustedWebActivityServiceConnectionPool (المعروف سابقًا باسم TrustedWebActivityServiceConnectionManager) يخزِّن مجموعة الحِزم التي تم التحقّق منها:
    • تمت إزالة registerClient وgetVerifiedPackages الآن.
    • يتم الآن تقديم مجموعة الحِزم التي تم إثبات صحتها يدويًا إلى execute (المعروفة سابقًا باسم connect) وserviceExistsForScope.
  • تفوض فئة TrustedWebActivityService إلى الفئة التي تلغي الإعدادات لتخزين مقدّم الخدمة الذي تم التحقّق منه.
    • تمّت إزالة setVerifiedProvider.
    • يجب أن ينفِّذ العميل getTokenStore الذي يعرض TokenStore يمكن استخدامه لتخزين Token واسترداده.

تغييرات واجهة برمجة التطبيقات

  • فئة TrustedWebActivityServiceConnectionManager:
    • تم تغيير اسمها إلى TrustedWebActivityServiceConnectionPool.
    • أصبحت نهائية الآن.
    • يتم إنشاؤها من خلال الطريقة الثابتة create بدلاً من طريقة الإنشاء العامة.
  • فئة TrustedWebActivityService:
    • أن تتضمّن تعليقات توضيحية لسلاسل المحادثات حول الطرق التي يمكن إلغاؤها
  • فئة TrustedWebActivityServiceWrapper:
    • تم تغيير اسمها إلى TrustedWebActivityServiceConnection.
    • أصبحت نهائية الآن.
    • يتم الآن رمي أخطاء RemoteExceptions أولية بدلاً من تغليفها في أخطاء RuntimeExceptions.
  • أصبحت فئة 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 على هذه المراجعات.

الميزات الجديدة

  • تمّت إضافة واجهات برمجة تطبيقات جديدة لميزة "مشاركة الاستهداف" في "الأنشطة الموثوق بها على الويب". يمكن للتطبيقات التي تستخدم أنشطة الويب الموثوق بها الآن إرسال البيانات إلى "هدف المشاركة على الويب"، والذي يتم تحديده من خلال البروتوكول https://wicg.github.io/web-share-target/level-2/ (aosp/I47b93، aosp/I0ec3e).

تغييرات واجهة برمجة التطبيقات

  • تمت إضافة دالة ردّ الاتصال extraCallbackWithResult إلى ICustomTabsCallback (aosp/Ic2cc2)
  • تم وضع علامة على بعض مَعلمات طريقة CustomTabsSession على أنّها Nullable أو NonNull (aosp/Iec460)
  • ينشئ TrustedWebActivityIntentBuilder الآن TrustedWebActivityIntent بدلاً من نية أساسية (aosp/I03fb6).

إصلاح الأخطاء

  • يستخدم CustomTabsClient الآن الإصدار القديم requestPostMessageChannel إذا لزم الأمر (aosp/Ibb324).
  • تم إصلاح CustomTabsSessionToken#equals (aosp/I7f249)
  • يستخدم تطبيق CustomTabsClient الآن newSession القديم إذا أمكن (aosp/Ie27dc).

المساهمة الخارجية

  • تم تفعيل فحص الأخطاء في واجهة برمجة التطبيقات لـ 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

تم إصدار browser-1.0.0.