فعال کردن کاربران برای پیکربندی ابزاره‌های برنامه

ابزاره‌های برنامه می‌توانند قابل‌پیکربندی باشند. برای مثال، ابزاره ساعت می‌تواند به کاربران اجازه دهد پیکربندی کنند کدام منطقه زمانی نمایش داده شود.

اگر می‌خواهید به کاربران اجازه دهید تنظیمات ابزارک شما را پیکربندی کنند، یک پیکربندی ابزارک Activity ایجاد کنید.

اعلام فعالیت پیکربندی

اعلام فعالیت پیکربندی در مانیفست و پیوند دادن آن در فراداده XML ارائه‌دهنده شما در هر دو ابزاره برنامه مبتنی بر Views و مبتنی بر Glance یکسان است.

برای آشنایی با نحوه اعلام فعالیت پیکربندی، به بخش اعلام فعالیت پیکربندی در سند پیکربندی Glance مراجعه کنید.

اجرای فعالیت پیکربندی

ازآنجایی‌که فعالیت‌های پیکربندی مؤلفه‌های استانداردی هستند که توسط راه‌انداز پلاتفرم فراخوانی می‌شوند، فراخوانی‌های چرخه حیات پایه آن‌ها باید از قوانین مقدار بازگشتی سیستم پیروی کنند.

برای آشنایی با نحوه پیاده‌سازی فعالیت پیکربندی، بخش پیاده‌سازی فعالیت پیکربندی را در اسناد Glance بررسی کنید.

به‌روزرسانی ابزاره از فعالیت پیکربندی

در ابزارک‌های سنتی مبتنی بر «نماها»، ابزارک را پس‌از تکمیل پیکربندی بااستفاده از AppWidgetManager و نمونه چیدمان RemoteViews به‌روز می‌کنید.

اگر درحال ساختن ابزاره قدیمی مبتنی بر Views هستید و باید چیدمان RemoteViews را به‌روز کنید، به کد نمونه به‌روزرسانی Views در GitHub مراجعه کنید. برای ابزاره‌های مدرن Compose-first، به بخش به‌روزرسانی از فعالیت پیکربندی در اسناد Glance مراجعه کنید.

گزینه‌های پیکربندی ابزاره

رفتارهای ابزاره (مانند اجازه دادن به پیکربندی مجدد در آینده یا رد شدن کامل از مراحل راه‌اندازی پیکربندی اولیه) بااستفاده از پرچم‌های استاندارد Android 12 در مشخصه‌های فراداده ثبت می‌شوند.

برای آشنایی با نحوه بهره‌برداری از گزینه‌های ابزاره پویا، به بخش گزینه‌های پیکربندی ابزاره Compose-first در اسناد پیکربندی Glance مراجعه کنید.

به کاربران اجازه دهید ابزاره‌های قرار داده‌شده را دوباره پیکربندی کنند

برای درک نحوه افزودن راه‌اندازهای راه‌اندازی قابل‌پیکربندی مجدد سفارشی، به بخش فعال کردن کاربران برای پیکربندی مجدد ابزاره‌های قرار داده‌شده در سند Glance مراجعه کنید.

استفاده از پیکربندی پیش‌فرض ابزاره

برای آشنایی با نحوه رد شدن از راه‌اندازی‌های پیکربندی به‌طور پیش‌فرض، به بخش استفاده از پیکربندی پیش‌فرض ابزاره در Compose-first در اسناد Glance مراجعه کنید.