アプリサービスの作成と利用

[アーティクル]
06/02/2023

重要

このトピックのコードリストは C# のみです。 C++/WinRT および C# の App Service サンプルアプリについては、App service サンプルアプリに関するページを参照してください。

アプリサービスは、他の UWP アプリにサービスを提供する UWP アプリです。これは、デバイス上にある Web サービスのようなものです。アプリサービスは、バックグラウンドタスクとしてホストアプリで実行され、そのサービスを他のアプリに提供することができます。たとえば、アプリサービスによって、他のアプリで使用できるバーコードスキャナーサービスが提供される場合があります。また、アプリのエンタープライズスイートに共通のスペルチェックアプリサービスを備えておき、そのサービスを同じスイート内の他のアプリから利用可能にする場合もあるでしょう。アプリサービスでは、同じデバイス上のアプリから呼び出せる UI を持たないサービスを作成できます。また、Windows 10 バージョン 1607 以降では、リモートデバイスからも呼び出せます。

Windows 10 バージョン 1607 以降では、ホストアプリと同じプロセスで実行されるアプリサービスを作成できます。この記事では、別のバックグラウンドプロセスで実行されるアプリサービスの作成と利用に重点を置いて説明します。プロバイダーと同じプロセスでアプリサービスを実行する詳細については、「ホストアプリと同じプロセスで実行するようにアプリサービスを変換する」をご覧ください。

新しいアプリサービスプロバイダープロジェクトの作成

このトピックでは、わかりやすくするためにすべてを 1 つのソリューションで作成します。

Visual Studio 2015 以降で、新しい UWP アプリプロジェクトを作成し、これに AppServiceProvider という名前を付けます。
1. [ファイル] > [新規] > [プロジェクト...] の順に選択します。
2. [新しいプロジェクトの作成] ダイアログボックスで、[空のアプリ (ユニバーサル Windows) C#] を選択します。これは、他の UWP アプリがアプリサービスを利用できるアプリとなります。
3. [次へ] をクリックし、プロジェクトに AppServiceProvider という名前を付け、その場所を選択して、[作成] をクリックします。
プロジェクトの[ターゲット] と [最小バージョン] の選択を求められたら、10.0.14393 以上を選びます。新しい SupportsMultipleInstances 属性を使用する場合は、Visual Studio 2017 または Visual Studio 2019 を使用し、10.0.15063 (Windows 10 Creators Update) 以降をターゲットにする必要があります。

Package.appxmanifest への App Service 拡張機能の追加

AppServiceProvider プロジェクトの Package.appxmanifest ファイルをテキストエディターで開きます。

ソリューションエクスプローラーで右クリックします。
[プログラムから開く] を選択します。
[XML (テキスト) エディター] を選択します。

次の AppService 拡張機能を <Application> 要素内に追加します。この例では、com.microsoft.inventory サービスをアドバタイズし、このアプリをアプリサービスプロバイダーとして識別します。実際のサービスは、バックグラウンドタスクとして実装されます。アプリサービスのプロジェクトは、サービスを他のアプリに公開します。サービス名には逆のドメイン名スタイルを使うことをお勧めします。

名前空間プレフィックス xmlns:uap4 と uap4:SupportsMultipleInstances 属性は、Windows SDK バージョン 10.0.15063 以降を対象としている場合にのみ有効です。以前のバージョンの SDK をターゲットとしている場合には、それらは安全に削除できます。

注意

C++/WinRT および C# の App Service サンプルアプリについては、App service サンプルアプリに関するページを参照してください。

<Package
    ...
    xmlns:uap3="http://schemas.microsoft.com/appx/manifest/uap/windows10/3"
    xmlns:uap4="http://schemas.microsoft.com/appx/manifest/uap/windows10/4"
    ...
    <Applications>
        <Application Id="AppServiceProvider.App"
          Executable="$targetnametoken$.exe"
          EntryPoint="AppServiceProvider.App">
          ...
          <Extensions>
            <uap:Extension Category="windows.appService" EntryPoint="MyAppService.Inventory">
              <uap3:AppService Name="com.microsoft.inventory" uap4:SupportsMultipleInstances="true"/>
            </uap:Extension>
          </Extensions>
          ...
        </Application>
    </Applications>

Category 属性は、このアプリケーションを App Service プロバイダーとして識別します。

EntryPoint 属性は、サービスを実装する名前空間修飾クラスを識別します。これについては、次に実装します。

SupportsMultipleInstances 属性は、App Service が呼び出されるたびに、新しいプロセスで実行する必要があることを示します。これは必須ではありませんが、その機能が必要で、10.0.15063 SDK (Windows 10 Creators Update) 以降を対象としている場合に使用できます。また、先頭に uap4 名前空間を付ける必要があります。

アプリサービスの作成

アプリサービスは、バックグラウンドタスクとして実装できます。これにより、フォアグラウンドアプリケーションは、別のアプリケーションのアプリサービスを呼び出すことができます。 App Service をバックグラウンドタスクとして作成するには、MyAppService という名前の新しい Windows ランタイムコンポーネントプロジェクトをソリューションに追加 ([ファイル] > [追加] > [新しいプロジェクト]) します。 [新しいプロジェクトの追加] ダイアログボックスで、[インストール済み] > [Visual C#] > [Windows ランタイムコンポーネント (ユニバーサル Windows)] の順に選びます。
AppServiceProvider プロジェクトで、新しい MyAppService プロジェクト (ソリューションエクスプローラーで、[AppServiceProvider] を右クリックし、[プロジェクト]>[追加]>[リファレンス]>[プロジェクト]>[ソリューション] から [MyAppService]>[OK] を選択) へプロジェクト間の参照を追加します。参照を追加しない場合でも、アプリサービスは実行時に接続されないため、この手順は重要です。

MyAppService プロジェクトで、Class1.cs の上部に、次の using ステートメントを追加します。

using Windows.ApplicationModel.AppService;
using Windows.ApplicationModel.Background;
using Windows.Foundation.Collections;

Class1.cs から Inventory.cs に名前を変更し、Class1 のスタブコードを Inventory という名前の新しいバックグラウンドタスククラスに置き換えます。
```
public sealed class Inventory : IBackgroundTask
{
    private BackgroundTaskDeferral backgroundTaskDeferral;
    private AppServiceConnection appServiceconnection;
    private String[] inventoryItems = new string[] { "Robot vacuum", "Chair" };
    private double[] inventoryPrices = new double[] { 129.99, 88.99 };

    public void Run(IBackgroundTaskInstance taskInstance)
    {
        // Get a deferral so that the service isn't terminated.
        this.backgroundTaskDeferral = taskInstance.GetDeferral();

        // Associate a cancellation handler with the background task.
        taskInstance.Canceled += OnTaskCanceled;

        // Retrieve the app service connection and set up a listener for incoming app service requests.
        var details = taskInstance.TriggerDetails as AppServiceTriggerDetails;
        appServiceconnection = details.AppServiceConnection;
        appServiceconnection.RequestReceived += OnRequestReceived;
    }

    private async void OnRequestReceived(AppServiceConnection sender, AppServiceRequestReceivedEventArgs args)
    {
        // This function is called when the app service receives a request.
    }

    private void OnTaskCanceled(IBackgroundTaskInstance sender, BackgroundTaskCancellationReason reason)
    {
        if (this.backgroundTaskDeferral != null)
        {
            // Complete the service deferral.
            this.backgroundTaskDeferral.Complete();
        }
    }
}
```
このクラスは、アプリサービスが作業を実行する場所です。

バックグラウンドタスクが作成されると、Run が呼び出されます。バックグラウンドタスクは Run が完了すると終了するため、バックグラウンドタスクが要求に引き続き対応できるように、コードは保留されます。バックグラウンドタスクとして実装されたアプリサービスは、呼び出しを受け取った後、約 30 秒間に再度呼び出されない限り、または保留されない限り、約 30 秒間有効になっています。アプリサービスが同じプロセスで呼び出し元として実装されると、アプリサービスの有効期間は呼び出し元の有効期間に関連付けられます。

アプリサービスの有効期間は、呼び出し元に依存します。
- 呼び出し元がフォアグラウンドである場合は、App Service の有効期間は、呼び出し元と同じです。
- 呼び出し元がバックグラウンドである場合は、App Service は実行に 30 秒間が確保されます。保留されると、1 回 5 秒追加されます。
タスクが取り消されると、OnTaskCanceled が呼び出されます。タスクが取り消されるのは、クライアントアプリが AppServiceConnection を破棄したとき、クライアントアプリが中断されたとき、OS がシャットダウンまたはスリープ状態になったとき、または OS がリソース不足になりタスクを実行できなくなったときです。

アプリサービスのコードを記述する

OnRequestReceived は、App Service のコードが配置される場所です。 MyAppService の Inventory.cs のスタブ OnRequestReceived を、この例のコードに置き換えます。このコードは、インベントリの項目のインデックスを取得し、コマンド文字列と共にサービスに渡して、指定したインベントリ項目の名前と価格を取得します。独自のプロジェクトには、エラー処理コードを追加します。

private async void OnRequestReceived(AppServiceConnection sender, AppServiceRequestReceivedEventArgs args)
{
    // Get a deferral because we use an awaitable API below to respond to the message
    // and we don't want this call to get canceled while we are waiting.
    var messageDeferral = args.GetDeferral();

    ValueSet message = args.Request.Message;
    ValueSet returnData = new ValueSet();

    string command = message["Command"] as string;
    int? inventoryIndex = message["ID"] as int?;

    if (inventoryIndex.HasValue &&
        inventoryIndex.Value >= 0 &&
        inventoryIndex.Value < inventoryItems.GetLength(0))
    {
        switch (command)
        {
            case "Price":
            {
                returnData.Add("Result", inventoryPrices[inventoryIndex.Value]);
                returnData.Add("Status", "OK");
                break;
            }

            case "Item":
            {
                returnData.Add("Result", inventoryItems[inventoryIndex.Value]);
                returnData.Add("Status", "OK");
                break;
            }

            default:
            {
                returnData.Add("Status", "Fail: unknown command");
                break;
            }
        }
    }
    else
    {
        returnData.Add("Status", "Fail: Index out of range");
    }

    try
    {
        // Return the data to the caller.
        await args.Request.SendResponseAsync(returnData);
    }
    catch (Exception e)
    {
        // Your exception handling code here.
    }
    finally
    {
        // Complete the deferral so that the platform knows that we're done responding to the app service call.
        // Note for error handling: this must be called even if SendResponseAsync() throws an exception.
        messageDeferral.Complete();
    }
}

OnRequestReceived が async であることに注意してください。この例では、SendResponseAsync への待機可能なメソッド呼び出しを行うためです。

保留が行われるのは、サービスが OnRequestReceived ハンドラーで async メソッドを使用できるようにするためです。これにより、OnRequestReceived への呼び出しは、メッセージの処理が完了するまで完了しません。 SendResponseAsync が結果を呼び出し元に送ります。 SendResponseAsync は、呼び出しの完了時に通知しません。 OnRequestReceived が完了したことを SendMessageAsync に通知するのは、保留の完了時です。 SendResponseAsync の呼び出しは、SendResponseAsync が例外をスローした場合でも保留を完了する必要があるため、try/finally ブロックでラップされます。

App Services では ValueSet オブジェクトを使って情報を交換します。渡すことができるデータのサイズは、システムリソースによってのみ制限されます。 ValueSet で使うことができる定義済みのキーはありません。アプリサービスのプロトコルの定義に使うキーの値を決定する必要があります。呼び出し元は、そのプロトコルを念頭に置いて記述する必要があります。この例では、アプリサービスがインベントリ項目またはその価格の名前を提供するかどうかを示す値を持つ、Command という名前のキーを選びました。インベントリ名のインデックスは、ID キーに保存されています。戻り値は Result キーに保存されます。

AppServiceClosedStatus 列挙体が呼び出し元に返され、アプリサービスの呼び出した成功したか失敗したかを示します。アプリサービスへの呼び出しが失敗する例として、OS がサービスのエンドポイントを中止した、リソースが超過したなどがあります。 ValueSet を通じて、さらにエラー情報を取得することができます。この例では、Status という名前のキーを使って、より詳細なエラー情報を呼び出し元に返します。

SendResponseAsync の呼び出しからは、ValueSet が呼び出し元に返されます。

サービスアプリを展開して、パッケージファミリ名を取得する

クライアントから呼び出す前に、App Service プロバイダーを展開する必要があります。 Visual Studio の [ビルド] > [ソリューションの配置] を選択して展開できます。

これを呼び出すには、App Service プロバイダーのパッケージファミリ名も必要になります。これは、デザイナービューで AppServiceProvider プロジェクトの Package.appxmanifest ファイルを開いて取得できます (ソリューションエクスプローラー でダブルクリックします)。 [パッケージ化] タブを選択し、[パッケージファミリ名] 横の値をコピーし、一旦メモ帳などに貼り付けます。

アプリサービスを呼び出すクライアントを作成する

[ファイル] > [追加] > [新しいプロジェクト]で、新しい空の Windows ユニバーサルアプリプロジェクトをソリューションに追加します。 [新しいプロジェクトの追加] ダイアログボックスで、[インストール済み] > [Visual C#] > [空のアプリ (ユニバーサル Windows)] の順に選び、ClientAppという名前を付けます。
ClientApp プロジェクトで、MainPage.xaml.cs の上部に、次の using ステートメントを追加します。
```
using Windows.ApplicationModel.AppService;
```
textBox というテキストボックスとボタンを MainPage.xaml に追加します。
button_Click というボタンのクリックハンドラーを追加し、ボタンハンドラーの署名にキーワード async を追加します。
ボタンのクリックハンドラーのスタブを、次のコードで置き換えます。必ず、inventoryService フィールドの宣言を含めます。
```
private AppServiceConnection inventoryService;

private async void button_Click(object sender, RoutedEventArgs e)
{
   // Add the connection.
   if (this.inventoryService == null)
   {
       this.inventoryService = new AppServiceConnection();

       // Here, we use the app service name defined in the app service 
       // provider's Package.appxmanifest file in the <Extension> section.
       this.inventoryService.AppServiceName = "com.microsoft.inventory";

       // Use Windows.ApplicationModel.Package.Current.Id.FamilyName 
       // within the app service provider to get this value.
       this.inventoryService.PackageFamilyName = "Replace with the package family name";

       var status = await this.inventoryService.OpenAsync();

       if (status != AppServiceConnectionStatus.Success)
       {
           textBox.Text= "Failed to connect";
           this.inventoryService = null;
           return;
       }
   }

   // Call the service.
   int idx = int.Parse(textBox.Text);
   var message = new ValueSet();
   message.Add("Command", "Item");
   message.Add("ID", idx);
   AppServiceResponse response = await this.inventoryService.SendMessageAsync(message);
   string result = "";

   if (response.Status == AppServiceResponseStatus.Success)
   {
       // Get the data  that the service sent to us.
       if (response.Message["Status"] as string == "OK")
       {
           result = response.Message["Result"] as string;
       }
   }

   message.Clear();
   message.Add("Command", "Price");
   message.Add("ID", idx);
   response = await this.inventoryService.SendMessageAsync(message);

   if (response.Status == AppServiceResponseStatus.Success)
   {
       // Get the data that the service sent to us.
       if (response.Message["Status"] as string == "OK")
       {
           result += " : Price = " + response.Message["Result"] as string;
       }
   }

   textBox.Text = result;
}
```
行 this.inventoryService.PackageFamilyName = "Replace with the package family name"; のパッケージファミリ名を、上記の「サービスアプリのデプロイ」で取得した AppServiceProvider プロジェクトのパッケージファミリ名に置き換え、パッケージファミリ名を取得します。

注意

文字列リテラルは、変数に配置するのではなく、必ず貼り付けてください。変数を使用した場合は機能しません。

最初に、コードによってアプリサービスとの接続が確立されます。接続は、this.inventoryService を破棄するまで開いたままになります。 App Service 名は、AppServiceProvider プロジェクトの Package.appxmanifest ファイルに追加した AppService 要素の Name 属性と一致する必要があります。この例では <uap3:AppService Name="com.microsoft.inventory"/> です。

message という名前の ValueSet が作成され、App Service に送信するコマンドを指定します。この例のアプリサービスでは、2 つのアクションのどちらを実行するかをコマンドが示すことを想定しています。クライアントアプリのテキストボックスからインデックスを取得し、Item コマンドでサービスを呼び出して項目の説明を取得します。その後、Price コマンドで呼び出しを行い、項目の価格を取得します。ボタンのテキストは結果に設定されています。

オペレーティングシステムがアプリサービスに呼び出しを接続できたかどうかを示すのは AppServiceResponseStatus のみです。このため、アプリサービスが要求を満たすことができたことを確認するために、アプリサービスから受け取る ValueSet の Status キーをチェックします。
ClientApp プロジェクトをスタートアッププロジェクトとして設定し (ソリューションエクスプローラー>[スタートアッププロジェクトとして設定] で右クリック)、ソリューションを実行します。数値 1 をテキストボックスに入力し、ボタンをクリックします。サービスから "Chair : Price = 88.99" が返されます。

App Service の呼び出しが失敗した場合は、ClientApp プロジェクトで次のことを確認します。

インベントリサービスの接続に割り当てられたパッケージファミリ名が、AppServiceProvider アプリのパッケージファミリ名と一致することを確認します。 this.inventoryService.PackageFamilyName = "..."; を含む button_Click の行をご覧ください。
button_Click で、インベントリサービスの接続に割り当てられた App Service 名が、AppServiceProvider の Package.appxmanifest ファイルの App Service 名と一致することを確認します。 this.inventoryService.AppServiceName = "com.microsoft.inventory"; をご覧ください。
AppServiceProvider アプリが展開済みであることを確認します。 (ソリューションエクスプローラーで、[ソリューション] を右クリックし、[ソリューションの配置] を選択します)。

アプリサービスのデバッグ

サービスを呼び出す前にアプリサービスプロバイダーのアプリが配置される必要があるため、ソリューションがデバッグする前に展開されるようにします。 (Visual Studio で、[ビルド] > [ソリューションの配置] の順にクリックします)。
ソリューションエクスプローラーで、AppServiceProvider プロジェクトを右クリックして、[プロパティ] を選択します。 [デバッグ] タブで、[開始動作] を [起動しないが、開始時にマイコードをデバッグする] に変更します。 (C++ を使ってアプリサービスプロバイダーを実装した場合、[デバッグ] タブから [アプリケーションの起動] を [いいえ] に変更します)。
MyAppService プロジェクトの Inventory.cs ファイルで、OnRequestReceived にブレークポイントを設定します。
AppServiceProvider プロジェクトをスタートアッププロジェクトとなるように設定し、F5 キーを押します。
(Visual Studio からではなく) [スタート] メニューから ClientApp を起動します。
数値 1 をテキストボックスに入力し、ボタンを押します。デバッガーは、アプリサービス内のブレークポイントでアプリサービスの呼び出しを停止します。

クライアントのデバッグ

前の手順に従って、アプリサービスを呼び出すクライアントをデバッグします。
[スタート] メニューから ClientApp を起動します。
(ApplicationFrameHost.exe プロセスではなく) ClientApp.exe プロセスにデバッガーをアタッチします。 (Visual Studio で、[デバッグ] > [プロセスにアタッチ] の順に選びます)。
ClientApp プロジェクトで、button_Click にブレークポイントを設定します。
ClientApp のテキストボックスに数値 1 を入力してボタンをクリックすると、クライアントと App Service の両方のブレークポイントがヒットするようになります。

一般的なアプリサービスのトラブルシューティング

App Service に接続しようとして AppUnavailable 状態が発生した場合、以下を確認します。

アプリサービスプロバイダープロジェクトとアプリサービスプロジェクトが展開されていることを確認します。クライアントを実行する前に、両方が展開されている必要があります。展開されていない場合、クライアントには接続先がありません。 Visual Studio から [ビルド]>[ソリューションの配置] で展開できます。
ソリューションエクスプローラーを使って、App Service プロバイダープロジェクトで、App Service を実装したプロジェクトへの、プロジェクト間の参照が設定されていることを確認します。
<Extensions> エントリとその子要素が、App Service プロバイダープロジェクトに属する Package.appxmanifest ファイルに追加されていることを確認します。詳しくは上述の「Package.appxmanifest への App Service 拡張機能の追加」をご覧ください。
App Service プロバイダーを呼び出すクライアントの AppServiceConnection.AppServiceName 文字列が、App Service プロバイダープロジェクトの Package.appxmanifest ファイルで指定された <uap3:AppService Name="..." /> と一致していることを確認します。
AppServiceConnection.PackageFamilyName が、App Service プロバイダーのコンポーネントのパッケージファミリ名と一致していることを確認します。詳しくは上述の「Package.appxmanifest への App Service 拡張機能の追加」をご覧ください。
この例のようなプロセス外の App Services では、App Service プロバイダープロジェクトの Package.appxmanifest ファイルの <uap:Extension ...> 要素で指定された EntryPoint が、App Service プロジェクトで IBackgroundTask を実装するパブリッククラスの名前空間とクラス名と一致していることを確認します。

デバッグのトラブルシューティング

アプリサービスプロバイダーまたはアプリサービスプロジェクトのブレークポイントでデバッガーが停止しない場合は、以下を確認します。

アプリサービスプロバイダープロジェクトとアプリサービスプロジェクトが展開されていることを確認します。クライアントを実行する前に、両方が展開されている必要があります。 Visual Studio から [ビルド]>[ソリューションの配置] で展開できます。
デバッグするプロジェクトがスタートアッププロジェクトとして設定されていることを確認します。そのプロジェクトのデバッグプロパティを確認し、F5 キーが押されたときにプロジェクトを実行しないように設定されていることを確認します。プロジェクトを右クリックし、[プロパティ]、[デバッグ] (または C++ では [デバッグ]) の順にクリックします。 C# では、[開始動作] を [起動しないが、開始時にマイコードをデバッグする] に設定します。 C++ では、[アプリケーションの起動] を [いいえ] に設定します。

注釈

この例では、バックグラウンドタスクとして実行されるアプリサービスを作成して、それを別のアプリから呼び出す概要を示しています。次の点に注意してください。

App service をホストするバックグラウンドタスクを作成します。
App service プロバイダーの Package.appxmanifest ファイルに windows.appService 拡張機能を追加します。
App service プロバイダーのパッケージファミリ名を取得し、クライアントアプリからアプリに接続できるようにします。
App service プロバイダープロジェクトから App service プロジェクトへのプロジェクト間参照を追加します。
Windows.ApplicationModel.AppService.AppServiceConnection を使用してサービスを呼び出します。

MyAppService の完全なコード

using System;
using Windows.ApplicationModel.AppService;
using Windows.ApplicationModel.Background;
using Windows.Foundation.Collections;

namespace MyAppService
{
    public sealed class Inventory : IBackgroundTask
    {
        private BackgroundTaskDeferral backgroundTaskDeferral;
        private AppServiceConnection appServiceconnection;
        private String[] inventoryItems = new string[] { "Robot vacuum", "Chair" };
        private double[] inventoryPrices = new double[] { 129.99, 88.99 };

        public void Run(IBackgroundTaskInstance taskInstance)
        {
            // Get a deferral so that the service isn't terminated.
            this.backgroundTaskDeferral = taskInstance.GetDeferral();

            // Associate a cancellation handler with the background task.
            taskInstance.Canceled += OnTaskCanceled;

            // Retrieve the app service connection and set up a listener for incoming app service requests.
            var details = taskInstance.TriggerDetails as AppServiceTriggerDetails;
            appServiceconnection = details.AppServiceConnection;
            appServiceconnection.RequestReceived += OnRequestReceived;
        }

        private async void OnRequestReceived(AppServiceConnection sender, AppServiceRequestReceivedEventArgs args)
        {
            // Get a deferral because we use an awaitable API below to respond to the message
            // and we don't want this call to get canceled while we are waiting.
            var messageDeferral = args.GetDeferral();

            ValueSet message = args.Request.Message;
            ValueSet returnData = new ValueSet();

            string command = message["Command"] as string;
            int? inventoryIndex = message["ID"] as int?;

            if (inventoryIndex.HasValue &&
                 inventoryIndex.Value >= 0 &&
                 inventoryIndex.Value < inventoryItems.GetLength(0))
            {
                switch (command)
                {
                    case "Price":
                        {
                            returnData.Add("Result", inventoryPrices[inventoryIndex.Value]);
                            returnData.Add("Status", "OK");
                            break;
                        }

                    case "Item":
                        {
                            returnData.Add("Result", inventoryItems[inventoryIndex.Value]);
                            returnData.Add("Status", "OK");
                            break;
                        }

                    default:
                        {
                            returnData.Add("Status", "Fail: unknown command");
                            break;
                        }
                }
            }
            else
            {
                returnData.Add("Status", "Fail: Index out of range");
            }

            // Return the data to the caller.
            await args.Request.SendResponseAsync(returnData);

            // Complete the deferral so that the platform knows that we're done responding to the app service call.
            // Note for error handling: this must be called even if SendResponseAsync() throws an exception.
            messageDeferral.Complete();
        }


        private void OnTaskCanceled(IBackgroundTaskInstance sender, BackgroundTaskCancellationReason reason)
        {
            if (this.backgroundTaskDeferral != null)
            {
                // Complete the service deferral.
                this.backgroundTaskDeferral.Complete();
            }
        }
    }
}

アプリサービスの作成と利用

新しいアプリサービスプロバイダープロジェクトの作成

Package.appxmanifest への App Service 拡張機能の追加

アプリサービスの作成

アプリサービスのコードを記述する

サービスアプリを展開して、パッケージファミリ名を取得する

アプリサービスを呼び出すクライアントを作成する

アプリサービスのデバッグ

クライアントのデバッグ

一般的なアプリサービスのトラブルシューティング

デバッグのトラブルシューティング

注釈

MyAppService の完全なコード

フィードバック

フィードバック

その他のリソース

アプリ サービスの作成と利用

新しいアプリ サービス プロバイダー プロジェクトの作成

Package.appxmanifest への App Service 拡張機能の追加

アプリ サービスの作成

アプリ サービスのコードを記述する

サービス アプリを展開して、パッケージ ファミリ名を取得する

アプリ サービスを呼び出すクライアントを作成する

アプリ サービスのデバッグ

クライアントのデバッグ

一般的なアプリ サービスのトラブルシューティング

デバッグのトラブルシューティング

注釈

MyAppService の完全なコード

関連トピック

フィードバック

フィードバック

その他のリソース

アプリサービスの作成と利用

新しいアプリサービスプロバイダープロジェクトの作成

アプリサービスの作成

アプリサービスのコードを記述する

サービスアプリを展開して、パッケージファミリ名を取得する

アプリサービスを呼び出すクライアントを作成する

アプリサービスのデバッグ

一般的なアプリサービスのトラブルシューティング