Android 應用啟動時僅執行一次邏輯：SharedPreferences 實現首次運行標識

核心需求

在 onCreate() 中執行某段初始化邏輯（如引導頁、數據遷移、權限申請、配置初始化），要求應用生命週期內僅執行一次，後續啟動自動跳過。

標準解決方案：SharedPreferences 持久化標識

實現代碼

public class MainActivity extends AppCompatActivity {
    private static final String PREFS_NAME = "AppInitPrefs";
    private static final String KEY_FIRST_RUN = "isFirstRun";

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        
        // 檢查是否首次運行
        if (isFirstRun()) {
            // 執行一次性初始化邏輯
            performFirstRunInitialization();
            
            // 標記為已初始化
            markFirstRunComplete();
        }
        
        // 正常業務邏輯...
    }
    
    private boolean isFirstRun() {
        SharedPreferences prefs = getSharedPreferences(PREFS_NAME, MODE_PRIVATE);
        return prefs.getBoolean(KEY_FIRST_RUN, true); // 默認 true（首次）
    }
    
    private void markFirstRunComplete() {
        SharedPreferences prefs = getSharedPreferences(PREFS_NAME, MODE_PRIVATE);
        prefs.edit().putBoolean(KEY_FIRST_RUN, false).apply(); // 異步寫入
    }
    
    private void performFirstRunInitialization() {
        // 具體業務：顯示引導頁、預載數據、申請權限、創建默認配置等
        showGuidePages();
        initDefaultSettings();
        preloadCriticalData();
    }
}

進階模式：版本感知的一次性執行

應用升級後需重新執行某些遷移邏輯：

private static final String KEY_LAST_VERSION_CODE = "lastVersionCode";

private boolean shouldRunForCurrentVersion() {
    SharedPreferences prefs = getSharedPreferences(PREFS_NAME, MODE_PRIVATE);
    int lastVersionCode = prefs.getInt(KEY_LAST_VERSION_CODE, -1);
    int currentVersionCode = BuildConfig.VERSION_CODE;
    
    if (lastVersionCode < currentVersionCode) {
        // 版本升級或首次安裝
        prefs.edit()
            .putInt(KEY_LAST_VERSION_CODE, currentVersionCode)
            .putBoolean(KEY_FIRST_RUN, false)
            .apply();
        return true;
    }
    return false;
}

替代方案對比

最佳實踐清單

1. ✅ 使用 apply() 而非 commit() 異步寫入，不阻塞主線程
2. ✅ 定義常量鍵名，避免拼寫錯誤
3. ✅ 邏輯與標識分離：isFirstRun()、markComplete()、performInit() 單一職責
4. ✅ 考慮「清除數據」場景：用戶在設置中清除應用數據後，標識重置，邏輯重新執行（符合預期）
5. ✅ 多進程應用：使用 MODE_MULTI_PROCESS 或遷移至 DataStore
6. ✅ 測試驗證：首次安裝 → 運行 → 關閉 → 重啟 → 驗證邏輯未執行

常見誤區

• ❌ 在 Application.onCreate() 中判斷：可能因多進程、組件啟動順序導致重複執行
• ❌ 使用靜態變量標識：進程重啟後失效，無法持久化
• ❌ 依賴 savedInstanceState：僅用於配置變更重建，不適用於冷啟動