萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> Android 開發

Android 螢幕旋轉時資料保存與恢復完整指南

為什麼螢幕旋轉會導致 Activity 重建?

Android 為了適應不同螢幕方向的佈局資源(如 layout-land、layout-port),預設會在裝置旋轉時銷毀並重建當前 Activity。這意味著所有成員變數、View 狀態、執行緒狀態都會丟失,除非開發者主動保存與恢復。

核心生命週期方法對照

旋轉前(銷毀階段)          旋轉後(重建階段)
┌─────────────────────┐      ┌─────────────────────┐
│ onPause()           │ ──▶  │ onCreate(Bundle)    │
│ onSaveInstanceState()│     │ onStart()           │
│ onStop()            │      │ onRestoreInstanceState()│
│ onDestroy()         │      │ onResume()          │
└─────────────────────┘      └─────────────────────┘

Bundle 儲存機制完整範例

public class MainActivity extends AppCompatActivity {
    private static final String KEY_TIMESTAMP = "saved_timestamp";
    private static final String KEY_USER_INPUT = "user_input_text";
    private static final String KEY_COUNTER = "click_counter";
    
    private EditText inputEditText;
    private TextView counterTextView;
    private long lastSaveTime;
    private int clickCount = 0;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        
        inputEditText = findViewById(R.id.input_edit_text);
        counterTextView = findViewById(R.id.counter_text_view);
        
        // 1. 從 Bundle 恢復資料(兩種方式皆可)
        if (savedInstanceState != null) {
            restoreFromBundle(savedInstanceState);
        }
        
        findViewById(R.id.increment_btn).setOnClickListener(v -> {
            clickCount++;
            updateCounterDisplay();
        });
    }

    // 方式一:在 onCreate 中恢復(推薦,較早執行)
    private void restoreFromBundle(Bundle bundle) {
        lastSaveTime = bundle.getLong(KEY_TIMESTAMP, 0);
        String savedText = bundle.getString(KEY_USER_INPUT, "");
        clickCount = bundle.getInt(KEY_COUNTER, 0);
        
        inputEditText.setText(savedText);
        updateCounterDisplay();
        
        Log.d("RotationDemo", "Restored: time=" + lastSaveTime + ", count=" + clickCount);
    }

    // 方式二:在 onRestoreInstanceState 中恢復(onStart 之後)
    @Override
    protected void onRestoreInstanceState(@NonNull Bundle savedInstanceState) {
        super.onRestoreInstanceState(savedInstanceState);
        // 此處同樣可恢復資料,但比 onCreate 晚執行
    }

    // 儲存資料:在 onStop 之前、onPause 之後調用
    @Override
    protected void onSaveInstanceState(@NonNull Bundle outState) {
        super.onSaveInstanceState(outState);
        
        lastSaveTime = System.currentTimeMillis();
        outState.putLong(KEY_TIMESTAMP, lastSaveTime);
        outState.putString(KEY_USER_INPUT, inputEditText.getText().toString());
        outState.putInt(KEY_COUNTER, clickCount);
        
        Log.d("RotationDemo", "Saved: time=" + lastSaveTime + ", count=" + clickCount);
    }
    
    private void updateCounterDisplay() {
        counterTextView.setText("點擊次數: " + clickCount);
    }
}

View 系統自動保存機制

擁有 android:id 的 View 會自動保存與恢復部分狀態:

  • EditText:輸入文字、游標位置、選取範圍
  • ScrollView、RecyclerView:捲動位置
  • CheckBox、RadioButton、Switch:勾選狀態
  • WebView:需手動呼叫 saveState()/restoreState()

注意:自動保存要求 View 必須設定 android:id,且 ID 在旋轉前後保持一致。

進階場景:大量資料與非 Bundle 型別處理

Bundle 有大小限制(約 50KB-100KB),且僅支援基本型別與 Parcelable/Serializable。大量資料建議採用以下策略:

方案一:ViewModel + SavedStateHandle(現代推薦)

public class RotationViewModel extends ViewModel {
    private final SavedStateHandle handle;
    private MutableLiveData> userList;

    public RotationViewModel(SavedStateHandle handle) {
        this.handle = handle;
    }

    public LiveData> getUserList() {
        if (userList == null) {
            // 從 SavedStateHandle 恢復或重新載入
            userList = handle.getLiveData("user_list", new MutableLiveData<>());
            if (userList.getValue() == null) {
                loadUserListFromRepository();
            }
        }
        return userList;
    }
    
    private void loadUserListFromRepository() {
        // 從資料庫/網路載入,完成後 postValue 更新
    }
}

方案二:onRetainNonConfigurationInstance(舊版 API,不推薦新專案使用)

@Override
public Object onRetainNonConfigurationInstance() {
    // 僅保留非配置相關的大型物件,如執行緒、資料庫連線
    return heavyDataObject;
}

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    Object retained = getLastNonConfigurationInstance();
    if (retained != null) {
        heavyDataObject = (HeavyDataObject) retained;
    }
}

最佳實踐總結

  1. 優先使用 ViewModel:配合 SavedStateHandle 自動處理旋轉保存,程式碼最簡潔
  2. 小量 UI 狀態用 Bundle:表單輸入、捲動位置、簡單計數器
  3. 避免在 Bundle 存放大型物件:Bitmap、Cursor、大型集合會導致 TransactionTooLargeException
  4. 測試旋轉場景:開發者選項啟用「不要保留活動」強制測試
  5. 考慮鎖定方向:若畫面極不適合旋轉(如遊戲、相機),在 Manifest 設定 android:screenOrientation="portrait"

常見錯誤排查

  • NullPointerException 在恢復時:檢查 savedInstanceState != null 後再讀取
  • 資料不見了:確認 super.onSaveInstanceState() 在自定儲存邏輯之後呼叫
  • 自動保存失效:檢查 View 是否有 android:id、佈局檔案旋轉前後 ID 是否一致
copyright © 萬盛學電腦網 all rights reserved