Criar uma Aplicação Xamarin.Android

Artigo
06/25/2019

Descrição Geral

Este tutorial mostra como adicionar um serviço de back-end baseado na nuvem a uma aplicação Xamarin.Android. Para obter mais informações, consulte O que são Mobile Apps.

Abaixo é exibida uma captura de ecrã da aplicação concluída:

A conclusão deste tutorial é um pré-requisito para todos os outros tutoriais de Mobile Apps para aplicações Xamarin.Android.

Pré-requisitos

Para concluir este tutorial, precisa dos seguintes pré-requisitos:

Uma conta ativa do Azure. Se não tiver uma conta, inscreva-se para uma versão de avaliação do Azure e obtenha até 10 Aplicações Móveis gratuitas. Para obter mais detalhes, consulte Avaliação Gratuita do Azure.
Visual Studio com Xamarin. Para obter instruções, consulte Configuração e instalação do Visual Studio e Xamarin.

Criar um back-end da Aplicação Móvel do Azure

Siga estes passos para criar um back-end da Aplicação Móvel.

Inicie sessão no portal do Azure.
Clique em Criar um recurso.
Na caixa de pesquisa, escreva Web App.
Na lista de resultados, selecione Web App do Marketplace.
Selecione o seu Grupo de Subscrição e Recursos (selecione um grupo de recursos existente ou crie um novo (utilizando o mesmo nome que a sua aplicação)).
Escolha um nome único da sua aplicação web.
Escolha a opção de publicação predefinido como Código.
Na pilha Runtime, é necessário selecionar uma versão em ASP.NET ou Nó. Se estiver a construir um backend .NET, selecione uma versão em ASP.NET. Caso contrário, se estiver a direcionar uma aplicação baseada no nó, selecione uma das versões do Nó.
Selecione o Sistema Operativo certo, seja o Linux ou o Windows.
Selecione a Região onde gostaria que esta aplicação fosse implementada.
Selecione o plano de Serviço de Aplicações apropriado e bata em Revisão e crie.
No Grupo de Recursos, selecione um grupo de recursos existente ou crie um novo (utilize o mesmo nome da sua aplicação).
Clique em Criar. Antes de prosseguir, aguarde alguns minutos até o serviço ser implementado com êxito. Observe o ícone de Notificações (sino) no cabeçalho de portal para ver se há atualizações de estado.
Assim que a implementação estiver concluída, clique na secção de detalhes de Implementação e, em seguida, clique no Recurso do Tipo Microsoft.Web/sites. Irá navegar para a Serviço de Aplicações Web App que acabou de criar.
Clique na lâmina de configuração em Definições e nas definições de Aplicação, clique no botão de definição de nova aplicação .
Na página de definição de aplicação Add/Edit, insira o Nome como MobileAppsManagement_EXTENSION_VERSION e Valor como mais recente e acerte OK.

Você está pronto para usar esta aplicação web de Serviço de Aplicações recentemente criada como uma aplicação Móvel.

Acabou de aprovisionar um back-end da Aplicação Móvel do Azure que pode ser utilizado pelas suas aplicações cliente móveis. Em seguida, transfira um projeto de servidor para um back-end simples de uma “lista de tarefas” e publique-o no Azure.

Crie uma ligação de base de dados e configuure o projeto do cliente e do servidor

Descarregue os quickstarts SDK do cliente para as seguintes plataformas:

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

Nota

Se utilizar o projeto iOS, precisa de baixar "azuresdk-iOS-*.zip" a partir da versão mais recente do GitHub. Desaperte e adicione o MicrosoftAzureMobile.framework ficheiro à raiz do projeto.
Terá de adicionar uma ligação de base de dados ou ligar-se a uma ligação existente. Primeiro, determine se irá criar uma loja de dados ou utilizar uma existente.
- Criar uma nova loja de dados: Se pretender criar uma loja de dados, utilize o seguinte arranque rápido:
  
  Quickstart: Começar com bases de dados individuais na SQL do Azure Database
- Fonte de dados existente: Siga as instruções abaixo se pretender utilizar uma ligação de base de dados existente
  1. Base de Dados SQL formato de cadeia de ligação -Data Source=tcp:{your_SQLServer},{port};Initial Catalog={your_catalogue};User ID={your_username};Password={your_password}
    
    {your_SQLServer} O nome do servidor pode ser encontrado na página geral da sua base de dados e é geralmente na forma de "server_name.database.windows.net". {porta} normalmente 1433. {your_catalogue} O nome da base de dados. {your_username} O nome de utilizador para aceder à sua base de dados. {your_password} Senha para aceder à sua base de dados.
    
    Saiba mais sobre o formato SQL Connection String
  2. Adicione o fio de ligação à sua aplicação móvel Em Serviço de Aplicações, pode gerir as cadeias de ligação para a sua aplicação utilizando a opção Configuração no menu.
    
    Para adicionar uma cadeia de ligação:
    1. Clique no separador Definições de Aplicação .
    2. Clique em [+] Nova cadeia de ligação.
    3. Terá de fornecer Nome, Valor e Tipo para a sua cadeia de ligação.
    4. Tipo de Nome comoMS_TableConnectionString
    5. O valor deve ser a cadeia de ligação que formou no passo anterior.
    6. Se estiver a adicionar um fio de ligação a uma base de dados SQL Azure escolha o SQLAzure por tipo.
A Azure Mobile Apps tem SDKs para backends .NET e Node.js.
- Node.js backend
  
  Se vai utilizar Node.js aplicação de arranque rápido, siga as instruções abaixo.
  1. No portal do Azure, vá a Easy Tables, verá este ecrã.
  2. Certifique-se de que a cadeia de ligação SQL já está adicionada no separador Configuração . Em seguida, verifique a caixa de eu reconhecer que isto substituirá todos os conteúdos do site e clique no botão de mesa Create TodoItem .
  3. Em Tabelas Fáceis, clique no botão + Adicionar .
  4. Criar uma TodoItem mesa com acesso anónimo.
- .NET backend
  
  Se vai utilizar a aplicação .NET quickstart, siga as instruções abaixo.
  1. Descarregue o projeto Azure Mobile Apps .NET server a partir do repositório azure-mobile-apps-quickstarts.
  2. Construa o projeto do servidor .NET localmente no Visual Studio.
  3. No Visual Studio, abra Explorador de Soluções, clique à direita no ZUMOAPPNAMEService projeto, clique em Publicar, verá uma Publish to App Service janela. Se estiver a trabalhar no Mac, confira outras formas de implementar a aplicação aqui.
  4. Selecione Serviço de Aplicações como alvo de publicação e, em seguida, clique em Selecionar Existir e, em seguida, clique no botão Publicar na parte inferior da janela.
  5. Primeiro terá de iniciar sessão no Visual Studio com a sua assinatura Azure. Selecione o Subscription, Resource Groupe, em seguida, selecione o nome da sua aplicação. Quando estiver pronto, clique em OK, isto irá implementar o projeto do servidor .NET que tem localmente no backend Serviço de Aplicações. Quando a implementação terminar, será redirecionado para http://{zumoappname}.azurewebsites.net/ o navegador.

Executar a aplicação Xamarin.Android

Abra o projeto Xamarin.Android.
Vá ao portal do Azure e navegue para a aplicação móvel que criou. Overview Na lâmina, procure o URL que é o ponto final público para a sua aplicação móvel. Exemplo - o nome do site para o meu nome de aplicação "test123" será https://test123.azurewebsites.net.
Abra o ficheiro ToDoActivity.cs nesta pasta - xamarin.android/ZUMOAPPNAME/ToDoActivity.cs. O nome da aplicação é ZUMOAPPNAME.
Na ToDoActivity aula, substitua ZUMOAPPURL a variável por ponto final público acima.

const string applicationURL = @"ZUMOAPPURL";

torna-se

const string applicationURL = @"https://test123.azurewebsites.net";
Pressione a tecla F5 para implementar e executar a aplicação.
Na aplicação, escreva texto significativo, como completar o tutorial e, em seguida, clicar no botão Adicionar .

Os dados do pedido são inseridos na tabela TodoItem. Os itens armazenados na tabela são devolvidos pelo back-end da aplicação móvel e os dados são apresentados na lista.

Nota

Pode rever o código que acede ao seu back-end da aplicação móvel para consultar e inserir dados (presente no ficheiro ToDoActivity.cs c#).

Resolução de problemas

Se tiver algum problema ao criar a solução, execute o gestor de pacotes NuGet e atualize os pacotes de suporte Xamarin.Android. Os projetos do início rápido nem sempre incluem as versões mais recentes.

Note que todos os pacotes de suporte referenciados no projeto têm de ter a mesma versão. O pacote NuGet de Aplicações Móveis do Azure tem dependência Xamarin.Android.Support.CustomTabs para a plataforma Android. Portanto, se o seu projeto utilizar os pacotes de suporte mais recentes, precisará de instalar diretamente este pacote com a versão necessária para evitar conflitos.