Como usar a Biblioteca de Cliente iOS para os Aplicativos Móveis do Azure

Artigo
06/25/2019

Visão geral

Este guia ensina a executar cenários comuns usando o mais recente SDK de Aplicativos Móveis do Azure para iOS. Se você for novo nos Aplicativos Móveis do Azure, primeiro conclua o Início Rápido dos Aplicativos Móveis do Azure para criar um back-end, criar uma tabela e baixar um projeto Xcode iOS pré-criado. Neste guia, abordaremos o SDK para iOS do lado do cliente. Para saber mais sobre o SDK do lado do servidor para o back-end, confira os TUTORIAIS do SDK do Servidor.

Documentação de referência

A documentação de referência para o SDK do cliente do iOS está aqui: Referência de cliente do iOS de Aplicativos Móveis do Azure.

Plataformas compatíveis

O SDK do iOS dá suporte a projetos de Objective-C, Swift 2.2 e projetos Swift 2.3 para iOS na versão 8.0 ou posterior.

A autenticação de "fluxo de servidor" usa um modo de exibição da Web para a interface do usuário apresentada. Se o dispositivo não for capaz de apresentar uma interface do usuário para modo de exibição da Web, será necessário outro método de autenticação fora do escopo do produto. Esse SDK, portanto, não é adequado para relógios ou dispositivos similarmente restritos.

Configuração e pré-requisitos

Este guia pressupõe que você tenha criado um back-end com uma tabela. Este guia pressupõe que a tabela tem o mesmo esquema das tabelas desses tutoriais. Este guia também pressupõe que em seu código, você referencia MicrosoftAzureMobile.framework e importa MicrosoftAzureMobile/MicrosoftAzureMobile.h.

Como: criar o cliente

Para acessar um back-end de Aplicativos Móveis do Azure em seu projeto, crie um MSClient. Substitua AppUrl pela URL do aplicativo. Você pode deixar gatewayURLString e applicationKey vazios. Se você configurar um gateway para autenticação, preencha gatewayURLString com a URL do gateway.

Objective-C:

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

Swift:

let client = MSClient(applicationURLString: "AppUrl")

Como criar uma referência de tabela

Para acessar ou atualizar dados, crie uma referência à tabela de back-end. Substitua TodoItem pelo nome da sua tabela

Objective-C:

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

Swift:

let table = client.tableWithName("TodoItem")

Como consultar dados

Para criar uma consulta de banco de dados, consulte o objeto MSTable . A consulta a seguir obtém todos os itens em TodoItem e registra o texto de cada item.

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

Como filtrar dados retornados

Para filtrar os resultados, há muitas opções disponíveis.

Para filtrar usando um predicado, use NSPredicate e readWithPredicate. Os filtros a seguir retornaram dados para localizar apenas os itens pendentes não concluídos.

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

Como usar o MSQuery

Para executar uma consulta complexa (incluindo classificação e paginação), crie um objeto de MSQuery diretamente ou usando um predicado:

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 permite que você controle vários comportamentos de consulta.

Especificar a ordem dos resultados
Limitar quais campos retornar
Limitar quantos registros retornar
Especificar contagem total na resposta
Especificar parâmetros de cadeia de consulta personalizada na solicitação
Aplicar funções adicionais

Executar uma consulta MSQuery chamando readWithCompletion no objeto.

Como classificar dados com MSQuery

Para classificar os resultados, vamos examinar um exemplo. Para classificar por 'texto' de campo em ordem crescente e 'concluído' em ordem decrescente, invoque MSQuery desta forma:

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

Como limitar campos e expandir os parâmetros de cadeia de caracteres de consulta com MSQuery

Para limitar os campos a serem retornados em uma consulta, especifique os nomes dos campos na propriedade selectFields . Esse exemplo retorna somente o texto e os campos preenchidos:

Objective-C:

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

Swift:

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

Para incluir parâmetros de cadeia de caracteres de consulta adicionais na solicitação do servidor (por exemplo, porque é usado por um script personalizado do lado do servidor), popule query.parameters desta forma:

Objective-C:

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

Swift:

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

Como: Configurar o tamanho de página

Com os Aplicativos Móveis do Azure, o tamanho da página controla o número de registros que são extraídos de uma só vez das tabelas do back-end. Uma chamada para dados pull, em seguida, criaria um lote de dados, com base no tamanho de página, até que não haja mais registros para efetuar pull.

É possível configurar um tamanho de página usando MSPullSettings conforme mostrado abaixo. O tamanho de página padrão é 50, e o exemplo a seguir é alterado para 3.

Você pode configurar um tamanho de página diferente por motivos de desempenho. Se você tiver um grande número de registros de dados pequenos, um tamanho de página alto reduz o número de viagens de ida e volta do servidor.

Essa configuração controla somente o tamanho da página no lado do cliente. Se o cliente solicita um tamanho de página maior que o suporte oferecido pelo back-end de Aplicativos Móveis, o tamanho da página está limitado ao máximo que o back-end está configurado para suportar.

Essa configuração também é o número de registros de dados, não o tamanho em bytes.

Se você aumentar o tamanho de página de cliente, também deverá aumentar o tamanho de página no servidor. Consulte "Como ajustar o tamanho de paginação da tabela" para conhecer as etapas para fazer isso.

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

Como inserir dados

Para inserir uma nova linha na tabela, crie um NSDictionary e invoque table insert. Se Esquema Dinâmico está habilitado, o back-end móvel do Serviço de Aplicativo do Azure gera novas colunas automaticamente com base no NSDictionary.

Se não for fornecida uma id , o back-end gera automaticamente uma ID exclusiva. Forneça sua própria id para usar endereços de email, nomes de usuários, ou seus próprios valores personalizados como ID. Fornecer sua própria identificação pode facilitar junções e lógicas de banco de dados comerciais.

O result contém o novo item que foi inserido. Dependendo de sua lógica de servidor, ele pode ter dados adicionais ou modificados em comparação com o que foi passado para o servidor.

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

Como modificar dados

Para atualizar uma linha existente, modifique um item e chame 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"])
        }
    })
}

Como alternativa, forneça a ID da linha e o campo atualizado:

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

No mínimo, o atributo id deve ser definido quando você faz atualizações.

Como excluir dados

Para excluir um item, invoque delete com o item:

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

Como alternativa, exclua fornecendo uma ID de linha:

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

No mínimo, o atributo id deve ser definido quando você faz exclusões.

Como chamar uma API personalizada

Com uma API personalizada, você pode expor qualquer funcionalidade de back-end. Ele não precisa mapear para uma operação de tabela. Não só você obtém mais controle sobre mensagens, mas pode até mesmo ler/definir os cabeçalhos e alterar o formato do corpo da resposta.

Para chamar uma API personalizada, chame MSClient.invokeAPI. O conteúdo de solicitação e resposta de conteúdo é tratado como JSON. Para usar outros tipos de mídia, use a outra sobrecarga de invokeAPI. Para fazer uma GET solicitação em vez de uma solicitação POST , defina parâmetro HTTPMethod"GET" para e parâmetro body ( nil uma vez que as solicitações GET não têm corpos de mensagem).) Se sua API personalizada der suporte a outros verbos HTTP, altere HTTPMethod adequadamente.

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

Como registrar modelos de envio por push para enviar notificações entre plataformas

Para registrar os modelos, passe modelos com o método client.push registerDeviceToken no seu aplicativo de 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)
    }
})

Seus modelos são do tipo NSDictionary e podem conter vários modelos no seguinte formato:

Objective-C:

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

Swift:

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

Todas as marcações são eliminadas da solicitação de segurança. Para adicionar marcas a instalações ou modelos dentro de instalações, confira Trabalhar com o SDK do servidor de back-end do .NET para Aplicativos Móveis do Azure. Para enviar notificações usando esses modelos registrados, trabalhe com APIs de Hubs de Notificação.

Como tratar erros

Quando você chama um back-end móvel do Serviço de Aplicativo do Azure, o bloco de conclusão contém um parâmetro NSError . Quando ocorre um erro, esse parâmetro é não nulo. No seu código, você deve marcar esse parâmetro e tratar o erro conforme necessário, conforme demonstrado nos snippets de código anteriores.

O arquivo <WindowsAzureMobileServices/MSError.h> define as constantes MSErrorResponseKey, MSErrorRequestKey e MSErrorServerItemKey. Para obter mais dados relacionados ao erro:

Objective-C:

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

Swift:

let serverItem = error.userInfo[MSErrorServerItemKey]

Além disso, o arquivo define constantes para cada código de erro:

Objective-C:

if (error.code == MSErrorPreconditionFailed) {

Swift:

if (error.code == MSErrorPreconditionFailed) {

Como autenticar usuários com a Biblioteca de Autenticação do Active Directory

Você pode usar a ADAL (Biblioteca de autenticação do Active Directory) para conectar os usuários ao seu aplicativo usando o Active Directory do Azure. É melhor usar a autenticação de fluxo de cliente usando SDK do provedor de identidade do que usar o método loginWithProvider:completion: . Autenticação de fluxo de cliente fornece uma aparência mais nativa do UX e permite uma maior personalização.

Configure o seu back-end de aplicativo móvel para entrada no AAD seguindo o tutorial Como configurar o Serviço de Aplicativo para logon no Active Directory . Complete a etapa opcional de registrar um aplicativo cliente nativo. Para iOS, recomendamos que o URI de redirecionamento tenha o formato <app-scheme>://<bundle-id>. Para saber mais, confira o Início rápido da ADAL para iOS.
Instale o ADAL usando o Cocoapods. Edite o Podfile para incluir a seguinte definição, substituindo YOUR-PROJECT pelo nome de seu projeto do Xcode:
```
 source 'https://github.com/CocoaPods/Specs.git'
 link_with ['YOUR-PROJECT']
 xcodeproj 'YOUR-PROJECT'
```
e o Pod:
```
 pod 'ADALiOS'
```
Usando o Terminal, execute pod install no diretório que contém o projeto e abra o workspace do Xcode gerado (não o projeto).
Adicione o código a seguir ao seu aplicativo, de acordo com a linguagem que você está usando. Em cada um, faça estas substituições:
- Substitua INSERT-AUTHORITY-HERE pelo nome do locatário no qual o aplicativo foi provisionado. O formato deve ser https://login.microsoftonline.com/contoso.onmicrosoft.com. Esse valor pode ser copiado da guia Domínio no Azure Active Directory no portal do Azure.
- Substitua INSERT-RESOURCE-ID-HERE pela ID do cliente do seu back-end de aplicativo móvel. Você pode obter a ID do cliente na guia Avançadas em Configurações do Azure Active Directory no portal.
- Substitua INSERT-CLIENT-ID-HERE pela ID do cliente copiada do aplicativo cliente nativo.
- Substitua INSERT-REDIRECT-URI-HERE pelo ponto de extremidade /.auth/login/done do site, usando o esquema HTTPS. Este valor deve ser semelhante a 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)
            }
        }
}

Instruções: autenticar usuários com o SDK do Facebook para iOS

Você pode usar o SDK do Facebook para iOS para conectar os usuários ao seu aplicativo usando o Facebook. É melhor usar a autenticação de fluxo de cliente do que usar o método loginWithProvider:completion: . A autenticação do fluxo de cliente fornece uma aparência mais nativa de UX e permite uma maior personalização.

Configure o seu back-end de aplicativo móvel para entrar no Facebook seguindo o tutorial Como configurar o Serviço de Aplicativo para logon do Facebook.
Instale o SDK do Facebook para iOS seguindo a documentação Facebook SDK para iOS - Introdução. Em vez de criar um aplicativo, você pode adicionar a plataforma do iOS ao seu registro existente.

A documentação do Facebook inclui algum código Objective-C no Representante do Aplicativo. Se você estiver usando Swift, poderá usar as seguintes conversões para 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
}

Além de adicionar FBSDKCoreKit.framework ao seu projeto, adicione também uma referência ao FBSDKLoginKit.framework da mesma maneira.

Adicione o código a seguir ao seu aplicativo, de acordo com a linguagem que você está usando.

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

Instruções: autenticar usuários com a Twitter Fabric para iOS

Você pode usar a Fabric para iOS para desconectar os usuários em seu aplicativo usando o Twitter. Normalmente, é melhor usar a autenticação de fluxo de cliente do que usar o método loginWithProvider:completion: , pois ele fornece uma aparência mais nativa do UX e permite uma maior personalização.

Configurar o seu back-end de aplicativos móveis para entrar no Twitter, seguindo o tutorial Como configurar o Serviço de Aplicativo para fazer logon no Twitter .
Adicione a Fabric ao seu projeto seguindo a documentação Fabric para iOS - Introdução e a configuração TwitterKit.

Observação

Por padrão, o Fabric cria um aplicativo do Twitter para você. Você pode evitar a criação de um aplicativo registrando a Chave do Consumidor e o Segredo do Consumidor criados anteriormente usando os snippets de código a seguir. Como alternativa, você pode substituir os valores de chave do consumidor e segredo do consumidor que fornece ao Serviço de Aplicativo com os valores que vê no Painel do Fabric. Se você escolher essa opção, certifique-se de definir a URL de retorno de chamada para um valor de espaço reservado, como https://<yoursitename>.azurewebsites.net/.auth/login/twitter/callback.

Se você optar por usar os segredos que criou anteriormente, adicione o seguinte código ao seu Representante de Aplicativo:

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

Adicione o código a seguir ao seu aplicativo, de acordo com a linguagem que você está usando.

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

Instruções: autenticar usuários com o SDK do Login do Google para iOS

Você pode usar o SDK do Login do Google para iOS para conectar os usuários ao seu aplicativo usando uma conta do Google. O Google anunciou alterações em suas políticas de segurança OAuth recentemente. Essas alterações de política exigirão o uso do SDK do Google.

Configurar o seu back-end de aplicativos móveis para entrar no Google, seguindo o tutorial How to configure App Service for Google login (Como configurar o Serviço de Aplicativo para fazer login no Google) .
Instale o SDK do Google para iOS seguindo a documentação Google Sign-In for iOS - Start integrating (Login do Google para iOS - iniciar a integração) . Você pode ignorar a seção "Autenticar com um servidor de back-end".

Adicione o seguinte ao método signIn:didSignInForUser:withError: do seu representante, de acordo com a linguagem que você estiver usando.

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

Adicione também o seguinte ao application:didFinishLaunchingWithOptions: em seu representante de aplicativo, substituindo "SERVER_CLIENT_ID" pela mesma ID que você usou para configurar o Serviço de Aplicativo na etapa 1.

Objective-C:
```
[GIDSignIn sharedInstance].serverClientID = @"SERVER_CLIENT_ID";
```
Swift:
```
GIDSignIn.sharedInstance().serverClientID = "SERVER_CLIENT_ID"
```
Adicione o código a seguir ao seu aplicativo em um UIViewController que implementa o protocolo GIDSignInUIDelegate , de acordo com a linguagem que você está usando. Você é desconectado antes de ser conectado novamente e, embora não precise digitar suas credenciais novamente, um diálogo de consentimento é exibido. Só chame esse método quando o token de sessão tiver expirado.

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

Como usar a Biblioteca de Cliente iOS para os Aplicativos Móveis do Azure

Visão geral

Documentação de referência

Plataformas compatíveis

Configuração e pré-requisitos

Como: criar o cliente

Como criar uma referência de tabela

Como consultar dados

Como filtrar dados retornados

Como usar o MSQuery

Como classificar dados com MSQuery

Como limitar campos e expandir os parâmetros de cadeia de caracteres de consulta com MSQuery

Como: Configurar o tamanho de página

Como inserir dados

Como modificar dados

Como excluir dados

Como chamar uma API personalizada

Como registrar modelos de envio por push para enviar notificações entre plataformas

Como tratar erros

Como autenticar usuários com a Biblioteca de Autenticação do Active Directory

Instruções: autenticar usuários com o SDK do Facebook para iOS

Instruções: autenticar usuários com a Twitter Fabric para iOS

Instruções: autenticar usuários com o SDK do Login do Google para iOS

Recursos adicionais