Criar um Aplicativo Xamarin.Android

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:

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

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

  1. Entre no portal do Azure.

  2. Clique em Criar um recurso.

  3. Na caixa de pesquisa, digite Aplicativo Web.

  4. Na lista de resultados, selecione Aplicativo Web no Marketplace.

  5. Selecione sua Assinatura e Grupo de Recursos (selecione um grupo de recursos existente ou crie um novo (usando o mesmo nome que seu aplicativo)).

  6. Escolha um nome exclusivo do aplicativo Web.

  7. Escolha a opção de Publicação padrão como Código.

  8. Na pilha Runtime, você precisa selecionar uma versão em ASP.NET ou . 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ó.

  9. Selecione o sistema operacional correto, linux ou Windows.

  10. Selecione a região em que você deseja que este aplicativo seja implantado.

  11. Selecione o plano de Serviço de Aplicativo apropriado e clique em Examinar e criar.

  12. Em Grupo de Recursos, selecione um grupo de recursos existente ou crie um novo (usando o mesmo nome que o aplicativo).

  13. 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.

  14. 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.

  15. Clique na folha Configuração em Configurações e, nas configurações do aplicativo, clique no botão Nova configuração do aplicativo .

  16. 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

  1. 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.

  2. 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.

  3. 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.

        Tabelas fáceis de nó

      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 .

        Configuração de tabelas fáceis de nó

      3. Em Tabelas Fáceis, clique no botão + Adicionar .

        Botão Adicionar Tabelas Fáceis de Nó

      4. Crie uma TodoItem tabela com acesso anônimo.

        Tabelas fáceis de nó adicionam tabela

    • 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.

        Publicação do Visual Studio

      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

  1. Abra o projeto Xamarin.Android.

  2. 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.

  3. Abra o arquivo ToDoActivity.cs nesta pasta – xamarin.android/ZUMOAPPNAME/ToDoActivity.cs. O nome do app é ZUMOAPPNAME.

  4. 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";

  5. Pressione a tecla F5 para implantar e executar o aplicativo.

  6. 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.