اپ‌کامپات

امکان دسترسی به APIهای جدید را در نسخه‌های قدیمی‌تر API پلتفرم (که بسیاری از آنها از طراحی متریال استفاده می‌کنند) فراهم می‌کند.
آخرین به‌روزرسانی انتشار پایدار کاندیدای انتشار انتشار بتا انتشار آلفا
۸ آوریل ۲۰۲۶ ۱.۷.۱ - - ۱.۸.۰-آلفا۰۱

اعلام وابستگی‌ها

برای افزودن وابستگی به Appcompat، باید مخزن Google Maven را به پروژه خود اضافه کنید. برای اطلاعات بیشتر، مخزن Google's Maven را مطالعه کنید.

وابستگی‌های مربوط به مصنوعات مورد نیاز خود را در فایل build.gradle برای برنامه یا ماژول خود اضافه کنید:

شیار

dependencies {
    def appcompat_version = "1.7.1"

    implementation "androidx.appcompat:appcompat:$appcompat_version"
    // For loading and tinting drawables on older versions of the platform
    implementation "androidx.appcompat:appcompat-resources:$appcompat_version"
}

کاتلین

dependencies {
    val appcompat_version = "1.7.1"

    implementation("androidx.appcompat:appcompat:$appcompat_version")
    // For loading and tinting drawables on older versions of the platform
    implementation("androidx.appcompat:appcompat-resources:$appcompat_version")
}

برای اطلاعات بیشتر در مورد وابستگی‌ها، به بخش «افزودن وابستگی‌های ساخت» مراجعه کنید.

بازخورد

بازخورد شما به بهبود Jetpack کمک می‌کند. اگر مشکلات جدیدی کشف کردید یا ایده‌هایی برای بهبود این کتابخانه دارید، به ما اطلاع دهید. لطفاً قبل از ایجاد یک کتابخانه جدید، نگاهی به مشکلات موجود در این کتابخانه بیندازید. می‌توانید با کلیک بر روی دکمه ستاره، رأی خود را به یک مشکل موجود اضافه کنید.

ایجاد یک مسئله جدید

برای اطلاعات بیشتر به مستندات ردیاب مشکل مراجعه کنید.

نسخه ۱.۸

نسخه ۱.۸.۰-آلفا۰۱

۸ آوریل ۲۰۲۶

androidx.appcompat:appcompat:1.8.0-alpha01 و androidx.appcompat:appcompat-resources:1.8.0-alpha01 منتشر شدند. نسخه 1.8.0-alpha01 شامل این کامیت‌ها است.

تغییرات API

  • حذف حاشیه‌نویسی‌های منسوخ‌شده‌ی @RequiresApi(21) ( I44f33 )
  • API جدید TextAppearanceSpanCompat برای کار با ویژگی فونت قابل دانلود ( I9c1c8 ، b/197242546 ، b/393805627 )

رفع اشکالات

  • انتقال minSdk پیش‌فرض از API 21 به API 23 ( Ibdfca ، b/380448311 ، b/435705964 ، b/435705223 )
  • AppCompat برای استفاده از Activity 1.8.0 به‌روزرسانی شده است تا به آن اجازه دهد از API مربوط initializeViewTreeOwners() از ComponentActivity استفاده کند تا اطمینان حاصل شود که همیشه ViewTreeOwners صحیح را دارد. ( I96919 , b/419208471 )
  • اصلاح ActionBarContextView و AppCompatDelegateImpl ( Ia83b3 )
  • این کتابخانه اکنون از حاشیه‌نویسی‌های nullness از نوع JSpecify استفاده می‌کند که از نوع type-use هستند. توسعه‌دهندگان Kotlin باید از آرگومان‌های کامپایلر زیر برای اعمال استفاده صحیح استفاده کنند: -Xjspecify-annotations=strict , -Xtype-enhancement-improvements-strict-mode ( Id9081 , b/326456246 )
  • عنوان پنجره‌ی AlertDialogs را برای اهداف a11y تنظیم کنید ( I8bbdd ، b/347729115 )
  • حذف دستورالعمل دسترسی به APIهای پلتفرم جدید، زیرا این امر به طور خودکار از طریق مدل‌سازی API هنگام استفاده از R8 با AGP 7.3 یا بالاتر (مثلاً R8 نسخه 3.3) و برای همه نسخه‌ها هنگام استفاده از AGP 8.1 یا بالاتر (مثلاً D8 نسخه 8.1) اتفاق می‌افتد. به مشتریانی که از AGP استفاده نمی‌کنند، توصیه می‌شود به D8 نسخه 8.1 یا بالاتر به‌روزرسانی کنند. برای جزئیات بیشتر به این مقاله مراجعه کنید. ( I9496c ، b/345472586 )
  • fontVariationSettings از textAppearance در نماهای AppCompat به درستی تنظیم شده است. ( I20d06 ، b/264321145 )
  • تغییرات پیکربندی در AppCompatActivity را به درخت نما ( Ibece8 ، b/321896385 ) ارسال کنید.
  • پروژه‌های منتشر شده با کاتلین ۲.۰ برای استفاده به KGP 2.0.0 یا جدیدتر نیاز دارند ( Idb6b5 ، b/344563182 )
  • رفع مشکل محاسبه ارتفاع نوار ابزار برای شامل شدن حاشیه‌های عمودی عنوان/زیرعنوان ( Ia5846 ، b/267200424 )

نسخه ۱.۷

نسخه ۱.۷.۱

۴ ژوئن ۲۰۲۵

androidx.appcompat:appcompat:1.7.1 و androidx.appcompat:appcompat-resources:1.7.1 منتشر شدند. نسخه ۱.۷.۱ شامل این کامیت‌ها است.

رفع اشکالات

  • AppCompat برای استفاده از Activity 1.8.0 به‌روزرسانی شده است تا به آن اجازه دهد از API initializeViewTreeOwners() از ComponentActivity استفاده کند تا اطمینان حاصل شود که همیشه ViewTreeOwners صحیح تنظیم شده است. این امر ناسازگاری بین AppCompatActivity و NavigationEvent و کتابخانه‌هایی که بر اساس آن ساخته می‌شوند مانند Navigation 3 را برطرف می‌کند. ( I96919 , b/419208471 )

نسخه ۱.۷.۰

۲۹ مه ۲۰۲۴

androidx.appcompat:appcompat:1.7.0 و androidx.appcompat:appcompat-resources:1.7.0 منتشر شدند. نسخه ۱.۷.۰ شامل این کامیت‌ها است.

تغییرات مهم از زمان ۱.۶.۰

  • AppCompatDialog اکنون به درستی LifecycleOwner ، SavedStateRegistryOwner و OnBackPressedDispatcherOwner را از طریق APIهای ViewTree روی نمای دکور دیالوگ تنظیم می‌کند و مشکلات مربوط به میزبانی یک ComposeView در یک AppCompatDialog را برطرف می‌کند.
  • AppCompatActivity اکنون ViewTreeOnBackPressedDispatcherOwner را طوری تنظیم می‌کند که بازیابی dispatcher از view امکان‌پذیر باشد.
  • عملکرد SupportMenuInflater به طور قابل توجهی بهبود یافته است.
  • Locale.getDefault() اکنون پس از شروع سرد، زبان سیستم را برمی‌گرداند.
  • LinearLayoutCompat اکنون پارامترهای طرح حاشیه را حفظ می‌کند.

به‌روزرسانی‌های وابستگی

  • AppCompat اکنون به Activity 1.7.0 وابسته است.
  • AppCompat اکنون به نسخه ۱.۵.۴ فرگمنت وابسته است.

نسخه ۱.۷.۰-rc01

۱۴ مه ۲۰۲۴

androidx.appcompat:appcompat:1.7.0-rc01 و androidx.appcompat:appcompat-resources:1.7.0-rc01 منتشر شدند. نسخه 1.7.0-rc01 شامل این کامیت‌ها است.

نسخه ۱.۷.۰-بتا۰۱

۱ مه ۲۰۲۴

androidx.appcompat:appcompat:1.7.0-beta01 و androidx.appcompat:appcompat-resources:1.7.0-beta01 منتشر شدند. نسخه 1.7.0-beta01 شامل این کامیت‌ها است.

نسخه ۱.۷.۰-آلفا۰۳

۲۶ ژوئیه ۲۰۲۳

androidx.appcompat:appcompat:1.7.0-alpha03 و androidx.appcompat:appcompat-resources:1.7.0-alpha03 منتشر شدند. نسخه 1.7.0-alpha03 شامل این کامیت‌ها است.

ویژگی‌های جدید

  • پشتیبانی از دریافت زبان‌های هر برنامه در زمینه‌های غیر از Activity ( I58e753 ). چهار API جدید برای این ویژگی اضافه شده است:

    • LocaleManagerCompat.getApplicationLocales() : برای اینکه توسعه‌دهندگان بتوانند زبان‌های هر برنامه را از محدوده فعالیت خارج کنند.

    • ContextCompat.getString() : رشته‌های محلی‌شده را بر اساس زبان‌های هر برنامه برمی‌گرداند.

    • ContextCompat.getContextForLanguage() : زمینه‌ای که توسط این متد برگردانده می‌شود، به زبان‌های محلی هر برنامه احترام می‌گذارد.

    • ConfigurationCompat.setLocales() : برای API های فوق، برای تنظیم زبان پیکربندی.

سایر تغییرات API

  • اضافه شدن setLineHeight(unit, lineHeight) به کلاس‌های Compat مربوط TextView ( Ia9fa9 )
  • کلاس‌های Compat مربوط به تابع setLineHeight(unit, lineHeight) به TextView اضافه شد ( Ib2ee1 )
  • اضافه شدن setLineHeight(unit, lineHeight) به کلاس‌های Compat مربوط به TextView ( I15716 )

رفع اشکالات

  • AppCompatDialog اکنون به درستی LifecycleOwner ، SavedStateRegistryOwner و OnBackPressedDispatcherOwner را از طریق APIهای ViewTree روی نمای دکور دیالوگ تنظیم می‌کند و مشکلات مربوط به میزبانی ComposeView در AppCompatDialog را برطرف می‌کند. AppCompat اکنون به Activity 1.7.0 وابسته است. ( Ib28ab ، b/261314581 )
  • بهبود قابل توجه عملکرد SupportMenuInflater ( I0b087 )

نسخه ۱.۷.۰-آلفا۰۲

۸ فوریه ۲۰۲۳

androidx.appcompat:appcompat:1.7.0-alpha02 و androidx.appcompat:appcompat-resources:1.7.0-alpha02 منتشر شدند. نسخه 1.7.0-alpha02 شامل این کامیت‌ها است.

رفع اشکالات

  • نشت حافظه در AppCompatDelegate.getLocaleManagerForApplication() ( 44b57fd ) برطرف شد.
  • AppCompat اکنون به نسخه ۱.۵.۴ فرگمنت ( I54dcd ) وابسته است.

نسخه ۱.۷.۰-آلفا۰۱

۵ اکتبر ۲۰۲۲

androidx.appcompat:appcompat:1.7.0-alpha01 و androidx.appcompat:appcompat-resources:1.7.0-alpha01 منتشر شدند. نسخه 1.7.0-alpha01 شامل این کامیت‌ها است.

رفع اشکالات

  • AppCompatActivity اکنون ViewTreeOnBackPressedDispatcherOwner را طوری تنظیم می‌کند که بازیابی dispatcher از view امکان‌پذیر باشد. ( I1a115 , b/235416503 )
  • Locale.getDefault() اکنون پس از شروع سرد، زبان سیستم را برمی‌گرداند ( I6a94b )
  • LinearLayoutCompat اکنون پارامترهای طرح حاشیه ( Id2af4 ) را حفظ می‌کند.

نسخه ۱.۶.۱

نسخه ۱.۶.۱

۸ فوریه ۲۰۲۳

androidx.appcompat:appcompat:1.6.1 و androidx.appcompat:appcompat-resources:1.6.1 منتشر شدند. نسخه ۱.۶.۱ شامل این کامیت‌ها است.

رفع اشکالات

  • نشت حافظه در AppCompatDelegate.getLocaleManagerForApplication() ( 44b57fd ) برطرف شد.

نسخه ۱.۶.۰

نسخه ۱.۶.۰

۱۱ ژانویه ۲۰۲۳

androidx.appcompat:appcompat:1.6.0 و androidx.appcompat:appcompat-resources:1.6.0 منتشر شدند. نسخه ۱.۶.۰ شامل این کامیت‌ها است.

تغییرات مهم از زمان ۱.۵.۰

  • پشتیبانی برای سفارشی‌سازی زبان‌های برنامه اضافه شده است. برای اطلاعات بیشتر به AppCompatDelegate.setApplicationLocales(LocaleListCompat) مراجعه کنید. سازگاری معکوس را برای API تنظیمات هر زبان جدید موجود در اندروید ۱۳ فراهم می‌کند.
  • به‌روزرسانی‌های قابلیت نال‌پذیری برای هماهنگی با SDK اندروید ۱۳ (Tiramisu، API سطح ۳۳).
  • کلاس‌های Compat مربوط DrawableWrapper ، DrawableContainer و StateListDrawable به سطح API عمومی اضافه شدند.

نسخه ۱.۶.۰-rc01

۷ سپتامبر ۲۰۲۲

androidx.appcompat:appcompat:1.6.0-rc01 و androidx.appcompat:appcompat-resources:1.6.0-rc01 منتشر شدند. نسخه 1.6.0-rc01 شامل این کامیت‌ها است.

رفع اشکالات

  • AppCompatActivity اکنون ViewTreeOnBackPressedDispatcherOwner را طوری تنظیم می‌کند که بازیابی dispatcher از view امکان‌پذیر باشد. ( I1a115 , b/235416503 )
  • رفع اشکالی که پیکربندی ارسال شده به onConfigurationChanged را بازنویسی می‌کرد، و باعث ایجاد مشکلاتی برای آزمایش‌هایی می‌شد که پیکربندی‌های سفارشی خود را از طریق onConfigurationChanged تزریق می‌کردند، بازگردانده شد.

نسخه ۱.۶.۰-بتا۰۱

۱۰ آگوست ۲۰۲۲

androidx.appcompat:appcompat:1.6.0-beta01 و androidx.appcompat:appcompat-resources:1.6.0-beta01 منتشر شدند. نسخه 1.6.0-beta01 شامل این کامیت‌ها است.

تغییرات API

  • کلاس‌های Compat مربوط به DrawableWrapper ، DrawableContainer و StateListDrawable را به API عمومی ( I37f3e ، b/227789566 ) منتقل کنید.
  • یک کارخانه جدید برای inflater طرح‌بندی ناهمگام (async layout inflater) معرفی می‌کند. ( Ia657b )

رفع اشکالات

  • Toolbar اکنون قبل از نمایش منو، به جای اینکه بدون قید و شرط هنگام ایجاد منو نمایش داده شود، تابع onPrepareMenu() را فراخوانی می‌کند. ( I2a58d , b/232206677 )
  • AppCompat اکنون صریحاً به Lifecycle 2.5.1 و SavedState 1.2.0 وابسته است. ( I7e3e2 )
  • پشتیبانی از فراخوانی برگشتی به AppCompatDelegate و پیاده‌سازی نوار ابزار ارائه شده توسط AppCompat اضافه شد. ( I24062 )
  • نهایی‌سازی APIهای AppCompat برای نسخه ۱.۵.۰-بتا۰۱ ( I2a43d ، b/236866227 )
  • نهایی‌سازی APIهای AppCompat برای نسخه ۱.۵.۰-بتا۰۱ ( I2a43d ، b/236866227 )

نسخه ۱.۶.۰-آلفا۰۵

۱۵ ژوئن ۲۰۲۲

androidx.appcompat:appcompat:1.6.0-alpha05 و androidx.appcompat:appcompat-resources:1.6.0-alpha05 منتشر شدند. نسخه 1.6.0-alpha05 در یک شاخه خصوصی پیش از انتشار توسعه داده شده بود و هیچ کامیت عمومی ندارد.

تغییرات API

  • به‌روزرسانی‌های قابلیت نال‌پذیری برای هماهنگی با سطح نهایی API در Tiramisu Beta 3 SDK
  • minCompileSdk اکنون ۳۳ است تا با Tiramisu Beta 3 SDK هماهنگ شود.

نسخه ۱.۶.۰-آلفا۰۴

۱۸ مه ۲۰۲۲

androidx.appcompat:appcompat:1.6.0-alpha04 و androidx.appcompat:appcompat-resources:1.6.0-alpha04 منتشر شده‌اند. این کتابخانه بر اساس یک شاخه خصوصی پیش از انتشار توسعه داده شده است، بنابراین هیچ گزارش کامیت (commit log) در دسترس نیست.

تغییرات API

  • یک API اضافه کنید تا محدودیت عرض SwitchCompat را برای استفاده توسط MDC-Android لغو کند.

رفع اشکالات

  • از پیکربندی مدیریت‌شده هنگام تغییر پیکربندی خارج از attachBaseConfig اجتناب کنید

نسخه ۱.۶.۰-آلفا۰۳

۲۷ آوریل ۲۰۲۲

androidx.appcompat:appcompat:1.6.0-alpha03 و androidx.appcompat:appcompat-resources:1.6.0-alpha03 منتشر شدند.

این نسخه برای کامپایل شدن به اندروید ۱۳ بتا ۱ نیاز دارد و تضمینی برای سازگاری آن با پیش‌نمایش‌های توسعه‌دهندگان آینده وجود ندارد.

ویژگی‌های جدید

  • پشتیبانی از انتخاب زبان سفارشی در سراسر برنامه از طریق AppCompatDelegate.setApplicationLocales() . پیاده‌سازی پلتفرم را در API 33 و بالاتر واگذار می‌کند.

نسخه ۱.۶.۰-آلفا۰۱

۲۳ فوریه ۲۰۲۲

androidx.appcompat:appcompat:1.6.0-alpha01 و androidx.appcompat:appcompat-resources:1.6.0-alpha01 منتشر شدند. نسخه 1.6.0-alpha01 از یک شاخه داخلی ساخته شده بود و کامیت‌های قابل مشاهده عمومی ندارد.

این نسخه برای کامپایل شدن به Android Tiramisu DP1 نیاز دارد و تضمینی برای سازگاری زمان اجرا با پیش‌نمایش‌های توسعه‌دهندگان آینده وجود ندارد.

ویژگی‌های جدید

  • پشتیبانی برای سفارشی‌سازی زبان‌های برنامه اضافه شده است. برای اطلاعات بیشتر به AppCompatDelegate.setApplicationLocales(LocaleListCompat) مراجعه کنید. سازگاری معکوس را برای API تنظیمات هر زبان جدید موجود در اندروید ۱۳ فراهم می‌کند.

نسخه ۱.۵.۱

نسخه ۱.۵.۱

۷ سپتامبر ۲۰۲۲

androidx.appcompat:appcompat:1.5.1 و androidx.appcompat:appcompat-resources:1.5.1 منتشر شدند. نسخه ۱.۵.۱ شامل این کامیت‌ها است.

به‌روزرسانی‌های وابستگی

نسخه ۱.۵.۰

نسخه ۱.۵.۰

۱۰ آگوست ۲۰۲۲

androidx.appcompat:appcompat:1.5.0 و androidx.appcompat:appcompat-resources:1.5.0 منتشر شدند. نسخه ۱.۵.۰ شامل این کامیت‌ها است.

تغییرات مهم از زمان ۱.۴.۰

  • این نسخه پایدار شامل بهبودهایی در پایداری حالت شب، رفع اشکالات و پشتیبانی از رنگ‌آمیزی ترکیبی قابل ترسیم برای ویجت‌های متنی پشتیبانی‌شده توسط AppCompat و بهبودهایی در قابلیت استفاده از API است. برای فهرست دقیق تغییرات، به یادداشت‌های انتشار قبلی سری ۱.۵.۰ مراجعه کنید.

نسخه ۱.۵.۰-rc01

۲۷ ژوئیه ۲۰۲۲

androidx.appcompat:appcompat:1.5.0-rc01 و androidx.appcompat:appcompat-resources:1.5.0-rc01 منتشر شدند. نسخه 1.5.0-rc01 شامل این کامیت‌ها است.

رفع اشکالات

  • مشکلی که باعث می‌شد بسته‌بندی زمینه AppCompat از پیاده‌سازی منبع پشتیبان زمینه برنامه دوباره استفاده کند و در نتیجه uiMode روی زمینه برنامه رونویسی شود، برطرف شد ( Idf9d5 ).

نسخه ۱.۵.۰-بتا۰۱

۱۳ ژوئیه ۲۰۲۲

androidx.appcompat:appcompat:1.5.0-beta01 و androidx.appcompat:appcompat-resources:1.5.0-beta01 منتشر شدند. نسخه 1.5.0-beta01 شامل این کامیت‌ها است.

تغییرات API

  • برای غیرفعال کردن تنظیم پیش‌فرض عرض سوئیچ، یک پرچم قابل لغو اضافه کنید. ( I37cb7 )
  • اضافه کردن حاشیه‌نویسی @FloatRange به API دریافت‌کننده موقعیت انگشت شست ( If524c )
  • حاشیه‌نویسی‌های nullability که وجود ندارند را به AnimatedStateListDrawableCompat ( Ieb4ec ) اضافه کنید.

رفع اشکالات

  • نهایی‌سازی APIهای AppCompat برای نسخه ۱.۵.۰-بتا۰۱ ( I2a43d ، b/236866227 )
  • تغییر مقدار className برای ActionMenuItemView برای در نظر گرفتن آن به عنوان یک Button ( I5ee1c )

نسخه ۱.۵.۰-آلفا۰۱

۶ آوریل ۲۰۲۲

androidx.appcompat:appcompat:1.5.0-alpha01 و androidx.appcompat:appcompat-resources:1.5.0-alpha01 منتشر شدند. نسخه 1.5.0-alpha01 شامل این کامیت‌ها است.

تغییرات API

  • یک API جدید اضافه شد تا موقعیت شست سوئیچ را برای زیرکلاس‌ها ( I9bfb4 ) نمایش دهد.
  • قابلیت تهی‌سازی به‌روزرسانی شد تا با Tiramisu DP2 ( I0cbb7 ) مطابقت داشته باشد.
  • رنگ‌آمیزی ترکیبی drawable به ویجت‌های مشتق‌شده از TextView ( Idf98c ، b/165822337 ) بازگردانده شده است.
  • AppCompatDialog اکنون ComponentDialog برای سازگاری با OnBackPressedDispatcher ( Id9b91 ، b/217620781 ) گسترش می‌دهد.
  • SearchView.onQueryRefine() اکنون قابلیت مشاهده محافظت‌شده‌ای دارد تا امکان لغو ( I6cce0 ، b/212882845 ) فراهم شود.

رفع اشکالات

  • Toolbar AppCompat اکنون API onPrepareMenu() را به MenuHostHelper فرا می‌خواند. ( I9b9b5 , b/227376894 )
  • AppCompatEditText ، AppCompatAutoCompleteEditText و AppCompatMultiAutoCompleteEditText دیگر در سازنده (constructor) در صورت تنظیم در XML ( Ic5066 ، b/221094907 ) به صورت clickable یا longClickable بازنشانی نمی‌شوند.
  • AppCompatEditText ، AppCompatAutoCompleteTextView و AppCompatMultiAutoCompleteTextView در طول سازنده ( I5c13a ، b/208480173 ) setKeyListener که بازنویسی شده است را فراخوانی نمی‌کنند.
  • Appcompat نمونه‌های NumberKeyListener ارسالی به setKeyListener را در بر نمی‌گیرد و TextView اجازه می‌دهد تا به درستی زبان را در NumberKeyListeners پیکربندی کند ( Ibf113 ، b/207119921 ).
  • مشکل تمام زیرکلاس‌های NumberKeyListener که در AppCompat 1.4.0 معرفی شده بودند و اجازه می‌دادند کاراکترهای غیرمنتظره مانند علائم نگارشی وارد شوند، برطرف شد ( Iede7a ، b/207119921 )

نسخه ۱.۴.۲

نسخه ۱.۴.۲

۱ ژوئن ۲۰۲۲

androidx.appcompat:appcompat:1.4.2 و androidx.appcompat:appcompat-resources:1.4.2 منتشر شدند. نسخه ۱.۴.۲ شامل این کامیت‌ها است.

رفع اشکالات

  • رفع مشکل کرش کردن AppCompatDelegateImpl که قبل از ایجاد نوار اکشن ( aosp/2048349 ، b/226648941 ) یک فراخوانی داخلی برای ensureSubDecor انجام می‌داد.

نسخه ۱.۴.۱

۱۲ ژانویه ۲۰۲۲

androidx.appcompat:appcompat:1.4.1 و androidx.appcompat:appcompat-resources:1.4.1 منتشر شدند. نسخه ۱.۴.۱ شامل این کامیت‌ها است.

رفع اشکالات

  • AppCompatEditText ، AppCompatAutoCompleteTextView و AppCompatMultiAutoCompleteTextView در طول سازنده، setKeyListener بازنویسی‌شده را فراخوانی نمی‌کنند. ( I5c13a ، b/208480173 )
  • Emoji2 نمونه‌هایی از NumberKeyListener را در بر نمی‌گیرد و به زبان اجازه می‌دهد تا توسط textview پیکربندی شود.
    • Appcompat نمونه‌های NumberKeyListener ارسالی به setKeyListener را در بر نمی‌گیرد و TextView اجازه می‌دهد تا به درستی زبان را روی NumberKeyListeners پیکربندی کند. ( Ibf113 , b/207119921 )
  • مشکل مربوط به تمام زیرکلاس‌های NumberKeyListener که در appcompat 1.4.0 معرفی شده بودند و اجازه می‌دادند کاراکترهای غیرمنتظره مانند علائم نگارشی (b/207119921) به عنوان ورودی وارد شوند ( Iede7a ، b/207119921 ) را برطرف کرد.

نسخه ۱.۴.۰

نسخه ۱.۴.۰

۱۷ نوامبر ۲۰۲۱

androidx.appcompat:appcompat:1.4.0 و androidx.appcompat:appcompat-resources:1.4.0 منتشر شدند. نسخه ۱.۴.۰ شامل این کامیت‌ها است.

تغییرات مهم از زمان ۱.۳.۰

  • کتابخانه اکنون سطح زبان جاوا ۸ را هدف قرار داده است
  • پشتیبانی از ایموجی‌های قابل به‌روزرسانی به طور پیش‌فرض از طریق کتابخانه androidx.emoji2 فعال است.
  • بهبود بازرسی ویژگی‌ها در Layout Inspector اندروید استودیو ( I02d55 )
  • پشتیبانی از منابع رنگی تو در تو و فایل‌های قابل ترسیم برداری در بارگذاری منابع AppCompat در backports اضافه شده است. با این حال، توجه داشته باشید که این بدان معناست که برنامه‌ها نمی‌توانند getDrawable() را روی یک شیء Resources سفارشی، زمانی که backports فعال هستند، لغو کنند. ( Ia6b03 , b/176129022 )
  • پس‌زمینه‌ی رنگیِ بک‌پورت شده و علامت تیک برای CheckedTextView ( I8575c )

نسخه ۱.۴.۰-rc01

۲۷ اکتبر ۲۰۲۱

androidx.appcompat:appcompat:1.4.0-rc01 و androidx.appcompat:appcompat-resources:1.4.0-rc01 منتشر شدند. نسخه 1.4.0-rc01 شامل این کامیت‌ها است.

نسخه ۱.۴.۰-بتا۰۱

۲۹ سپتامبر ۲۰۲۱

androidx.appcompat:appcompat:1.4.0-beta01 و androidx.appcompat:appcompat-resources:1.4.0-beta01 منتشر شدند. نسخه 1.4.0-beta01 شامل این کامیت‌ها است.

تغییرات API

  • Toolbar AndroidX AppCompat اکنون یک MenuHost است و می‌تواند MenuProvider را مدیریت کند. ( I5cd95 )

رفع اشکالات

  • رفع مشکل مدیریت نوارهای پیشرفت لیست لایه‌ها در AppCompatProgressBar ( I6ece3 ، b/142004509 )
  • به درستی android:digits در AppCompatEditText حفظ کنید، این کار اشکال 193047889 که در AppCompat 1.4.0-alpha03 معرفی شده بود را برطرف می‌کند. ( I4b4fc ، b/193047889 )
  • کیت توسعه نرم‌افزاری یکپارچه OnReceiveContentListener و پشتیبانی از APIهای کتابخانه‌ای ( Ic6914 ، b/173814913 )

نسخه ۱.۴.۰-آلفا۰۳

۳۰ ژوئن ۲۰۲۱

androidx.appcompat:appcompat:1.4.0-alpha03 و androidx.appcompat:appcompat-resources:1.4.0-alpha03 منتشر شدند. نسخه 1.4.0-alpha03 شامل این کامیت‌ها است.

ویژگی‌های جدید

  • کتابخانه اکنون سطح زبان جاوا ۸ را هدف قرار داده است
  • پشتیبانی از emoji2 را برای زیرکلاس‌های TextView بیشتر ( AppCompatMultiAutoCompleteTextView ، AppCompatAutoCompleteTextView ، AppCompatRadioButton ، AppCompatCheckBox ) اضافه کنید.

تغییرات API

  • یک API برای پیکربندی InputConnection اضافه شد تا از View.performReceiveContent برای مدیریت فراخوانی‌های IME به InputConnection.commitContent استفاده کند. ( I3a2ad )
  • اضافه کردن پشتیبانی برای EmojiCompat به AppCompatMultiAutoCompleteTextView ( Ifece0 )
  • اضافه کردن پشتیبانی از EmojiCompat به AppCompatAutoCompleteTextView ( Ia1f4b )
  • اضافه کردن پشتیبانی از EmojiCompat به AppCompatRadioButton ( If08af )
  • اضافه کردن پشتیبانی از EmojiCompat به AppCompatCheckBox ( I2b3bc )
  • اجازه دادن به null KeyListener در AppCompatEditText . این کار حاشیه‌نویسی غیرتهی که در نسخه ۱.۴-alpha01 به AppCompatEditText اضافه شده بود را معکوس می‌کند و رفتار قبلی هنگام ارسال null را بازیابی می‌کند. ( I21482 , b/189559345 )
  • برای ایجاد توازن با APIهای پلتفرم ( I43bb3 ، b/182789798 ) PopupMenu.setForceShowIcon را اضافه کنید.

رفع اشکالات

  • رفع اشکال در AppCompatEditText که نوع ورودی مشخص شده در XML را برای حذف تغییرات بازنشانی می‌کند. این اشکال در AppCompat 1.4.0-alpha01 معرفی شد. ( I9df36 ، b/191061070 )

نسخه ۱.۴.۰-آلفا۰۲

۲ ژوئن ۲۰۲۱

androidx.appcompat:appcompat:1.4.0-alpha02 و androidx.appcompat:appcompat-resources:1.4.0-alpha02 منتشر شدند. نسخه 1.4.0-alpha02 شامل این کامیت‌ها است.

تغییرات API

  • سازنده‌ی AppCompatDialogFragment اضافه شد که یک شناسه‌ی طرح‌بندی ( Icbf22 ، b/188119987 ) می‌گیرد.
  • پشتیبانی بهبود یافته از بازرس طرح ( I02d55 )
  • نام بسته در emoji2-views-helper به androidx.emoji2.viewsintegration تغییر یافت. این یک تغییر اساسی برای AppCompat 1.4.0-alpha01 است و برنامه‌ها باید اطمینان حاصل کنند که وابستگی AppCompat برای استفاده از نسخه جدید emoji2 ( Ie8397 ) به‌روزرسانی شده است.

رفع اشکالات

  • مشکلی که باعث می‌شد فعالیت‌های متوقف‌شده، تغییرات پیکربندی را از تغییرات حالت شبِ ابزار AppCompat دریافت نکنند، برطرف شد. ( I8fa8f ، b/188681415 )
  • اشکال موجود در AppCompatEditText که باعث می‌شد نماها حتی زمانی که android:focusable="false" در xml مشخص شده بود، قابل فوکوس باشند، برطرف شد (اشکالی که در AppCompat 1.4.0-alpha01 معرفی شد) ( Ib9412 )

نسخه ۱.۴.۰-آلفا۰۱

۱۸ مه ۲۰۲۱

androidx.appcompat:appcompat:1.4.0-alpha01 و androidx.appcompat:appcompat-resources:1.4.0-alpha01 منتشر شدند. نسخه 1.4.0-alpha01 شامل این کامیت‌ها است.

تغییرات API

  • پشتیبانی یکپارچه از EmojiCompat برای انواع ویجت‌های AppCompat ( Id409b ، If7a1a ، Ic262d ، Ib5f4a ، I4fb3c )
  • پشتیبانی از منابع رنگی تو در تو و فایل‌های قابل ترسیم برداری در بارگذاری منابع AppCompat در backports اضافه شده است. با این حال، توجه داشته باشید که این بدان معناست که برنامه‌ها نمی‌توانند getDrawable() را روی یک شیء Resources سفارشی، زمانی که backports فعال هستند، لغو کنند. ( Ia6b03 , b/176129022 )
  • پشتیبانی بهبود یافته از بازرس طرح ( I6d771 )

رفع اشکالات

  • مشکلی که باعث می‌شد فراخوانی setSupportActionBar پس از تنظیم تابع فراخوانی پنجره، روی تابع فراخوانی قبلی بازنویسی شود، برطرف شد ( Ie43ee ، b/186791590 ).
  • یک راه حل برای مشکلی در SDK های 29 و 30 اضافه شد که در آن منابع ColorStateListDrawable که از حافظه نهان drawable کپی شده‌اند، تا زمانی که تغییر وضعیت دریافت نکنند، رنگ پیش‌فرض را بارگذاری نمی‌کنند. ( Iedb4b )
  • هنگام مدیریت فراخوانی‌های حالت اکشن انتخاب سفارشی تهی در نماهای پشتیبانی‌شده با AppCompat، از NPE اجتناب کنید. ( I033c7 ، b/173435375 )

به‌روزرسانی‌های وابستگی

مشارکت خارجی

  • بک‌پورت پس‌زمینه‌ی رنگی و علامت تیک برای CheckedTextView ( I8575c )

نسخه ۱.۳.۱

نسخه ۱.۳.۱

۲۱ ژوئیه ۲۰۲۱

androidx.appcompat:appcompat:1.3.1 و androidx.appcompat:appcompat-resources:1.3.1 منتشر شدند. نسخه ۱.۳.۱ شامل این کامیت‌ها است.

به‌روزرسانی‌های وابستگی

  • AppCompat اکنون به Activity 1.2.4 و Fragment 1.3.6 وابسته است و باعث می‌شود اصلاحات مربوط به آن نسخه‌ها به طور پیش‌فرض هنگام استفاده از AppCompat 1.3.1 لحاظ شوند. ( I8fbec )

نسخه ۱.۳.۰

نسخه ۱.۳.۰

۱۸ مه ۲۰۲۱

androidx.appcompat:appcompat:1.3.0 و androidx.appcompat:appcompat-resources:1.3.0 منتشر شدند. نسخه ۱.۳.۰ شامل این کامیت‌ها است.

تغییرات مهم از زمان ۱.۲.۰

  • انتشار ثابت ویژگی‌های android:theme در طرح‌بندی‌های <include> d در دستگاه‌های قبل از Lollipop
  • کاهش حجم کتابخانه با تبدیل بسیاری از منابع PNG به VectorDrawables
  • پشتیبانی از رویدادهای کشیدن و رها کردن به AppCompatEditText با OnReceiveContentListener اضافه شد
  • برای پشتیبانی از تغییرات در مدیریت درج پنجره در اندروید ۱۱ به‌روزرسانی شد
  • پشتیبانی از RTL در آیتم‌های منو با آیکون‌ها اضافه شد
  • پشتیبانی از درج محتوای غنی (مثلاً چسباندن تصویر) در AppCompatEditText اضافه شد

  • وابستگی‌های به‌روزرسانی‌شده : appcompat بسیاری از وابستگی‌های انتقالی خود را برای پشتیبانی از قابلیت‌ها و اصلاحات جدید به‌روزرسانی کرد:

نسخه ۱.۳.۰-rc01

۲۴ مارس ۲۰۲۱

androidx.appcompat:appcompat:1.3.0-rc01 و androidx.appcompat:appcompat-resources:1.3.0-rc01 منتشر شدند. نسخه 1.3.0-rc01 شامل این کامیت‌ها است.

رفع اشکالات

  • از لغو زودهنگام مجوزها هنگام مدیریت درج محتوای IME جلوگیری می‌کند.

به‌روزرسانی‌های وابستگی

مشارکت خارجی

  • رفع مشکل انتشار ویژگی android:theme در طرح‌بندی‌های <include> d در دستگاه‌های قبل از Lollipop (سیمون برگنر در اپرا)

نسخه ۱.۳.۰-بتا۰۱

۱۳ ژانویه ۲۰۲۱

androidx.appcompat:appcompat:1.3.0-beta01 و androidx.appcompat:appcompat-resources:1.3.0-beta01 منتشر شدند. نسخه 1.3.0-beta01 شامل این کامیت‌ها است.

ویژگی‌های جدید

  • فایل‌های قابل ترسیم حالت اکشن سطح تم با منابع برداری جایگزین شده‌اند. این ممکن است باعث تغییرات جزئی در ظاهر بصری آیکون‌های منفرد شود. ( I741a6 )

تغییرات API

  • قابلیت کشیدن و رها کردن (drop events) در AppCompatEditText با OnReceiveContentListener یکپارچه شده است. ( Ib26c9 , b/175343405 )
  • به‌روزرسانی OnReceiveContentListener و APIهای مرتبط. برای جزئیات بیشتر به تغییرات کتابخانه androidx.core مراجعه کنید. ( Ib4616 ، b/173814913 )
  • widget.RichContentReceiverCompat به view.OnReceiveContentListener منتقل شد. ( Ifdab7 , b/173814913 )
  • رابط‌های برنامه‌نویسی کاربردی (API) برای تهیه و بازیابی متن اولیه پیرامونی به EditorInfoCompat بک‌پورت شده‌اند. آن‌ها به برنامه‌های IME اجازه می‌دهند از تأخیر IPC اضافی جلوگیری کنند. ( Ie3809 )

نسخه ۱.۳.۰-آلفا۰۲

۱۹ آگوست ۲۰۲۰

androidx.appcompat:appcompat:1.3.0-alpha02 و androidx.appcompat:appcompat-resources:1.3.0-alpha02 منتشر شدند. نسخه 1.3.0-alpha02 شامل این کامیت‌ها است.

رفع اشکالات

  • فایل‌های قابل ترسیم PNG مربوط به AppCompatRatingBar با منابع برداری جایگزین شده‌اند. این ممکن است باعث تغییرات جزئی در ظاهر بصری ستاره‌های منفرد شود. ( I6b99d )
  • به‌روزرسانی WindowInsetsCompat به APIهای اندروید ۱۱ ( I3df9e )
  • پشتیبانی از RTL در آیتم‌های منو با آیکون‌ها ( I2f5c5 )

به‌روزرسانی‌های وابستگی

  • AppCompat وابستگی خود را از Fragment 1.1.0 به Fragment 1.3.0-alpha08 به‌روزرسانی کرده است. اکیداً توصیه می‌شود که یادداشت‌های انتشار Fragment 1.2.0 را مطالعه کنید تا تغییرات عمده معرفی شده در نسخه قبلی Fragment را درک کنید.
  • AppCompat وابستگی خود را از Activity 1.0.0 به Activity 1.2.0-alpha08 به‌روزرسانی کرده است. اکیداً توصیه می‌شود که یادداشت‌های انتشار Activity 1.1.0 را مطالعه کنید تا تغییرات عمده معرفی شده در نسخه قبلی Activity را درک کنید.
    • AppCompatActivity اکنون از رابط برنامه‌نویسی کاربردی OnContextAvailableListener که در Activity 1.2.0-alpha08 معرفی شد، برای راه‌اندازی AppCompatDelegate استفاده می‌کند. هر شنونده‌ای که به زیرکلاس‌های AppCompatActivity اضافه شود، پس از این شنونده اجرا خواهد شد. ( I513da )

نسخه ۱.۳.۰-آلفا۰۱

۲۰ مه ۲۰۲۰

androidx.appcompat:appcompat:1.3.0-alpha01 و androidx.appcompat:appcompat-resources:1.3.0-alpha01 منتشر شدند. نسخه 1.3.0-alpha01 شامل این کامیت‌ها است.

ویژگی‌های جدید

  • یک قانون Lint جدید برای علامت‌گذاری فراخوانی‌های setActionBar در فعالیت‌هایی که AppCompatActivity را بسط می‌دهند، اضافه کنید.
  • پشتیبانی از ViewTreeLifecycleOwner از Lifecycle 2.3.0-alpha01 ، ViewTreeViewModelStoreOwner از Lifecycle 2.3.0-alpha03 و ViewTreeSavedStateRegistryOwner از SavedState 1.1.0-alpha01 هنگام استفاده از یک View درون AppCompatActivity اضافه شد. ( b/151603528 ، aosp/1300264 )
  • API مشترکی برای درج محتوای غنی (مثلاً چسباندن یک تصویر) اضافه کنید. فراخوانی جدید، یک API واحد ارائه می‌دهد که برنامه‌ها می‌توانند آن را برای پشتیبانی از روش‌های مختلف درج محتوای غنی پیاده‌سازی کنند. در حال حاضر، این API فقط به AppCompatEditText اضافه شده و برای مسیرهای کد زیر فراخوانی خواهد شد:
    • چسباندن از کلیپ بورد
    • درج محتوا از IME ( InputConnection.commitContent ) ( I22bf7 )

رفع اشکالات

  • از AppCompat 1.2.0-rc01 : AppCompat دیگر تابع onMenuOpened() را با منوی null فراخوانی نمی‌کند. ( b/142843126 )
  • به درستی لینک متن و رنگ‌های راهنما را در دستگاه‌های قدیمی‌تر، زمانی که TextViewCompat.setTextAppearance با یک سبک ظاهر متن فراخوانی می‌شود که دارای لیست‌های حالت رنگ است که به ویژگی‌های رنگ تم اشاره دارند ( b/154702995 )

نسخه ۱.۲.۰

نسخه ۱.۲.۰

۵ آگوست ۲۰۲۰

androidx.appcompat:appcompat:1.2.0 و androidx.appcompat:appcompat-resources:1.2.0 منتشر شدند. نسخه ۱.۲.۰ شامل این کامیت‌ها است.

تغییرات عمده از زمان ۱.۱.۰

  • پشتیبانی از موارد استفاده از لغو پیکربندی، شامل زبان‌های سفارشی و مقیاس‌های فونت، برطرف شد. برای مثالی از نحوه پیاده‌سازی صحیح لغوها با استفاده از appcompat:1.2.0 به اینجا مراجعه کنید.
  • AppCompatDelegate.attachBaseContext() منسوخ شده است. اگر این متد را فراخوانی یا override می‌کنید، به جای آن AppCompatDelegate.attachBaseContext2() استفاده کنید.
  • CollapsibleActionView منسوخ شده است. این رابط دیگر مورد نیاز نیست، از رابط android.view.CollapsibleActionView ارائه شده توسط پلتفرم استفاده کنید.

نسخه ۱.۲.۰-rc02

۲۲ ژوئیه ۲۰۲۰

androidx.appcompat:appcompat:1.2.0-rc02 و androidx.appcompat:appcompat-resources:1.2.0-rc02 منتشر شدند. نسخه 1.2.0-rc02 شامل این کامیت‌ها است.

رفع اشکالات

  • مشکلی مربوط به حالت شب که در آن فراخوانی AppCompatDelegate.setDefaultNightMode از یک پنجره محاوره‌ای، گاهی اوقات در ایجاد مجدد فعالیت‌ها و اعمال حالت جدید با شکست مواجه می‌شد، برطرف شد. ( aosp/1348308 , b/158923881 )

نسخه ۱.۲.۰-rc01

۱۴ مه ۲۰۲۰

androidx.appcompat:appcompat:1.2.0-rc01 و androidx.appcompat:appcompat-resources:1.2.0-rc01 منتشر شدند. نسخه 1.2.0-rc01 شامل این کامیت‌ها است.

تغییرات API

  • به دلیل مشکل پلتفرم در مورد نشت تغییرات پیکربندی بین اکتیویتی‌ها در SDKهای قدیمی‌تر AppCompatDelegate.setLocalNightMode به عنوان فایلی که نیاز به SDK نسخه ۱۷ یا بالاتر دارد، علامت‌گذاری شده است.

رفع اشکالات

  • اکنون می‌توان AppCompatDelegate.setLocalNightMode قبل از Activity.attachBaseContext فراخوانی کرد.
  • مشکل مصرف inset ActionBarOverlayLayout که به اشتباه از insetهای ذخیره شده استفاده می‌کرد، برطرف شد.
  • AppCompat دیگر با منوی null menu) تابع onMenuOpened() را فراخوانی نمی‌کند. ( b/142843126 )

نسخه ۱.۲.۰-بتا۰۱

۱ آوریل ۲۰۲۰

androidx.appcompat:appcompat:1.2.0-beta01 و androidx.appcompat:appcompat-resources:1.2.0-beta01 منتشر شدند. نسخه 1.2.0-beta01 شامل این کامیت‌ها است.

ویژگی‌های جدید

  • قوانین جدید lint زیر اضافه شده‌اند که کاربردهای نادرست AppCompat را در سناریوهای زیر علامت‌گذاری می‌کنند:
    • بارگیری لیست‌های وضعیت رنگ: پیشنهاد می‌کند از APIهای ContextCompat و AppCompatResources برای سازگاری با نسخه‌های قبلی استفاده شود
    • بارگذاری drawableها: پیشنهاد می‌کند برای سازگاری با نسخه‌های قبلی از APIهای ContextCompat و ResourcesCompat استفاده شود.
    • استفاده از لیست‌های وضعیت رنگ با ویژگی آلفا: پرچم‌هایی که ویژگی android:alpha را ندارند که منجر به نمایش نادرست در برخی نسخه‌های پلتفرم می‌شود.
    • رنگ‌آمیزی نماهای تصویر: پرچم‌هایی که app:tint استفاده نمی‌کنند و منجر به نمایش نادرست در نسخه‌های قدیمی‌تر پلتفرم می‌شوند.
    • استفاده از drawableهای مرکب و رنگ‌آمیزی روی نماهای متنی: پیشنهاد می‌کند از ویژگی‌های compat و APIها برای سازگاری با نسخه‌های قبلی استفاده شود.

رفع اشکالات

  • مشکلی که باعث می‌شد ActionBarOverlayLayout (عملیات تزئین پنجره) به درستی WindowInsets را ارسال نکند، برطرف شد.
  • مشکلات مربوط به رنگ‌آمیزی فایل‌های قابل ترسیم و ظاهر متن در نسخه‌های قدیمی‌تر پلتفرم برطرف شد.
  • مشکلی که باعث می‌شد androidx.appcompat:appcompat:1.1.0 هنگام نگه داشتن طولانی مدت webview، webview را از کار بیندازد، برطرف شد ( b/141351441 )
  • رفع مشکلات مربوط به دستکاری زمینه پایه و بازیابی سرویس‌های سیستم در هنگام راه‌اندازی فعالیت، پیاده‌سازی شد.

نسخه ۱.۲.۰-آلفا۰۳

۴ مارس ۲۰۲۰

androidx.appcompat:appcompat:1.2.0-alpha03 و androidx.appcompat:appcompat-resources:1.2.0-alpha03 منتشر شدند. نسخه 1.2.0-alpha03 شامل این کامیت‌ها است.

رفع اشکالات

  • مشکلی که باعث می‌شد محافظ وضعیت حالت اکشن به اشتباه به نوار ناوبری گسترش یابد و رنگ اشتباهی داشته باشد ( Ia4a09 ) برطرف شد.
  • رفع مشکل عدم از سرگیری فعالیت‌های متوقف‌شده در API سطح ۲۳ و پایین‌تر ( I45201 )

نسخه ۱.۲.۰-آلفا۰۲

۲۹ ژانویه ۲۰۲۰

androidx.appcompat:appcompat:1.2.0-alpha02 و androidx.appcompat:appcompat-resources:1.2.0-alpha02 منتشر شدند. نسخه 1.2.0-alpha02 شامل این کامیت‌ها است .

رفع اشکالات

  • مشکل کرش کردن webview در appcompat 1.1.0 هنگام لمس طولانی مدت ( b/141351441 ) برطرف شد.
  • مشکل تغییر رنگ فایل‌های drawable در TextView نسبت به فایل‌های drawable مرکب در API سطح ۲۳ ( aosp/1172194 ) برطرف شد.
  • اطمینان حاصل شد که زمینه پایه همیشه یک پوشش ( aosp/1194355 ) است.
  • برخی بهبودها برای هوشمندتر شدن هنگام تغییر پیکربندی زمینه پایه ( aosp/1204543 ) اضافه شد.
  • تابع createConfigurationContext() برای Robolectric غیرفعال شد ( aosp/1186218 )

نسخه ۱.۲.۰-آلفا۰۱

۴ دسامبر ۲۰۱۹

androidx.appcompat:appcompat:1.2.0-alpha01 و androidx.appcompat:appcompat-resources:1.2.0-alpha01 منتشر شدند. نسخه 1.2.0-alpha01 شامل این کامیت‌ها است .

رفع اشکالات

  • فراخوانی‌های PackageManager.getActivityInfo دیگر در حالت strict با فعال بودن بررسی‌های boot-aware از کار نمی‌افتند.
  • رفع مشکل رنگ‌آمیزی فایل‌های drawable در AppCompatButton
  • رفع مشکل رنگ‌آمیزی و ظاهر متن در نسخه‌های قدیمی‌تر پلتفرم

نسخه ۱.۱.۰

نسخه ۱.۱.۰

۵ سپتامبر ۲۰۱۹

androidx.appcompat:appcompat:1.1.0 و androidx.appcompat:appcompat-resources:1.1.0 منتشر شدند. کامیت‌های موجود در این نسخه را می‌توانید اینجا پیدا کنید.

تغییرات مهم از زمان ۱.۰.۰

  • بهبودهای حالت تاریک : MODE_NIGHT_AUTO و تغییر حالت تاریک/روشن بر اساس زمان فعلی اکنون منسوخ شده است. استفاده از یک تنظیم صریح یا MODE_NIGHT_AUTO_BATTERY در نظر گرفته شده است.
  • Activity 1.0 : AppCompatActivity اکنون به صورت انتقالی از ComponentActivity از Activity 1.0.0 از طریق Fragment 1.1.0 امتداد می‌یابد. برای اطلاعات مربوط به تغییرات در هر کتابخانه، به یادداشت‌های انتشار مرتبط مراجعه کنید.
  • سازنده‌ی AppCompatActivity LayoutId : زیرکلاس‌های AppCompatActivity اکنون می‌توانند به صورت اختیاری یک سازنده در AppCompatActivity را فراخوانی کنند که یک شناسه‌ی R.layout می‌گیرد و نشان‌دهنده‌ی چیدمانی است که باید به عنوان نمای محتوا تنظیم شود، به عنوان جایگزینی برای فراخوانی setContentView() در onCreate() . این الزام که زیرکلاس شما باید یک سازنده‌ی بدون آرگومان داشته باشد را تغییر نمی‌دهد.

نسخه ۱.۱.۰-rc01

۲ ژوئیه ۲۰۱۹

androidx.appcompat:appcompat:1.1.0-rc01 و androidx.appcompat:appcompat-resources:1.1.0-rc01 منتشر شدند. کامیت‌های موجود در این نسخه را می‌توانید اینجا پیدا کنید.

رفع اشکالات

  • DayNight اکنون configChanges به درستی تشخیص می‌دهد ( aosp/981105 )
  • فقط در فعالیت‌های آغاز شده ( aosp/987483 ) فراخوانی onConfigurationChanged

نسخه ۱.۱.۰-بتا۰۱

۵ ژوئن ۲۰۱۹

androidx.appcompat:appcompat:1.1.0-beta01 و androidx.appcompat:appcompat-resources:1.1.0-beta01 منتشر شدند. کامیت‌های موجود در این نسخه را می‌توانید اینجا پیدا کنید.

رفع اشکالات

  • مطمئن شوید که گیرنده‌ها را در AppCompatDialogs ( aosp/959376 ) پاک‌سازی می‌کنیم.
  • اضافه شدن پشتیبانی برای buttonGravity=center_vertical در نوار ابزار ( b/130361721 )
  • رفع انحراف افقی اسپینر ( b/79477181 )

نسخه ۱.۱.۰-آلفا۰۵

۷ مه ۲۰۱۹

androidx.appcompat:appcompat:1.1.0-alpha05 و androidx.appcompat:appcompat-resources:1.1.0-alpha05 منتشر شدند. کامیت‌های موجود در این نسخه را می‌توانید اینجا پیدا کنید.

ویژگی‌های جدید

رفع اشکالات

  • رفع مشکلات مختلف حالت DayNight
  • نامعتبر کردن طرح کلی در هرگونه تغییر پس‌زمینه در ActionBar
  • رفع مشکل اسکرول ویجت اسپینر
  • رفع مشکل لغو شدن پس‌زمینه‌های پنجره‌های تنظیم‌شده سفارشی در AlertDialog

نسخه ۱.۱.۰-آلفا۰۴

۳ آوریل ۲۰۱۹

androidx.appcompat:appcompat:1.1.0-alpha04 و androidx.appcompat:appcompat-resources:1.1.0-alpha04 منتشر شدند. کامیت‌های موجود در این نسخه را می‌توانید اینجا پیدا کنید.

ویژگی‌های جدید

  • خانواده‌ی جدید تم‌های ThemeOverlay.AppCompat.DayNight اضافه شد. این تم‌ها باید هنگام استفاده از ویژگی DayNight استفاده شوند.

تغییرات API

  • AppCompatActivity اکنون شامل یک سازنده دوم است که یک @LayoutRes int می‌گیرد، که جایگزین رفتار قبلی حاشیه‌نویسی کلاس AppCompatActivity شما با @ContentView می‌شود. این رویکرد در هر دو ماژول app و library کار می‌کند. ( b/128352521 )

رفع اشکالات

  • در صورت امکان، وابستگی‌های داخلی را به نسخه‌های پایدار پین کرد
  • رفع مشکل اسکرول AppCompatSpinner در حالت کشویی ( b/124274573 )
  • فقط در صورت نیاز برای DayNight، تابع applyOverrideConfiguration() ‎ فراخوانی می‌شود.

نسخه ۱.۱.۰-آلفا۰۳

۱۳ مارس ۲۰۱۹

androidx.appcompat:appcompat:1.1.0-alpha03 and androidx.appcompat:appcompat-resources:1.1.0-alpha03 are released. This is the first release of appcompat-resources . The full list of commits included in this version can be found here .

ویژگی‌های جدید

  • The new appcompat-resources library contains APIs that allow apps to load and tint drawables (including vector drawables) on older versions of the platform. This is the same functionality that was previously part of the appcompat module, but is now available without the overhead of the full appcompat backport of Material design that includes widgets, dialogs, night mode etc.
  • Major fixes to DayNight mode support
  • New MODE_NIGHT_AUTO_BATTERY option for DayNight mode
  • Drawable tinting in AppCompatTextView
  • Toolbar overflow can now be styled with themed color state lists
  • Menu icons can now use colors that reference theme attributes
  • The new app:menu attribute can be set on a Toolbar to provide the menu content at inflation time

رفع اشکالات

  • Fixed default tint mode on ImageView on version 21
  • Fixed spinner popup incorrect dismissal on device rotation
  • Fixed DayNight does not respect configChanges in manifest
  • Fixed switching to MODE_NIGHT_FOLLOW_SYSTEM doesn't work ( b/111345020 )
  • Fixed WebView resets DayNight Resources ( b/37124582 )

نسخه ۱.۱.۰-آلفا۰۲

February 7, 2019

androidx.appcompat:appcompat 1.1.0-alpha02 is released.

ویژگی‌های جدید

  • Extracted resource-specific drawable handling into a hook ( aosp/870976 )
  • Allowed Toolbar titleTextColor and subtitleTextColor to use a ColorStateList and added ColorStateList overloads of the setTitleTextColor and setSubtitleTextColor methods ( aosp/867489 )

رفع اشکالات

  • Fixed fontFamily not working on pre API 24 ( aosp/807054 )
  • Fixed bug where textFontWeight did not work when an activity extends from AppCompatActivity ( aosp/847640 )
  • Fixed bug that caused the title text on the spinner widget popup (when using dialog mode) to not use the font specified in the fontFamily ( aosp/789994 )
  • Fix bug that prevented widgets AppCompatCheckBox and AppCompatRadioButton from be able to change the background tint ( aosp/825160 )
  • Fixed bug where AppCompat did not override android: list styles ( aosp/862350 )

نسخه ۱.۱.۰-آلفا۰۱

December 3, 2018

ویژگی‌های جدید

  • AppCompatTextView now supports app:drawableLeftCompat , app:drawableTopCompat , app:drawableRightCompat , app:drawableBottomCompat , app:drawableStartCompat and app:drawableEndCompat compound drawables, supporting backported drawable types such as VectorDrawableCompat .

  • AppCompatCheckBox and AppCompatRadioButton 's default drawables now animate check state changes.

تغییرات API

  • aosp/740385 : ActionBarOverlayLayout now implements NestedScrollingParent2 and NestedScrollingParent3, enabling it to facilitate the latest functionality in nested scrolling 3. If developer code currently overrides ActionBarOverLayLayout.onNestedScroll(View, int, int, int, int) , it will likely no longer be called and ActionBarOverLayLayout.onNestedScroll(View, int, int, int, int, int, int[]) should be overridden instead.

نسخه ۱.۰.۲

نسخه ۱.۰.۲

November 7, 2018

Bugfix release of core-1.0.1 and appcompat-1.0.2 .

رفع اشکالات

  • Fixed bug where PrecomputedTextCompat would crash when used with RTL AppCompatTextView . b/113070424

نسخه ۱.۰.۰

نسخه ۱.۰.۰

November 7, 2018

ویژگی‌های جدید