src/com/android/settings/MediaFormat.java

   1 /*
   2  * Copyright (C) 2008 The Android Open Source Project
   3  *
   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
   7  *
   8  *      http://www.apache.org/licenses/LICENSE-2.0
   9  *
  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.
  15  */
  16
  17 package com.android.settings;
  18
  19 import android.app.Activity;
  20 import android.content.Intent;
  21 import android.os.Bundle;
  22 import android.os.storage.StorageVolume;
  23 import android.view.LayoutInflater;
  24 import android.view.View;
  25 import android.widget.Button;
  26
  27 import com.android.internal.os.storage.ExternalStorageFormatter;
  28
  29 /**
  30  * Confirm and execute a format of the sdcard.
  31  * Multiple confirmations are required: first, a general "are you sure
  32  * you want to do this?" prompt, followed by a keyguard pattern trace if the user
  33  * has defined one, followed by a final strongly-worded "THIS WILL ERASE EVERYTHING
  34  * ON THE SD CARD" prompt.  If at any time the phone is allowed to go to sleep, is
  35  * locked, et cetera, then the confirmation sequence is abandoned.
  36  */
  37 public class MediaFormat extends Activity {
  38
  39     private static final int KEYGUARD_REQUEST = 55;
  40
  41     private LayoutInflater mInflater;
  42
  43     private View mInitialView;
  44     private Button mInitiateButton;
  45
  46     private View mFinalView;
  47     private Button mFinalButton;
  48
  49     /**
  50      * The user has gone through the multiple confirmation, so now we go ahead
  51      * and invoke the Mount Service to format the SD card.
  52      */
  53     private Button.OnClickListener mFinalClickListener = new Button.OnClickListener() {
  54             public void onClick(View v) {
  55
  56                 if (Utils.isMonkeyRunning()) {
  57                     return;
  58                 }
  59                 Intent intent = new Intent(ExternalStorageFormatter.FORMAT_ONLY);
  60                 intent.setComponent(ExternalStorageFormatter.COMPONENT_NAME);
  61                 // Transfer the storage volume to the new intent
  62                 final StorageVolume storageVolume = getIntent().getParcelableExtra(
  63                         StorageVolume.EXTRA_STORAGE_VOLUME);
  64                 intent.putExtra(StorageVolume.EXTRA_STORAGE_VOLUME, storageVolume);
  65                 startService(intent);
  66                 finish();
  67             }
  68         };
  69
  70     /**
  71      *  Keyguard validation is run using the standard {@link ConfirmLockPattern}
  72      * component as a subactivity
  73      */
  74     private boolean runKeyguardConfirmation(int request) {
  75         return new ChooseLockSettingsHelper(this)
  76                 .launchConfirmationActivity(request,
  77                         getText(R.string.media_format_gesture_prompt),
  78                         getText(R.string.media_format_gesture_explanation));
  79     }
  80
  81     @Override
  82     protected void onActivityResult(int requestCode, int resultCode, Intent data) {
  83         super.onActivityResult(requestCode, resultCode, data);
  84
  85         if (requestCode != KEYGUARD_REQUEST) {
  86             return;
  87         }
  88
  89         // If the user entered a valid keyguard trace, present the final
  90         // confirmation prompt; otherwise, go back to the initial state.
  91         if (resultCode == Activity.RESULT_OK) {
  92             establishFinalConfirmationState();
  93         } else if (resultCode == Activity.RESULT_CANCELED) {
  94             finish();
  95         } else {
  96             establishInitialState();
  97         }
  98     }
  99
 100     /**
 101      * If the user clicks to begin the reset sequence, we next require a
 102      * keyguard confirmation if the user has currently enabled one.  If there
 103      * is no keyguard available, we simply go to the final confirmation prompt.
 104      */
 105     private Button.OnClickListener mInitiateListener = new Button.OnClickListener() {
 106             public void onClick(View v) {
 107                 if (!runKeyguardConfirmation(KEYGUARD_REQUEST)) {
 108                     establishFinalConfirmationState();
 109                 }
 110             }
 111         };
 112
 113     /**
 114      * Configure the UI for the final confirmation interaction
 115      */
 116     private void establishFinalConfirmationState() {
 117         if (mFinalView == null) {
 118             mFinalView = mInflater.inflate(R.layout.media_format_final, null);
 119             mFinalButton =
 120                     (Button) mFinalView.findViewById(R.id.execute_media_format);
 121             mFinalButton.setOnClickListener(mFinalClickListener);
 122         }
 123
 124         setContentView(mFinalView);
 125     }
 126
 127     /**
 128      * In its initial state, the activity presents a button for the user to
 129      * click in order to initiate a confirmation sequence.  This method is
 130      * called from various other points in the code to reset the activity to
 131      * this base state.
 132      *
 133      * <p>Reinflating views from resources is expensive and prevents us from
 134      * caching widget pointers, so we use a single-inflate pattern:  we lazy-
 135      * inflate each view, caching all of the widget pointers we'll need at the
 136      * time, then simply reuse the inflated views directly whenever we need
 137      * to change contents.
 138      */
 139     private void establishInitialState() {
 140         if (mInitialView == null) {
 141             mInitialView = mInflater.inflate(R.layout.media_format_primary, null);
 142             mInitiateButton =
 143                     (Button) mInitialView.findViewById(R.id.initiate_media_format);
 144             mInitiateButton.setOnClickListener(mInitiateListener);
 145         }
 146
 147         setContentView(mInitialView);
 148     }
 149
 150     @Override
 151     protected void onCreate(Bundle savedState) {
 152         super.onCreate(savedState);
 153
 154         mInitialView = null;
 155         mFinalView = null;
 156         mInflater = LayoutInflater.from(this);
 157
 158         establishInitialState();
 159     }
 160
 161     /** Abandon all progress through the confirmation sequence by returning
 162      * to the initial view any time the activity is interrupted (e.g. by
 163      * idle timeout).
 164      */
 165     @Override
 166     public void onPause() {
 167         super.onPause();
 168
 169         if (!isFinishing()) {
 170             establishInitialState();
 171         }
 172     }
 173 }