O AWS Mobile SDK for Xamarin agora está incluído no AWS SDK for .NET. Este guia faz referência à versão arquivada do Mobile SDK para Xamarin.

Configurar o AWS Mobile SDK para .NET e Xamarin

Você pode configurar o AWS Mobile SDK para .NET e Xamarin e começar a criar um novo projeto ou integrar o SDK a um projeto existente. Você também pode clonar e executar os exemplos para ter uma ideia de como funciona o SDK. Siga estas etapas para configurar e começar a usar o AWS Mobile SDK para .NET e Xamarin.

Pré-requisitos

Antes de usar o AWS Mobile SDK para .NET e Xamarin, você precisa fazer o seguinte:

Após concluir os pré-requisitos:

Etapa 1: Obter as credenciais da AWS

Para fazer chamadas para a AWS no aplicativo, primeiro obtenha as credenciais da AWS. Faça isso usando o Amazon Cognito, um serviço da AWS que permite que o aplicativo acesse os serviços do SDK sem precisar incorporar as credenciais privadas da AWS ao aplicativo.

Para começar a usar o Amazon Cognito, é necessário criar um banco de identidades. Um grupo de identidades é um armazenamento de informações específico da sua conta e identificado por um ID de grupo de identidades com a seguinte aparência:

"us-east-1:00000000-0000-0000-0000-000000000000"

Normalmente, você só usa um grupo de identidades por aplicativo.

Após criar o grupo de identidades, você obterá as credenciais da AWS criando um objeto CognitoAWSCredentials (inserindo o ID do grupo de identidades) e inserindo-o no construtor de um cliente da AWS, da seguinte forma:

CognitoAWSCredentials credentials = new CognitoAWSCredentials (
    "us-east-1:00000000-0000-0000-0000-000000000000", // Your identity pool ID
    RegionEndpoint.USEast1 // Region
);

// Example for |MA|
analyticsManager = MobileAnalyticsManager.GetOrCreateInstance(
  credentials,
  RegionEndpoint.USEast1, // Region
  APP_ID // app id
);

Etapa 2: Definir permissões

Defina permissões para cada serviço da AWS a ser usado no aplicativo. Primeiro, você precisa entender como a AWS visualiza os usuários do aplicativo.

Quando alguém usa o aplicativo e faz chamadas para a AWS, ela atribui uma identidade a esse usuário. O grupo de identidades criado na Etapa 1 é o local onde a AWS armazena essas identidades. Existem dois tipos de identidades: autenticados e não autenticados. As identidades autenticadas pertencem a usuários que serão autenticados por meio de um provedor de login público (por exemplo, Facebook, Amazon, Google). As identidades não autenticadas pertencem a usuários convidados.

Cada identidade é associada a uma função do AWS Identity and Access Management. Na Etapa 1, você criou dois perfis do IAM, um para usuários autenticados e outro para usuários não autenticados. Cada perfil do IAM tem uma ou mais políticas anexadas a ele que especificam quais serviços da AWS as identidades atribuídas a esse perfil podem acessar. Por exemplo, a política de exemplo a seguir concede acesso a um bucket do Amazon S3:

{
  "Statement": [
    {
      "Action": [
        "s3:AbortMultipartUpload",
        "s3:DeleteObject",
        "s3:GetObject",
        "s3:PutObject"
      ],
      "Effect": "Allow",
      "Resource": "arn:aws:s3:::MYBUCKETNAME/*",
      "Principal": "*"
    }
  ]
}

Para definir permissões para os serviços da AWS que você deseja usar no aplicativo, modifique a política anexada aos perfis.

Para obter mais informações sobre como criar políticas ou escolher um item em uma lista de políticas, consulte Políticas do IAM.

Etapa 3: Criar um novo projeto da

Windows

Você pode usar o Visual Studio para desenvolver seu aplicativo.

OS X

Você pode usar o Visual Studio para desenvolver aplicativos. O desenvolvimento para iOS usando o Xamarin requer acesso a um Mac para executar o aplicativo. Para obter mais informações, consulte Como instalar o Xamarin.iOS no Windows.

Etapa 4: Instalar o AWS Mobile SDK para .NET e Xamarin

Windows

Opção 1: Instalar usando o console do Package Manager

O AWS Mobile SDK para .NET e Xamarin consiste em um conjunto de assemblies .NET. Para instalar o AWS Mobile SDK para .NET e Xamarin, execute o comando install-package para cada pacote no console do Package Manager. Por exemplo, para instalar o Cognito Identity, execute o seguinte:

Install-Package AWSSDK.CognitoIdentity

Os pacotes do AWS Core Runtime e do Amazon Cognito Identity são necessários em todos os projetos. Veja a seguir uma lista completa de nomes de pacotes para cada serviço.

Para incluir um pacote de pré-lançamento, inclua o argumento de linha de comando -Pre durante a instalação do pacote, da seguinte forma:

Install-Package AWSSDK.CognitoSync -Pre

Veja uma lista completa de pacotes de serviços da AWS em Pacotes do AWS SDK no NuGet ou no GitHub Repository do AWS SDK para .NET.

Opção 2: Instalar usando o IDE

No Visual Studio

Mac (OS X)

No Visual Studio

Etapa 5: Configurar o AWS Mobile SDK para .NET e Xamarin

Definição do registro

Definas as configurações de registro usando as classes Amazon.AWSConfigs e Amazon.Util.LoggingConfig. Você as encontrará no assembly AWSSdk.Core, disponível por meio do Nuget Package Manager no Visual Studio. Insira o código das configurações de registro no método OnCreate do arquivo MainActivity.cs para aplicativos Android ou do arquivo AppDelegate.cs para aplicativos iOS. Você também deve adicionar as instruções using Amazon e using Amazon.Util aos arquivos .cs.

Defina as configurações de registro da seguinte maneira:

var loggingConfig = AWSConfigs.LoggingConfig;
loggingConfig.LogMetrics = true;
loggingConfig.LogResponses = ResponseLoggingOption.Always;
loggingConfig.LogMetricsFormat = LogMetricsFormatOption.JSON;
loggingConfig.LogTo = LoggingOptions.SystemDiagnostics;

Quando você se registra em SystemDiagnostics, a estrutura imprime internamente a saída para o System.Console. Se você deseja registrar respostas HTTP, defina o sinalizador LogResponses. Os valores podem ser Always, Never ou OnError.

Você também pode registrar as métricas de desempenho das solicitações HTTP usando a propriedade LogMetrics. O formato do log pode ser especificado através da propriedade LogMetricsFormat. Os valores válidos são JSON ou standard.

Definição do endpoint da região

Configure a região padrão para todos os clientes do serviço da seguinte maneira:

AWSConfigs.AWSRegion="us-east-1";

Isso define a região padrão para todos os clientes de serviços no SDK. Você pode substituir essa configuração especificando explicitamente a região no momento da criação de uma instância do cliente de serviço, da seguinte maneira:

IAmazonS3 s3Client = new AmazonS3Client(credentials,RegionEndpoint.USEast1);

Definição das configurações de proxy HTTP

Se a rede estiver atrás de um proxy, você poderá definir as configurações de proxy das solicitações HTTP da seguinte maneira.

var proxyConfig = AWSConfigs.ProxyConfig;
proxyConfig.Host = "localhost";
proxyConfig.Port = 80;
proxyConfig.Username = "<username>";
proxyConfig.Password = "<password>";

Correção da distorção do relógio

Esta propriedade determina se o SDK corrigirá a distorção de relógio do cliente determinando a hora de servidor correta e emitindo novamente a solicitação com a hora correta.

AWSConfigs.CorrectForClockSkew = true;

Este campo será definido se uma chamada de serviço tiver resultado em uma exceção e o SDK tiver determinado que há uma diferença entre a hora local e a hora do servidor.

var offset = AWSConfigs.ClockOffset;

Para saber mais sobre distorção de relógio, consulte Correção de distorção de relógio no Blog da AWS.

Próximas etapas

Agora que configurou o AWS Mobile SDK para .NET e Xamarin, você pode: