Procédure pas à pas des services connectésConnected Services walkthrough

Comme le flux de travail Services connectés intègre le flux de travail du portail Azure à Visual Studio pour Mac, vous n’avez pas à quitter votre projet pour ajouter des services.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.

Cette procédure pas à pas montre comment ajouter un service backend Azure, qui intègre le stockage de données dans le cloud, l’authentification et les notifications Push à une application de bibliothèque de classes portable (PCL) Xamarin.Forms multiplateforme.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. Commencez par double-cliquer sur le nœud Services connectés dans la solution, pour afficher la galerie des services.Start by double-clicking on the Connected Services node in the solution, which brings up the Services Gallery. Il s’agit d’une liste de tous les services disponibles pour le type d’application.This is a list of all the available services for the application type. Sélectionnez un service (tel que Backend mobile avec Azure App Service) en cliquant dessus.Select a service (such as Mobile backend with Azure App Service) by clicking on it.

    Nœud Services connectés dans Visual Studio pour MacConnected Services node in Visual Studio for Mac

  2. La page Détails sur le service comporte une description du service et des dépendances à installer.The Service Details Page has a description of the service and the dependencies to be installed. Cliquez sur le bouton Ajouter pour ajouter les dépendances à l’application :Click the Add button to add the dependencies to the app:

    Backend mobile avec AzureMobile backend with Azure

  3. Les dépendances doivent être ajoutées à la fois à la bibliothèque PCL et aux projets spécifiques à une plateforme pour fonctionner.The dependencies need to be added to both the PCL and the platform-specific projects to work. Cochez les cases pour ajouter le service à chaque projet qui le référence (directement ou indirectement) :Select the checkboxes to add the service to every project that will reference it (either directly or indirectly):

    Vérifier tous les projets qui doivent référencer le serviceCheck all projects that should reference the service

  4. Choisissez Accepter dans les boîtes de dialogue Acceptation de la licence pour les packages NuGet.Choose Accept on the License Acceptance dialogs for the NuGet packages. Deux boîtes de dialogue avec l’option Accepter peuvent s’afficher : une pour MobileClient et les dépendances, et une autre pour SQLiteStore, ce qui est nécessaire pour la synchronisation de données hors connexion :There may be two dialogs to accept, one for the MobileClient and dependencies, and another for SQLiteStore, which is required for offline data sync:

    Accepter les contrats de licenceAccept License Agreements

    Fenêtre acceptation de la licenceLicense Acceptance window

  5. Une fois que les dépendances sont ajoutées, vous êtes invité à vous connecter avec le compte que vous voulez utiliser pour communiquer avec Azure.Once the dependencies are added, you'll be asked to log in with the account you want to use to communicate with Azure. Si vous êtes déjà connecté avec un ID Microsoft, Visual Studio pour Mac va tenter de récupérer vos abonnements Azure et tous les App Services qui s’y rapportent.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. Si vous n’avez aucun abonnement, vous pouvez en ajouter un en vous inscrivant pour un essai gratuit ou en achetant un plan d’abonnement dans le portail 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. Sélectionnez un App Service dans la liste.Select an app service from the list. Cela remplira le code du modèle pour l’objet MobileServiceClient avec l’URL correspondante de l’App Service sur Azure :This will fill the template code for the MobileServiceClient object with the corresponding URL of the app service on Azure:

    Sélectionner App service dans la listeSelect app service from list

    Si aucun service n’est répertorié, cliquez sur le bouton Nouveau (consultez l’étape 9).If there are no services listed, click the New button (see Step 9.)

  7. Copiez le code du modèle pour l’objet MobileServiceClient dans la bibliothèque PCL.Copy the template code for the MobileServiceClient into the PCL. L’emplacement du fichier n’est pas important tant qu’il n’existe qu’une seule instance de celui-ci.The file location is not important, so long as there is only one instance of it. L’approche recommandée consiste à créer une classe AzureService qui gère toutes les interactions Azure et utilise l’objet MobileServiceClient :The recommended approach is to create an AzureService class that handles all Azure interactions and uses the MobileServiceClient:

    Copier le code de configuration dans le point d’accèsCopy config code into the ap

  8. Suivez la documentation dans Étapes suivantes pour ajouter des données, la synchronisation hors connexion, l’authentification et les notifications Push à votre application :Follow the documentation in Next Steps to add data, offline sync, authentication, and push notifications to your app:

    Passez en revue les instructions suivantesReview the next steps instructions

  9. Si vous n’avez aucun App Service, vous pouvez en créer de nouveaux à partir de Visual Studio pour Mac.If you don’t have any existing app services, you can create new services from within Visual Studio for Mac. Cliquez sur le bouton Nouveau dans la partie inférieure gauche de la liste des services pour ouvrir la boîte de dialogue Nouvel App Service :Click the New button in the bottom left of the services list to open the New App Service dialog:

    Créer un app service dans Visual Studio pour MacCreate a new app service in Visual Studio for Mac

Un nouveau service nécessite les paramètres suivants :A new service requires the following parameters:

  • Nom de l’App Service : ID/nom unique du planApp service name – unique name/id for the plan
  • Abonnement : abonnement que vous souhaitez utiliser pour payer le serviceSubscription – the subscription you’d like to use to pay for the service
  • Groupe de ressources : façon d’organiser toutes vos ressources Azure pour un projet.Resource Group – a way or organizing all your Azure resources for a project. Possibilité d’utiliser l’existant ou d’en créer un autre.Option to use existing or create a new one. S’il s’agit de votre premier service Azure, créez-en un autre.If this is your first Azure service, create a new one.
  • Plan de service : détermine l’emplacement et le coût des ressources qui l’utilisent.Service Plan – Determines the location and cost of any resources that use it. Possibilité d’utiliser l’existant ou d’en créer un autre.Option to use existing or create a new one. S’il s’agit de votre premier service Azure, utilisez celui par défaut ou créez-en un autre dans le niveau gratuit (F1).If this is your first Azure service, use the default one or create a new one in the free tier (F1).

Pour plus d’informations, consultez la documentation sur les applications mobiles.Visit the Mobile apps documentation for more information.

Voir aussiSee also