### 影片簡介 - 本影片介紹在 Jetpack Compose 專案中，不同畫面之間分享資料的五種方法，不涵蓋舊式 XML 或 Fragment 方式。 ### Navigation Arguments - 使用 NavHost 的 navArguments 傳遞資料，簡單直覺。 - 資料存在 SavedStateHandle 中，可自動處理 Process Death。 - 適合單次傳遞簡單型別資料。 - 無法有效傳遞複雜資料或多螢幕間的資料共享。 - 傳遞的是靜態資料，無法動態變更。 ### Shared ViewModel - 透過在導航子圖（Nested Navigation Graph）中共用 ViewModel，實現多螢幕共用相同狀態。 - 使用自訂方法從子圖的 BackStackEntry 綁定 ViewModel，讓 ViewModel 只在子圖清除時一起清除。 - 適合流程性畫面（如註冊流程）中多步驟累積資料，所有畫面可讀寫同一份狀態。 - 支援即時狀態變更，可透過 StateFlow 觀察更新，能儲存任何複雜資料。 - 預設無法支援 Process Death，但可透過 SavedStateHandle 手動保存與還原狀態。 - 若使用 Hilt 依賴注入，需要以 HiltViewModel 取代標準 ViewModel 實作。 - 相較於單純傳遞 Navigation Arguments，更方便管理大量資料且支援動態變更。 - 缺點是容易產生耦合，若狀態只屬於單一螢幕，需小心拆分或使用多個 ViewModel，否則會增加除錯與維護難度。 - 適用於功能明確且多畫面需要共享資料的模組，例如 Onboarding 流程、即時通訊或視訊會議功能。 --- ### Sharing a Stateful Dependency - 透過單例物件（如 Singleton）分享狀態，例如以 Dagger Hilt 建立全域計數器並注入至多個 ViewModel。 - 簡單快速可以共享同一份資料實例。 - 不推薦此方法，因為無法自然支援 Process Death，需要醜陋的手動還原流程。 - 單例無生命週期管理，若只需要在局部範圍使用，必須手動重置狀態，易出錯。 - 容易造成狀態錯誤延續，例如使用者登出後狀態未清除問題。 ### CompositionLocals - 使用 CompositionLocal 機制可在 Composable 中共享資料，避免層層參數傳遞。 - 適合場景如在整個應用中共用 Scaffold 的 SnackbarHostState。 - 可簡化資料共享，但僅限於 Composable 之間，無法在 ViewModel 中使用。 - 需注意如果預覽畫面（Preview）沒有提供 CompositionLocal 會導致錯誤或顯示異常。 - 遇到無法提供預設值的 CompositionLocal，建議改用傳參數或回調函式的方式避免錯誤。 ### Persistent Storage - 透過如 SharedPreferences 保存資料，實現跨螢幕的資料共享並支援 Process Death。 - 常用於管理如使用者登入 Session 等需持久保存的重要資料。 - 儲存於磁碟而非記憶體，資料可在應用被系統回收或重啟後保留。 - 登出時需統一清除 Session 資料，建議集中管理登出流程以避免遺漏。 - 適用於需要全域且持久資料的場景，如使用者資訊、設定檔等。 ### Terminology - **Compose**：Google 推出的現代化 Android UI 框架，以 Kotlin 編寫，取代傳統 XML 布局。 - **Navigation Arguments**：通過導航傳遞的資料，用於在不同畫面間共享簡單資料。 - **NavHost**：承載不同畫面（Composable）的容器，負責導航流程。 - **Composable**：Compose 中可重組的 UI 元件，像是函式。 - **NavBackStackEntry**：導航堆疊中的單一項目，包含路由與相關資料。 - **SavedStateHandle**：用於保存 ViewModel 中的資料，以應對進程死亡（Process Death）。 - **Parcelable**：Android 中高效能的序列化機制，用於傳遞複雜資料。 - **Process Death**：應用程式因資源緊張被系統終止的情況。 - **Shared ViewModel**：讓多個畫面共享相同 ViewModel 實例，達成資料同步。 - **Navigation Graph**：定義應用內所有畫面及其之間的導航路徑的結構圖。 - **Subgraph**：Navigation Graph 中的一部分，代表一個功能模組內的流程。 - **StateFlow**：Kotlin 中一種可觀察、可持續變更的資料流。 - **ViewModel**：保存 UI 相關資料的類別，讓資料在配置變更（如旋轉螢幕）時依然存在。 - **Scoped ViewModel**：將 ViewModel 綁定至特定導航圖（Subgraph）內，控制生命週期。 - **Remember**：Compose 中保存狀態於重組期間的函式。 - **NavController**：Compose Navigation 中管理畫面切換的控制器。 - **Inclusive PopUpTo**：從導航堆疊中移除直到特定畫面（包含該畫面）的所有畫面。 - **State Restoration**：應對 Process Death，恢復應用狀態的機制。 - **Onboarding Flow**：引導新用戶完成初步設置流程的一系列畫面。 - **Arguments Bundle**：用來打包導航參數的資料結構。 - **Single Activity Architecture**：整個應用僅有一個 Activity，所有畫面以 Fragment 或 Compose 形式載入。 - **Stateless Data**：資料在傳遞後不可變動。 - **Dynamic State**：可變動的應用狀態，通常透過 StateFlow 管理。 - **NavGraphRoute**：導航圖中某個節點的路由名稱。 - **Lockcat Terminate Application**：Android Studio 提供的模擬 Process Death 的功能。 - **Parcelable Limitations**：限制了只能傳遞能序列化成 Parcelable 的資料類型。 - **State Coupling**：多個元件過度依賴同一個狀態來源，導致耦合。 - **Dependency Injection (DI)**：以依賴注入方式提供物件，如 ViewModelFactory 或 Hilt。 - **Hilt ViewModel**：使用 Hilt 進行依賴注入的 ViewModel。 - **Screen-specific State**：僅在特定畫面中需要的狀態資料。 - **Feature Module**：應用中具備獨立功能的一個模組單位。 - **ViewModelFactory**：負責創建 ViewModel 實例的工廠類別。 - **Jetpack**：Google 提供的一系列 Android 開發元件集合。 - **Single Responsibility Principle**：每個類別或模組應僅負責一個功能。 - **Unidirectional Data Flow**：資料以單一方向流動，方便追蹤變化。 - **Backstack Management**：管理應用畫面堆疊行為的策略。 - **Memory Management**：有效使用與釋放裝置記憶體的技術。 - **Event Handling**：處理使用者互動或系統事件的流程。 - **Lifecycle Awareness**：根據元件生命週期管理資料或行為。 - **State Hoisting**：將狀態提升至父 Composable 元件，由上層管理狀態。 - **MutableState**：Compose 中可變的狀態類型，用於觸發重組。 - **Back Navigation**：支援使用者返回上一個畫面的行為。 - **Deep Link**：外部連結直接導向應用內特定畫面的功能。 - **Route Parameterization**：將路由參數化，使不同資料可以共用同一路由結構。 - **Type Safety**：保證資料型別正確，減少執行期錯誤。 - **Recomposition**：Compose 根據狀態變更重新渲染 UI。 - **Graph Scope**：限制 ViewModel 或其他元件的生命週期在特定導航圖內。 - **State Preservation**：保存應用狀態以應對不可預期終止或配置變更。 - **Composable Destination**：指定可組合目的地（畫面）的導航目標。 - **Stateful Dependency**：具有內部可變狀態的類別，常用來在應用中多處共享資料。 - **Singleton**：全應用共用的單一實例，生命週期與應用程式相同。 - **Dagger Hilt**：Android 用的依賴注入框架，簡化物件管理。 - **MutableStateFlow**：可以持續變化並能被觀察的資料流，支援即時更新 UI。 - **Global Counter**：一個應用中共用的計數器實例，通常為單例。 - **Injection**：將依賴物件自動提供給需要的類別或元件。 - **State Synchronization**：跨畫面保持資料一致性的技術。 - **Manual State Reset**：在需要時手動重設單例物件中的狀態資料。 - **Process Death Issue**：單例無法天然支援進程死亡後狀態恢復的問題。 - **Global State Danger**：過度依賴全域狀態導致難以維護與錯誤頻發。 - **Scoped Singleton**：將單例限定在特定範圍內，避免全域污染。 - **Authentication State**：表示使用者是否登入的狀態資料。 - **Navigation Graph Lifecycle**：透過導航圖控制狀態生命週期，確保適時清除。 - **Composition Local**：Compose 中提供資料給下層 Composables 的機制。 - **LocalContext**：取得目前組成上下文的 CompositionLocal。 - **LocalSnackbarHostState**：提供 Snackbar 控制狀態的 CompositionLocal。 - **CompositionLocalProvider**：提供 CompositionLocal 值的組合式函式。 - **SnackbarHost**：用來在應用中統一顯示提示訊息的元件。 - **Context Sharing**：在 Compose 中分享 Context 物件。 - **Preview Breakage**：由於 CompositionLocal 缺失導致的預覽失效。 - **Default Value for CompositionLocal**：設定 CompositionLocal 預設值，避免錯誤。 - **RememberNavController Issue**：因為是組合式函式，無法當作預設值使用。 - **Error Throwing CompositionLocal**：無法提供預設值時，拋出錯誤提醒。 - **Callback Usage**：以回呼函式取代直接傳遞大型狀態或控制器。 - **Persistent Storage**：將資料保存至裝置儲存空間，應對應用終止與重啟。 - **Session Cache**：用來保存登入使用者資訊的快取機制。 - **SharedPreferences**：Android 上簡單輕量的持久儲存方式。 - **Session Management**：管理使用者登入會話的策略。 - **JSON Serialization**：將物件轉換為 JSON 字串以便儲存或傳遞。 - **Moshi Library**：Android 上常用的 JSON 序列化與反序列化庫。 - **Process Death Persistence**：即使應用被系統終止，也能恢復資料。 - **Login State Sharing**：跨畫面共用使用者登入狀態。 - **Logout Handling**：在登出時清除所有相關資料的作法。 - **Global Logout Function**：統一管理登出行為的函式。 - **User Session Survival**：確保使用者會話在應用重啟後仍然存在。 - **Disk-backed Storage**：資料存儲於裝置硬碟，而非記憶體。 - **Navigation and Storage Integration**：導航與儲存整合應對狀態問題。 - **Data Access Object (DAO)**：數據存取物件，用於與資料庫或儲存層互動。 - **Token Expiration Management**：管理登入憑證過期的邏輯。 - **Cross-screen State Retrieval**：在不同畫面中取得共享資料。 - **Serialization Error Handling**：處理資料序列化失敗的錯誤。 - **State Consistency Assurance**：確保在各畫面間狀態一致。 - **Shared Storage Injection**：將持久儲存物件注入至 ViewModel 或其他類別。 - **Data Persistence Strategy**：根據應用需求設計資料保存策略。 - **Application-wide Session Access**：整個應用可存取的使用者會話資料。 - **Storage Layer Abstraction**：將儲存邏輯封裝於單獨類別，易於管理。 - **Disk I/O Considerations**：考量儲存與讀取資料對效能的影響。 - **Session Expiry Handling**：自動處理會話過期與重新登入流程。 - **SharedPreferences Key Management**：有組織地管理偏好設定中的 Key。 - **Error-prone Manual Management**：警惕因手動管理狀態導致的錯誤。 - **Robust State Sharing**：強健可靠的跨畫面資料共享方法。 - **Process Resilience**：設計能適應應用被系統中止的架構。