کاربران را قادر می سازد تا ویجت های برنامه را پیکربندی کنند

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

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

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

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

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

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

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

برای یادگیری نحوه‌ی پیاده‌سازی یک فعالیت پیکربندی، بخش Compose-first Implement the configuration activity را در مستندات Glance بررسی کنید.

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

در ویجت‌های سنتی مبتنی بر Views، شما ویجت را پس از تکمیل پیکربندی با استفاده از AppWidgetManager و یک نمونه طرح‌بندی RemoteViews به‌روزرسانی می‌کنید.

اگر در حال ساخت یک ویجت قدیمی مبتنی بر Views هستید و نیاز به به‌روزرسانی طرح‌بندی RemoteViews دارید، به کد نمونه قدیمی Views Update در GitHub مراجعه کنید. برای ویجت‌های مدرن Compose-first، به بخش Update from the configuration activity در مستندات Glance مراجعه کنید.

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

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

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

کاربران را قادر می‌سازد تا ابزارک‌های قرار داده شده را دوباره پیکربندی کنند

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

از تنظیمات پیش‌فرض ویجت استفاده کنید

برای یادگیری نحوه‌ی صرف نظر کردن از تنظیمات پیکربندی پیش‌فرض، به بخش «استفاده از پیکربندی پیش‌فرض ویجت در مرحله‌ی نوشتن» در مستندات Glance مراجعه کنید.