Execute o aplicativo de exemplo: iOS - Xcode (Swift ou Objective-C)

Este guia de início rápido aborda como executar o aplicativo de exemplo Azure Spatial Anchors para dispositivos iOS usando Xcode (Swift ou Objective-C). O Azure Spatial Anchors é um serviço de desenvolvedor multiplataforma que permite criar experiências de realidade mista usando objetos que persistem sua localização entre dispositivos ao longo do tempo. Quando terminar, você terá um aplicativo ARKit para iOS que pode salvar e recuperar uma âncora espacial.

Vai aprender a:

• Criar uma conta de Âncoras Espaciais
• Configurar o identificador de conta e a chave de conta das Âncoras Espaciais
• Implantar e executar em um dispositivo iOS

Se não tiver uma subscrição do Azure, crie uma conta gratuita do Azure antes de começar.

Pré-requisitos

Para concluir este início rápido, certifique-se de que tem:

• Um desenvolvedor habilitado para a máquina macOS com a versão mais recente do Xcode e CocoaPods instalados .
• Git instalado via HomeBrew:
  1. Digite o seguinte comando como uma única linha no terminal: /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)".
  2. Execute brew install git e brew install git-lfs.
  3. Atualize sua configuração do git com git lfs install (para o usuário atual) ou git lfs install --system (para todo o sistema).
• Um dispositivo iOS compatível com ARKit habilitado para desenvolvedor.

Criar um recurso de Âncoras Espaciais

Portal

Aceda ao portal do Azure.

No painel esquerdo, selecione Criar um recurso.

Use a caixa de pesquisa para procurar Âncoras Espaciais.

Selecione Âncoras espaciais e, em seguida, selecione Criar.

No painel Conta de Âncoras Espaciais, faça o seguinte:

• Insira um nome de recurso exclusivo usando caracteres alfanuméricos regulares.

• Selecione a subscrição à qual pretende anexar o recurso.

• Crie um grupo de recursos selecionando Criar novo. Nomeie-o myResourceGroup e selecione 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. Por exemplo, pode optar por eliminar todo o grupo de recursos num único passo simples mais tarde.

• Selecione um local (região) no qual colocar o recurso.

• Selecione Criar para começar a criar o recurso.

Depois que o recurso é criado, o portal do Azure mostra que sua implantação foi concluída.

Selecione Ir para recurso. Agora você pode exibir as propriedades do recurso.

Copie o valor de ID de conta do recurso em um editor de texto para uso posterior.

Copie também o valor Account Domain do recurso em um editor de texto para uso posterior.

Em Configurações, selecione Chave de acesso. Copie o valor da chave primária, Chave de conta, em um editor de texto para uso posterior.

CLI do Azure

Comece por preparar o seu ambiente para a CLI do Azure:

• Use o ambiente Bash no Azure Cloud Shell. Para obter mais informações, consulte Guia de início rápido para Bash no Azure Cloud Shell.

  

• Se preferir executar comandos de referência da CLI localmente, instale a CLI do Azure. Se estiver a utilizar o Windows ou macOS, considere executar a CLI do Azure num contentor Docker. Para obter mais informações, consulte Como executar a CLI do Azure em um contêiner do Docker.

  • Se estiver a utilizar uma instalação local, inicie sessão no CLI do Azure ao utilizar o comando az login. Para concluir o processo de autenticação, siga os passos apresentados no seu terminal. Para outras opções de entrada, consulte Entrar com a CLI do Azure.

  • Quando solicitado, instale a extensão da CLI do Azure na primeira utilização. Para obter mais informações sobre as extensões, veja Utilizar extensões com o CLI do Azure.

  • Execute o comando az version para localizar a versão e as bibliotecas dependentes instaladas. Para atualizar para a versão mais recente, execute o comando az upgrade.

1. Depois de entrar, use o comando az account set para selecionar a assinatura na qual configurar a conta de âncoras espaciais:

   az account set --subscription 00000000-0000-0000-0000-000000000000
   

2. Execute o comando az group create para criar um grupo de recursos ou use um grupo de recursos existente:

   az group create --name myResourceGroup --location eastus2
   

   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. Por exemplo, pode optar por eliminar todo o grupo de recursos num único passo simples mais tarde.

   Você pode exibir suas contas de âncoras espaciais atuais para um grupo de recursos usando o comando az spatial-anchors-account list :

   az spatial-anchors-account list --resource-group myResourceGroup
   

   Você também pode visualizar as contas de âncoras espaciais para sua assinatura:

   az spatial-anchors-account list
   

3. Execute o comando az spatial-anchors-account create para criar sua conta de âncoras espaciais:

   az spatial-anchors-account create --resource-group myResourceGroup --name MySpatialAnchorsQuickStart --location eastus2
   

4. Exiba as propriedades do recurso usando o comando az spatial-anchors-account show :

   az spatial-anchors-account show --resource-group myResourceGroup --name MySpatialAnchorsQuickStart
   

   Copie o valor ID da Conta do recurso e o valor do Domínio da Conta do recurso em um editor de texto para uso posterior.

5. Execute o comando az spatial-anchors-account key show para obter suas chaves primária e secundária:

   az spatial-anchors-account key show --resource-group myResourceGroup --name MySpatialAnchorsQuickStart
   

   Copie os valores-chave em um editor de texto para uso posterior.

   Se você precisar regenerar chaves, use o comando az spatial-anchors-account key renew :

   az spatial-anchors-account key renew --resource-group myResourceGroup --name example --key primary
   az spatial-anchors-account key renew --resource-group myResourceGroup --name example --key secondary
   

Você pode excluir uma conta usando o comando az spatial-anchors-account delete :

az spatial-anchors-account delete --resource-group myResourceGroup --name MySpatialAnchorsQuickStart

Azure PowerShell

Comece por preparar o seu ambiente para o Azure PowerShell:

• Se você optar por usar o Azure PowerShell localmente:
  • Instale a versão mais recente do módulo Az PowerShell.
  • Conecte-se à sua conta do Azure usando o cmdlet Connect-AzAccount .
• Se você optar por usar o Azure Cloud Shell:
  • Consulte Visão geral do Azure Cloud Shell para obter mais informações.

Importante

Enquanto o módulo Az.MixedReality PowerShell estiver em visualização, você deve instalá-lo separadamente usando o Install-Module cmdlet. Quando este módulo do PowerShell entrar em disponibilidade geral, fará parte das versões futuras do módulo Az PowerShell e estará disponível por predefinição a partir do Azure Cloud Shell.

Install-Module -Name Az.MixedReality

1. Depois de entrar, use o cmdlet Set-AzContext para selecionar a assinatura na qual configurar a conta de âncoras espaciais:

   Set-AzContext -SubscriptionId 00000000-0000-0000-0000-000000000000
   

2. Execute o cmdlet New-AzResourceGroup para criar um grupo de recursos ou use um grupo de recursos existente:

   New-AzResourceGroup -Name myResourceGroup -Location eastus2
   

   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. Por exemplo, pode optar por eliminar todo o grupo de recursos num único passo simples mais tarde.

   Você pode exibir suas contas de âncoras espaciais atuais para um grupo de recursos usando o cmdlet Get-AzSpatialAnchorsAccount :

   Get-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup
   

   Você também pode visualizar as contas de âncoras espaciais para sua assinatura:

   Get-AzSpatialAnchorsAccount
   

3. Execute o cmdlet New-AzSpatialAnchorsAccount para criar sua conta de âncoras espaciais:

   New-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart -Location eastus2
   

4. Exiba as propriedades do recurso usando o cmdlet Get-AzSpatialAnchorsAccount :

   Get-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart
   

   Copie o valor accountId da propriedade e o valor accountDomain da propriedade em um editor de texto para uso posterior.

5. Execute o cmdlet Get-AzSpatialAnchorsAccountKey para obter suas chaves primária e secundária:

   Get-AzSpatialAnchorsAccountKey -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart
   

   Copie os valores-chave em um editor de texto para uso posterior.

   Se precisar regenerar chaves, use o cmdlet New-AzSpatialAnchorsAccountKey :

   New-AzSpatialAnchorsAccountKey -ResourceGroupName myResourceGroup -Name MySpatialAnchorsQuickStart -Primary
   New-AzSpatialAnchorsAccountKey -ResourceGroupName myResourceGroup -Name MySpatialAnchorsQuickStart -Secondary
   

Você pode excluir uma conta usando o cmdlet Remove-AzSpatialAnchorsAccount :

Remove-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart

Abrir o projeto de exemplo

Use o Terminal para executar as seguintes ações.

Clone o repositório de amostras executando os seguintes comandos:

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

Instale os pods necessários usando CocoaPods:

Swift

Navegar para iOS/Swift/.

cd ./iOS/Swift/

Objective-C

Navegar para iOS/Objective-C/.

cd ./iOS/Objective-C/

Execute pod install --repo-update para instalar os CocoaPods para o projeto.

Nota

Use o seguinte comando se tiver o macOS Monterey (12.2.1)

Execute pod update para instalar os CocoaPods para o projeto.

Agora abra o .xcworkspace no Xcode.

Nota

Consulte as etapas de solução de problemas aqui se você estiver tendo problemas com o CocoaPod após a atualização para o macOS Catalina (10.15).

Swift

open ./SampleSwift.xcworkspace

Objective-C

open ./SampleObjC.xcworkspace

Configurar identificador de conta e chave

A próxima etapa é configurar o aplicativo para usar seu identificador de conta e chave de conta. Você os copiou em um editor de texto ao configurar o recurso Âncoras espaciais.

Swift

Abrir iOS/Swift/SampleSwift/ViewControllers/BaseViewController.swift.

Localize o spatialAnchorsAccountKey campo e substitua Set me pela chave da conta.

Localize o spatialAnchorsAccountId campo e substitua Set me pelo identificador da conta.

Localize o spatialAnchorsAccountDomain campo e substitua Set me pelo domínio da conta.

Objective-C

Abrir iOS/Objective-C/SampleObjC/BaseViewController.m.

Localize o SpatialAnchorsAccountKey campo e substitua Set me pela chave da conta.

Localize o SpatialAnchorsAccountId campo e substitua Set me pelo identificador da conta.

Localize o SpatialAnchorsAccountDomain campo e substitua Set me pelo domínio da conta.

Implantar o aplicativo em seu dispositivo iOS

Conecte o dispositivo iOS ao Mac e defina o esquema ativo para o seu dispositivo iOS.

Selecione Compilar e execute o esquema atual.

Nota

Se vir um library not found for -lPods-SampleObjC erro, é provável que tenha aberto o .xcodeproj ficheiro em vez do .xcworkspaceficheiro . Abra o .xcworkspace e tente novamente.

No Xcode, pare o aplicativo pressionando Parar.

Resolução de problemas

Problemas do CocoaPods no macOS Catalina (10.15)

Se você atualizou recentemente para o macOS Catalina (10.15) e tinha o CocoaPods instalado antes, o CocoaPods pode estar em um estado quebrado e não configurar corretamente seus pods e .xcworkspace arquivos de projeto. Para resolver esse problema, você precisará reinstalar o CocoaPods executando os seguintes comandos:

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

O aplicativo falha ao implantar no iOS 10.3.1 a partir de um perfil de provisionamento pessoal/conta de desenvolvedor

Se você implantar seu aplicativo iOS no iOS 10.3.1 a partir de um perfil de provisionamento pessoal/conta de desenvolvedor, poderá ver este erro: Library not loaded: @rpath/ADAL....

Para resolver o problema:

• Use um perfil de provisionamento que não seja um perfil de Equipe Pessoal (conta de desenvolvedor paga).
• Implante seu aplicativo em um dispositivo iOS executando o iOS 13.3 ou anterior, ou em um dispositivo que execute a versão beta ou de lançamento do iOS 13.4.
• Leia mais sobre este problema em Stack Overflow.

Clean up resources (Limpar recursos)

Nos passos anteriores, criou os recursos do Azure num grupo de recursos. Se provavelmente não necessitar desses recursos no futuro, pode eliminá-los ao eliminar o grupo de recursos.

No menu do portal do Azure ou na página inicial , selecione Grupos de recursos. Em seguida, na página Grupos de recursos, selecione myResourceGroup.

Na página myResourceGroup, certifique-se de que os recursos listados são aqueles que você deseja excluir.

Selecione Excluir grupo de recursos, digite myResourceGroup na caixa de texto para confirmar e selecione Excluir.

Próximos passos

Neste início rápido, você criou uma conta de Âncoras Espaciais. Em seguida, você configurou e implantou um aplicativo para salvar e recuperar âncoras espaciais. Para saber mais sobre como melhorar o aplicativo para que ele possa compartilhar âncoras espaciais com outros dispositivos, continue para o próximo tutorial.

Tutorial: Compartilhar âncoras espaciais entre dispositivos