העדפות לכתוביות

ברוב המקרים, הוספת סיכומי העדפות היא פשוטה יחסית, כי צריך רק להוסיף את המאפיין android:summary להעדפה הרלוונטית עם משאב המחרוזת המתאים. עם זאת, אם הכתוביות צריכות להתעדכן באופן דינמי, יכול להיות שיהיה צורך בבורר העדפות מותאם אישית.

כתוביות סטטיות

כדי להוסיף כתוביות סטטיות להעדפה:

1. מוסיפים את המאפיין 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 כך שתכלול כותרת משנה שמציינת אם המיקום מופעל או מושבת, ואם הוא מופעל, מציינת כמה אפליקציות יש להן כרגע גישה למיקום.

1. מגדירים את המחרוזות החדשות:

   <!-- 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>
   

2. יוצרים 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 עם מספר האפליקציות שיש להן גישה.
   • כשמפעילים את בקר ההעדפות, הבקר רושם מקלט ומתרענן את מצב ההעדפה כשמצב המיקום משתנה.
3. משנים את קובץ ה-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"/>