Criar uma aplicação Xamarin.iOS

Descrição Geral

Este tutorial mostra como adicionar um serviço de back-end baseado na nuvem a uma aplicação móvel Xamarin.iOS utilizando um back-end da aplicação móvel do Azure. Pode criar tanto um novo back-end da aplicação móvel assim como uma simples aplicação Xamarin.iOS de uma Lista de tarefas que armazena dados da aplicação no Azure.

A conclusão deste tutorial é um pré-requisito para todos os outros tutoriais do Xamarin.iOS referentes à utilização da funcionalidade Mobile Apps no App Service do Azure.

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, que pode continuar a utilizar mesmo após o final do período de avaliação. Para obter mais detalhes, consulte Avaliação Gratuita do Azure.
  • Visual Studio para Mac. Consulte a Configuração e instale-Visual Studio para Mac
  • Um Mac com Xcode 9.0 ou mais tarde.

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

  1. Inicie sessão no portal do Azure.

  2. Clique em Criar um recurso.

  3. Na caixa de pesquisa, escreva Web App.

  4. Na lista de resultados, selecione Web App do Marketplace.

  5. 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)).

  6. Escolha um nome único da sua aplicação web.

  7. Escolha a opção de publicação predefinido como Código.

  8. Na pilha Runtime, é necessário selecionar uma versão em ASP.NET ou . 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ó.

  9. Selecione o Sistema Operativo certo, seja o Linux ou o Windows.

  10. Selecione a Região onde gostaria que esta aplicação fosse implementada.

  11. Selecione o plano de Serviço de Aplicações apropriado e bata em Revisão e crie.

  12. No Grupo de Recursos, selecione um grupo de recursos existente ou crie um novo (utilize o mesmo nome da sua aplicação).

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

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

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

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

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

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

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

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

        Mesas fáceis de nó

      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 .

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

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

        Tabelas fáceis de nó adicionar botão

      4. Criar uma TodoItem mesa com acesso anónimo.

        Tabelas fáceis de nó adicionar tabela

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

        Publicação de estúdio visual

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

  1. Abra o projeto Xamarin.iOS.

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

  3. Abra o ficheiro QSTodoService.cs nesta pasta - xamarin.iOS/ZUMOAPPNAME. O nome da aplicação é ZUMOAPPNAME.

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

  5. Pressione a tecla F5 para implementar e executar a aplicação num emulador de iPhone.

  6. Na aplicação, escreva texto significativo, como completar o tutorial e, em seguida, clicar no botão +.

    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#).