src/com/android/settings/Settings.java

/*
 * Copyright (C) 2008 The Android Open Source Project
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package com.android.settings;

import android.app.Activity;
import android.app.Fragment;
import android.app.Fragment.InstantiationException;
import android.content.Intent;
import android.os.Bundle;
import android.preference.Preference;
import android.preference.PreferenceFragment;
import android.preference.PreferenceGroup;
import android.preference.PreferenceScreen;
import android.text.TextUtils;
import android.util.Log;
import android.view.View;

import java.util.ArrayList;

/**
 * Top-level settings activity to handle single pane and double pane UI layout.
 */
public class Settings extends Activity
        implements PreferenceFragment.OnPreferenceStartFragmentCallback,
        SettingsPreferenceFragment.OnStateListener {

    private static final String TAG = "Settings";

    private static final String KEY_PARENT = "parent";
    private static final String KEY_CALL_SETTINGS = "call_settings";
    private static final String KEY_SYNC_SETTINGS = "sync_settings";
    private static final String KEY_SEARCH_SETTINGS = "search_settings";
    private static final String KEY_DOCK_SETTINGS = "dock_settings";

    private static final String KEY_OPERATOR_SETTINGS = "operator_settings";
    private static final String KEY_MANUFACTURER_SETTINGS = "manufacturer_settings";

    public static final String EXTRA_SHOW_FRAGMENT = ":settings:show_fragment";

    public static final String EXTRA_SHOW_FRAGMENT_ARGUMENTS = ":settings:show_fragment_args";

    // Temporary, until all top-level settings are converted to fragments
    private static final String BACK_STACK_PREFS = ":settings:prefs";

    private View mPrefsPane;
    private View mMainPane;
    private boolean mSinglePane;

    private ArrayList<CharSequence> mTrail = new ArrayList<CharSequence>();

    /*
    @Override
    protected void onResume() {
        super.onResume();
        findPreference(KEY_CALL_SETTINGS).setEnabled(!AirplaneModeEnabler.isAirplaneModeOn(this));
    }
    */

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.settings_top_level);
        mPrefsPane = findViewById(R.id.prefs);
        mMainPane = findViewById(R.id.top_level);
        mSinglePane = mMainPane == null;
        if (mSinglePane) mMainPane = mPrefsPane;

        final Intent intent = getIntent();
        String initialFragment = intent.getStringExtra(EXTRA_SHOW_FRAGMENT);
        Bundle initialArguments = intent.getBundleExtra(EXTRA_SHOW_FRAGMENT_ARGUMENTS);

        if (mSinglePane) {
            if (initialFragment != null) {
                showFragment(initialFragment, initialArguments);
            } else {
                // Intent#getCompontent() lets us get Fragment name, even when the Intent is
                // given via <activity-alias>.
                //
                // e.g. When we reach here via "ChildSetting" activity-alias,
                // we should get the name here instead of targetActivity ("Settings").
                if (intent.getComponent().getClassName().equals(this.getClass().getName())) {
                    showFragment(TopLevelSettings.class.getName(), null);
                } else {
                    showFragment(intent.getComponent().getClassName(), intent.getExtras());
                }
            }
        } else {
            if (!intent.getComponent().getClassName().equals(this.getClass().getName())) {
                if (showFragment(intent.getComponent().getClassName(), intent.getExtras())) {
                    mMainPane.setVisibility(View.GONE);
                }
            } else {
                Fragment topLevel = getFragmentManager().findFragmentById(R.id.top_level);
                if (topLevel != null) {
                    ((TopLevelSettings) topLevel).selectFirst();
                }
            }
        }
    }

    boolean showFragment(Preference preference) {
        if (mSinglePane) {
            startWithFragment(preference.getFragment(), preference.getExtras());
            return false;
        } else {
            return showFragment(preference.getFragment(), preference.getExtras());
        }
    }

    private void startWithFragment(String fragmentName, Bundle args) {
        Intent intent = new Intent(Intent.ACTION_MAIN);
        intent.setClass(this, getClass());
        intent.putExtra(EXTRA_SHOW_FRAGMENT, fragmentName);
        intent.putExtra(EXTRA_SHOW_FRAGMENT_ARGUMENTS, args);
        startActivity(intent);
    }

    private boolean showFragment(String fragmentClass, Bundle extras) {
        try {
            Fragment f = Fragment.instantiate(this, fragmentClass, extras);
            if (f instanceof SettingsPreferenceFragment) {
                ((SettingsPreferenceFragment) f).setOnStateListener(this);
            }
            getFragmentManager().openTransaction().replace(R.id.prefs, f).commit();
            return true;
        } catch (InstantiationException exc) {
            Log.d(TAG, "Couldn't instantiate fragment " + fragmentClass);
            return false;
        }
    }

    private void addToBreadCrumbs(Fragment fragment) {
        final CharSequence title = ((PreferenceFragment) fragment)
                .getPreferenceScreen().getTitle();
        if (mSinglePane) mTrail.clear();
        if (mTrail.size() == 0 || !TextUtils.equals(title, mTrail.get(mTrail.size() - 1))) {
            mTrail.add(title);
            updateTitle();
        }
    }

    private void removeFromBreadCrumbs(Fragment fragment) {
        if (mTrail.size() > 0) {
            mTrail.remove(mTrail.size() - 1);
        }
        updateTitle();
    }

    private void updateTitle() {
        String trail = "";
        for (CharSequence trailPart : mTrail) {
            if (trail.length() != 0)
                trail += " | ";
            trail = trail + trailPart;
        }
        setTitle(trail);
    }

    public void onCreated(SettingsPreferenceFragment fragment) {
        Log.d(TAG, "Fragment created " + fragment + " (name: " + fragment.getClass() + ")");
        addToBreadCrumbs(fragment);
    }

    public void onDestroyed(SettingsPreferenceFragment fragment) {
        removeFromBreadCrumbs(fragment);
        Log.d(TAG, "Fragment destroyed " + fragment + " (name: " + fragment.getClass() + ")");
    }

    public boolean onPreferenceStartFragment(PreferenceFragment caller, Preference pref) {
        Fragment f = Fragment.instantiate(this, pref.getFragment(), pref.getExtras());
        if (f instanceof SettingsPreferenceFragment) {
            ((SettingsPreferenceFragment) f).setOnStateListener(this);
        }
        getFragmentManager().openTransaction().replace(R.id.prefs, f)
                .addToBackStack(BACK_STACK_PREFS).commit();
        return true;
    }

    public static class TopLevelSettings extends PreferenceFragment {

        private IconPreferenceScreen mHighlightedPreference;

        @Override
        public void onCreate(Bundle savedInstanceState) {
            super.onCreate(savedInstanceState);

            // Load the preferences from an XML resource
            addPreferencesFromResource(R.xml.settings);

            updatePreferenceList();
        }

        private void updatePreferenceList() {
            final Activity activity = getActivity();
            PreferenceGroup parent = (PreferenceGroup) findPreference(KEY_PARENT);
            Utils.updatePreferenceToSpecificActivityOrRemove(activity, parent,
                    KEY_SYNC_SETTINGS, 0);
            Utils.updatePreferenceToSpecificActivityOrRemove(activity, parent,
                    KEY_SEARCH_SETTINGS, 0);

            Preference dockSettings = parent.findPreference(KEY_DOCK_SETTINGS);
            if (activity.getResources().getBoolean(R.bool.has_dock_settings) == false
                    && dockSettings != null) {
                parent.removePreference(dockSettings);
            }

            Utils.updatePreferenceToSpecificActivityFromMetaDataOrRemove(activity, parent,
                    KEY_OPERATOR_SETTINGS);
            Utils.updatePreferenceToSpecificActivityFromMetaDataOrRemove(activity, parent,
                    KEY_MANUFACTURER_SETTINGS);
        }

        @Override
        public boolean onPreferenceTreeClick(PreferenceScreen screen, Preference preference) {
            // If it is a fragment preference, replace the prefs pane in the 2 pane UI.
            final String fragmentClass = preference.getFragment();
            if (fragmentClass != null) {
                boolean showed = ((Settings) getActivity()).showFragment(preference);
                if (showed) {
                    highlight(preference);
                }
                return showed;
            }
            return false;
        }

        void highlight(Preference preference) {
            if (mHighlightedPreference != null) {
                mHighlightedPreference.setHighlighted(false);
            }
            mHighlightedPreference = (IconPreferenceScreen) preference;
            mHighlightedPreference.setHighlighted(true);
        }

        void selectFirst() {
            Preference first = getPreferenceScreen().getPreference(0);
            onPreferenceTreeClick(getPreferenceScreen(), first);
        }
    }
}