يمكن ضبط إعدادات أدوات التطبيقات. على سبيل المثال، يمكن أن يتيح تطبيق مصغّر للساعة للمستخدمين ضبط المنطقة الزمنية التي يريدون عرضها.
إذا أردت السماح للمستخدمين بضبط إعدادات تطبيقك المصغّر، عليك إنشاء Activity لضبط التطبيق المصغّر.
تعريف نشاط الإعداد
إنّ تعريف نشاط الإعداد في البيان وربطه داخل البيانات الوصفية بتنسيق XML الخاصة بموفّر البيانات هو نفسه في كل من التطبيقات المستندة إلى Views والتطبيقات المستندة إلى Glance.
للتعرّف على كيفية تعريف نشاط الإعداد، راجِع قسم تعريف نشاط الإعداد في مستندات إعداد Glance ضمن Compose-first.
تنفيذ نشاط الإعداد
بما أنّ أنشطة الإعداد هي مكوّنات عادية يستدعيها مشغّل النظام الأساسي، يجب أن تتّبع عمليات معاودة الاتصال الأساسية لدورة الحياة قواعد القيمة المرجَعة للنظام.
للتعرّف على كيفية تنفيذ نشاط إعداد، يمكنك الاطّلاع على قسم تنفيذ نشاط الإعداد في مستندات Glance.
تعديل الأداة من نشاط الإعداد
في التطبيقات المصغّرة التقليدية المستندة إلى "طرق العرض"، يتم تعديل التطبيق المصغّر عند اكتمال عملية الإعداد باستخدام AppWidgetManager ونسخة من تنسيق RemoteViews.
إذا كنت بصدد إنشاء أداة مستندة إلى Views قديمة وتحتاج إلى تعديل تنسيق RemoteViews، يمكنك الرجوع إلى عيّنة الرمز البرمجي التقليدية لتعديل Views على GitHub. بالنسبة إلى التطبيقات المصغّرة الحديثة التي تستخدم Compose أولاً، يُرجى الاطّلاع على التحديث من قسم نشاط الإعداد في مستندات Glance.
خيارات إعداد التطبيق المصغّر
يتم تسجيل سلوكيات التطبيقات المصغّرة (مثل السماح بإعادة الضبط لاحقًا أو تخطّي خطوات إعداد الضبط الأولي بالكامل) داخل سمات البيانات الوصفية باستخدام علامات Android 12 العادية.
للتعرّف على كيفية الاستفادة من خيارات التطبيق المصغّر الديناميكية، يمكنك الاطّلاع على قسم خيارات إعداد التطبيق المصغّر في مستندات إعداد Glance.
السماح للمستخدمين بإعادة ضبط التطبيقات المصغّرة التي تم وضعها
لمعرفة كيفية إضافة مشغّلات إعدادات مخصّصة قابلة لإعادة الضبط، يُرجى الاطّلاع على قسم "السماح للمستخدمين بإعادة ضبط الأدوات الموضوعة" في مستندات Glance ضمن "التركيز على Compose".
استخدام الإعدادات التلقائية للأداة
لمعرفة كيفية تخطّي عمليات إعداد الضبط تلقائيًا، راجِع قسم استخدام الإعداد التلقائي للأداة في مستندات Glance حول Compose-first.