2 * Copyright (C) 2008 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.settings;
19 import com.android.settings.accounts.AccountSyncSettings;
20 import com.android.settings.bluetooth.BluetoothEnabler;
21 import com.android.settings.fuelgauge.PowerUsageSummary;
22 import com.android.settings.wifi.WifiEnabler;
24 import android.content.ComponentName;
25 import android.content.Context;
26 import android.content.Intent;
27 import android.content.pm.ActivityInfo;
28 import android.content.pm.PackageManager;
29 import android.content.pm.PackageManager.NameNotFoundException;
30 import android.os.Bundle;
31 import android.preference.Preference;
32 import android.preference.PreferenceActivity;
33 import android.preference.PreferenceFragment;
34 import android.text.TextUtils;
35 import android.util.Log;
36 import android.view.LayoutInflater;
37 import android.view.View;
38 import android.view.View.OnClickListener;
39 import android.view.ViewGroup;
40 import android.widget.ArrayAdapter;
41 import android.widget.Button;
42 import android.widget.ImageView;
43 import android.widget.ListAdapter;
44 import android.widget.Switch;
45 import android.widget.TextView;
47 import java.util.ArrayList;
48 import java.util.HashMap;
49 import java.util.List;
52 * Top-level settings activity to handle single pane and double pane UI layout.
54 public class Settings extends PreferenceActivity implements ButtonBarHandler {
56 private static final String LOG_TAG = "Settings";
57 private static final String META_DATA_KEY_HEADER_ID =
58 "com.android.settings.TOP_LEVEL_HEADER_ID";
59 private static final String META_DATA_KEY_FRAGMENT_CLASS =
60 "com.android.settings.FRAGMENT_CLASS";
61 private static final String META_DATA_KEY_PARENT_TITLE =
62 "com.android.settings.PARENT_FRAGMENT_TITLE";
63 private static final String META_DATA_KEY_PARENT_FRAGMENT_CLASS =
64 "com.android.settings.PARENT_FRAGMENT_CLASS";
66 private static final String EXTRA_CLEAR_UI_OPTIONS = "settings:remove_ui_options";
68 private static final String SAVE_KEY_CURRENT_HEADER = "com.android.settings.CURRENT_HEADER";
69 private static final String SAVE_KEY_PARENT_HEADER = "com.android.settings.PARENT_HEADER";
71 private String mFragmentClass;
72 private int mTopLevelHeaderId;
73 private Header mFirstHeader;
74 private Header mCurrentHeader;
75 private Header mParentHeader;
76 private boolean mInLocalHeaderSwitch;
78 // TODO: Update Call Settings based on airplane mode state.
80 protected HashMap<Integer, Integer> mHeaderIndexMap = new HashMap<Integer, Integer>();
81 private List<Header> mHeaders;
84 protected void onCreate(Bundle savedInstanceState) {
85 if (getIntent().getBooleanExtra(EXTRA_CLEAR_UI_OPTIONS, false)) {
86 getWindow().setUiOptions(0);
90 mInLocalHeaderSwitch = true;
91 super.onCreate(savedInstanceState);
92 mInLocalHeaderSwitch = false;
94 if (!onIsHidingHeaders() && onIsMultiPane()) {
96 // Force the title so that it doesn't get overridden by a direct launch of
97 // a specific settings screen.
98 setTitle(R.string.settings_label);
101 // Retrieve any saved state
102 if (savedInstanceState != null) {
103 mCurrentHeader = savedInstanceState.getParcelable(SAVE_KEY_CURRENT_HEADER);
104 mParentHeader = savedInstanceState.getParcelable(SAVE_KEY_PARENT_HEADER);
107 // If the current header was saved, switch to it
108 if (savedInstanceState != null && mCurrentHeader != null) {
109 //switchToHeaderLocal(mCurrentHeader);
110 showBreadCrumbs(mCurrentHeader.title, null);
113 if (mParentHeader != null) {
114 setParentTitle(mParentHeader.title, null, new OnClickListener() {
115 public void onClick(View v) {
116 switchToParent(mParentHeader.fragment);
121 // TODO Add support for android.R.id.home in all Setting's onOptionsItemSelected
122 // getActionBar().setDisplayOptions(ActionBar.DISPLAY_HOME_AS_UP,
123 // ActionBar.DISPLAY_HOME_AS_UP);
127 protected void onSaveInstanceState(Bundle outState) {
128 super.onSaveInstanceState(outState);
130 // Save the current fragment, if it is the same as originally launched
131 if (mCurrentHeader != null) {
132 outState.putParcelable(SAVE_KEY_CURRENT_HEADER, mCurrentHeader);
134 if (mParentHeader != null) {
135 outState.putParcelable(SAVE_KEY_PARENT_HEADER, mParentHeader);
140 public void onResume() {
143 ListAdapter listAdapter = getListAdapter();
144 if (listAdapter instanceof HeaderAdapter) {
145 ((HeaderAdapter) listAdapter).resume();
150 public void onPause() {
153 ListAdapter listAdapter = getListAdapter();
154 if (listAdapter instanceof HeaderAdapter) {
155 ((HeaderAdapter) listAdapter).pause();
159 private void switchToHeaderLocal(Header header) {
160 mInLocalHeaderSwitch = true;
161 switchToHeader(header);
162 mInLocalHeaderSwitch = false;
166 public void switchToHeader(Header header) {
167 if (!mInLocalHeaderSwitch) {
168 mCurrentHeader = null;
169 mParentHeader = null;
171 super.switchToHeader(header);
175 * Switch to parent fragment and store the grand parent's info
176 * @param className name of the activity wrapper for the parent fragment.
178 private void switchToParent(String className) {
179 final ComponentName cn = new ComponentName(this, className);
181 final PackageManager pm = getPackageManager();
182 final ActivityInfo parentInfo = pm.getActivityInfo(cn, PackageManager.GET_META_DATA);
184 if (parentInfo != null && parentInfo.metaData != null) {
185 String fragmentClass = parentInfo.metaData.getString(META_DATA_KEY_FRAGMENT_CLASS);
186 CharSequence fragmentTitle = parentInfo.loadLabel(pm);
187 Header parentHeader = new Header();
188 parentHeader.fragment = fragmentClass;
189 parentHeader.title = fragmentTitle;
190 mCurrentHeader = parentHeader;
192 switchToHeaderLocal(parentHeader);
195 mParentHeader = new Header();
196 mParentHeader.fragment
197 = parentInfo.metaData.getString(META_DATA_KEY_PARENT_FRAGMENT_CLASS);
198 mParentHeader.title = parentInfo.metaData.getString(META_DATA_KEY_PARENT_TITLE);
200 } catch (NameNotFoundException nnfe) {
201 Log.w(LOG_TAG, "Could not find parent activity : " + className);
206 public void onNewIntent(Intent intent) {
207 super.onNewIntent(intent);
209 // If it is not launched from history, then reset to top-level
210 if ((intent.getFlags() & Intent.FLAG_ACTIVITY_LAUNCHED_FROM_HISTORY) == 0
211 && mFirstHeader != null && !onIsHidingHeaders() && onIsMultiPane()) {
212 switchToHeaderLocal(mFirstHeader);
216 private void highlightHeader() {
217 if (mTopLevelHeaderId != 0) {
218 Integer index = mHeaderIndexMap.get(mTopLevelHeaderId);
220 getListView().setItemChecked(index, true);
221 getListView().smoothScrollToPosition(index);
227 public Intent getIntent() {
228 Intent superIntent = super.getIntent();
229 String startingFragment = getStartingFragmentClass(superIntent);
230 // This is called from super.onCreate, isMultiPane() is not yet reliable
231 // Do not use onIsHidingHeaders either, which relies itself on this method
232 if (startingFragment != null && !onIsMultiPane()) {
233 Intent modIntent = new Intent(superIntent);
234 modIntent.putExtra(EXTRA_SHOW_FRAGMENT, startingFragment);
235 Bundle args = superIntent.getExtras();
237 args = new Bundle(args);
241 args.putParcelable("intent", superIntent);
242 modIntent.putExtra(EXTRA_SHOW_FRAGMENT_ARGUMENTS, superIntent.getExtras());
249 * Checks if the component name in the intent is different from the Settings class and
250 * returns the class name to load as a fragment.
252 protected String getStartingFragmentClass(Intent intent) {
253 if (mFragmentClass != null) return mFragmentClass;
255 String intentClass = intent.getComponent().getClassName();
256 if (intentClass.equals(getClass().getName())) return null;
258 if ("com.android.settings.ManageApplications".equals(intentClass)
259 || "com.android.settings.RunningServices".equals(intentClass)
260 || "com.android.settings.applications.StorageUse".equals(intentClass)) {
261 // Old names of manage apps.
262 intentClass = com.android.settings.applications.ManageApplications.class.getName();
269 * Override initial header when an activity-alias is causing Settings to be launched
270 * for a specific fragment encoded in the android:name parameter.
273 public Header onGetInitialHeader() {
274 String fragmentClass = getStartingFragmentClass(super.getIntent());
275 if (fragmentClass != null) {
276 Header header = new Header();
277 header.fragment = fragmentClass;
278 header.title = getTitle();
279 header.fragmentArguments = getIntent().getExtras();
280 mCurrentHeader = header;
288 public Intent onBuildStartFragmentIntent(String fragmentName, Bundle args,
289 int titleRes, int shortTitleRes) {
290 Intent intent = super.onBuildStartFragmentIntent(fragmentName, args,
291 titleRes, shortTitleRes);
293 // some fragments want to avoid split actionbar
294 if (DataUsageSummary.class.getName().equals(fragmentName) ||
295 PowerUsageSummary.class.getName().equals(fragmentName) ||
296 AccountSyncSettings.class.getName().equals(fragmentName) ||
297 UserDictionarySettings.class.getName().equals(fragmentName)) {
298 intent.putExtra(EXTRA_CLEAR_UI_OPTIONS, true);
301 intent.setClass(this, SubSettings.class);
306 * Populate the activity with the top-level headers.
309 public void onBuildHeaders(List<Header> headers) {
310 loadHeadersFromResource(R.xml.settings_headers, headers);
312 updateHeaderList(headers);
317 private void updateHeaderList(List<Header> target) {
319 while (i < target.size()) {
320 Header header = target.get(i);
321 // Ids are integers, so downcasting
322 int id = (int) header.id;
323 if (id == R.id.dock_settings) {
324 if (!needsDockSettings())
325 target.remove(header);
326 } else if (id == R.id.operator_settings || id == R.id.manufacturer_settings) {
327 Utils.updateHeaderToSpecificActivityFromMetaDataOrRemove(this, target, header);
328 } else if (id == R.id.wifi_settings) {
329 // Remove WiFi Settings if WiFi service is not available.
330 if (!getPackageManager().hasSystemFeature(PackageManager.FEATURE_WIFI)) {
331 target.remove(header);
333 } else if (id == R.id.bluetooth_settings) {
334 // Remove Bluetooth Settings if Bluetooth service is not available.
335 if (!getPackageManager().hasSystemFeature(PackageManager.FEATURE_BLUETOOTH)) {
336 target.remove(header);
340 // Increment if the current one wasn't removed by the Utils code.
341 if (target.get(i) == header) {
342 // Hold on to the first header, when we need to reset to the top-level
343 if (mFirstHeader == null &&
344 HeaderAdapter.getHeaderType(header) != HeaderAdapter.HEADER_TYPE_CATEGORY) {
345 mFirstHeader = header;
347 mHeaderIndexMap.put(id, i);
353 private boolean needsDockSettings() {
354 return getResources().getBoolean(R.bool.has_dock_settings);
357 private void getMetaData() {
359 ActivityInfo ai = getPackageManager().getActivityInfo(getComponentName(),
360 PackageManager.GET_META_DATA);
361 if (ai == null || ai.metaData == null) return;
362 mTopLevelHeaderId = ai.metaData.getInt(META_DATA_KEY_HEADER_ID);
363 mFragmentClass = ai.metaData.getString(META_DATA_KEY_FRAGMENT_CLASS);
365 // Check if it has a parent specified and create a Header object
366 final int parentHeaderTitleRes = ai.metaData.getInt(META_DATA_KEY_PARENT_TITLE);
367 String parentFragmentClass = ai.metaData.getString(META_DATA_KEY_PARENT_FRAGMENT_CLASS);
368 if (parentFragmentClass != null) {
369 mParentHeader = new Header();
370 mParentHeader.fragment = parentFragmentClass;
371 if (parentHeaderTitleRes != 0) {
372 mParentHeader.title = getResources().getString(parentHeaderTitleRes);
375 } catch (NameNotFoundException nnfe) {
381 public boolean hasNextButton() {
382 return super.hasNextButton();
386 public Button getNextButton() {
387 return super.getNextButton();
390 private static class HeaderAdapter extends ArrayAdapter<Header> {
391 static final int HEADER_TYPE_CATEGORY = 0;
392 static final int HEADER_TYPE_NORMAL = 1;
393 static final int HEADER_TYPE_SWITCH = 2;
394 private static final int HEADER_TYPE_COUNT = HEADER_TYPE_SWITCH + 1;
396 private final WifiEnabler mWifiEnabler;
397 private final BluetoothEnabler mBluetoothEnabler;
399 private static class HeaderViewHolder {
406 private LayoutInflater mInflater;
408 static int getHeaderType(Header header) {
409 if (header.fragment == null && header.intent == null) {
410 return HEADER_TYPE_CATEGORY;
411 } else if (header.id == R.id.wifi_settings || header.id == R.id.bluetooth_settings) {
412 return HEADER_TYPE_SWITCH;
414 return HEADER_TYPE_NORMAL;
419 public int getItemViewType(int position) {
420 Header header = getItem(position);
421 return getHeaderType(header);
425 public boolean areAllItemsEnabled() {
426 return false; // because of categories
430 public boolean isEnabled(int position) {
431 return getItemViewType(position) != HEADER_TYPE_CATEGORY;
435 public int getViewTypeCount() {
436 return HEADER_TYPE_COUNT;
440 public boolean hasStableIds() {
444 public HeaderAdapter(Context context, List<Header> objects) {
445 super(context, 0, objects);
446 mInflater = (LayoutInflater)context.getSystemService(Context.LAYOUT_INFLATER_SERVICE);
448 // Temp Switches provided as placeholder until the adapter replaces these with actual
449 // Switches inflated from their layouts. Must be done before adapter is set in super
450 mWifiEnabler = new WifiEnabler(context, new Switch(context));
451 mBluetoothEnabler = new BluetoothEnabler(context, new Switch(context));
455 public View getView(int position, View convertView, ViewGroup parent) {
456 HeaderViewHolder holder;
457 Header header = getItem(position);
458 int headerType = getHeaderType(header);
461 if (convertView == null) {
462 holder = new HeaderViewHolder();
463 switch (headerType) {
464 case HEADER_TYPE_CATEGORY:
465 view = new TextView(getContext(), null,
466 android.R.attr.listSeparatorTextViewStyle);
467 holder.title = (TextView) view;
470 case HEADER_TYPE_SWITCH:
471 view = mInflater.inflate(R.layout.preference_header_switch_item, parent,
473 holder.icon = (ImageView) view.findViewById(R.id.icon);
474 holder.title = (TextView)
475 view.findViewById(com.android.internal.R.id.title);
476 holder.summary = (TextView)
477 view.findViewById(com.android.internal.R.id.summary);
478 holder.switch_ = (Switch) view.findViewById(R.id.switchWidget);
481 case HEADER_TYPE_NORMAL:
482 view = mInflater.inflate(
483 com.android.internal.R.layout.preference_header_item, parent,
485 holder.icon = (ImageView) view.findViewById(com.android.internal.R.id.icon);
486 holder.title = (TextView)
487 view.findViewById(com.android.internal.R.id.title);
488 holder.summary = (TextView)
489 view.findViewById(com.android.internal.R.id.summary);
495 holder = (HeaderViewHolder) view.getTag();
498 // All view fields must be updated every time, because the view may be recycled
499 switch (headerType) {
500 case HEADER_TYPE_CATEGORY:
501 holder.title.setText(header.getTitle(getContext().getResources()));
504 case HEADER_TYPE_SWITCH:
505 // Would need a different treatment if the main menu had more switches
506 if (header.id == R.id.wifi_settings) {
507 mWifiEnabler.setSwitch(holder.switch_);
509 mBluetoothEnabler.setSwitch(holder.switch_);
511 // No break, fall through on purpose to update common fields
514 case HEADER_TYPE_NORMAL:
515 holder.icon.setImageResource(header.iconRes);
516 holder.title.setText(header.getTitle(getContext().getResources()));
517 CharSequence summary = header.getSummary(getContext().getResources());
518 if (!TextUtils.isEmpty(summary)) {
519 holder.summary.setVisibility(View.VISIBLE);
520 holder.summary.setText(summary);
522 holder.summary.setVisibility(View.GONE);
530 public void resume() {
531 mWifiEnabler.resume();
532 mBluetoothEnabler.resume();
535 public void pause() {
536 mWifiEnabler.pause();
537 mBluetoothEnabler.pause();
542 public boolean onPreferenceStartFragment(PreferenceFragment caller, Preference pref) {
543 // Override the fragment title for Wallpaper settings
544 CharSequence title = pref.getTitle();
545 if (pref.getFragment().equals(WallpaperTypeSettings.class.getName())) {
546 title = getString(R.string.wallpaper_settings_fragment_title);
548 startPreferencePanel(pref.getFragment(), pref.getExtras(), 0, title, null, 0);
553 public void setListAdapter(ListAdapter adapter) {
554 if (mHeaders == null) {
555 mHeaders = new ArrayList<Header>();
556 // When the saved state provides the list of headers, onBuildHeaders is not called
557 // Copy the list of Headers from the adapter, preserving their order
558 for (int i = 0; i < adapter.getCount(); i++) {
559 mHeaders.add((Header) adapter.getItem(i));
563 // Ignore the adapter provided by PreferenceActivity and substitute ours instead
564 super.setListAdapter(new HeaderAdapter(this, mHeaders));
568 * Settings subclasses for launching independently.
570 public static class BluetoothSettingsActivity extends Settings { /* empty */ }
571 public static class WirelessSettingsActivity extends Settings { /* empty */ }
572 public static class TetherSettingsActivity extends Settings { /* empty */ }
573 public static class VpnSettingsActivity extends Settings { /* empty */ }
574 public static class DateTimeSettingsActivity extends Settings { /* empty */ }
575 public static class StorageSettingsActivity extends Settings { /* empty */ }
576 public static class WifiSettingsActivity extends Settings { /* empty */ }
577 public static class WifiP2pSettingsActivity extends Settings { /* empty */ }
578 public static class InputMethodAndLanguageSettingsActivity extends Settings { /* empty */ }
579 public static class InputMethodAndSubtypeEnablerActivity extends Settings { /* empty */ }
580 public static class SpellCheckersSettingsActivity extends Settings { /* empty */ }
581 public static class LocalePickerActivity extends Settings { /* empty */ }
582 public static class UserDictionarySettingsActivity extends Settings { /* empty */ }
583 public static class SoundSettingsActivity extends Settings { /* empty */ }
584 public static class DisplaySettingsActivity extends Settings { /* empty */ }
585 public static class DeviceInfoSettingsActivity extends Settings { /* empty */ }
586 public static class ApplicationSettingsActivity extends Settings { /* empty */ }
587 public static class ManageApplicationsActivity extends Settings { /* empty */ }
588 public static class StorageUseActivity extends Settings { /* empty */ }
589 public static class DevelopmentSettingsActivity extends Settings { /* empty */ }
590 public static class AccessibilitySettingsActivity extends Settings { /* empty */ }
591 public static class SecuritySettingsActivity extends Settings { /* empty */ }
592 public static class LocationSettingsActivity extends Settings { /* empty */ }
593 public static class PrivacySettingsActivity extends Settings { /* empty */ }
594 public static class DockSettingsActivity extends Settings { /* empty */ }
595 public static class RunningServicesActivity extends Settings { /* empty */ }
596 public static class ManageAccountsSettingsActivity extends Settings { /* empty */ }
597 public static class PowerUsageSummaryActivity extends Settings { /* empty */ }
598 public static class AccountSyncSettingsActivity extends Settings { /* empty */ }
599 public static class AccountSyncSettingsInAddAccountActivity extends Settings { /* empty */ }
600 public static class CryptKeeperSettingsActivity extends Settings { /* empty */ }
601 public static class DeviceAdminSettingsActivity extends Settings { /* empty */ }
602 public static class DataUsageSummaryActivity extends Settings { /* empty */ }
603 public static class AdvancedWifiSettingsActivity extends Settings { /* empty */ }
604 public static class TextToSpeechSettingsActivity extends Settings { /* empty */ }
605 public static class AndroidBeamSettingsActivity extends Settings { /* empty */ }