โดยส่วนใหญ่ การเพิ่มสรุปการกำหนดลักษณะจะค่อนข้างตรงไปตรงมา เนื่องจากเกี่ยวข้องกับการเพิ่มแอตทริบิวต์ android:summary
ให้กับค่ากำหนดตามลำดับด้วยทรัพยากรสตริงที่เหมาะสม อย่างไรก็ตาม หากคำบรรยายควรอัปเดตแบบไดนามิก อาจจำเป็นต้องใช้ตัวควบคุมการกำหนดลักษณะที่กำหนดเอง
คำบรรยายแบบคงที่
ในการเพิ่มคำบรรยายคงที่ในการตั้งค่า:
- เพิ่มแอตทริบิวต์
android:summary
ให้กับการตั้งค่า ตัวอย่างเช่น หากต้องการเพิ่มข้อมูลสรุปในการตั้งค่าการแสดงผล L0 ให้เพิ่มข้อมูลต่อไปนี้ในแอตทริบิวต์การกำหนดลักษณะ:android:summary="@string/display_settings_summary"
ตัวอย่างเช่น ลองพิจารณาตัวอย่างโค้ดการกำหนดค่าตามความชอบแบบเต็มนี้:
<Preference android:fragment="com.android.car.settings.display.DisplaySettingsFragment" android:icon="@drawable/ic_settings_display" android:key="@string/pk_display_settings_entry" android:title="@string/display_settings" android:summary="@string/display_settings_summary" settings:controller="com.android.car.settings.common.DefaultRestrictionsPreferenceController"/>
คำบรรยายแบบไดนามิก
คำบรรยายที่ระบุด้วยแอตทริบิวต์ android:summary
เป็นแบบคงที่ ดังนั้นจึงไม่สามารถอัปเดตตามเงื่อนไขบางประการได้ สำหรับคำบรรยายแบบไดนามิก คุณต้องแก้ไขตัวควบคุมการกำหนดลักษณะสำหรับค่ากำหนด ตัวอย่างต่อไปนี้จะแก้ไขการตั้งค่าตำแหน่ง L0 เพื่อให้มีคำบรรยายที่ระบุว่าตำแหน่งเปิดหรือปิดอยู่ และหากเปิดอยู่ จะระบุจำนวนแอปที่สามารถเข้าถึงตำแหน่งได้ในปัจจุบัน
- กำหนดสตริงใหม่:
<!-- Summary for Location settings when location is off [CHAR LIMIT=NONE] --> <string name="location_settings_summary_location_off">Off</string> <!-- Summary for Location settings when location is on, explaining how many apps have location permission [CHAR LIMIT=NONE]--> <plurals name="location_settings_summary_location_on"> <item quantity="one">On - <xliff:g id="count">%1$d</xliff:g> app has access to location</item> <item quantity="other">On - <xliff:g id="count">%1$d</xliff:g> apps have access to location</item> </plurals> <!-- Location settings, loading the number of apps which have location permission [CHAR LIMIT=30] --> <string name="location_settings_loading_app_permission_stats">Loading\u2026</string>
- สร้าง PreferenceController ใหม่
LocationEntryPreferenceController
เพื่อตั้งค่าและเปลี่ยนข้อความสรุปการตั้งค่าตำแหน่งแบบไดนามิก:public class LocationEntryPreferenceController extends PreferenceController<Preference> { private static final Logger LOG = new Logger(LocationEntryPreferenceController.class); private static final IntentFilter INTENT_FILTER_LOCATION_MODE_CHANGED = new IntentFilter(LocationManager.MODE_CHANGED_ACTION); private final Context mContext; private final LocationManager mLocationManager; /** Total number of apps that have location permissions. */ private int mNumTotal = -1; private int mNumTotalLoading = 0; private AtomicInteger mLoadingInProgress = new AtomicInteger(0); private final BroadcastReceiver mReceiver = new BroadcastReceiver() { @Override public void onReceive(Context context, Intent intent) { refreshUi(); } }; public LocationEntryPreferenceController(Context context, String preferenceKey, FragmentController fragmentController, CarUxRestrictions uxRestrictions) { super(context, preferenceKey, fragmentController, uxRestrictions); mContext = context; mLocationManager = (LocationManager) getContext().getSystemService( Service.LOCATION_SERVICE); } @Override protected Class<Preference> getPreferenceType() { return Preference.class; } @Override protected void onStartInternal() { getContext().registerReceiver(mReceiver, INTENT_FILTER_LOCATION_MODE_CHANGED); } @Override protected void onStopInternal() { getContext().unregisterReceiver(mReceiver); } @Override protected void updateState(Preference preference) { super.updateState(preference); updateSummary(preference); if (!mLocationManager.isLocationEnabled() || mLoadingInProgress.get() != 0) { return; } mNumTotalLoading = 0; // Retrieve a list of users inside the current user profile group. List<UserHandle> users = mContext.getSystemService( UserManager.class).getUserProfiles(); mLoadingInProgress.set(users.size()); for (UserHandle user : users) { Context userContext = createPackageContextAsUser(mContext, user.getIdentifier()); if (userContext == null) { if (mLoadingInProgress.decrementAndGet() == 0) { setLocationAppCount(preference, mNumTotalLoading); } continue; } PermissionControllerManager permController = userContext.getSystemService(PermissionControllerManager.class); permController.countPermissionApps( Arrays.asList(ACCESS_FINE_LOCATION, ACCESS_COARSE_LOCATION), PermissionControllerManager.COUNT_ONLY_WHEN_GRANTED, (numApps) -> { mNumTotalLoading += numApps; if (mLoadingInProgress.decrementAndGet() == 0) { setLocationAppCount(preference, mNumTotalLoading); } }, null); } } @VisibleForTesting void setLocationAppCount(Preference preference, int numApps) { mNumTotal = numApps; updateSummary(preference); } private void updateSummary(Preference preference) { String summary = ""; if (mLocationManager.isLocationEnabled()) { if (mNumTotal == -1) { summary = mContext.getString(R.string.location_settings_loading_app_permission_stats); } else { summary = mContext.getResources().getQuantityString( R.plurals.location_settings_summary_location_on, mNumTotal, mNumTotal); } } else { summary = mContext.getString(R.string.location_settings_summary_location_off); } preference.setSummary(summary); } private Context createPackageContextAsUser(Context context, int userId) { try { return context.createPackageContextAsUser( context.getPackageName(), 0 /* flags */, UserHandle.of(userId)); } catch (PackageManager.NameNotFoundException e) { LOG.e("Failed to create user context", e); } return null; } }
สำหรับตัวควบคุมตัวอย่างนี้:
- หากปิดใช้งานตำแหน่ง ข้อความสรุปจะถูกตั้งค่าเป็นสตริง
location_settings_summary_location_off
- หากเปิดใช้งานตำแหน่ง จำนวนแอพที่อนุญาตตำแหน่งจะถูกเพิ่ม ขณะที่กำลังโหลด สตริง
location_settings_loading_app_permission_stats
จะปรากฏขึ้น เมื่อโหลดข้อมูลแล้ว ตัวควบคุมจะตั้งค่าสรุปเป็นสตริงlocation_settings_summary_location_on
ด้วยจำนวนแอปที่ระบุการเข้าถึง - เมื่อตัวควบคุมการกำหนดลักษณะเริ่มทำงาน ตัวควบคุมจะลงทะเบียนเครื่องรับและรีเฟรชสถานะการกำหนดค่าตามความชอบเมื่อสถานะตำแหน่งเปลี่ยนแปลง
- หากปิดใช้งานตำแหน่ง ข้อความสรุปจะถูกตั้งค่าเป็นสตริง
- แก้ไขไฟล์ XML ส่วนย่อยเพื่อแนบคอนโทรลเลอร์ใหม่กับการตั้งค่าที่เกี่ยวข้อง:
<Preference android:fragment="com.android.car.settings.location.LocationSettingsFragment" android:icon="@drawable/ic_settings_location" android:key="@string/pk_location_settings_entry" android:title="@string/location_settings_title" settings:controller="com.android.car.settings.location.LocationEntryPreferenceController"/>