2020年的UWP(3)——UWP和desktop extension的簡單互動

樓上那個蜀黍發表於2020-11-10

上一篇《2020年的UWP(2)——In Process App Service》中我們瞭解了UWP和Desktop Extension可以通過AppService進行資料互動。本篇我們就來梳理在不同場景，UWP和Desktop Extension可能存在的互動方式。

對Desktop Extension中程式的型別，我暫時分為以下四種：

  • 執行後立即退出
  • 等待request，處理完後退出
  • 一或多個request/response週期
  • 和UWP程式相同生命週期

本篇我們僅討論第一種，Desktop Extension中執行後立即退出的程式。該型別有以下特徵：

  1. 簡單的單向呼叫：
  2. 不接受request
  3. 不關心返回結果
  4. 呼叫後立即退出

下圖是該型別互動場景的示意圖。通過FullTrustProcessLauncher從UWP端啟動Desktop Extension，我已在《遷移桌面程式到MS Store（9）——APPX With Desktop Extension》介紹過了，本篇不再贅述。

比較典型的如執行某個特定操作，例如呼叫LockScreen的Win32 API。

    class Program
    {
        [DllImport("user32.dll", SetLastError = true)]
        public static extern bool LockWorkStation();

        static void Main(string[] args)
        {
                LockWorkStation();
        }
    }

我們觀察從UWP端啟動Desktop Extension的程式碼：

        private async void Button_Click(object sender, RoutedEventArgs e)
        {
            await FullTrustProcessLauncher.LaunchFullTrustProcessForCurrentAppAsync();
        }

LaunchFullTrustProcessForCurrentAppAsync方法沒有傳遞引數給LockScreen方法，也不關心返回值。啟動Desktop Extension後也不會通過AppService進一步傳送request。
似乎和本篇的主題，資料互動毫不相關。但實際情況下，一個Desktop Extension的exe中，會有多個像LockScreen這種一次性的消費型方法。這就要求我們能夠區分UWP端具體要執行哪一個。
首先我們來介紹標準的做法，給LaunchFullTrustProcessForCurrentAppAsync方法傳參。

public static IAsyncAction LaunchFullTrustProcessForCurrentAppAsync(string parameterGroupId);

這裡要注意的是。這裡所謂的引數parameterGroupId，不會傳遞到Desktop Extension的Main方法裡。而是用這個string引數去Package.appxmanifest檔案中做匹配，在Package.appxmanifest檔案中對應的那個字串才會被傳遞給Main方法。

  <Applications>
    <Application Id="App"
      Executable="$targetnametoken$.exe"
      EntryPoint="$targetentrypoint$">
      <uap:VisualElements
        DisplayName="DataExchangeSimpleCallPackage"
        Description="DataExchangeSimpleCallPackage"
        BackgroundColor="transparent"
        Square150x150Logo="Images\Square150x150Logo.png"
        Square44x44Logo="Images\Square44x44Logo.png">
        <uap:DefaultTile Wide310x150Logo="Images\Wide310x150Logo.png" />
        <uap:SplashScreen Image="Images\SplashScreen.png" />
      </uap:VisualElements>
        <Extensions>
            <desktop:Extension Category="windows.fullTrustProcess" Executable="ExistAfterCallsProgram\ExistAfterCallsProgram.exe">
                <desktop:FullTrustProcess>
                    <desktop:ParameterGroup GroupId="LockScreen" Parameters="LockScreen" />
                    <desktop:ParameterGroup GroupId="ControlPanel" Parameters="ControlPanel" />
                </desktop:FullTrustProcess>
            </desktop:Extension>
        </Extensions>
    </Application>
  </Applications>

因為都是寫死的字串，除了用來區分Desktop Extension中數量有限的方法外，並不適合作為一種靈活的傳參方式用於具體方法的邏輯判斷。
通常意義上的靈活傳參給Desktop Extension，基本都是通過AppService來實現，在介紹另外三種型別時會展開討論。
在不使用AppService的簡單互動場景，除了欽定的使用parameterGroupId的做法外。還有一種容易被忽視的方式，即使用LocalSettings。

不提示的話，很難想到在同一個Package裡的UWP和Desktop Extension，是可以訪問相同的LocalSettings物件的。
在UWP的MainPage.cs中，我們將“mspaint.exe”儲存到key為“content”的LocalSettings鍵值對中。

        private async void ButtonLocalSettings_Click(object sender, RoutedEventArgs e)
        {
            ApplicationData.Current.LocalSettings.Values["content"] = "mspaint.exe";
            await FullTrustProcessLauncher.LaunchFullTrustProcessForCurrentAppAsync("LocalSettings");
        }

而在Desktop Extension中，我們同樣也可以取到這個值，從而達成資料互動的目的。在這個例子中，我們可以傳遞需要執行的exe、msi檔名或路徑，而不用為每一個檔案建立單獨的parameterGroupId。

        static void Main(string[] args)
        {
            string funcName = args[2];
            switch (funcName)
            {
                case "LockScreen":
                    LockWorkStation();
                    break;
                case "ControlPanel":
                    Process.Start("control.exe");
                    break;
                case "LocalSettings":
                    var content = ApplicationData.Current.LocalSettings.Values["content"].ToString();
                    Process.Start(content);
                    break;
            }
        }

本篇討論了UWP和Desktop Extension的簡單資料互動，“執行後立即退出”的場景。後續我們會接著講另外的三種型別，感謝看到這裡的同學們！
Github：
https://github.com/manupstairs/UWPSamples/tree/master/UWPSamples/DataExchangeUWP/ExitAfterCalls

 

相關文章