Azure Mobile Apps 向け iOS クライアントライブラリの使用方法

[アーティクル]
06/25/2019

概要

このガイドでは、最新の Azure Mobile Apps iOS SDK を使用して一般的なシナリオを実行する方法について説明します。 Azure Mobile Apps を初めて使用する場合は、まず、「 iOS アプリの作成」を参照して、バックエンドの作成、テーブルの作成、構築済みの iOS Xcode プロジェクトのダウンロードを行ってください。このガイドでは、クライアント側の iOS SDK に重点を置いています。バックエンドのサーバー側 SDK の詳細については、サーバー SDK の使用方法に関する記事をご覧ください。

リファレンスドキュメント

iOS クライアント SDK のリファレンスドキュメントは、Azure Mobile Apps iOS クライアントのリファレンスに関するページにあります。

サポートされているプラットフォーム

iOS SDK は、iOS バージョン 8.0 以降の Objective-C プロジェクト、Swift 2.2 プロジェクト、Swift 2.3 プロジェクトをサポートしています。

"サーバーフロー" の認証では、UI の表示に WebView を使用します。デバイスで WebView UI を表示できない場合は、この製品の対象外である別の認証方法が必要になります。そのため、この SDK は腕時計型デバイスのような制限付きデバイスには適していません。

セットアップと前提条件

このガイドでは、バックエンドとテーブルを作成済みであることを前提としています。このガイドでは、テーブルのスキーマが、これらのチュートリアルのテーブルの場合と同じであることを前提とします。また、コードで MicrosoftAzureMobile.framework を参照し、MicrosoftAzureMobile/MicrosoftAzureMobile.h をインポートしていることも前提となります。

方法: クライアントを作成する

プロジェクトで Azure Mobile Apps バックエンドにアクセスするには、 MSClientを作成します。 AppUrl をアプリの URL に置き換えます。 gatewayURLString と applicationKey は空のままにしておいてかまいません。認証用のゲートウェイを設定する場合は、ゲートウェイの URL で gatewayURLString を設定します。

Objective-C:

MSClient *client = [MSClient clientWithApplicationURLString:@"AppUrl"];

Swift:

let client = MSClient(applicationURLString: "AppUrl")

方法: テーブル参照を作成する

データへのアクセスやデータの更新を行うには、バックエンドテーブルへの参照を作成します。 TodoItem を実際のテーブルの名前に置き換えます。

Objective-C:

MSTable *table = [client tableWithName:@"TodoItem"];

Swift:

let table = client.tableWithName("TodoItem")

方法: データのクエリを実行する

データベースクエリを作成するには、 MSTable オブジェクトのクエリを実行します。次のクエリは、 TodoItem 内のすべての項目を取得し、各項目のテキストをログに記録します。

Objective-C:

[table readWithCompletion:^(MSQueryResult *result, NSError *error) {
        if(error) { // error is nil if no error occurred
                NSLog(@"ERROR %@", error);
        } else {
                for(NSDictionary *item in result.items) { // items is NSArray of records that match query
                        NSLog(@"Todo Item: %@", [item objectForKey:@"text"]);
                }
        }
}];

Swift:

table.readWithCompletion { (result, error) in
    if let err = error {
        print("ERROR ", err)
    } else if let items = result?.items {
        for item in items {
            print("Todo Item: ", item["text"])
        }
    }
}

方法: 返されるデータをフィルター処理する

結果をフィルター処理するには、多くのオプションを使用できます。

述語を使用してフィルター処理するには、NSPredicate と readWithPredicate を使用します。次のコードは、返されたデータをフィルター処理して、不完全な Todo 項目のみを見つけます。

Objective-C:

// Create a predicate that finds items where complete is false
NSPredicate * predicate = [NSPredicate predicateWithFormat:@"complete == NO"];
// Query the TodoItem table
[table readWithPredicate:predicate completion:^(MSQueryResult *result, NSError *error) {
        if(error) {
                NSLog(@"ERROR %@", error);
        } else {
                for(NSDictionary *item in result.items) {
                        NSLog(@"Todo Item: %@", [item objectForKey:@"text"]);
                }
        }
}];

Swift:

// Create a predicate that finds items where complete is false
let predicate =  NSPredicate(format: "complete == NO")
// Query the TodoItem table
table.readWithPredicate(predicate) { (result, error) in
    if let err = error {
        print("ERROR ", err)
    } else if let items = result?.items {
        for item in items {
            print("Todo Item: ", item["text"])
        }
    }
}

方法: MSQuery を使用する

複雑なクエリ (並べ替えとページングを含む) を実行するには、 MSQuery オブジェクトを直接作成するか、述語を使用して作成します。

Objective-C:

MSQuery *query = [table query];
MSQuery *query = [table queryWithPredicate: [NSPredicate predicateWithFormat:@"complete == NO"]];

Swift:

let query = table.query()
let query = table.queryWithPredicate(NSPredicate(format: "complete == NO"))

MSQuery を使用すると、複数のクエリ動作を制御できます。

結果の順序を指定する
返すフィールドを制限する
返すレコード数を制限する
応答の合計数を指定する
要求内にカスタムクエリ文字列パラメーターを指定する
追加の関数を適用する

オブジェクトで readWithCompletion を呼び出して、MSQuery クエリを実行します。

方法: MSQuery でデータを並べ替える

結果の並べ替えの例を見てみましょう。 "text" フィールドを昇順で並べ替えた後、"complete" を降順で並べ替えるには、次のように MSQuery を呼び出します。

Objective-C:

[query orderByAscending:@"text"];
[query orderByDescending:@"complete"];
[query readWithCompletion:^(MSQueryResult *result, NSError *error) {
        if(error) {
                NSLog(@"ERROR %@", error);
        } else {
                for(NSDictionary *item in result.items) {
                        NSLog(@"Todo Item: %@", [item objectForKey:@"text"]);
                }
        }
}];

Swift:

query.orderByAscending("text")
query.orderByDescending("complete")
query.readWithCompletion { (result, error) in
    if let err = error {
        print("ERROR ", err)
    } else if let items = result?.items {
        for item in items {
            print("Todo Item: ", item["text"])
        }
    }
}

方法: MSQuery でフィールドを制限し、クエリ文字列パラメーターを展開する

クエリで返されるフィールドを制限するには、 selectFields プロパティにフィールド名を指定します。次の例では、text フィールドと completed フィールドだけが返されます。

Objective-C:

query.selectFields = @[@"text", @"complete"];

Swift:

query.selectFields = ["text", "complete"]

サーバー要求に追加のクエリ文字列パラメーターを含めるには (たとえば、カスタムサーバー側のスクリプトで使用されているため)、 query.parameters 次のように設定します。

Objective-C:

query.parameters = @{
    @"myKey1" : @"value1",
    @"myKey2" : @"value2",
};

Swift:

query.parameters = ["myKey1": "value1", "myKey2": "value2"]

方法: ページサイズを構成する

Azure Mobile Apps では、バックエンドテーブルから同時に取得されるレコードの数がページサイズで制御されます。 pull データの呼び出しは、このページサイズに基づいて、プルするレコードがなくなるまで、データをバッチで追加します。

次のように、MSPullSettings を使用してページサイズを構成することができます。既定のページサイズは 50 ですが、次の例では 3 に変更します。

パフォーマンス上の理由から、別のページサイズを構成できます。小さいデータレコードが多数ある場合は、ページサイズが大きければ、サーバーのラウンドトリップの数が少なくなります。

この設定では、クライアント側のページサイズのみが制御されます。クライアントが要求するページサイズが、Mobile Apps バックエンドでサポートされるページサイズを超える場合は、バックエンドがサポートするように構成されている最大ページサイズが上限になります。

これも、"バイトサイズ" でなく、データレコードの "数" で設定します。

クライアントのページサイズを増やす場合は、サーバーのページサイズを大きくする必要があります。そのための手順については、「方法: テーブルのページングサイズを調整する」を参照してください。

Objective-C:

  MSPullSettings *pullSettings = [[MSPullSettings alloc] initWithPageSize:3];
  [table  pullWithQuery:query queryId:@nil settings:pullSettings
                        completion:^(NSError * _Nullable error) {
                               if(error) {
                    NSLog(@"ERROR %@", error);
                }
                           }];

Swift:

let pullSettings = MSPullSettings(pageSize: 3)
table.pullWithQuery(query, queryId:nil, settings: pullSettings) { (error) in
    if let err = error {
        print("ERROR ", err)
    }
}

方法: データを挿入する

新しいテーブル行を挿入するには、NSDictionary を作成し、table insert を呼び出します。動的スキーマが有効になっている場合、Azure App Service モバイルバックエンドは、NSDictionary に基づいて新しい列を自動的に生成します。

id が指定されていない場合、バックエンドは新しい一意の ID を自動的に生成します。電子メールアドレス、ユーザー名、または独自のカスタム値を ID として使用するには、独自の id を指定します。独自の ID を指定すると、結合およびビジネス指向のデータベースロジックを容易にすることができます。

result には、挿入された新しい項目が含まれます。サーバーロジックによっては、サーバーに渡された内容と比較して、追加または変更されたデータが含まれる場合があります。

Objective-C:

NSDictionary *newItem = @{@"id": @"custom-id", @"text": @"my new item", @"complete" : @NO};
[table insert:newItem completion:^(NSDictionary *result, NSError *error) {
    if(error) {
        NSLog(@"ERROR %@", error);
    } else {
        NSLog(@"Todo Item: %@", [result objectForKey:@"text"]);
    }
}];

Swift:

let newItem = ["id": "custom-id", "text": "my new item", "complete": false]
table.insert(newItem) { (result, error) in
    if let err = error {
        print("ERROR ", err)
    } else if let item = result {
        print("Todo Item: ", item["text"])
    }
}

方法: データを変更する

既存の行を更新するには、次のように項目を変更して updateを呼び出します。

Objective-C:

NSMutableDictionary *newItem = [oldItem mutableCopy]; // oldItem is NSDictionary
[newItem setValue:@"Updated text" forKey:@"text"];
[table update:newItem completion:^(NSDictionary *result, NSError *error) {
    if(error) {
        NSLog(@"ERROR %@", error);
    } else {
        NSLog(@"Todo Item: %@", [result objectForKey:@"text"]);
    }
}];

Swift:

if let newItem = oldItem.mutableCopy() as? NSMutableDictionary {
    newItem["text"] = "Updated text"
    table2.update(newItem as [NSObject: AnyObject], completion: { (result, error) -> Void in
        if let err = error {
            print("ERROR ", err)
        } else if let item = result {
            print("Todo Item: ", item["text"])
        }
    })
}

あるいは、次のように行 ID と更新フィールドを指定します。

Objective-C:

[table update:@{@"id":@"custom-id", @"text":"my EDITED item"} completion:^(NSDictionary *result, NSError *error) {
    if(error) {
        NSLog(@"ERROR %@", error);
    } else {
        NSLog(@"Todo Item: %@", [result objectForKey:@"text"]);
    }
}];

Swift:

table.update(["id": "custom-id", "text": "my EDITED item"]) { (result, error) in
    if let err = error {
        print("ERROR ", err)
    } else if let item = result {
        print("Todo Item: ", item["text"])
    }
}

更新操作を行う場合は、少なくとも id 属性を設定する必要があります。

方法: データを削除する

項目を削除するには、次のように、該当する項目を指定して delete を呼び出します。

Objective-C:

[table delete:item completion:^(id itemId, NSError *error) {
    if(error) {
        NSLog(@"ERROR %@", error);
    } else {
        NSLog(@"Todo Item ID: %@", itemId);
    }
}];

Swift:

table.delete(newItem as [NSObject: AnyObject]) { (itemId, error) in
    if let err = error {
        print("ERROR ", err)
    } else {
        print("Todo Item ID: ", itemId)
    }
}

あるいは、次のように行 ID を指定して削除します。

Objective-C:

[table deleteWithId:@"37BBF396-11F0-4B39-85C8-B319C729AF6D" completion:^(id itemId, NSError *error) {
    if(error) {
        NSLog(@"ERROR %@", error);
    } else {
        NSLog(@"Todo Item ID: %@", itemId);
    }
}];

Swift:

table.deleteWithId("37BBF396-11F0-4B39-85C8-B319C729AF6D") { (itemId, error) in
    if let err = error {
        print("ERROR ", err)
    } else {
        print("Todo Item ID: ", itemId)
    }
}

削除操作を行う場合は、少なくとも id 属性を設定する必要があります。

方法: カスタム API の呼び出し

カスタム API を使用して、任意のバックエンド機能を公開できます。テーブル操作にマップする必要はありません。メッセージングを詳細に制御できるだけでなく、ヘッダーの読み取り/設定や応答本文の形式の変更も可能です。

カスタム API を呼び出すには、 MSClient.invokeAPIを呼び出します。要求と応答のコンテンツは、JSON として扱われます。他のメディアの種類を使用するには、の他のオーバーロードを使用しますinvokeAPI。要求のPOST代わりに要求をGET行うには、パラメーターHTTPMethodを次に"GET"設定し、パラメーターbodyをnil設定します (GET 要求にはメッセージ本文がないため)。カスタム API で他の HTTP 動詞がサポートされている場合は、適切に変更HTTPMethodしてください。

Objective-C:

[self.client invokeAPI:@"sendEmail"
                  body:@{ @"contents": @"Hello world!" }
            HTTPMethod:@"POST"
            parameters:@{ @"to": @"bill@contoso.com", @"subject" : @"Hi!" }
               headers:nil
            completion: ^(NSData *result, NSHTTPURLResponse *response, NSError *error) {
                if(error) {
                    NSLog(@"ERROR %@", error);
                } else {
                    // Do something with result
                }
            }];

Swift:

client.invokeAPI("sendEmail",
            body: [ "contents": "Hello World" ],
            HTTPMethod: "POST",
            parameters: [ "to": "bill@contoso.com", "subject" : "Hi!" ],
            headers: nil)
            {
                (result, response, error) -> Void in
                if let err = error {
                    print("ERROR ", err)
                } else if let res = result {
                          // Do something with result
                }
        }

方法: プッシュテンプレートを登録してクロスプラットフォーム通知を送信する

テンプレートを登録するには、 client.push registerDeviceToken メソッドを使用してクライアントアプリにテンプレートを渡します。

Objective-C:

[client.push registerDeviceToken:deviceToken template:iOSTemplate completion:^(NSError *error) {
    if(error) {
        NSLog(@"ERROR %@", error);
    }
}];

Swift:

client.push?.registerDeviceToken(NSData(), template: iOSTemplate, completion: { (error) in
    if let err = error {
        print("ERROR ", err)
    }
})

テンプレートは NSDictionary 型であり、次の形式で複数のテンプレートを含めることができます。

Objective-C:

NSDictionary *iOSTemplate = @{ @"templateName": @{ @"body": @{ @"aps": @{ @"alert": @"$(message)" } } } };

Swift:

let iOSTemplate = ["templateName": ["body": ["aps": ["alert": "$(message)"]]]]

セキュリティを確保するために、要求からすべてのタグが削除されます。インストールまたはインストール内のテンプレートにタグを追加する方法については、「Azure Mobile Apps 用 .NET バックエンドサーバー SDK の操作」を参照してください。これらの登録済みテンプレートを使用して通知を送信するには、Notification Hubs API を使用します。

方法: エラーを処理する

Azure App Service モバイルバックエンドを呼び出すと、完了ブロックに NSError パラメーターが含まれます。エラーが発生すると、このパラメーターは null 以外の値になります。前のコードスニペットに示すように、コードでは、このパラメーターを確認し、必要に応じてエラーを処理する必要があります。

<WindowsAzureMobileServices/MSError.h> ファイルで、MSErrorResponseKey、MSErrorRequestKey、MSErrorServerItemKey の各定数を定義します。エラーに関するさらに多くのデータを取得するには、次のコードを使用します。

Objective-C:

NSDictionary *serverItem = [error.userInfo objectForKey:MSErrorServerItemKey];

Swift:

let serverItem = error.userInfo[MSErrorServerItemKey]

さらに、このファイルでエラーコードごとに定数を定義します。

Objective-C:

if (error.code == MSErrorPreconditionFailed) {

Swift:

if (error.code == MSErrorPreconditionFailed) {

方法: Active Directory 認証ライブラリを使用してユーザーを認証する

Active Directory 認証ライブラリ (ADAL) を使用して、Azure Active Directory を使用しているアプリケーションにユーザーをサインインさせることができます。 ID プロバイダー SDK を使用したクライアントフローの認証は、 loginWithProvider:completion: メソッドを使用する方法よりも推奨されます。クライアントフローの認証により、よりネイティブな UX が実現し、さらにカスタマイズすることが可能になります。

「 Azure Active Directory ログインを使用するように App Service アプリケーションを構成する方法」のチュートリアルに従って、AAD のサインイン用にモバイルアプリバックエンドを構成します。ネイティブクライアントアプリケーションを登録する省略可能な手順を確実に実行します。 iOS の場合、リダイレクト URI を <app-scheme>://<bundle-id> 形式にすることをお勧めします。詳細については、ADAL iOS のクイックスタートに関する記事をご覧ください。
Cocoapods を使用して ADAL をインストールします。 POD ファイルを編集して次の定義を含め、 YOUR-PROJECT を Xcode プロジェクトの名前に置き換えます。
```
 source 'https://github.com/CocoaPods/Specs.git'
 link_with ['YOUR-PROJECT']
 xcodeproj 'YOUR-PROJECT'
```
POD:
```
 pod 'ADALiOS'
```
ターミナルを使用して、プロジェクトを含むディレクトリから pod install を実行し、(プロジェクトではなく) 生成された Xcode ワークスペースを開きます。
ご使用の言語に応じて、アプリケーションに次のコードを追加します。各コードでは、次のように置き換えます。
- INSERT-AUTHORITY-HERE を、アプリケーションをプロビジョニングしたテナントの名前に置き換えます。形式は https://login.microsoftonline.com/contoso.onmicrosoft.com である必要があります。この値は、Azure portalの Azure Active Directory の [ドメイン] タブからコピーできます。
- INSERT-RESOURCE-ID-HERE を、モバイルアプリバックエンドのクライアント ID に置き換えます。クライアント ID は、ポータルの [Azure Active Directory の設定] の [詳細] タブで入手できます。
- INSERT-CLIENT-ID-HERE を、ネイティブクライアントアプリケーションからコピーしたクライアント ID に置き換えます。
- INSERT-REDIRECT-URI-HERE を、HTTPS スキームを使用して、サイトの /.auth/login/done エンドポイントに置き換えます。これは、https://contoso.azurewebsites.net/.auth/login/done のような値である必要があります。

Objective-C:

#import <ADALiOS/ADAuthenticationContext.h>
#import <ADALiOS/ADAuthenticationSettings.h>
// ...
- (void) authenticate:(UIViewController*) parent
            completion:(void (^) (MSUser*, NSError*))completionBlock;
{
    NSString *authority = @"INSERT-AUTHORITY-HERE";
    NSString *resourceId = @"INSERT-RESOURCE-ID-HERE";
    NSString *clientId = @"INSERT-CLIENT-ID-HERE";
    NSURL *redirectUri = [[NSURL alloc]initWithString:@"INSERT-REDIRECT-URI-HERE"];
    ADAuthenticationError *error;
    ADAuthenticationContext *authContext = [ADAuthenticationContext authenticationContextWithAuthority:authority error:&error];
    authContext.parentController = parent;
    [ADAuthenticationSettings sharedInstance].enableFullScreen = YES;
    [authContext acquireTokenWithResource:resourceId
                                    clientId:clientId
                                redirectUri:redirectUri
                            completionBlock:^(ADAuthenticationResult *result) {
                                if (result.status != AD_SUCCEEDED)
                                {
                                    completionBlock(nil, result.error);;
                                }
                                else
                                {
                                    NSDictionary *payload = @{
                                                            @"access_token" : result.tokenCacheStoreItem.accessToken
                                                            };
                                    [client loginWithProvider:@"aad" token:payload completion:completionBlock];
                                }
                            }];
}

Swift:

// add the following imports to your bridging header:
//        #import <ADALiOS/ADAuthenticationContext.h>
//        #import <ADALiOS/ADAuthenticationSettings.h>

func authenticate(parent: UIViewController, completion: (MSUser?, NSError?) -> Void) {
    let authority = "INSERT-AUTHORITY-HERE"
    let resourceId = "INSERT-RESOURCE-ID-HERE"
    let clientId = "INSERT-CLIENT-ID-HERE"
    let redirectUri = NSURL(string: "INSERT-REDIRECT-URI-HERE")
    var error: AutoreleasingUnsafeMutablePointer<ADAuthenticationError?> = nil
    let authContext = ADAuthenticationContext(authority: authority, error: error)
    authContext.parentController = parent
    ADAuthenticationSettings.sharedInstance().enableFullScreen = true
    authContext.acquireTokenWithResource(resourceId, clientId: clientId, redirectUri: redirectUri) { (result) in
            if result.status != AD_SUCCEEDED {
                completion(nil, result.error)
            }
            else {
                let payload: [String: String] = ["access_token": result.tokenCacheStoreItem.accessToken]
                client.loginWithProvider("aad", token: payload, completion: completion)
            }
        }
}

方法: Facebook SDK for iOS でユーザーを認証する

Facebook SDK for iOS を使用すると、Facebook でアプリケーションにユーザーをサインインさせることができます。クライアントフローの認証の使用は、 loginWithProvider:completion: メソッドを使用する方法よりも推奨されます。クライアントフローの認証により、よりネイティブな UX が実現し、さらにカスタマイズすることが可能になります。

Facebook ログイン用に App Service を構成する方法に関するチュートリアルに従って、Facebook のサインイン用にモバイルアプリバックエンドを構成します。
Facebook SDK for iOS の概要に関するページに従って Facebook SDK for iOS をインストールします。アプリを作成する代わりに、既存の登録に iOS プラットフォームを追加できます。

Facebook のドキュメントには、App Delegate での Objective-C コードが含まれます。 Swift を使用している場合は、AppDelegate.swift に次の変換を使用できます。

// Add the following import to your bridging header:
//        #import <FBSDKCoreKit/FBSDKCoreKit.h>

func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject : AnyObject]?) -> Bool {
    FBSDKApplicationDelegate.sharedInstance().application(application, didFinishLaunchingWithOptions: launchOptions)
    // Add any custom logic here.
    return true
}

func application(application: UIApplication, openURL url: NSURL, sourceApplication: String?, annotation: AnyObject?) -> Bool {
    let handled = FBSDKApplicationDelegate.sharedInstance().application(application, openURL: url, sourceApplication: sourceApplication, annotation: annotation)
    // Add any custom logic here.
    return handled
}

FBSDKCoreKit.framework をプロジェクトに追加するだけでなく、同じ方法で FBSDKLoginKit.framework への参照を追加することもできます。

ご使用の言語に応じて、アプリケーションに次のコードを追加します。

Objective-C:

#import <FBSDKLoginKit/FBSDKLoginKit.h>
#import <FBSDKCoreKit/FBSDKAccessToken.h>
// ...
- (void) authenticate:(UIViewController*) parent
            completion:(void (^) (MSUser*, NSError*)) completionBlock;
{
    FBSDKLoginManager *loginManager = [[FBSDKLoginManager alloc] init];
    [loginManager
        logInWithReadPermissions: @[@"public_profile"]
        fromViewController:parent
        handler:^(FBSDKLoginManagerLoginResult *result, NSError *error) {
            if (error) {
                completionBlock(nil, error);
            } else if (result.isCancelled) {
                completionBlock(nil, error);
            } else {
                NSDictionary *payload = @{
                                        @"access_token":result.token.tokenString
                                        };
                [client loginWithProvider:@"facebook" token:payload completion:completionBlock];
            }
        }];
}

Swift:

// Add the following imports to your bridging header:
//        #import <FBSDKLoginKit/FBSDKLoginKit.h>
//        #import <FBSDKCoreKit/FBSDKAccessToken.h>

func authenticate(parent: UIViewController, completion: (MSUser?, NSError?) -> Void) {
    let loginManager = FBSDKLoginManager()
    loginManager.logInWithReadPermissions(["public_profile"], fromViewController: parent) { (result, error) in
        if (error != nil) {
            completion(nil, error)
        }
        else if result.isCancelled {
            completion(nil, error)
        }
        else {
            let payload: [String: String] = ["access_token": result.token.tokenString]
            client.loginWithProvider("facebook", token: payload, completion: completion)
        }
    }
}

方法: Twitter Fabric for iOS でユーザーを認証する

Fabric for iOS を使用すると、Twitter でアプリケーションにユーザーをサインインさせることができます。クライアントフローの認証を使用すると、よりネイティブな UX が実現し、さらにカスタマイズすることが可能になるため、 loginWithProvider:completion: メソッドを使用する方法よりも推奨されます。

「 App Service アプリケーションを Twitter ログインを使用するように構成する方法」のチュートリアルに従って、Twitter のサインイン用にモバイルアプリバックエンドを構成します。
「Fabric for iOS - Getting Started (Fabric for iOS - 概要)」ドキュメントに従ってプロジェクトに Fabric を追加し、TwitterKit をセットアップします。

Note

既定では、Fabric は Twitter アプリケーションを自動的に作成します。次のコードスニペットを使用して、以前に作成したコンシューマーキーとコンシューマーシークレットを登録することにより、アプリケーションを作成しなくて済みます。または、App Service に提供したコンシューマーキーとコンシューマーシークレットの値を、 Fabric Dashboardに表示される値に置き換えることもできます。このオプションを選択する場合は、コールバック URL を https://<yoursitename>.azurewebsites.net/.auth/login/twitter/callbackなどのプレースホルダーの値に設定してください。

以前に作成したシークレットを使用する場合は、App Delegate に次のコードを追加します。

Objective-C:
```
#import <Fabric/Fabric.h>
#import <TwitterKit/TwitterKit.h>
// ...
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
    [[Twitter sharedInstance] startWithConsumerKey:@"your_key" consumerSecret:@"your_secret"];
    [Fabric with:@[[Twitter class]]];
    // Add any custom logic here.
    return YES;
}
```
Swift:
```
import Fabric
import TwitterKit
// ...
func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject : AnyObject]?) -> Bool {
    Twitter.sharedInstance().startWithConsumerKey("your_key", consumerSecret: "your_secret")
    Fabric.with([Twitter.self])
    // Add any custom logic here.
    return true
}
```

ご使用の言語に応じて、アプリケーションに次のコードを追加します。

Objective-C:

#import <TwitterKit/TwitterKit.h>
// ...
- (void)authenticate:(UIViewController*)parent completion:(void (^) (MSUser*, NSError*))completionBlock
{
    [[Twitter sharedInstance] logInWithCompletion:^(TWTRSession *session, NSError *error) {
        if (session) {
            NSDictionary *payload = @{
                                        @"access_token":session.authToken,
                                        @"access_token_secret":session.authTokenSecret
                                    };
            [client loginWithProvider:@"twitter" token:payload completion:completionBlock];
        } else {
            completionBlock(nil, error);
        }
    }];
}

Swift:

import TwitterKit
// ...
func authenticate(parent: UIViewController, completion: (MSUser?, NSError?) -> Void) {
    let client = self.table!.client
    Twitter.sharedInstance().logInWithCompletion { session, error in
        if (session != nil) {
            let payload: [String: String] = ["access_token": session!.authToken, "access_token_secret": session!.authTokenSecret]
            client.loginWithProvider("twitter", token: payload, completion: completion)
        } else {
            completion(nil, error)
        }
    }
}

方法: Google Sign-In SDK for iOS でユーザーを認証する

Google Sign-In SDK for iOS を使用すると、Google アカウントでユーザーをアプリケーションにサインインさせることができます。 Google は、OAuth セキュリティポリシーの変更を最近発表しました。ポリシーのこれらの変更により、将来的に Google SDK を使用することが必要になります。

Google ログイン用に App Service を構成する方法のチュートリアルに従って、Google のサインイン用にモバイルアプリバックエンドを構成します。
Google Sign-In for iOS の統合の開始に関するドキュメントに従って、Google SDK for iOS をインストールします。バックエンドサーバーによる認証に関するセクションはスキップしてかまいません。

ご使用の言語に応じて、デリゲートの signIn:didSignInForUser:withError: メソッドに次のコードを追加します。

Objective-C:

NSDictionary *payload = @{
                            @"id_token":user.authentication.idToken,
                            @"authorization_code":user.serverAuthCode
                            };

[client loginWithProvider:@"google" token:payload completion:^(MSUser *user, NSError *error) {
    // ...
}];

Swift:

let payload: [String: String] = ["id_token": user.authentication.idToken, "authorization_code": user.serverAuthCode]
client.loginWithProvider("google", token: payload) { (user, error) in
    // ...
}

アプリデリゲートの application:didFinishLaunchingWithOptions: に、次のコードも必ず追加してください。"SERVER_CLIENT_ID" は、手順 1. で App Service の構成に使用したものと同じ ID に置き換えます。

Objective-C:
```
[GIDSignIn sharedInstance].serverClientID = @"SERVER_CLIENT_ID";
```
Swift:
```
GIDSignIn.sharedInstance().serverClientID = "SERVER_CLIENT_ID"
```
ご使用の言語に応じて、GIDSignInUIDelegate プロトコルを実装する、アプリケーションの UIViewController に次のコードを追加します。サインアウトしてサインインし直します。資格情報を再度入力する必要はありませんが、同意ダイアログが表示されます。このメソッドを呼び出すのは、セッショントークンの有効期限が切れたときだけです。

Objective-C:
```
#import <Google/SignIn.h>
// ...
- (void)authenticate
{
        [GIDSignIn sharedInstance].uiDelegate = self;
        [[GIDSignIn sharedInstance] signOut];
        [[GIDSignIn sharedInstance] signIn];
}
```
Swift:
```
// ...
func authenticate() {
    GIDSignIn.sharedInstance().uiDelegate = self
    GIDSignIn.sharedInstance().signOut()
    GIDSignIn.sharedInstance().signIn()
}
```

Azure Mobile Apps 向け iOS クライアント ライブラリの使用方法

概要

リファレンス ドキュメント

サポートされているプラットフォーム

セットアップと前提条件

方法: クライアントを作成する

方法: テーブル参照を作成する

方法: データのクエリを実行する

方法: 返されるデータをフィルター処理する

方法: MSQuery を使用する

方法: MSQuery でデータを並べ替える

方法: MSQuery でフィールドを制限し、クエリ文字列パラメーターを展開する

方法: ページ サイズを構成する

方法: データを挿入する

方法: データを変更する

方法: データを削除する

方法: カスタム API の呼び出し

方法: プッシュ テンプレートを登録してクロス プラットフォーム通知を送信する

方法: エラーを処理する

方法: Active Directory 認証ライブラリを使用してユーザーを認証する

方法: Facebook SDK for iOS でユーザーを認証する

方法: Twitter Fabric for iOS でユーザーを認証する

方法: Google Sign-In SDK for iOS でユーザーを認証する

その他のリソース

Azure Mobile Apps 向け iOS クライアントライブラリの使用方法

リファレンスドキュメント

方法: ページサイズを構成する

方法: プッシュテンプレートを登録してクロスプラットフォーム通知を送信する