환경설정 자막

대부분의 경우 환경설정 요약을 추가하는 작업은 비교적 간단합니다. 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"/>