Inicio rápido: Crear una aplicación iOS con Azure Spatial Anchors en Swift u Objective-CQuickstart: Create an iOS app with Azure Spatial Anchors, in either Swift or Objective-C

En esta guía de inicio rápido se describe cómo crear una aplicación iOS con Azure Spatial Anchors en Swift o en Objective-C.This quickstart covers how to create an iOS app using Azure Spatial Anchors in either Swift or Objective-C. Azure Spatial Anchors es un servicio multiplataforma para desarrolladores que le permite crear experiencias de realidad mixta mediante objetos cuya ubicación persiste en todos los dispositivos a lo largo del tiempo.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. Cuando haya terminado, tendrá una aplicación iOS de ARKit que puede guardar y recuperar un delimitador espacial.When you're finished, you'll have an ARKit iOS app that can save and recall a spatial anchor.

Aprenderá a:You'll learn how to:

  • Crear una cuenta de Spatial AnchorsCreate a Spatial Anchors account
  • Configurar la clave y el identificador de la cuenta de Spatial AnchorsConfigure the Spatial Anchors account identifier and account key
  • Implementar y ejecutar en un dispositivo iOSDeploy and run on an iOS device

Si no tiene una suscripción a Azure, cree una cuenta gratuita antes de empezar.If you don't have an Azure subscription, create a free account before you begin.

Requisitos previosPrerequisites

Para completar esta guía de inicio rápido, asegúrese de que dispone de lo siguiente:To complete this quickstart, make sure you have:

  • Una máquina macOS habilitada para el desarrollo que tenga instaladas las versiones más recientes de Xcode y CocoaPods.A developer enabled macOS machine with the latest version of Xcode and CocoaPods installed.
  • GIT instalado mediante HomeBrew.Git installed via HomeBrew. Escriba el siguiente comando en una sola línea de 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)". A continuación, ejecute brew install git.Then, run brew install git.
  • Un dispositivo iOS compatible con ARKit habilitado para el desarrollo.A developer enabled ARKit compatible iOS device.

Creación de un recurso de Spatial AnchorsCreate a Spatial Anchors resource

Vaya a Azure Portal.Go to the Azure portal.

En el panel de navegación izquierdo de Azure Portal, seleccione Crear un recurso.In the left navigation pane in the Azure portal, select Create a resource.

Use el cuadro de búsqueda para buscar Spatial Anchors.Use the search box to search for Spatial Anchors.

Búsqueda de Spatial Anchors

Seleccione Spatial Anchors.Select Spatial Anchors. En el cuadro de diálogo, seleccione Crear.In the dialog box, select Create.

En el cuadro de diálogo Cuenta de Spatial Anchors:In the Spatial Anchors Account dialog box:

  • Escriba un nombre de recurso único con caracteres alfanuméricos normales.Enter a unique resource name, using regular alphanumeric characters.

  • Seleccione la suscripción a la que desea asociar el recurso.Select the subscription that you want to attach the resource to.

  • Cree un grupo de recursos, para lo que debe seleccionar Crear nuevo.Create a resource group by selecting Create new. Asígnele el nombre myResourceGroup y seleccione Aceptar.Name it myResourceGroup and select OK. Un grupo de recursos es un contenedor lógico en el que se implementan y administran recursos de Azure como aplicaciones web, bases de datos y cuentas de almacenamiento.A resource group is a logical container into which Azure resources like web apps, databases, and storage accounts are deployed and managed. Por ejemplo, más adelante puede elegir eliminar todo el grupo de recursos en un solo paso.For example, you can choose to delete the entire resource group in one simple step later.

  • Seleccione la ubicación (región) en la que desea colocar el recurso.Select a location (region) in which to place the resource.

  • Seleccione New (Nuevo) para empezar a crear el recurso.Select New to begin creating the resource.

    Creación de un recurso

Una vez creado el recurso, Azure Portal mostrará que se completó la implementación.After the resource is created, Azure Portal will show that your deployment is complete. Haga clic en Ir al recurso.Click Go to resource.

Implementación completada

A continuación, puede ver las propiedades del recurso.Then, you can view the resource properties. Copie el valor de Id. de cuenta en un editor de texto, ya que lo necesitará más adelante.Copy the resource's Account ID value into a text editor because you'll need it later.

Propiedades del recurso

En Configuración, seleccione Clave.Under Settings, select Key. Copie el valor de Clave principal en un editor de texto.Copy the Primary key value into a text editor. Este valor es Account Key.This value is the Account Key. Lo necesitará más adelante.You'll need it later.

Clave de cuenta

Apertura del proyecto de ejemploOpen the sample project

Use Terminal para realizar las acciones siguientes:Use the Terminal to perform the following actions.

Ejecute el siguiente comando para clonar el repositorio de ejemplos:Clone the samples repository by running the following command:

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

Instale los pods necesarios mediante CocoaPods:Install the necessary pods using CocoaPods:

Vaya a iOS/Swift/.Navigate to iOS/Swift/.

cd ./iOS/Swift/

Ejecute pod install --repo-update para instalar los pods de CocoaPods para el proyecto.Run pod install --repo-update to install the CocoaPods for the project.

Ahora abra .xcworkspace en Xcode.Now open the .xcworkspace in Xcode.

Nota

Consulte los pasos de solución de problemas aquí si tiene problemas con CocoaPod después de actualizar a macOS Catalina (10.15).See the troubleshooting steps here if you're having CocoaPod issues after upgrading to macOS Catalina (10.15).

open ./SampleSwift.xcworkspace

Configuración del identificador y la clave de la cuentaConfigure account identifier and key

El paso siguiente es configurar la aplicación para usar el identificador de cuenta y la clave de cuenta.The next step is to configure the app to use your account identifier and account key. Los copió en un editor cuando configuró el recurso de Spatial Anchors.You copied them into a text editor when setting up the Spatial Anchors resource.

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

Busque el campo spatialAnchorsAccountKey y reemplace Set me por la clave de la cuenta.Locate the spatialAnchorsAccountKey field and replace Set me with the account key.

Busque el campo spatialAnchorsAccountId y reemplace Set me por el identificador de la cuenta.Locate the spatialAnchorsAccountId field and replace Set me with the account identifier.

Implementación de la aplicación en el dispositivo iOSDeploy the app to your iOS device

Conecte el dispositivo iOS al equipo Mac y establezca el esquema activo en su dispositivo iOS.Connect the iOS device to the Mac and set the active scheme to your iOS device.

Selección del dispositivo

Seleccione Build and then run the current scheme (Compilar y luego ejecutar el esquema actual).Select Build and then run the current scheme.

Implementación y ejecución

Nota

Si ve un error library not found for -lPods-SampleObjC, es probable que haya abierto el archivo .xcodeproj en lugar de .xcworkspace.If you see a library not found for -lPods-SampleObjC error, you likely opened the .xcodeproj file instead of the .xcworkspace. Abra .xcworkspace e inténtelo de nuevo.Open the .xcworkspace and try again.

En Xcode, presione Stop (Detener) para detener la aplicación.In Xcode, stop the app by pressing Stop.

solución de problemasTroubleshooting

Problemas con CocoaPods en macOS Catalina (10.15)CocoaPods issues on macOS Catalina (10.15)

Si ha actualizado recientemente a macOS Catalina (10.15) y tenía CocoaPods instalado con antelación, puede que CocoaPods esté en un estado interrumpido y no pueda configurar correctamente los pods y los archivos de proyecto de .xcworkspace.If you recently updated to macOS Catalina (10.15) and had CocoaPods installed beforehand, CocoaPods may be in a broken state and fail to properly configure your pods and .xcworkspace project files. Para resolver este problema, debe volver a instalar CocoaPods ejecutando los siguientes comandos:To resolve this issue, you'll need to reinstall CocoaPods by running the following commands:

brew update
brew install cocoapods --build-from-source
brew link --overwrite cocoapods

Limpieza de recursosClean up resources

En los pasos anteriores, creó recursos de Azure en un grupo de recursos.In the preceding steps, you created Azure resources in a resource group. Si no cree que vaya a necesitar estos recursos en el futuro, puede eliminarlos mediante la eliminación del grupo de recursos.If you don't expect to need these resources in the future, you can delete them by deleting the resource group.

En el menú de Azure Portal o en la página de inicio, seleccione Grupos de recursos y, en la página Grupos de recursos, seleccione myResourceGroup.From the Azure portal menu or Home page, select Resource groups, and on the Resource groups page, select myResourceGroup.

En la página myResourceGroup, asegúrese de que los recursos enumerados sean los que desea eliminar.On the myResourceGroup page, make sure that the listed resources are the ones you want to delete.

Seleccione Eliminar, escriba myResourceGroup en el cuadro de texto y seleccione Eliminar.Select Delete, type myResourceGroup in the text box, and then select Delete.

Pasos siguientesNext steps

En este inicio rápido, ha creado una cuenta de Spatial Anchors.In this quickstart, you created a Spatial Anchors account. Después, ha configurado e implementado una aplicación para guardar y recuperar los anclajes espaciales.You then configured and deployed an app to save and recall spatial anchors. Para más información acerca de cómo mejorar la aplicación para que pueda compartir anclajes espaciales con otros dispositivos, diríjase al siguiente tutorial.To learn more about how to improve the app so it can share spatial anchors with other devices, continue to the next tutorial.