Utilisation de la bibliothèque cliente iOS pour Azure Mobile Apps

Article
06/25/2019

Vue d’ensemble

Ce guide indique le déroulement de scénarios courants dans le cadre de l’utilisation du dernier SDK iOS Azure Mobile Apps. Si vous ne connaissez pas Azure Mobile Apps, consultez d’abord la section Démarrage rapide d’Azure Mobile Apps pour créer un backend, créer une table et télécharger un projet Xcode iOS prédéfini. Dans ce guide, nous nous concentrons sur le SDK iOS côté client. Pour en savoir plus sur le Kit de développement logiciel (SDK) côté serveur, consultez les procédures du SDK Server.

Documentation de référence

La documentation de référence du SDK du client iOS se trouve ici : Référence du client iOS Azure Mobile Apps.

Plateformes prises en charge

Le Kit de développement logiciel (SDK) iOS prend en charge les projets Objective-C, Swift 2.2 et Swift 2.3 pour iOS 8.0 ou versions ultérieures.

L’authentification « serveur flux » utilise un mode d’affichage WebView pour l’interface utilisateur présentée. Si l’appareil n’est pas en mesure de présenter une interface utilisateur WebView, une autre méthode d’authentification est alors nécessaire, ce qui sort du cadre de ce produit. Ce SDK ne convient donc pas au type Watch ou d’autres appareils restreints similaires.

Configuration et conditions préalables

Ce guide part du principe que vous avez créé un serveur principal avec une table. Ce guide suppose que la table a le même schéma que les tables dans ces didacticiels. Ce guide suppose également que dans votre code, vous référencez MicrosoftAzureMobile.framework et importez MicrosoftAzureMobile/MicrosoftAzureMobile.h.

Création du client

Pour accéder à un backend Azure Mobile Apps dans votre projet, créez un MSClient. Remplacez AppUrl par l’URL de l’application. Vous pouvez laisser gatewayURLString et applicationKey vides. Si vous avez configuré une passerelle pour l’authentification, renseignez gatewayURLString avec l’URL de la passerelle.

Objective-C :

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

Swift :

let client = MSClient(applicationURLString: "AppUrl")

Procédure : création d'une référence de table

Pour accéder aux données ou les mettre à jour, créez une référence à la table principale. Remplacez TodoItem par le nom de votre table.

Objective-C :

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

Swift :

let table = client.tableWithName("TodoItem")

Guide pratique pour interroger des données

Pour créer une requête de base de données, interrogez l'objet MSTable . La requête suivante obtient tous les éléments dans TodoItem et enregistre le texte de chaque élément.

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"])
        }
    }
}

Procédure : filtrage des données renvoyées

Pour filtrer les résultats, il existe de nombreuses options.

Pour filtrer à l'aide d'un prédicat, utilisez un NSPredicate et readWithPredicate. Les filtres suivants retournent des données pour rechercher uniquement les éléments Todo incomplets.

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"])
        }
    }
}

Procédure : utilisation de MSQuery

Pour effectuer une requête complexe (y compris le tri et la pagination), créez un objet MSQuery , directement ou en utilisant un prédicat :

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 vous permet de contrôler plusieurs comportements de requête.

Spécifier l’ordre des résultats
Limiter les champs à renvoyer
Limiter le nombre d’enregistrements à renvoyer
Spécifier le nombre total dans la réponse
Spécifier des paramètres de chaîne de requête personnalisés dans la requête
Appliquer des fonctions supplémentaires

Exécutez une requête MSQuery en appelant readWithCompletion sur l’objet.

Procédure : trier des données avec MSQuery

Pour trier les résultats, examinons un exemple. Pour trier selon le champ ’text’ par ordre croissant, puis selon ’complete’ par ordre décroissant, vous devez appeler MSQuery , comme suit :

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"])
        }
    }
}

Procédure : limitation des champs et développement des paramètres de chaîne de requête avec MSQuery

Pour limiter les champs à retourner dans une requête, spécifiez les noms des champs dans la propriété selectFields . Cet exemple renvoie uniquement les champs text et completed :

Objective-C :

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

Swift :

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

Pour inclure des paramètres de chaîne de requête supplémentaires dans la demande serveur (par exemple, si un script côté serveur personnalisé les utilise), remplissez query.parameters comme suit :

Objective-C :

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

Swift :

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

Procédure : configuration du format de page

Avec Azure Mobile Apps, le format de page contrôle le nombre d’enregistrements extraits à la fois des tables du backend. Un appel des données pull entraînerait la création de lots de données en fonction du format de page, jusqu'à ce qu’il n’y a plus aucun enregistrement à extraire.

Il est possible de configurer un format de page à l’aide de MSPullSettings comme indiqué ci-dessous. Le format de page par défaut est 50, et il est paramétré dans l’exemple ci-dessous sur 3.

Vous pouvez configurer un autre format de page pour des raisons de performances. Si vous avez un grand nombre d’enregistrements de données de petite taille, une taille de page élevée permet de réduire le nombre d’allers-retours avec le serveur.

Ce paramètre contrôle uniquement le format de page côté client. Si le client demande un format de page plus grand que le backend Mobile Apps prend en charge, le format de page est limitée à la valeur maximale que configurée prise en charge par le serveur.

Ce paramètre correspond également au nombre d’enregistrements de données, non à la taille en octets.

Si vous augmentez le format de page côté client, vous devez également augmenter le format de page sur le serveur. Consultez « Ajuster la taille de pagination des tables » pour connaître les étapes à suivre.

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)
    }
}

Procédure : insertion de données

Pour insérer une nouvelle ligne de table, créez un NSDictionary et appelez table insert. Si le schéma dynamique est activé, le backend mobile Azure App Service génère automatiquement de nouvelles colonnes basées sur le NSDictionary.

Si id n'est pas fourni, le backend génère automatiquement un nouvel ID unique. Fournissez votre propre id pour utiliser les adresses de messagerie électronique, les noms d'utilisateurs, ou vos propres valeurs personnalisées sous la forme d'ID. Fournir son propre ID peut faciliter les jointures et la logique de base de données orientée métier.

L’élément result contient le nouvel élément qui a été inséré. Selon la logique du serveur, il peut afficher des données supplémentaires ou modifiées par rapport à ce qui a été transmis au serveur.

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"])
    }
}

Procédure : modification des données

Pour mettre à jour une ligne existante, modifiez un élément et appelez 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"])
        }
    })
}

Vous pouvez également fournir l'ID de la ligne et le champ mis à jour :

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"])
    }
}

Au minimum, l'attribut id doit être défini quand vous effectuez des mises à jour.

Procédure : suppression de données

Pour supprimer un élément, appelez delete avec l'élément :

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)
    }
}

Vous pouvez également effectuer la suppression en fournissant un ID de ligne :

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)
    }
}

Au minimum, l'attribut id doit être défini quand vous effectuez des suppressions.

Procédure : appel d’une API personnalisée

Une API personnalisée vous permet d’exposer toutes les fonctionnalités du serveur principal. Il n’est pas nécessaire de la mapper à une opération de table. Non seulement vous avez davantage de contrôle sur la messagerie, mais vous pouvez également lire/définir des en-têtes et modifier le format du corps de réponse.

Pour appeler une API personnalisée, appelez MSClient.invokeAPI. Le contenu de la requête et de la réponse est traité au format JSON. Pour utiliser d’autres types de média, utilisez l’autre surcharge de invokeAPI. Pour effectuer une requête au lieu d’une GETPOST requête, définissez le paramètre sur "GET" et le paramètre HTTPMethodbodynil sur (étant donné que les requêtes GET n’ont pas de corps de message.) Si votre API personnalisée prend en charge d’autres verbes HTTP, modifiez HTTPMethod de manière appropriée.

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
                }
        }

Inscription de modèles de notifications Push pour envoyer des notifications multiplateforme

Pour inscrire des modèles, transmettez-les avec votre méthode client.push registerDeviceToken dans votre application cliente.

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)
    }
})

Vos modèles sont de type NSDictionary et peuvent contenir plusieurs modèles au format suivant :

Objective-C :

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

Swift :

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

Toutes les balises sont supprimées de la demande pour des raisons de sécurité. Pour ajouter des balises à des installations ou à des modèles contenus dans une installation, consultez Utiliser le Kit de développement logiciel (SDK) du serveur principal .NET pour Azure Mobile Apps. Pour envoyer des notifications à l’aide de ces modèles inscrits, utilisez les API Notification Hubs.

Guide pratique pour gérer les erreurs

Quand vous appelez un backend mobile Azure App Service, le bloc completion contient un paramètre NSError . Si une erreur se produit, ce paramètre est non-nil. Vous devez vérifier ce paramètre dans votre code et gérer les erreurs, le cas échéant, comme indiqué dans les extraits de code précédents.

Le fichier <WindowsAzureMobileServices/MSError.h> définit les constantes MSErrorResponseKey, MSErrorRequestKey et MSErrorServerItemKey. Pour obtenir plus d’informations sur l’erreur :

Objective-C :

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

Swift :

let serverItem = error.userInfo[MSErrorServerItemKey]

En outre, le fichier définit des constantes pour chaque code d'erreur :

Objective-C :

if (error.code == MSErrorPreconditionFailed) {

Swift :

if (error.code == MSErrorPreconditionFailed) {

Procédure : authentifier des utilisateurs avec la bibliothèque Active Directory Authentication Library

Vous pouvez utiliser la bibliothèque d’authentification Active Directory (ADAL) pour authentifier des utilisateurs dans votre application à l’aide d’Azure Active Directory. L’authentification par flux client à l’aide d’un SDK de fournisseur d’identité est préférable à l’utilisation de la méthode loginWithProvider:completion: . L’authentification par client flux offre une interface UX native plus simple et permet une personnalisation supplémentaire.

Si vous souhaitez configurer le serveur d’applications mobiles back-end pour utiliser la connexion AAD, suivez le didacticiel Configurer votre application App Service pour utiliser la connexion Azure Active Directory. Bien que cette étape soit facultative, veillez à inscrire une application cliente native. Pour iOS, il est recommandé d’utiliser une URI de redirection de type <app-scheme>://<bundle-id>. Pour plus d’informations, consultez le didacticiel de démarrage rapide d’ADAL pour iOS.
Installez la bibliothèque ADAL à l’aide de Cocoapods. Modifiez votre podfile pour inclure la définition suivante, en remplaçant YOUR-PROJECT par le nom de votre projet Xcode :
```
 source 'https://github.com/CocoaPods/Specs.git'
 link_with ['YOUR-PROJECT']
 xcodeproj 'YOUR-PROJECT'
```
et le pod :
```
 pod 'ADALiOS'
```
À l’aide du Terminal, exécutez pod install à partir du répertoire contenant votre projet, puis ouvrez l’espace de travail Xcode généré (et non le projet).
Ajoutez le code suivant à votre application, en fonction du langage utilisé. Vérifiez à chaque fois ces remplacements :
- Remplacez INSERT-AUTHORITY-HERE par le nom du client dans lequel vous avez approvisionné votre application. Le format doit être https://login.microsoftonline.com/contoso.onmicrosoft.com. Cette valeur peut être copiée à partir de l’onglet Domaine de votre annuaire Azure Active Directory dans le Portail Azure.
- Remplacez INSERT-RESOURCE-ID-HERE par l’ID client du serveur principal de votre application mobile. Vous pouvez obtenir l’ID client sur le portail, sous l’onglet Avancé du menu Paramètres Azure Active Directory.
- Remplacez INSERT-CLIENT-ID-HERE par l’ID client que vous avez copié depuis l’application cliente native.
- Remplacez INSERT-REDIRECT-URI-HERE par le point de terminaison /.auth/login/done de votre site, en utilisant le modèle HTTPS. Cette valeur doit être similaire à 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)
            }
        }
}

Procédure : authentifier les utilisateurs avec le kit de développement logiciel (SDK) Facebook pour iOS

Vous pouvez utiliser le kit de développement logiciel (SDK) Facebook pour iOS pour identifier les utilisateurs sur votre application utilisant Facebook. L’authentification par flux client est préférable à l’utilisation de la méthode loginWithProvider:completion: . L’authentification par client flux offre une interface UX native plus simple et permet une personnalisation supplémentaire.

Si vous souhaitez configurer le serveur d’applications mobiles back-end pour utiliser la connexion Facebook, suivez le didacticiel Configurer votre application App Service pour utiliser la connexion Facebook.
Installez le SDK Facebook pour iOS en suivant la documentation Kit de développement logiciel (SDK) Facebook pour iOS : prise en main. Au lieu de créer une application, vous pouvez ajouter la plateforme iOS à votre inscription existante.

La documentation de Facebook comprend du code en Objective-C dans le délégué de l’application. Si vous utilisez Swift, vous pouvez vous servir des conversions suivantes pour 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
}

En plus d’ajouter FBSDKCoreKit.framework à votre projet, ajoutez également une référence à FBSDKLoginKit.framework de la même façon.

Ajoutez le code suivant à votre application, en fonction du langage utilisé.

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)
        }
    }
}

Procédure : authentifier les utilisateurs avec Twitter Fabric pour iOS

Vous pouvez utiliser Twitter Fabric pour iOS pour identifier les utilisateurs sur votre application utilisant Twitter. L’authentification par flux client est souvent préférable à l’utilisation de la méthode loginWithProvider:completion: , car elle offre une interface UX native plus simple et permet une personnalisation supplémentaire.

Si vous souhaitez configurer le backend de votre application mobile pour utiliser la connexion Twitter, suivez le didacticiel Configurer votre application App Service pour utiliser la connexion Twitter .
Ajoutez Fabric à votre projet en suivant la documentation Fabric pour iOS : prise en main (en anglais) et en configurant TwitterKit.

Notes

Par défaut, Fabric crée une application Twitter pour vous. Vous pouvez éviter de créer une application en enregistrant la clé et la clé secrète du client que vous avez créées plus tôt avec les extraits de code suivants. Vous pouvez également remplacer les valeurs de clé et de clé secrète du client que vous fournissez à App Service avec les valeurs que vous voyez dans le Tableau de bord de Fabric. Si vous choisissez cette option, veillez à définir l’URL de rappel sur une valeur d’espace réservé, par exemple https://<yoursitename>.azurewebsites.net/.auth/login/twitter/callback.

Si vous choisissez d’utiliser les clés secrètes que vous avez créées précédemment, ajoutez le code suivant à votre délégué d’application :

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
}
```

Ajoutez le code suivant à votre application, en fonction du langage utilisé.

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)
        }
    }
}

Procédure : authentifier les utilisateurs avec le kit de développement logiciel (SDK) Google Sign-In pour iOS

Vous pouvez utiliser le kit de développement logiciel (SDK) Google Sign-In pour iOS pour identifier les utilisateurs sur votre application utilisant un compte Google. Google a récemment annoncé que des modifications avaient été apportées à ses stratégies de sécurité OAuth. Ces modifications de stratégie nécessiteront l’utilisation du SDK Google à l’avenir.

Si vous souhaitez configurer le backend de votre application mobile pour utiliser la connexion Google, suivez le didacticiel Configurer votre application App Service pour utiliser la connexion Google .
Installez le SDK Google pour iOS en suivant les instructions figurant dans la documentation Google Sign-In for iOS - Start integrating (Google Sign-In pour iOS - Démarrer l’intégration). Vous pouvez ignorer la section « Authentification avec un serveur principal ».

Ajoutez ce qui suit à la méthode signIn:didSignInForUser:withError: de votre délégué, en fonction du langage que vous utilisez.

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
    // ...
}

Assurez-vous que vous ajoutez également le code suivant à application:didFinishLaunchingWithOptions: dans votre délégué d’application, en remplaçant « SERVER_CLIENT_ID » par le même ID utilisé pour configurer App Service à l’étape 1.

Objective-C :
```
[GIDSignIn sharedInstance].serverClientID = @"SERVER_CLIENT_ID";
```
Swift :
```
GIDSignIn.sharedInstance().serverClientID = "SERVER_CLIENT_ID"
```
Ajoutez le code suivant à votre application dans un UIViewController qui implémente le protocole GIDSignInUIDelegate , en fonction du langage que vous utilisez. Vous êtes déconnecté avant d’être connecté à nouveau, et même si vous n’avez pas à entrer ses informations d’identification, une boîte de dialogue de consentement s’affiche. Appelez uniquement cette méthode lorsque le jeton de session a expiré.

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()
}
```

Partager via

Utilisation de la bibliothèque cliente iOS pour Azure Mobile Apps

Vue d’ensemble

Documentation de référence

Plateformes prises en charge

Configuration et conditions préalables

Création du client

Procédure : création d'une référence de table

Guide pratique pour interroger des données

Procédure : filtrage des données renvoyées

Procédure : utilisation de MSQuery

Procédure : trier des données avec MSQuery

Procédure : limitation des champs et développement des paramètres de chaîne de requête avec MSQuery

Procédure : configuration du format de page

Procédure : insertion de données

Procédure : modification des données

Procédure : suppression de données

Procédure : appel d’une API personnalisée

Inscription de modèles de notifications Push pour envoyer des notifications multiplateforme

Guide pratique pour gérer les erreurs

Procédure : authentifier des utilisateurs avec la bibliothèque Active Directory Authentication Library

Procédure : authentifier les utilisateurs avec le kit de développement logiciel (SDK) Facebook pour iOS

Procédure : authentifier les utilisateurs avec Twitter Fabric pour iOS

Procédure : authentifier les utilisateurs avec le kit de développement logiciel (SDK) Google Sign-In pour iOS

Ressources supplémentaires