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