المتصفح

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

تعريف التبعيات

لإضافة تبعية إلى 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. يُرجى إعلامنا إذا اكتشفت مشاكل جديدة أو كانت لديك أفكار لتحسين هذه المكتبة. يُرجى الاطّلاع على المشاكل الحالية في هذه المكتبة قبل إنشاء مشكلة جديدة. يمكنك إضافة صوتك إلى مشكلة حالية من خلال النقر على زر النجمة.

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

يُرجى الاطّلاع على مستندات Issue Tracker للحصول على مزيد من المعلومات.

الإصدار 1.9

الإصدار 1.9.0-beta01

‫2 يوليو 2025

تم طرح 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 على عمليات الدمج هذه.

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

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

  • تمت إضافة عمليات تحميل زائدة للرمز 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 الإضافي" (مثل الإصدار 3.3 من R8)، وجميع عمليات الإنشاء عند استخدام الإصدار 8.1 أو إصدار أحدث من "مكوّن Android الإضافي" (مثل الإصدار 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)

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

  • تم تفعيل فحص API 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)

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

الإصدار 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.