Android 12 (سطح میانای برنامه‌سازی کاربردی ۳۱) میانای برنامه‌سازی کاربردی ابزاره‌های موجود را اصلاح می‌کند تا تجربه کاربر و توسعه‌دهنده را در پلاتفرم و راه‌اندازها بهبود بخشد. از این راهنما برای یادگیری نحوه اطمینان از سازگاری ابزاره با Android 12 و همچنین به‌عنوان مرجعی برای APIها جهت بازآوری ابزاره موجود خود استفاده کنید.
مطمئن شوید ابزاره‌تان با Android 12 سازگار باشد
ابزاره‌ها در Android 12 گوشه‌های گرد دارند. وقتی از ابزاره برنامه در دستگاهی با Android نسخه ۱۲ یا بالاتر استفاده می‌شود، راه‌انداز به‌طور خودکار پس‌زمینه ابزاره را شناسایی می‌کند و آن را برش می‌دهد تا گوشه‌های گرد داشته باشد.
در این سناریو، ممکن است ابزاره شما در هریک از شرایط زیر به‌درستی نمایش داده نشود:
ابزارک حاوی محتوا در گوشه‌ها است: این امر ممکن است باعث شود برخی‌از محتواها در ناحیه گوشه برش داده شود.
ابزاره از پس‌زمینه‌ای استفاده می‌کند که مستعد برش نیست. این شامل پس‌زمینه شفاف، نماها یا چیدمان‌های خالی، یا هر نوع پس‌زمینه خاص دیگری است که مستعد برش نیست. ممکن است سیستم نتواند پس‌زمینه مناسب را به‌درستی شناسایی کند.
اگر ابزاره شما تحت تأثیر این تغییر قرار می‌گیرد، توصیه می‌کنیم آن را با گوشه‌های گرد (همان‌طور که در بخش زیر توضیح داده شده است) بازآوری کنید تا مطمئن شوید به‌درستی نمایش داده می‌شود.
استفاده از نمونه
برای دیدن همه این میاناهای برنامه‌سازی کاربردی در عمل، ابزارک فهرست نمونه ما را بررسی کنید.
پیاده‌سازی گوشه‌های گرد
Android 12 پارامترهای سیستم system_app_widget_background_radius
و system_app_widget_inner_radius
را برای تنظیم شعاع گوشه‌های گرد ابزارک معرفی می‌کند.
۱ گوشه ابزاره.
۲ گوشه نمای داخل ابزاره.
برای جزئیات، به پیاده‌سازی گوشه‌های گرد مراجعه کنید.
افزودن زمینه‌سازی دستگاه
از Android 12، ابزاره می‌تواند از رنگ‌های زمینه دستگاه برای دکمه‌ها، پس‌زمینه‌ها، و دیگر مؤلفه‌ها، ازجمله زمینه‌های روشن و تیره، استفاده کند. این کار باعث انتقال روان‌تر و هماهنگی بیشتر بین ابزاره‌های مختلف می‌شود.
برای اطلاعات بیشتر، افزودن زمینه‌سازی دستگاه را ببینید.
آسان‌تر شدن شخصی‌سازی ابزاره‌ها
اگر فعالیت پیکربندی را با ویژگی configure
appwidget-provider مشخص کنید،
میزبان «ابزاره برنامه» بلافاصله پس‌از اینکه کاربر ابزاره را به صفحه اصلی اضافه کرد،
آن فعالیت را راه‌اندازی می‌کند.
Android 12 گزینه‌های جدیدی اضافه می‌کند تا بتوانید تجربه پیکربندی بهتری برای کاربران فراهم کنید. برای جزئیات، فعال کردن کاربران برای پیکربندی ابزارک‌ها را ببینید.
افزودن دکمه‌های ترکیبی جدید
Android 12 پشتیبانی جدیدی برای رفتار باحالت بااستفاده از مؤلفه‌های موجود زیر اضافه می‌کند:
ابزاره هنوز بدون حالت است. برنامه شما باید وضعیت را ذخیره کند و برای رویدادهای تغییر وضعیت ثبت‌نام کند.
برای جزئیات، پشتیبانی از رفتار باحالت را ببینید.
استفاده از میاناهای برنامه‌سازی کاربردی بهبودیافته برای اندازه‌ها و چیدمان‌های ابزارک
از Android 12، می‌توانید با مشخص کردن محدودیت‌های بیشتر برای اندازه ابزاره، و با ارائه چیدمان‌های واکنش‌گرا و چیدمان‌های دقیق، از ویژگی‌های اندازه دقیق‌تر و چیدمان‌های انعطاف‌پذیرتر بهره ببرید.
برای جزئیات، ارائه طرح‌بندی‌های انعطاف‌پذیر برای ابزاره را ببینید.
بهبود تجربه انتخابگر ابزاره برنامه
Android 12 به شما امکان می‌دهد با افزودن پیش‌نمایش‌های ابزارک پویا و شرح ابزارک، تجربه انتخابگر ابزارک را برای برنامه‌تان بهبود دهید. برای جزئیات، به افزودن پیش‌نمایش‌های ابزاره مقیاس‌پذیر به انتخابگر ابزاره و افزودن شرح برای ابزاره مراجعه کنید.
فعال کردن انتقال‌های روان‌تر
از Android نسخه ۱۲، راه‌اندازها انتقال روان‌تری را ارائه می‌دهند وقتی کاربر برنامه‌تان را از ابزاره راه‌اندازی می‌کند. برای جزئیات، به فعال کردن انتقال‌های روان‌تر مراجعه کنید.
استفاده کردن از مجموعه‌های ساده‌شده RemoteViews
Android 12 روش
setRemoteAdapter(int viewId, RemoteViews.RemoteCollectionItems items)
را اضافه می‌کند که به برنامه‌تان اجازه می‌دهد هنگام پر کردن
ListView،
مجموعه‌ای را مستقیماً ارسال کند. قبلاً، هنگام استفاده از
ListView، لازم بود
RemoteViewsService پیاده‌سازی و اعلام شود تا
RemoteViewsFactory برگردانده شود.
برای جزئیات، به استفاده از مجموعه‌های RemoteViews مراجعه کنید.
استفاده از اصلاح زمان اجرای RemoteViews
Android 12 چندین روش RemoteViews اضافه می‌کند که امکان اصلاح مشخصه‌های RemoteViews را در زمان اجرا فراهم می‌کند. برای مشاهده فهرست کامل روش‌های اضافه‌شده،
به مرجع میانای برنامه‌سازی کاربردی RemoteViews مراجعه کنید.
برای جزئیات، استفاده از اصلاح زمان اجرا
RemoteViews را ببینید.