Início Rápido: Criar um aplicativo para iOS com Âncoras Espaciais do Azure em Objective-C ou SwiftQuickstart: Create an iOS app with Azure Spatial Anchors, in either Swift or Objective-C

Este início rápido aborda como criar um aplicativo iOS usando Âncoras Espaciais do Azure em Swift ou Objective-C.This quickstart covers how to create an iOS app using Azure Spatial Anchors in either Swift or Objective-C. As Âncoras Espaciais do Azure são um serviço de desenvolvedor multiplataforma para você criar experiências de realidade misturada usando objetos que persistem sua localização em todos os dispositivos ao longo do tempo.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. Quando tiver terminado, você terá um aplicativo do ARKit iOS que pode salvar e lembrar de uma âncora espacial.When you're finished, you'll have an ARKit iOS app that can save and recall a spatial anchor.

Você aprenderá a:You'll learn how to:

  • Criar uma conta de Âncoras EspaciaisCreate a Spatial Anchors account
  • Configurar o identificador e a chave de conta das Âncoras EspaciaisConfigure the Spatial Anchors account identifier and account key
  • Implantar e executar em um dispositivo iOSDeploy and run on an iOS device

Se você não tiver uma assinatura do Azure, crie uma conta gratuita antes de começar.If you don't have an Azure subscription, create a free account before you begin.

Pré-requisitosPrerequisites

Para concluir este início rápido, certifique-se de que:To complete this quickstart, make sure you have:

  • Um desenvolvedor habilitou o computador macOS com a versão mais recente do Xcode e CocoaPods instalada.A developer enabled macOS machine with the latest version of Xcode and CocoaPods installed.
  • Git instalado via Homebrew.Git installed via HomeBrew. Insira o seguinte comando em uma única linha do 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)". Em seguida, execute brew install git.Then, run brew install git.
  • Um dispositivo iOS compatível com ARKit habilitado para desenvolvedor.A developer enabled ARKit compatible iOS device.

Criar um recurso Âncoras EspaciaisCreate a Spatial Anchors resource

Vá para o Portal do Azure.Go to the Azure portal.

No painel de navegação esquerdo do portal do Azure, clique em Criar um recurso.In the left navigation pane in the Azure portal, select Create a resource.

Use a caixa de pesquisa para Âncoras Espaciais.Use the search box to search for Spatial Anchors.

Pesquisar Âncoras Espaciais

Selecione Âncoras Espaciais.Select Spatial Anchors. Na caixa de diálogo, selecione Criar.In the dialog box, select Create.

No caixa de diálogo Conta de Âncoras Espaciais:In the Spatial Anchors Account dialog box:

  • Insira um nome de recurso exclusivos, usando caracteres alfanuméricos regulares.Enter a unique resource name, using regular alphanumeric characters.

  • Selecione a assinatura que você deseja anexar o recurso.Select the subscription that you want to attach the resource to.

  • Crie um grupo de recursos, selecionando Criar novo.Create a resource group by selecting Create new. Denomine-o como myResourceGroup e selecione OK.Name it myResourceGroup and select OK. Um grupo de recursos é um contêiner lógico no qual os recursos do Azure, como aplicativos Web, bancos de dados e contas de armazenamento, são implantados e gerenciados.A resource group is a logical container into which Azure resources like web apps, databases, and storage accounts are deployed and managed. Por exemplo, é possível excluir posteriormente todo o grupo de recursos com uma única etapa simples.For example, you can choose to delete the entire resource group in one simple step later.

  • Selecione um local (região) para criar o recurso.Select a location (region) in which to place the resource.

  • Selecione Novo para começar a criar o recurso.Select New to begin creating the resource.

    Criar um recurso

Depois que o recurso é criado, o portal do Azure mostra que a implantação foi concluída.After the resource is created, Azure Portal will show that your deployment is complete. Clique em Ir para o recurso.Click Go to resource.

Implantação concluída

Em seguida, você pode exibir as propriedades do recurso.Then, you can view the resource properties. Copiar o valor de ID da conta em um editor de texto, pois você precisará dele mais tarde.Copy the resource's Account ID value into a text editor because you'll need it later.

Propriedades de recurso

Em Configurações, selecione Chave.Under Settings, select Key. Cópia do valor de Chave primária em um editor de texto.Copy the Primary key value into a text editor. Esse valor é o Account Key.This value is the Account Key. Você precisará dela mais tarde.You'll need it later.

Chave de conta

Abrir o projeto de exemploOpen the sample project

Use o Terminal para realizar as ações a seguir.Use the Terminal to perform the following actions.

Clone o repositório de exemplos executando o seguinte comando:Clone the samples repository by running the following command:

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

Instale os pods necessários usando o CocoaPods:Install the necessary pods using CocoaPods:

Navegue até iOS/Swift/.Navigate to iOS/Swift/.

cd ./iOS/Swift/

Execute pod install --repo-update para instalar os CocoaPods para o projeto.Run pod install --repo-update to install the CocoaPods for the project.

Agora, abra o .xcworkspace no Xcode.Now open the .xcworkspace in Xcode.

Observação

Confira as etapas de solução de problemas aqui se estiver enfrentado problemas com o CocoaPod após atualizar para o 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

Configurar a chave e o identificador da contaConfigure account identifier and key

A próxima etapa é configurar o aplicativo para usar o identificador e a chave de conta.The next step is to configure the app to use your account identifier and account key. Você os copiou em um editor de texto ao configurar o recurso Âncoras Espaciais.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.

Localize o campo spatialAnchorsAccountKey e substitua Set me pela chave de conta.Locate the spatialAnchorsAccountKey field and replace Set me with the account key.

Localize o campo spatialAnchorsAccountId e substitua Set me pelo identificador de conta.Locate the spatialAnchorsAccountId field and replace Set me with the account identifier.

Implantar o aplicativo em seu dispositivo iOSDeploy the app to your iOS device

Conecte o dispositivo iOS ao Mac e defina o esquema ativo como o dispositivo iOS.Connect the iOS device to the Mac and set the active scheme to your iOS device.

Selecione o dispositivo

Selecione Compilar e, em seguida, executar o esquema atual.Select Build and then run the current scheme.

Implantar e executar

Observação

Se um erro library not found for -lPods-SampleObjC é exibido, provavelmente, você abriu o arquivo .xcodeproj em vez do .xcworkspace.If you see a library not found for -lPods-SampleObjC error, you likely opened the .xcodeproj file instead of the .xcworkspace. Abra o .xcworkspace e tente novamente.Open the .xcworkspace and try again.

No Xcode, interrompa o aplicativo pressionando Parar.In Xcode, stop the app by pressing Stop.

solução de problemasTroubleshooting

Problemas do CocoaPods no macOS Catalina (10.15)CocoaPods issues on macOS Catalina (10.15)

Se você atualizou recentemente para o macOS Catalina (10.15) e tinha o CocoaPods instalado anteriormente, o CocoaPods pode estar em um estado incompleto e falhar ao configurar corretamente seus arquivos de projeto .xcworkspace e pods.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 esse problema, será preciso reinstalar o CocoaPods executando os seguintes 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

Limpar recursosClean up resources

Nas etapas anteriores, você criou os recursos do Azure em um grupo de recursos.In the preceding steps, you created Azure resources in a resource group. Se você não espera precisar desses recursos no futuro, poderá excluí-los ao excluir o grupo de recursos.If you don't expect to need these resources in the future, you can delete them by deleting the resource group.

No menu do portal do Azure ou na página Inicial, selecione Grupos de Recursos e, na página Grupos de Recursos, selecione myResourceGroup.From the Azure portal menu or Home page, select Resource groups, and on the Resource groups page, select myResourceGroup.

Na página myResourceGroup, certifique-se de que os recursos listados são aqueles que deseja excluir.On the myResourceGroup page, make sure that the listed resources are the ones you want to delete.

Selecione Excluir, digite myResourceGroup na caixa de texto e selecione Excluir.Select Delete, type myResourceGroup in the text box, and then select Delete.

Próximas etapasNext steps

Neste início rápido, você criou uma conta de Âncoras Espaciais.In this quickstart, you created a Spatial Anchors account. Em seguida, você configurou e implantou um aplicativo para salvar e fazer recall de âncoras espaciais.You then configured and deployed an app to save and recall spatial anchors. Para saber mais sobre como melhorar o aplicativo, de modo que ele possa compartilhar âncoras espaciais com outros dispositivos, continue no próximo tutorial.To learn more about how to improve the app so it can share spatial anchors with other devices, continue to the next tutorial.