Démarrage rapide : Créer une application iOS avec Azure Spatial Anchors, en Swift ou Objective-CQuickstart: Create an iOS app with Azure Spatial Anchors, in either Swift or Objective-C

Ce démarrage rapide explique comment créer une application iOS à l’aide d’Azure Spatial Anchors en Swift ou Objective-C.This quickstart covers how to create an iOS app using Azure Spatial Anchors in either Swift or Objective-C. Azure Spatial Anchors est un service de développement multiplateforme qui vous permet de créer des expériences de réalité mixte en utilisant des objets qui conservent leur emplacement d’un appareil à un autre au fil du temps.Azure Spatial Anchors is a cross-platform developer service that allows you to create mixed reality experiences using objects that persist their location across devices over time. Quand vous aurez terminé, vous aurez une application iOS ARKit capable d’enregistrer et de rappeler une ancre spatiale.When you're finished, you'll have an ARKit iOS app that can save and recall a spatial anchor.

Vous découvrirez comment effectuer les actions suivantes :You'll learn how to:

  • Créer un compte Spatial AnchorsCreate a Spatial Anchors account
  • Configurer l’identificateur et la clé du compte Spatial AnchorsConfigure the Spatial Anchors account identifier and account key
  • Déployer et exécuter sur un appareil iOSDeploy and run on an iOS device

Si vous n’avez pas d’abonnement Azure, créez un compte gratuit avant de commencer.If you don't have an Azure subscription, create a free account before you begin.

PrérequisPrerequisites

Pour suivre ce guide de démarrage rapide, veillez à avoir :To complete this quickstart, make sure you have:

  • Une machine macOS prête pour le développement dotée de Xcode 10+ et de CocoaPods.A developer enabled macOS machine with Xcode 10+ and CocoaPods installed.
  • Git installé via HomeBrew.Git installed via HomeBrew. Entrez la commande suivante sur une seule ligne du Terminal : /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)".Enter the following command into a single line of the Terminal: /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)". Exécutez ensuite brew install git.Then, run brew install git.
  • Un appareil iOS compatible ARKit prêt pour le développement.A developer enabled ARKit compatible iOS device.

Créer une ressource Spatial AnchorsCreate a Spatial Anchors resource

Accédez au portail Azure.Go to the Azure portal.

Dans le volet de navigation gauche du portail Azure, sélectionnez Créer une ressource.In the left navigation pane in the Azure portal, select Create a resource.

Utilisez la zone de recherche pour rechercher Spatial Anchors.Use the search box to search for Spatial Anchors.

Recherche de Spatial Anchors

Sélectionnez Spatial Anchors.Select Spatial Anchors. Dans la boîte de dialogue, sélectionnez Créer.In the dialog box, select Create.

Dans la boîte de dialogue Compte Spatial Anchors :In the Spatial Anchors Account dialog box:

  • Entrez un nom de ressource unique, en utilisant des caractères alphanumériques normaux.Enter a unique resource name, using regular alphanumeric characters.

  • Sélectionnez l’abonnement auquel attacher la ressource.Select the subscription that you want to attach the resource to.

  • Créer un groupe de ressources en sélectionnant Créer.Create a resource group by selecting Create new. Nommez-le myResourceGroup et sélectionnez OK.Name it myResourceGroup and select OK. Un groupe de ressources est un conteneur logique dans lequel les ressources Azure comme les applications web, les bases de données et les comptes de stockage sont déployés et gérés.A resource group is a logical container into which Azure resources like web apps, databases, and storage accounts are deployed and managed. Par exemple, vous pouvez choisir de supprimer le groupe de ressources complet ultérieurement en une seule étape.For example, you can choose to delete the entire resource group in one simple step later.

  • Sélectionnez un emplacement (région) où placer la ressource.Select a location (region) in which to place the resource.

  • Sélectionnez Nouveau pour commencer à créer la ressource.Select New to begin creating the resource.

    Créer une ressource

Une fois la ressource créée, le portail Azure indique que votre déploiement est terminé.After the resource is created, Azure Portal will show that your deployment is complete. Cliquez sur Accéder à la ressource.Click Go to resource.

Déploiement terminé

Ensuite, vous pouvez afficher les propriétés de la ressource.Then, you can view the resource properties. Copiez l’ID de compte de la ressource dans un éditeur de texte, car vous en aurez besoin par la suite.Copy the resource's Account ID value into a text editor because you'll need it later.

Propriétés de la ressource

Sous Paramètres, sélectionnez Clé.Under Settings, select Key. Copiez la valeur de la Clé primaire dans un éditeur de texte.Copy the Primary key value into a text editor. Cette valeur est la Account Key.This value is the Account Key. Vous en aurez besoin ultérieurement.You'll need it later.

Clé de compte

Ouvrir l’exemple de projetOpen the sample project

Dans le Terminal, exécutez les actions suivantes.Use the Terminal to perform the following actions.

Cloner le dépôt d’exemples en exécutant la commande suivante :Clone the samples repository by running the following command:

git clone https://github.com/Azure/azure-spatial-anchors-samples.git

Installez les pods nécessaires à l’aide de CocoaPods :Install the necessary pods using CocoaPods:

Accédez à iOS/Swift/.Navigate to iOS/Swift/.

cd ./iOS/Swift/

Exécutez pod install --repo-update pour installer les CocoaPods pour le projet.Run pod install --repo-update to install the CocoaPods for the project.

Ouvrez maintenant .xcworkspace dans Xcode.Now open the .xcworkspace in Xcode.

open ./SampleSwift.xcworkspace

Configurer l’identificateur et la clé du compteConfigure account identifier and key

L’étape suivante configure l’application pour qu’elle utilise votre identificateur et votre clé de compte.The next step is to configure the app to use your account identifier and account key. Vous les avez copiés dans un éditeur de texte pendant la configuration de la ressource Spatial Anchors.You copied them into a text editor when setting up the Spatial Anchors resource.

Ouvrez iOS/Swift/SampleSwift/ViewControllers/BaseViewController.swift.Open iOS/Swift/SampleSwift/ViewControllers/BaseViewController.swift.

Localisez le champ spatialAnchorsAccountKey et remplacez Set me par la clé du compte.Locate the spatialAnchorsAccountKey field and replace Set me with the account key.

Localisez le champ spatialAnchorsAccountId et remplacez Set me par l’identificateur du compte.Locate the spatialAnchorsAccountId field and replace Set me with the account identifier.

Déployer l’application sur votre appareil iOSDeploy the app to your iOS device

Connectez l’appareil iOS au Mac et définissez le schéma actif sur votre appareil iOS.Connect the iOS device to the Mac and set the active scheme to your iOS device.

Sélectionner l’appareil

Sélectionnez Build and then run the current scheme.Select Build and then run the current scheme.

Déployer et exécuter

Notes

Si l’erreur library not found for -lPods-SampleObjC s’affiche, vous avez probablement ouvert le fichier .xcodeproj à la place de .xcworkspace.If you see a library not found for -lPods-SampleObjC error, you likely opened the .xcodeproj file instead of the .xcworkspace. Ouvrez .xcworkspace et réessayez.Open the .xcworkspace and try again.

Dans Xcode, arrêtez l’application en appuyant sur Stop.In Xcode, stop the app by pressing Stop.

Supprimer des ressourcesClean up resources

Au cours des étapes précédentes, vous avez créé des ressources Azure au sein d’un groupe de ressources.In the preceding steps, you created Azure resources in a resource group. Si vous ne pensez pas avoir besoin de ces ressources à l’avenir, vous pouvez les supprimer en supprimant le groupe de ressources.If you don't expect to need these resources in the future, you can delete them by deleting the resource group.

Dans le menu de gauche du portail Azure, cliquez sur Groupes de ressources, puis sur myResourceGroup.From the left menu in the Azure portal, select Resource groups and then select myResourceGroup.

Sur la page Groupes de ressources, assurez-vous que les ressources répertoriées sont bien celles que vous souhaitez supprimer.On the resource group page, make sure that the listed resources are the ones you want to delete.

Sélectionnez Supprimer, tapez myResourceGroup dans la zone de texte, puis sélectionnez Supprimer.Select Delete, type myResourceGroup in the text box, and then select Delete.

Étapes suivantesNext steps

Dans ce guide de démarrage rapide, vous avez créé un compte Spatial Anchors.In this quickstart, you created a Spatial Anchors account. Vous avez ensuite configuré et déployé une application pour enregistrer et rappeler des ancres spatiales.You then configured and deployed an app to save and recall spatial anchors. Pour en savoir plus sur la façon d’améliorer l’application pour qu’elle puisse partager des ancres spatiales avec d’autres appareils, passez au tutoriel suivant.To learn more about how to improve the app so it can share spatial anchors with other devices, continue to the next tutorial.