Criar um Aplicativo Xamarin.Android

Artigo
06/25/2019

Visão geral

Este tutorial mostra como adicionar um serviço de back-end baseado em nuvem a um aplicativo Xamarin Android. Para saber mais, confira O que são Aplicativos Móveis.

Uma captura de tela do aplicativo completo está disponível abaixo:

A conclusão deste tutorial é um pré-requisito para todos os outros tutoriais de Aplicativos Móveis para aplicativos Xamarin.Android.

Pré-requisitos

Para concluir este tutorial, você precisará dos seguintes pré-requisitos:

Uma conta ativa do Azure. Se você não tiver uma conta, inscreva-se para uma avaliação do Azure e obtenha até 10 aplicativos móveis gratuitos. Para obter detalhes, consulte Avaliação gratuita do Azure.
Visual Studio com Xamarin. Veja Setup and Install for Visual Studio and Xamarin (Configuração e instalação para Visual Studio e Xamarin).

Criar um back-end de aplicativo móvel do Azure

Siga estas etapas para criar um back-end de aplicativo móvel.

Entre no portal do Azure.
Clique em Criar um recurso.
Na caixa de pesquisa, digite Aplicativo Web.
Na lista de resultados, selecione Aplicativo Web no Marketplace.
Selecione sua Assinatura e Grupo de Recursos (selecione um grupo de recursos existente ou crie um novo (usando o mesmo nome que seu aplicativo)).
Escolha um nome exclusivo do aplicativo Web.
Escolha a opção de Publicação padrão como Código.
Na pilha Runtime, você precisa selecionar uma versão em ASP.NET ou Nó. Se você estiver criando um back-end do .NET, selecione uma versão em ASP.NET. Caso contrário, se você estiver direcionando um aplicativo baseado em nó, selecione uma das versões do Nó.
Selecione o sistema operacional correto, linux ou Windows.
Selecione a região em que você deseja que este aplicativo seja implantado.
Selecione o plano de Serviço de Aplicativo apropriado e clique em Examinar e criar.
Em Grupo de Recursos, selecione um grupo de recursos existente ou crie um novo (usando o mesmo nome que o aplicativo).
Clique em Criar. Aguarde alguns minutos para que o serviço seja implantado com êxito antes de continuar. Observe o ícone de notificações (sino) no cabeçalho do portal para atualizações de status.
Depois que a implantação for concluída, clique na seção Detalhes da Implantação e clique no Recurso do Tipo Microsoft.Web/sites. Ele navegará até o aplicativo Web Serviço de Aplicativo que você acabou de criar.
Clique na folha Configuração em Configurações e, nas configurações do aplicativo, clique no botão Nova configuração do aplicativo .
Na página de configuração Adicionar/Editar aplicativo , insira Nome como MobileAppsManagement_EXTENSION_VERSION e Valor como mais recente e clique em OK.

Você está pronto para usar este aplicativo Web Serviço de Aplicativo recém-criado como um aplicativo Móvel.

Você acabou de provisionar um back-end do aplicativo móvel do Azure que pode ser usado pelos aplicativos móveis clientes. Em seguida, baixe um projeto do servidor para um back-end simples da "lista de tarefas" e publique-o no Azure.

Criar uma conexão de banco de dados e configurar o projeto cliente e servidor

Baixe os guias de início rápido do SDK do cliente para as seguintes plataformas:

iOS (Objective-C)
iOS (Swift)
Android (Java)
Xamarin.iOS
Xamarin.Android
Xamarin.Forms
Cordova
Windows (C#)

Observação

Se você usar o projeto do iOS, precisará baixar "azuresdk-iOS-*.zip" da versão mais recente do GitHub. Descompacte e adicione o MicrosoftAzureMobile.framework arquivo à raiz do projeto.
Você precisará adicionar uma conexão de banco de dados ou conectar-se a uma conexão existente. Primeiro, determine se você criará um armazenamento de dados ou usará um existente.
- Crie um novo armazenamento de dados: se você vai criar um armazenamento de dados, use o seguinte início rápido:
  
  Início Rápido: Introdução a bancos de dados individuais no Banco de Dados SQL do Azure
- Fonte de dados existente: siga as instruções abaixo se você quiser usar uma conexão de banco de dados existente
  1. formato de cadeia de conexão Banco de Dados SQL -Data Source=tcp:{your_SQLServer},{port};Initial Catalog={your_catalogue};User ID={your_username};Password={your_password}
    
    {your_SQLServer} Nome do servidor, isso pode ser encontrado na página de visão geral do banco de dados e geralmente está na forma de "server_name.database.windows.net". {port} geralmente 1433. {your_catalogue} Nome do banco de dados. {your_username} Nome de usuário para acessar seu banco de dados. {your_password} Senha para acessar seu banco de dados.
    
    Saiba mais sobre o formato cadeia de conexão do SQL
  2. Adicione a cadeia de conexão ao aplicativo móvel em Serviço de Aplicativo, você pode gerenciar cadeias de conexão para seu aplicativo usando a opção Configuração no menu.
    
    Para adicionar uma cadeia de conexão:
    1. Clique na guia Configurações do aplicativo .
    2. Clique em [+] Nova cadeia de conexão.
    3. Você precisará fornecer Nome, Valor e Tipo para sua cadeia de conexão.
    4. Nome do Tipo comoMS_TableConnectionString
    5. O valor deve ser a cadeia de conexão que você formou na etapa anterior.
    6. Se você estiver adicionando uma cadeia de conexão a um banco de dados SQL Azure escolha SQLAzure no tipo.
Os Aplicativos Móveis do Azure têm SDKs para back-ends do .NET e Node.js.
- Back-end do Node.js
  
  Se você vai usar Node.js aplicativo de início rápido, siga as instruções abaixo.
  1. No portal do Azure, vá para Tabelas Fáceis, você verá essa tela.
  2. Verifique se a cadeia de conexão SQL já foi adicionada na guia Configuração . Em seguida, marque a caixa de reconhecimento de que isso substituirá todo o conteúdo do site e clicará no botão Criar tabela TodoItem .
  3. Em Tabelas Fáceis, clique no botão + Adicionar .
  4. Crie uma TodoItem tabela com acesso anônimo.
- Back-end do .NET
  
  Se você vai usar o aplicativo de início rápido .NET, siga as instruções abaixo.
  1. Baixe o projeto do servidor .NET dos Aplicativos Móveis do Azure no repositório de início rápido do azure-mobile-apps-quickstarts.
  2. Crie o projeto do servidor .NET localmente no Visual Studio.
  3. No Visual Studio, abra Gerenciador de Soluções, clique com o botão direito do mouse no projeto, clique em ZUMOAPPNAMEServicePublicar, você verá uma Publish to App Service janela. Se você estiver trabalhando no Mac, confira outras maneiras de implantar o aplicativo aqui.
  4. Selecione Serviço de Aplicativo como destino de publicação e clique em Selecionar Existente e, em seguida, clique no botão Publicar na parte inferior da janela.
  5. Você precisará fazer logon no Visual Studio com sua assinatura do Azure primeiro. Selecione o Subscription, e, em seguida, Resource Groupselecione o nome do seu aplicativo. Quando você estiver pronto, clique em OK, isso implantará o projeto do servidor .NET que você tem localmente no back-end Serviço de Aplicativo. Quando a implantação for concluída, você será redirecionado para http://{zumoappname}.azurewebsites.net/ o navegador.

Executar o aplicativo Xamarin.Android

Abra o projeto Xamarin.Android.
Acesse o portal do Azure e navegue até o aplicativo móvel que você criou. Overview Na folha, procure a URL que é o ponto de extremidade público para seu aplicativo móvel. Exemplo : o nome do site do meu nome de aplicativo "test123" será https://test123.azurewebsites.net.
Abra o arquivo ToDoActivity.cs nesta pasta – xamarin.android/ZUMOAPPNAME/ToDoActivity.cs. O nome do app é ZUMOAPPNAME.
Na ToDoActivity classe, substitua ZUMOAPPURL a variável pelo ponto de extremidade público acima.

const string applicationURL = @"ZUMOAPPURL";

se torna

const string applicationURL = @"https://test123.azurewebsites.net";
Pressione a tecla F5 para implantar e executar o aplicativo.
No aplicativo, digite um texto significativo, como Concluir o tutorial e depois clique no botão Adicionar.

Os dados da solicitação são inseridos na tabela TodoItem. Itens armazenados na tabela são retornados pelo back-end do aplicativo móvel e os dados aparecem na lista.

Observação

Você pode examinar o código que acessa o back-end do aplicativo móvel para consultar e inserir dados que estão localizados no arquivo ToDoActivity.cs C#.

Solução de problemas

Se você tiver problemas para compilar a solução, execute o gerenciador de pacotes NuGet e atualize os pacotes de suporte do Xamarin.Android. Os projetos de Início Rápido nem sempre incluem as últimas versões.

Observe que todos os pacotes de suporte referenciados em seu projeto devem ter a mesma versão. O pacote NuGet de Aplicativos Móveis do Azure depende de Xamarin.Android.Support.CustomTabs para a plataforma Android e, portanto, se o projeto usar pacotes de suporte mais recentes, será necessário instalar diretamente esse pacote com a versão necessária para evitar conflitos.

Compartilhar via