این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

ساختار اطلاعات

اندروید 8.0 معماری اطلاعات جدیدی را برای برنامه تنظیمات معرفی کرد تا نحوه سازماندهی تنظیمات را ساده کند و کاربران بتوانند به سرعت تنظیمات را برای سفارشی کردن دستگاه های اندرویدی خود پیدا کنند. اندروید 9 برای ارائه عملکرد تنظیمات بیشتر و اجرای آسان تر، بهبودهایی را معرفی کرد.

مثال ها و منبع

اکثر صفحات در تنظیمات در حال حاضر با استفاده از چارچوب جدید اجرا می شوند. یک مثال خوب DisplaySettings است: packages/apps/Settings/src/com/android/settings/DisplaySettings.java

مسیرهای فایل برای اجزای مهم در زیر فهرست شده است:

CategoryKey : packages/SettingsLib/src/com/android/settingslib/drawer/CategoryKey.java
DashboardFragmentRegistry : packages/apps/Settings/src/com/android/settings/dashboard/DashboardFragmentRegistry.java
DashboardFragment : packages/apps/Settings/src/com/android/settings/dashboard/DashboardFragment.java
AbstractPreferenceController : frameworks/base/packages/SettingsLib/src/com/android/settingslib/core/AbstractPreferenceController.java
BasePreferenceController (معرفی شده در اندروید 9): packages/apps/Settings/src/com/android/settings/core/BasePreferenceController.java

پیاده سازی

سازندگان دستگاه تشویق می شوند تا معماری اطلاعات تنظیمات موجود را تطبیق دهند و صفحات تنظیمات اضافی را در صورت نیاز برای تطبیق با ویژگی های خاص شریک درج کنند. انتقال تنظیمات برگزیده از صفحه قدیمی (که به عنوان SettingsPreferencePage اجرا می شود) به یک صفحه جدید (اجرا شده با استفاده از DashboardFragment ) می تواند پیچیده باشد. ترجیحات صفحه قدیمی احتمالاً با PreferenceController اجرا نمی شود.

بنابراین، هنگام انتقال تنظیمات ترجیحی از یک صفحه قدیمی به صفحه جدید، باید یک PreferenceController ایجاد کنید و کد را قبل از نمونه‌سازی در DashboardFragment جدید به کنترلر منتقل کنید. APIهایی که PreferenceController نیاز دارد به نام آنها توضیح داده شده و در Javadoc مستند شده است.

به شدت توصیه می شود برای هر PreferenceController یک تست واحد اضافه کنید. اگر تغییر به AOSP ارسال شود، آزمایش واحد مورد نیاز است. برای دریافت اطلاعات بیشتر در مورد نحوه نوشتن تست‌های مبتنی بر Robolectric، به packages/apps/Settings/tests/robotests/README.md مراجعه کنید.

معماری اطلاعات به سبک پلاگین

هر مورد تنظیمات به عنوان یک اولویت اجرا می شود. یک Preference را می توان به راحتی از یک صفحه به صفحه دیگر منتقل کرد.

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

DashboardFragment

DashboardFragment میزبان کنترلرهای ترجیحی به سبک پلاگین است. قطعه از PreferenceFragment به ارث می رسد و دارای قلاب هایی برای گسترش و به روز رسانی لیست های ترجیحی ثابت و لیست های اولویت پویا است.

ترجیحات استاتیک

یک لیست ترجیحی ثابت در XML با استفاده از تگ <Preference> تعریف می شود. یک پیاده سازی DashboardFragment از متد getPreferenceScreenResId() استفاده می کند تا مشخص کند کدام فایل XML حاوی لیست ایستا ترجیحات برای نمایش است.

ترجیحات پویا

یک آیتم پویا نشان دهنده یک کاشی با قصد است که منجر به یک فعالیت خارجی یا داخلی می شود. معمولاً هدف به صفحه تنظیمات متفاوتی منتهی می شود. به عنوان مثال، آیتم تنظیم "Google" در صفحه اصلی تنظیمات یک مورد پویا است. موارد پویا در AndroidManifest تعریف می‌شوند (در زیر بحث می‌شود) و از طریق FeatureProvider (تعریف شده به عنوان DashboardFeatureProvider ) بارگیری می‌شوند.

تنظیمات پویا سنگین‌تر از تنظیمات پیکربندی استاتیک هستند، بنابراین معمولاً توسعه‌دهندگان باید تنظیمات را به‌عنوان یک تنظیمات ثابت پیاده‌سازی کنند. با این حال، تنظیم پویا زمانی می تواند مفید باشد که یکی از موارد زیر درست باشد:

این تنظیم مستقیماً در برنامه تنظیمات (مانند تزریق تنظیماتی که توسط برنامه‌های OEM/Carrier اجرا شده است) اجرا نمی‌شود.
این تنظیم باید در صفحه اصلی تنظیمات ظاهر شود.
شما قبلاً یک Activity برای تنظیم دارید و نمی خواهید پیکربندی استاتیک اضافی را پیاده سازی کنید.

برای پیکربندی یک Activity به عنوان یک تنظیم پویا، موارد زیر را انجام دهید:

با افزودن یک فیلتر قصد به فعالیت، فعالیت را به عنوان یک تنظیم پویا علامت گذاری کنید.
به برنامه تنظیمات بگویید به کدام دسته تعلق دارد. دسته یک ثابت است که در CategoryKey تعریف شده است.
اختیاری: هنگامی که تنظیمات نمایش داده می شود، متن خلاصه را اضافه کنید.

در اینجا یک مثال از برنامه Settings برای DisplaySettings گرفته شده است.

<activity android:name="Settings$DisplaySettingsActivity"
                   android:label="@string/display_settings"
                   android:icon="@drawable/ic_settings_display">
             <!-- Mark the activity as a dynamic setting -->
              <intent-filter>
                     <action android:name="com.android.settings.action.IA_SETTINGS" />
              </intent-filter>
             <!-- Tell Settings app which category it belongs to -->
              <meta-data android:name="com.android.settings.category"
                     android:value="com.android.settings.category.ia.homepage" />
             <!-- Add a summary text when the setting is displayed -->
              <meta-data android:name="com.android.settings.summary"
                     android:resource="@string/display_dashboard_summary"/>
             </activity>

در زمان رندر، قطعه فهرستی از تنظیمات برگزیده را از تنظیمات XML ایستا و پویا که در AndroidManifest تعریف شده است، می خواهد. چه PreferenceController ها در کد جاوا تعریف شده باشند یا در XML، DashboardFragment منطق مدیریت هر تنظیمات را از طریق PreferenceController مدیریت می کند (در زیر بحث شده است). سپس آنها در UI به عنوان یک لیست ترکیبی نمایش داده می شوند.

PreferenceController

تفاوت هایی بین اجرای PreferenceController در اندروید 9 و اندروید 8.x وجود دارد، همانطور که در این بخش توضیح داده شد.

PreferenceController در نسخه اندروید 9

یک PreferenceController شامل تمام منطق برای تعامل با اولویت است، از جمله نمایش، به روز رسانی، فهرست بندی جستجو و غیره.

رابط PreferenceController به عنوان BasePreferenceController تعریف می شود. برای مثال، کد را در packages/apps/Settings/src/com/android/settings/core/ BasePreferenceController.java ببینید.

چندین زیر کلاس از BasePreferenceController وجود دارد که هر کدام به یک سبک UI خاص که برنامه تنظیمات به طور پیش فرض از آن پشتیبانی می کند، نگاشت می شود. به عنوان مثال، TogglePreferenceController یک API دارد که مستقیماً نحوه تعامل کاربر با یک رابط کاربری ترجیحی مبتنی بر جابجایی را ترسیم می کند.

BasePreferenceController دارای APIهایی مانند getAvailabilityStatus() ، displayPreference() ، handlePreferenceTreeClicked(), و غیره است. مستندات دقیق برای هر API در کلاس رابط موجود است.

یک محدودیت در پیاده سازی BasePreferenceController (و زیر کلاس های آن مانند TogglePreferenceController ) این است که امضای سازنده باید با یکی از موارد زیر مطابقت داشته باشد:

public MyController(Context context, String key) {}
public MyController(Context context) {}

در حین نصب اولویت برای قطعه، داشبورد روشی را برای اتصال PreferenceController قبل از زمان نمایش ارائه می دهد. در زمان نصب، کنترل‌کننده به قطعه سیم‌کشی می‌شود، بنابراین تمام رویدادهای مرتبط آینده به کنترل‌کننده ارسال می‌شوند.

DashboardFragment لیستی از PreferenceController ها را در صفحه نگه می دارد. در onCreate() فرگمنت، همه کنترلرها برای متد getAvailabilityStatus() فراخوانی می شوند و اگر مقدار true را برگرداند، displayPreference() برای پردازش منطق نمایش فراخوانی می شود. getAvailabilityStatus() همچنین برای اطلاع دادن به چارچوب تنظیمات مهم است که چه مواردی در طول جستجو در دسترس هستند.

PreferenceController در نسخه های اندروید 8.x منتشر شده است

یک PreferenceController شامل تمام منطق برای تعامل با اولویت است، از جمله نمایش، به روز رسانی، فهرست بندی جستجو. و غیره.

مطابق با تعاملات ترجیحی، رابط PreferenceController دارای APIهای isAvailable() ، displayPreference() ، handlePreferenceTreeClicked() و غیره است. مستندات دقیق در مورد هر API را می توان در کلاس رابط یافت.

DashboardFragment لیستی از PreferenceControllers را در صفحه نگه می دارد. در onCreate() فرگمنت، تمام کنترلرها برای متد isAvailable() فراخوانی می شوند و اگر مقدار true را برگرداند، displayPreference() برای پردازش منطق نمایش فراخوانی می شود.

استفاده از DashboardFragment

انتقال اولویت از صفحه A به B

اگر اولویت به صورت ایستا در فایل XML ترجیحی صفحه اصلی فهرست شده است، رویه حرکت Static را برای نسخه اندروید خود در زیر دنبال کنید. در غیر این صورت، رویه حرکت پویا را برای نسخه اندروید خود دنبال کنید.

حرکت استاتیک در اندروید 9

فایل های XML ترجیحی را برای صفحه اصلی و صفحه مقصد پیدا کنید. می توانید این اطلاعات را از متد getPreferenceScreenResId() صفحه پیدا کنید.
اولویت را از XML صفحه اصلی حذف کنید.
اولویت را به XML صفحه مقصد اضافه کنید.
PreferenceController برای این اولویت از پیاده سازی جاوا صفحه اصلی حذف کنید. معمولاً در createPreferenceControllers() است. کنترلر ممکن است مستقیماً در XML اعلام شود.
توجه : ترجیح ممکن است PreferenceController نداشته باشد.
PreferenceController را در createPreferenceControllers() صفحه مقصد نمونه سازی کنید. اگر PreferenceController در صفحه قدیمی در XML تعریف شده است، آن را برای صفحه جدید نیز در XML تعریف کنید.

حرکت پویا در اندروید 9

پیدا کنید کدام دسته میزبان صفحه اصلی و مقصد است. می توانید این اطلاعات را در DashboardFragmentRegistry بیابید.
فایل AndroidManifest.xml را که حاوی تنظیماتی است که باید جابجا کنید باز کنید و ورودی Activity که این تنظیم را نشان می دهد را پیدا کنید.
مقدار فراداده فعالیت را برای com.android.settings.category روی کلید دسته بندی صفحه جدید تنظیم کنید.

حرکت ایستا در نسخه های اندروید 8.x

فایل های XML ترجیحی را برای صفحه اصلی و صفحه مقصد پیدا کنید.

getPreferenceScreenResId()

اولویت را در XML صفحه اصلی حذف کنید.
اولویت را به XML صفحه مقصد اضافه کنید.
PreferenceController برای این اولویت در پیاده سازی جاوا صفحه اصلی حذف کنید. معمولاً در getPreferenceControllers() است.

توجه : این امکان وجود دارد که اولویت دارای PreferenceController نباشد.

PreferenceController را در getPreferenceControllers() صفحه مقصد نمونه سازی کنید.

حرکت پویا در نسخه های اندروید 8.x

پیدا کنید کدام دسته میزبان صفحه اصلی و مقصد است. می توانید این اطلاعات را در DashboardFragmentRegistry بیابید.
فایل AndroidManifest.xml را که حاوی تنظیماتی است که باید جابجا کنید باز کنید و ورودی Activity که این تنظیم را نشان می دهد را پیدا کنید.
مقدار فراداده فعالیت را برای com.android.settings.category تغییر دهید، نقطه مقدار را روی کلید دسته بندی صفحه جدید تنظیم کنید.

ایجاد یک اولویت جدید در یک صفحه

اگر اولویت به صورت ایستا در فایل XML ترجیحی صفحه اصلی فهرست شده است، روش ثابت زیر را دنبال کنید. در غیر این صورت رویه پویا را دنبال کنید.

ایجاد یک اولویت ثابت

فایل های XML ترجیحی را برای صفحه پیدا کنید. می توانید این اطلاعات را از متد ()getPreferenceScreenResId صفحه پیدا کنید.
یک آیتم Preference جدید در XML اضافه کنید. مطمئن شوید که یک android:key منحصر به فرد دارد.
در متد getPreferenceControllers() صفحه یک PreferenceController برای این اولویت تعریف کنید.
- در Android 8.x و به صورت اختیاری در Android 9، یک PreferenceController برای این اولویت در متد createPreferenceControllers() صفحه نمونه سازی کنید.
  اگر این اولویت قبلاً در جاهای دیگر وجود داشته است، ممکن است قبلاً یک PreferenceController برای آن وجود داشته باشد. می‌توانید بدون ساختن یک کنترلر جدید، دوباره از PreferenceController استفاده کنید.
- با شروع اندروید 9، می‌توانید PreferenceController را در XML در کنار اولویت اعلام کنید. به عنوان مثال:
```
<Preference
        android:key="reset_dashboard"
        android:title="@string/reset_dashboard_title"
        settings:controller="com.android.settings.system.ResetPreferenceController"/>
```

ایجاد یک اولویت پویا

پیدا کنید کدام دسته میزبان صفحه اصلی و مقصد است. می توانید این اطلاعات را در DashboardFragmentRegistry بیابید.
یک فعالیت جدید در AndroidManifest ایجاد کنید
برای تعریف تنظیمات، متادیتای لازم را به Activity جدید اضافه کنید. مقدار فراداده را برای com.android.settings.category روی همان مقدار تعریف شده در مرحله 1 تنظیم کنید.

یک صفحه جدید ایجاد کنید

یک قطعه جدید ایجاد کنید که از DashboardFragment به ارث می رسد.
دسته بندی آن را در DashboardFragmentRegistry تعریف کنید.
توجه: این مرحله اختیاری است. اگر در این صفحه نیازی به تنظیمات پویا ندارید، نیازی به ارائه کلید دسته ندارید.
مراحل اضافه کردن تنظیمات مورد نیاز برای این صفحه را دنبال کنید. برای اطلاعات بیشتر به بخش پیاده سازی مراجعه کنید.

اعتبار سنجی

تست های روبولکتریک را در تنظیمات اجرا کنید. تمام آزمون های موجود و جدید باید قبول شوند.
تنظیمات را بسازید و نصب کنید، سپس به صورت دستی صفحه در حال تغییر را باز کنید. صفحه باید فورا به روز شود.