Passo a passo do Connected ServicesConnected Services walkthrough

O fluxo de trabalho do Connected Services leva o fluxo de trabalho do portal do Azure ao Visual Studio para Mac, para que não seja necessário sair do projeto para adicionar serviços.The Connected Services workflow brings the Azure portal workflow into Visual Studio for Mac, so you don’t have to leave your project to add services.

Este passo a passo mostra como adicionar um serviço de back-end do Azure, que oferece armazenamento de dados em nuvem, autenticação e notificações por push, em um aplicativo PCL (Biblioteca de Classes Portátil) multiplataforma do Xamarin.Forms.This walkthrough shows how to add an Azure backend service, which brings cloud data storage, authentication, and push notifications to a cross-platform Xamarin.Forms Portable Class Library (PCL) application.

  1. Para começar, clique duas vezes no nó Connected Services na solução, o que abre a Galeria de Serviços.Start by double-clicking on the Connected Services node in the solution, which will bring up the Services Gallery. Esta é uma lista de todos os serviços disponíveis para o tipo de aplicativo.This is a list of all the available services for the application type. Selecione um serviço (como Back-end móvel com o Serviço de Aplicativo do Azure) clicando nele.Select a service (such as Mobile backend with Azure App Service) by clicking on it.

    Nó do Connected Services no Visual Studio para MacConnected Services node in Visual Studio for Mac

  2. A página de Detalhes do Serviço oferece uma descrição do serviço e das dependências que serão instaladas.The Service Details Page has a description of the service and the dependencies to be installed. Clique no botão Adicionar para adicionar as dependências ao aplicativo:Click the Add button to add the dependencies to the app:

    Back-end móvel com o AzureMobile backend with Azure

  3. As dependências precisam ser adicionadas aos projetos PCL e específicos da plataforma para que funcionem.The dependencies need to be added to both the PCL and the platform-specific projects to work. Marque as caixas de seleção para adicionar o serviço em cada projeto que o referenciará (direta ou indiretamente):Select the checkboxes to add the service to every project that will reference it (either directly or indirectly):

    Marque todos os projetos que devem referenciar o serviçoCheck all projects that should reference the service

  4. Escolha Aceitar nas caixas de diálogo Aceitação da licença dos pacotes NuGet.Choose Accept on the License Acceptance dialogs for the NuGet packages. Pode haver duas caixas de diálogo a serem aceitas, uma do MobileClient e das dependências e outra do SQLiteStore, que é necessário para a sincronização de dados offline:There may be two dialogs to accept, one for the MobileClient and dependencies, and another for SQLiteStore, which is required for offline data sync:

    Aceite os contratos de licençaAccept License Agreements

    Janela de aceitação da licençaLicense Acceptance window

  5. Quando as dependências forem adicionadas, será solicitado que você faça logon com a conta que deseja usar para se comunicar com o Azure.Once the dependencies are added, you'll be asked to log in with the account you want to use to communicate with Azure. Se você já tiver feito logon com uma ID da Microsoft, o Visual Studio para Mac tentará buscar suas assinaturas do Azure e todos os serviços de aplicativo associados a elas.If you’re already logged in with a Microsoft ID, Visual Studio for Mac will attempt to fetch your Azure subscriptions and any app services associated with them. Se você não tiver nenhuma assinatura, adicione uma inscrevendo-se para uma avaliação gratuita ou comprando um plano de assinatura no Portal do Azure.If you do not have any subscriptions, you can add one by signing up for a free trial or purchasing a subscription plan in the Azure portal.

  6. Selecione um serviço de aplicativo na lista.Select an app service from the list. Isso preencherá o código de modelo para o objeto MobileServiceClient com a URL correspondente do serviço de aplicativo no Azure:This will fill the template code for the MobileServiceClient object with the corresponding URL of the app service on Azure:

    Selecione o serviço de aplicativo na listaSelect app service from list

    Se não houver nenhum serviço listado, clique no botão Novo (confira a Etapa 9).If there are no services listed, click the New button (see Step 9.)

  7. Copie o código de modelo do MobileServiceClient no PCL.Copy the template code for the MobileServiceClient into the PCL. O local do arquivo não é importante, desde que haja apenas uma instância dele.The file location is not important, so long as there is only one instance of it. A abordagem recomendada é criar uma classe AzureService que manipule todas as interações do Azure e use o MobileServiceClient:The recommended approach is to create an AzureService class that handles all Azure interactions and uses the MobileServiceClient:

    Copie o código de configuração no aplicativoCopy config code into the ap

  8. Siga a documentação em Próximas Etapas para adicionar dados, sincronizar offline, autenticar e enviar notificações por push para o aplicativo:Follow the documentation in Next Steps to add data, offline sync, authentication, and push notifications to your app:

    Examine as instruções das próximas etapasReview the next steps instructions

  9. Se você não tiver nenhum serviço de aplicativo existente, crie serviços usando o Visual Studio para Mac.If you don’t have any existing app services, you can create new services from within Visual Studio for Mac. Clique no botão Novo no canto inferior esquerdo da lista de serviços para abrir a caixa de diálogo Novo Serviço de Aplicativo:Click the New button in the bottom left of the services list to open the New App Service dialog:

    Crie um serviço de aplicativo no Visual Studio para MacCreate a new app service in Visual Studio for Mac

Um novo serviço requer os seguintes parâmetros:A new service requires the following parameters:

  • Nome do serviço de aplicativo – nome/ID exclusiva do planoApp service name – unique name/id for the plan
  • Assinatura – a assinatura que você deseja usar para pagar pelo serviçoSubscription – the subscription you’d like to use to pay for the service
  • Grupo de Recursos – um modo de organizar todos os recursos do Azure para um projeto.Resource Group – a way or organizing all your Azure resources for a project. Opção de usar um existente ou criar um.Option to use existing or create a new one. Se esse for seu primeiro serviço do Azure, crie um.If this is your first Azure service, create a new one.
  • Plano de Serviço – determina o local e o custo dos recursos que o usam.Service Plan – Determines the location and cost of any resources that use it. Opção de usar um existente ou criar um.Option to use existing or create a new one. Se esse for o primeiro serviço do Azure, use o padrão ou crie um novo na camada gratuita (F1).If this is your first Azure service, use the default one or create a new one in the free tier (F1).

Visite a Documentação do Serviço de Aplicativo do Azure para obter mais informações.Visit the Azure App Service documentation for more information.