طرح هماهنگ کننده

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

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

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

dependencies {
    implementation "androidx.coordinatorlayout:coordinatorlayout:1.3.0"
}

dependencies {
    implementation("androidx.coordinatorlayout:coordinatorlayout:1.3.0")
}

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

بازخورد

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

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

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

نسخه ۱.۳

نسخه ۱.۳.۰

۲۶ فوریه ۲۰۲۵

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

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

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

• پشتیبانی از رویدادهای کلیدی بالا بردن صفحه، پایین آوردن صفحه، رفتن به خانه و پایان دادن به صفحه را اضافه می‌کند. ( 14719d3 )
• دموهایی از RecyclerView در یک CoordinatorLayout با نوار برنامه جمع‌شونده و PreferenceScreen در یک CoordinatorLayout با نوار برنامه جمع‌شونده اضافه می‌کند. ( fca56e0 ، I4c679 )

رفع اشکالات

• عملکردهای صفحه کلید با قابلیت بالا، پایین، فاصله و تغییر کلید را با NestedScrollView در یک CoordinatorLayout برطرف می‌کند. ( I216f4 )
• رفع مشکل جمع شدن صحیح نوار برنامه (App Bar) با کیبورد، زمانی که از recyclerview درون CoordinatorLayout استفاده می‌شود. ( I7eac4 )

نسخه ۱.۳.۰-rc01

۱۲ فوریه ۲۰۲۵

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

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

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

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

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

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

androidx.coordinatorlayout:coordinatorlayout:1.3.0-alpha03 منتشر شد. نسخه 1.3.0-alpha03 شامل این کامیت‌ها است.

رفع اشکالات

• این کتابخانه اکنون از حاشیه‌نویسی‌های nullness از نوع JSpecify استفاده می‌کند که از نوع type-use هستند. توسعه‌دهندگان کاتلین باید از آرگومان کامپایلر زیر برای اعمال استفاده صحیح استفاده کنند: -Xjspecify-annotations=strict (این پیش‌فرض است که از نسخه 2.1.0 کامپایلر کاتلین شروع می‌شود). ( I9ab25 ، b/326456246 )
• نوار برنامه اکنون هنگام استفاده از recyclerview درون CoordinatorLayout ، با پایین نگه داشتن صفحه کلید، به درستی جمع می‌شود.

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

۴ اکتبر ۲۰۲۳

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

• یک نسخه آزمایشی منتشر شده، بدون تغییر نسبت به 1.3.0-alpha01 .

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

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

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

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

• پشتیبانی از رویدادهای کلیدی بالا بردن صفحه، پایین آوردن صفحه، رفتن به خانه و پایان دادن به صفحه را اضافه می‌کند. ( 14719d3 )

تغییرات API

• حاشیه‌نویسی‌های Nullability در CoordinatorLayout.java اضافه شد. ( Ieb647 ، b/236474453 )

رفع اشکالات

• عملکردهای صفحه کلید با قابلیت بالا، پایین، فاصله و تغییر کلید را با NestedScrollView و CoordinatorLayout برطرف می‌کند. ( bdd72e6 )

نسخه ۱.۲

نسخه ۱.۲.۰

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

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

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

• فقط حاشیه‌نویسی‌های قابل مشاهده در زمان اجرا را در قوانین CoordinatorLayout ( 9ec7cb ) حفظ کنید.

نسخه ۱.۲.۰-rc01

۱۵ دسامبر ۲۰۲۱

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

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

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

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

تغییرات API

• APIها برای نسخه بتا نهایی شده‌اند.

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

۳ نوامبر ۲۰۲۱

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

رفع اشکالات

• فقط حاشیه‌نویسی‌های قابل مشاهده در زمان اجرا را در قوانین CoordinatorLayout ( 9ec7cb ) حفظ کنید.

نسخه ۱.۱.۰

نسخه ۱.۱.۰

۴ دسامبر ۲۰۱۹

androidx.coordinatorlayout:coordinatorlayout:1.1.0 منتشر شد. نسخه ۱.۱.۰ شامل این کامیت‌ها است .

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

• aosp/737190 : CoordinatorLayout اکنون NestedScrollingParent3 پیاده‌سازی می‌کند و CoordinatorLayout.Behavior یک overload جدید از onNestedScroll پیاده‌سازی می‌کند تا Behaviors بتوانند میزان مسافت پیمایش مصرفی خود را به فرزندان پیمایش تو در تو گزارش دهند (در طول ارسال dispatchNestedScroll() / onNestedScroll() ). پیاده‌سازی‌های قبلی onNestedScroll(CoordinatorLayout, V, View, int, int, int, int, int) به نفع پیاده‌سازی‌های جدید onNestedScroll(CoordinatorLayout, V, View, int, int, int, int, int, int[]) منسوخ شده‌اند و پیاده‌سازی‌های Behavior نیز باید بر این اساس به‌روزرسانی شوند. اگر کد توسعه‌دهنده در حال حاضر CoordinatorLayout#onNestedScroll(View, int, int, int, int, int) لغو می‌کند، احتمالاً دیگر فراخوانی نخواهد شد و به جای آن CoordinatorLayout#onNestedScroll(View, int, int, int, int, int, int[]) باید لغو شود.
• CoordinatorLayout در معرض سرویس‌های دسترسی‌پذیری ( aosp/1056175 )
• حاشیه‌نویسی CoordinatorLayout.DefaultBehavior منسوخ شده است. به جای آن از رابط CoordinatorLayout.AttachedBehavior استفاده کنید.

نسخه ۱.۱.۰-rc01

۲۳ اکتبر ۲۰۱۹

androidx.coordinatorlayout:coordinatorlayout:1.1.0-rc01 منتشر شد. نسخه 1.1.0-rc01 شامل این کامیت‌ها است .

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

• CoordinatorLayout در معرض سرویس‌های دسترسی‌پذیری ( aosp/1056175 )

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

۵ ژوئن ۲۰۱۹

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

رفع اشکالات

• از کلاس‌های تست منسوخ شده ( aosp/853955 ) مهاجرت کنید

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

۳ دسامبر ۲۰۱۸

تغییرات API

• aosp/737190 : CoordinatorLayout اکنون NestedScrollingParent3 پیاده‌سازی می‌کند و CoordinatorLayout.Behavior یک overload جدید از onNestedScroll پیاده‌سازی می‌کند تا Behaviors بتوانند میزان مسافت پیمایش مصرفی خود را به فرزندان پیمایش تو در تو گزارش دهند (در طول ارسال dispatchNestedScroll() / onNestedScroll() ). پیاده‌سازی‌های قبلی onNestedScroll(CoordinatorLayout, V, View, int, int, int, int, int) به نفع پیاده‌سازی‌های جدید onNestedScroll(CoordinatorLayout, V, View, int, int, int, int, int, int[]) منسوخ شده‌اند و پیاده‌سازی‌های Behavior نیز باید بر این اساس به‌روزرسانی شوند.

  اگر کد توسعه‌دهنده در حال حاضر CoordinatorLayout#onNestedScroll(View, int, int, int, int, int) لغو می‌کند، احتمالاً دیگر فراخوانی نخواهد شد و به جای آن CoordinatorLayout#onNestedScroll(View, int, int, int, int, int, int[]) باید لغو شود.