Pou's IT Life

在<Windows Phone 8.1 - Application lifecycle 概念>介紹了相關 XAML App 新 Lifecycle之後，

接著該篇將說明怎麼在 Lifecycle 中保存與還原 App 裡使用到的資料。

再複習一次這一篇重要的圖示：

針對這張圖搭配 App 的幾個重要事件來說明：

A. 負責處理 App 啟動的事件：

a-1. Override launch handler：

    不管任何理由當 App 被啟動時，系統會發送一個 Activated 事件。透過覆寫 OnLaunchHandler 來得知是什麼方式啟動。

    藉由「ActivationKind」列舉得知有那些啟動類型，如下圖說明：

    需注意有些項目有分「Windows Store Only 與 Windows Phone Only」。

    另外，「Windows.UI.Xaml.Application」定義多種可被覆寫的 OnActivated 方法互相配合。

    藉由覆寫 OnLaunched 方法補捉用戶啟動 App 的時機，並使用 LaunchActivatedEventArgs  取得啟動參數與 App 之前的狀態。

    [注意]

    a. OnLaunched 方法在 Windows Phone 環境，當用戶透過 Start tile 或 App list 啟動該 App 均會被觸發，即使 App 在記憶體

        中為 Suspended 狀態也是。

    b. OnLaunched 方法在 Windows Store 環境，當 App 存在記憶體中為 Suspended 時，用戶透過 Start tile 或 App list 均不會啟動。

a-2. Restore application data if app was suspended then terminated：

    當用戶選擇開啟已被 Terminated 的 App 後，系統會通知 Activated event 設定 Launch 的 Kind 的值為 Launch 與指定 PreviousExecutionState

    為 Terminated 或 ClosedByUser。此時，App 應該載入儲存的 application data 與更新畫面中的內容。如果 PreviousExecutionState 的值為：

    NotRunning 的話，代表 App 可能發現 Crash 或是其他狀態，那麼 App 應該回到剛啟動應用程式的狀態，初始化所有需要的值。

async protected override void OnLaunched(LaunchActivatedEventArgs args)

{

   if (args.PreviousExecutionState == ApplicationExecutionState.Terminated ||

       args.PreviousExecutionState == ApplicationExecutionState.ClosedByUser)

   {

      // TODO: Populate the UI with the previously saved application data

   }

   else

   {

      // TODO: Populate the UI with defaults

   }

   EnsurePageCreatedAndActivate();

}

    (如果 NotRunning 不處理，App 卻有邏輯是需要依賴 restore 的資料時，那可能會出現永遠 crash 的狀態，因為 restore 的資料是錯的，

    建議可以增加處理 NotRunning 來還原資料)

    [注意]

    〉在 Windows Phone，當 App 正在 suspended 或 re-launched 隨著用戶點擊 primary tile 或 app list 開啟時，Resuming event 永遠在

        OnLaunched event之後。可以搭配「LaunchActivatedEventArgs.TileId 」來決定 App 從 primary tile 或 secondary tiles 啟動時，

        是否需要保持離開前的狀態或是重新來過。

B. 負責處理 App 進入暫停的事件：

b-1. Register the suspending event handler：

        註冊 Suspending event 處理在 App 被系統 suspends 前把重要的資料保存起來。

partial class MainPage

{

   public MainPage()

   {

      InitializeComponent();

      Application.Current.Suspending += new SuspendingEventHandler(App_Suspending);

   }

}

b-2. Save application data before suspension：

         在保存資料時，可透過 File、ApplicationData、Roaming Data 或是 SuspendingManager 的功能將保存的物件序列化成檔案…等；

partial class MainPage

{

    async void App_Suspending(

        Object sender, 

        Windows.ApplicationModel.SuspendingEventArgs e)

    {

        // TODO: This is the time to save app data in case the process is terminated

    }

}

在此介紹簡單相關的 ApplicationData 相關類別的使用：

〉ApplicationData：

    提供存取應用程式資料的類別，包括：App 資料夾(local、roaming、temporary…)、檔案與設定…等。如下列舉：

     如果需要存取 App 安裝目錄下的檔案，請使用：Windows.ApplicationModel.Package.InstalledLocation。

b-3. Release exclusive resources and file handles：

        App 進入 Suspending event 時，除了要保存資料之外，可建議在這個時候將使用到的資源或存取中的檔案加以釋放，

例如：相機功能的存取、檔案占用、外部設備連接、網路資源…等，這樣有助於其他程式可以存取他們。等到 App 又重新被啟動時，

再重新取得連線與資源的存取。

[注意]

1. 當 App 剛被系統暫停後例如：用戶切換至另一個程式或回到開始畫面)，如果用戶又馬上切回到 App，

    App 中使用的變數與資料結構還是跟離開前的一樣，是不需特別做什麼事情的。

2. 當 App 被系統暫停後，系統僅是使用有限的記憶體空間保存該 App，但是當系統發現記憶體不夠用時，它會將暫停的 App 終結掉。

    此時，用戶再切換回 App 時，App 使用的變數與資料結構將消失，此時就需要 App 實作 OnLaunched 來還原資料；

3. 由於 App 由暫停至系統終結，App 本身不會收到任何事件，所以需要在觸發 Suspending event 時將資料保存；

4. 如果在 Suspending event 內處理的需要有非同步或較長的時間，記得運用 「SuspendingOperation.GetDeferral()」

    取得加長時間的請求，等到完成後再呼叫「Complete」宣告已完成；

5. 注意用 Visual studio Debug 時，需要藉由「Location toolbar」上的 Suspend icon 來觸發 Suspending event；

6. Windows 8.1 在 suspending event 內的邏輯時間不可超過 5 秒；

    Windows Phone 8.1 介於 1 ~ 10 秒之間；

C. 處理 App 由暫停狀態重新回到執行狀態 (Resume)：

c-1. Register the resuming event handler：

        註冊 Resuming event 負責還原 App 返回後，需要更新的內容與擷取網路資源的任務。

partial class MainPage

{

   public MainPage()

   {

      InitializeComponent();

      // 在畫面註冊 Resuming 事件來處理當 Page 返回時可對 UI 做一些處理

      Application.Current.Resuming += new EventHandler<Object>(App_Resuming);

   }

}

c-2. Refresh displayed content after suspension：

        藉由在 Page 註冊 Resuming event 來處理畫面的呈現與資料的 binding。

但是要注意：Resuming event 不是從 UI thread 衍生的，所以沒有辦法直接操作 UI 上的物件，需要搭配：dispatcher，來操作。

partial class MainPage

{

    private void App_Resuming(Object sender, Object e)

    {

        // TODO: Refresh network data

    }

}

D. 處理 Back button (只有 WP)：

    過去在 Silverlight App 開發的 Windows Phone App，當用戶按下 Back 按鈕時，如果 Navigation Stack 有其他 Page 系統將會自動退回上一頁。

但是 XAML App 開始將與 Store App 相同，按下 Back 按鈕後 App 會進入 Suspend 的狀態，畫面退回至 Start Screen 或另一個 App。

為了讓用戶有一致的操作體驗，在開發 XAML App 時需要針對 「BackPressed event」進行處理。

* BackPressed event：

    監聽該事件的觸發，搭配「BackPressedEventArgs.Handled」屬性值的設定，舉例來說：如果預計該 App 在第二個 Page 時，

    用戶按下了 Back button，希望退回到第一個 Page，那麼就應該設定「BackPressedEventArgs.Handled = true」代表 Back button 的事件已經

    被處理完畢不需要再往上一層通知處理。相反地，如果希望 App 進入 Suspend 的狀態那就不要設定該值。

    如下 App.xaml.cs 提供的範例<Handling the Back Button in a Windows Phone app (XAML)>：

public App()

{

    this.InitializeComponent();

    this.Suspending += this.OnSuspending;

    // 註冊要處理 Back Button 的事件邏輯。

    Windows.Phone.UI.Input.HardwareButtons.BackPressed += HardwareButtons_BackPressed;

}

void HardwareButtons_BackPressed(object sender, Windows.Phone.UI.Input.BackPressedEventArgs e)

{

    Frame frame = Window.Current.Content as Frame;

    if (frame == null)

    {

        return;

    }