2 * Copyright (C) 2015 The Android Open Source Project
4 * Licensed under the Apache License, Version 2.0 (the "License");
5 * you may not use this file except in compliance with the License.
6 * You may obtain a copy of the License at
8 * http://www.apache.org/licenses/LICENSE-2.0
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 * See the License for the specific language governing permissions and
14 * limitations under the License.
17 package com.android.launcher3;
19 import android.app.Activity;
20 import android.content.ContentResolver;
21 import android.database.ContentObserver;
22 import android.os.Bundle;
23 import android.os.Handler;
24 import android.preference.ListPreference;
25 import android.preference.Preference;
26 import android.preference.PreferenceFragment;
27 import android.provider.Settings;
28 import android.provider.Settings.System;
29 import android.support.v4.os.BuildCompat;
31 import com.android.launcher3.graphics.IconShapeOverride;
34 * Settings activity for Launcher. Currently implements the following setting: Allow rotation
36 public class SettingsActivity extends Activity {
38 private static final String ICON_BADGING_PREFERENCE_KEY = "pref_icon_badging";
39 // TODO: use Settings.Secure.NOTIFICATION_BADGING
40 private static final String NOTIFICATION_BADGING = "notification_badging";
43 protected void onCreate(Bundle savedInstanceState) {
44 super.onCreate(savedInstanceState);
46 // Display the fragment as the main content.
47 getFragmentManager().beginTransaction()
48 .replace(android.R.id.content, new LauncherSettingsFragment())
53 * This fragment shows the launcher preferences.
55 public static class LauncherSettingsFragment extends PreferenceFragment {
57 private SystemDisplayRotationLockObserver mRotationLockObserver;
58 private IconBadgingObserver mIconBadgingObserver;
61 public void onCreate(Bundle savedInstanceState) {
62 super.onCreate(savedInstanceState);
63 getPreferenceManager().setSharedPreferencesName(LauncherFiles.SHARED_PREFERENCES_KEY);
64 addPreferencesFromResource(R.xml.launcher_preferences);
66 ContentResolver resolver = getActivity().getContentResolver();
68 // Setup allow rotation preference
69 Preference rotationPref = findPreference(Utilities.ALLOW_ROTATION_PREFERENCE_KEY);
70 if (getResources().getBoolean(R.bool.allow_rotation)) {
71 // Launcher supports rotation by default. No need to show this setting.
72 getPreferenceScreen().removePreference(rotationPref);
74 mRotationLockObserver = new SystemDisplayRotationLockObserver(rotationPref, resolver);
76 // Register a content observer to listen for system setting changes while
78 resolver.registerContentObserver(
79 Settings.System.getUriFor(System.ACCELEROMETER_ROTATION),
80 false, mRotationLockObserver);
82 // Initialize the UI once
83 mRotationLockObserver.onChange(true);
84 rotationPref.setDefaultValue(Utilities.getAllowRotationDefaultValue(getActivity()));
87 Preference iconBadgingPref = findPreference(ICON_BADGING_PREFERENCE_KEY);
88 if (!BuildCompat.isAtLeastO()) {
89 getPreferenceScreen().removePreference(
90 findPreference(SessionCommitReceiver.ADD_ICON_PREFERENCE_KEY));
91 getPreferenceScreen().removePreference(iconBadgingPref);
93 // Listen to system notification badge settings while this UI is active.
94 mIconBadgingObserver = new IconBadgingObserver(iconBadgingPref, resolver);
95 resolver.registerContentObserver(
96 Settings.Secure.getUriFor(NOTIFICATION_BADGING),
97 false, mIconBadgingObserver);
98 mIconBadgingObserver.onChange(true);
101 Preference iconShapeOverride = findPreference(IconShapeOverride.KEY_PREFERENCE);
102 if (iconShapeOverride != null) {
103 if (IconShapeOverride.isSupported(getActivity())) {
104 IconShapeOverride.handlePreferenceUi((ListPreference) iconShapeOverride);
106 getPreferenceScreen().removePreference(iconShapeOverride);
112 public void onDestroy() {
113 if (mRotationLockObserver != null) {
114 getActivity().getContentResolver().unregisterContentObserver(mRotationLockObserver);
115 mRotationLockObserver = null;
117 if (mIconBadgingObserver != null) {
118 getActivity().getContentResolver().unregisterContentObserver(mIconBadgingObserver);
119 mIconBadgingObserver = null;
126 * Content observer which listens for system auto-rotate setting changes, and enables/disables
127 * the launcher rotation setting accordingly.
129 private static class SystemDisplayRotationLockObserver extends ContentObserver {
131 private final Preference mRotationPref;
132 private final ContentResolver mResolver;
134 public SystemDisplayRotationLockObserver(
135 Preference rotationPref, ContentResolver resolver) {
136 super(new Handler());
137 mRotationPref = rotationPref;
138 mResolver = resolver;
142 public void onChange(boolean selfChange) {
143 boolean enabled = Settings.System.getInt(mResolver,
144 Settings.System.ACCELEROMETER_ROTATION, 1) == 1;
145 mRotationPref.setEnabled(enabled);
146 mRotationPref.setSummary(enabled
147 ? R.string.allow_rotation_desc : R.string.allow_rotation_blocked_desc);
152 * Content observer which listens for system badging setting changes,
153 * and updates the launcher badging setting subtext accordingly.
155 private static class IconBadgingObserver extends ContentObserver {
157 private final Preference mBadgingPref;
158 private final ContentResolver mResolver;
160 public IconBadgingObserver(Preference badgingPref, ContentResolver resolver) {
161 super(new Handler());
162 mBadgingPref = badgingPref;
163 mResolver = resolver;
167 public void onChange(boolean selfChange) {
168 boolean enabled = Settings.Secure.getInt(mResolver, NOTIFICATION_BADGING, 1) == 1;
169 mBadgingPref.setSummary(enabled
170 ? R.string.icon_badging_desc_on
171 : R.string.icon_badging_desc_off);