app/src/main/java/net/ktnx/mobileledger/SettingsActivity.java

   1 package net.ktnx.mobileledger;
   2
   3 import android.annotation.TargetApi;
   4 import android.content.Context;
   5 import android.content.Intent;
   6 import android.content.res.Configuration;
   7 import android.media.Ringtone;
   8 import android.media.RingtoneManager;
   9 import android.net.Uri;
  10 import android.os.Build;
  11 import android.os.Bundle;
  12 import android.preference.ListPreference;
  13 import android.preference.Preference;
  14 import android.preference.PreferenceActivity;
  15 import android.preference.PreferenceFragment;
  16 import android.preference.PreferenceManager;
  17 import android.preference.RingtonePreference;
  18 import android.support.v4.app.NavUtils;
  19 import android.support.v7.app.ActionBar;
  20 import android.text.TextUtils;
  21 import android.view.MenuItem;
  22
  23 import java.util.List;
  24
  25 /**
  26  * A {@link PreferenceActivity} that presents a set of application settings. On
  27  * handset devices, settings are presented as a single list. On tablets,
  28  * settings are split by category, with category headers shown to the left of
  29  * the list of settings.
  30  * <p>
  31  * See <a href="http://developer.android.com/design/patterns/settings.html">
  32  * Android Design: Settings</a> for design guidelines and the <a
  33  * href="http://developer.android.com/guide/topics/ui/settings.html">Settings
  34  * API Guide</a> for more information on developing a Settings UI.
  35  */
  36 public class SettingsActivity extends AppCompatPreferenceActivity {
  37
  38     /**
  39      * A preference value change listener that updates the preference's summary
  40      * to reflect its new value.
  41      */
  42     private static Preference.OnPreferenceChangeListener sBindPreferenceSummaryToValueListener = (preference, value) -> {
  43         String stringValue = value.toString();
  44
  45         AccountSummary.preferences_changed();
  46
  47         if (preference instanceof ListPreference) {
  48             // For list preferences, look up the correct display value in
  49             // the preference's 'entries' list.
  50             ListPreference listPreference = (ListPreference) preference;
  51             int index = listPreference.findIndexOfValue(stringValue);
  52
  53             // Set the summary to reflect the new value.
  54             preference.setSummary(
  55                     index >= 0
  56                             ? listPreference.getEntries()[index]
  57                             : null);
  58
  59         } else if (preference instanceof RingtonePreference) {
  60             // For ringtone preferences, look up the correct display value
  61             // using RingtoneManager.
  62             if (TextUtils.isEmpty(stringValue)) {
  63                 // Empty values correspond to 'silent' (no ringtone).
  64                 preference.setSummary(R.string.pref_ringtone_silent);
  65
  66             } else {
  67                 Ringtone ringtone = RingtoneManager.getRingtone(
  68                         preference.getContext(), Uri.parse(stringValue));
  69
  70                 if (ringtone == null) {
  71                     // Clear the summary if there was a lookup error.
  72                     preference.setSummary(null);
  73                 } else {
  74                     // Set the summary to reflect the new ringtone display
  75                     // name.
  76                     String name = ringtone.getTitle(preference.getContext());
  77                     preference.setSummary(name);
  78                 }
  79             }
  80         } else {
  81             // For all other preferences, set the summary to the value's
  82             // simple string representation.
  83             preference.setSummary(stringValue);
  84         }
  85
  86         return true;
  87     };
  88
  89     /**
  90      * Helper method to determine if the device has an extra-large screen. For
  91      * example, 10" tablets are extra-large.
  92      */
  93     private static boolean isXLargeTablet(Context context) {
  94         return (context.getResources().getConfiguration().screenLayout
  95                 & Configuration.SCREENLAYOUT_SIZE_MASK) >= Configuration.SCREENLAYOUT_SIZE_XLARGE;
  96     }
  97
  98     /**
  99      * Binds a preference's summary to its value. More specifically, when the
 100      * preference's value is changed, its summary (line of text below the
 101      * preference title) is updated to reflect the value. The summary is also
 102      * immediately updated upon calling this method. The exact display format is
 103      * dependent on the type of preference.
 104      *
 105      * @see #sBindPreferenceSummaryToValueListener
 106      */
 107     private static void bindPreferenceSummaryToValue(Preference preference) {
 108         // Set the listener to watch for value changes.
 109         preference.setOnPreferenceChangeListener(sBindPreferenceSummaryToValueListener);
 110
 111         // Trigger the listener immediately with the preference's
 112         // current value.
 113         sBindPreferenceSummaryToValueListener.onPreferenceChange(preference,
 114                 PreferenceManager
 115                         .getDefaultSharedPreferences(preference.getContext())
 116                         .getString(preference.getKey(), ""));
 117     }
 118
 119     @Override
 120     protected void onCreate(Bundle savedInstanceState) {
 121         super.onCreate(savedInstanceState);
 122         setupActionBar();
 123     }
 124
 125     /**
 126      * Set up the {@link android.app.ActionBar}, if the API is available.
 127      */
 128     private void setupActionBar() {
 129         ActionBar actionBar = getSupportActionBar();
 130         if (actionBar != null) {
 131             // Show the Up button in the action bar.
 132             actionBar.setDisplayHomeAsUpEnabled(true);
 133         }
 134     }
 135
 136     @Override
 137     public boolean onMenuItemSelected(int featureId, MenuItem item) {
 138         int id = item.getItemId();
 139         if (id == android.R.id.home) {
 140             if (!super.onMenuItemSelected(featureId, item)) {
 141                 NavUtils.navigateUpFromSameTask(this);
 142             }
 143             return true;
 144         }
 145         return super.onMenuItemSelected(featureId, item);
 146     }
 147
 148     /**
 149      * {@inheritDoc}
 150      */
 151     @Override
 152     public boolean onIsMultiPane() {
 153         return isXLargeTablet(this);
 154     }
 155
 156     /**
 157      * {@inheritDoc}
 158      */
 159     @Override
 160     @TargetApi(Build.VERSION_CODES.HONEYCOMB)
 161     public void onBuildHeaders(List<Header> target) {
 162         loadHeadersFromResource(R.xml.pref_headers, target);
 163     }
 164
 165     /**
 166      * This method stops fragment injection in malicious applications.
 167      * Make sure to deny any unknown fragments here.
 168      */
 169     protected boolean isValidFragment(String fragmentName) {
 170         return PreferenceFragment.class.getName().equals(fragmentName)
 171                 || BackendPreferenceFragment.class.getName().equals(fragmentName)
 172                 || DataSyncPreferenceFragment.class.getName().equals(fragmentName)
 173                 || NotificationPreferenceFragment.class.getName().equals(fragmentName)
 174                 || InterfacePreferenceFragment.class.getName().equals(fragmentName);
 175     }
 176
 177     /**
 178      * This fragment shows general preferences only. It is used when the
 179      * activity is showing a two-pane settings UI.
 180      */
 181     @TargetApi(Build.VERSION_CODES.HONEYCOMB)
 182     public static class BackendPreferenceFragment extends PreferenceFragment {
 183         @Override
 184         public void onCreate(Bundle savedInstanceState) {
 185             super.onCreate(savedInstanceState);
 186             addPreferencesFromResource(R.xml.pref_backend);
 187             setHasOptionsMenu(true);
 188
 189             // Bind the summaries of EditText/List/Dialog/Ringtone preferences
 190             // to their values. When their values change, their summaries are
 191             // updated to reflect the new value, per the Android Design
 192             // guidelines.
 193             bindPreferenceSummaryToValue(findPreference("backend_url"));
 194             bindPreferenceSummaryToValue(findPreference("backend_auth_user"));
 195
 196         }
 197
 198         @Override
 199         public boolean onOptionsItemSelected(MenuItem item) {
 200             int id = item.getItemId();
 201             if (id == android.R.id.home) {
 202                 startActivity(new Intent(getActivity(), SettingsActivity.class));
 203                 return true;
 204             }
 205             return super.onOptionsItemSelected(item);
 206         }
 207     }
 208
 209     /**
 210      * This fragment shows general preferences only. It is used when the
 211      * activity is showing a two-pane settings UI.
 212      */
 213     @TargetApi(Build.VERSION_CODES.HONEYCOMB)
 214     public static
 215     class InterfacePreferenceFragment extends PreferenceFragment {
 216         @Override
 217         public
 218         void onCreate(Bundle savedInstanceState) {
 219             super.onCreate(savedInstanceState);
 220             addPreferencesFromResource(R.xml.pref_interface);
 221             setHasOptionsMenu(true);
 222
 223             // Bind the summaries of EditText/List/Dialog/Ringtone preferences
 224             // to their values. When their values change, their summaries are
 225             // updated to reflect the new value, per the Android Design
 226             // guidelines.
 227 //            bindPreferenceSummaryToValue(findPreference("show_hidden_accounts"));
 228
 229         }
 230
 231         @Override
 232         public
 233         boolean onOptionsItemSelected(MenuItem item) {
 234             int id = item.getItemId();
 235             if (id == android.R.id.home) {
 236                 startActivity(new Intent(getActivity(), SettingsActivity.class));
 237                 return true;
 238             }
 239             return super.onOptionsItemSelected(item);
 240         }
 241     }
 242
 243     /**
 244      * This fragment shows notification preferences only. It is used when the
 245      * activity is showing a two-pane settings UI.
 246      */
 247     @TargetApi(Build.VERSION_CODES.HONEYCOMB)
 248     public static class NotificationPreferenceFragment extends PreferenceFragment {
 249         @Override
 250         public void onCreate(Bundle savedInstanceState) {
 251             super.onCreate(savedInstanceState);
 252             addPreferencesFromResource(R.xml.pref_notification);
 253             setHasOptionsMenu(true);
 254
 255             // Bind the summaries of EditText/List/Dialog/Ringtone preferences
 256             // to their values. When their values change, their summaries are
 257             // updated to reflect the new value, per the Android Design
 258             // guidelines.
 259             bindPreferenceSummaryToValue(findPreference("notifications_new_message_ringtone"));
 260         }
 261
 262         @Override
 263         public boolean onOptionsItemSelected(MenuItem item) {
 264             int id = item.getItemId();
 265             if (id == android.R.id.home) {
 266                 startActivity(new Intent(getActivity(), SettingsActivity.class));
 267                 return true;
 268             }
 269             return super.onOptionsItemSelected(item);
 270         }
 271     }
 272
 273     /**
 274      * This fragment shows data and sync preferences only. It is used when the
 275      * activity is showing a two-pane settings UI.
 276      */
 277     @TargetApi(Build.VERSION_CODES.HONEYCOMB)
 278     public static class DataSyncPreferenceFragment extends PreferenceFragment {
 279         @Override
 280         public void onCreate(Bundle savedInstanceState) {
 281             super.onCreate(savedInstanceState);
 282             addPreferencesFromResource(R.xml.pref_data_sync);
 283             setHasOptionsMenu(true);
 284
 285             // Bind the summaries of EditText/List/Dialog/Ringtone preferences
 286             // to their values. When their values change, their summaries are
 287             // updated to reflect the new value, per the Android Design
 288             // guidelines.
 289             bindPreferenceSummaryToValue(findPreference("sync_frequency"));
 290         }
 291
 292         @Override
 293         public boolean onOptionsItemSelected(MenuItem item) {
 294             int id = item.getItemId();
 295             if (id == android.R.id.home) {
 296                 startActivity(new Intent(getActivity(), SettingsActivity.class));
 297                 return true;
 298             }
 299             return super.onOptionsItemSelected(item);
 300         }
 301     }
 302 }