Voer de voorbeeld-app uit: iOS - Xcode (Swift of Objective-C)
In deze quickstart wordt beschreven hoe u de Azure Spatial Anchors-voorbeeld-app voor iOS-apparaten uitvoert met behulp van Xcode (Swift of Objective-C). Azure Spatial Anchors is een platformoverschrijdende ontwikkelaarsservice waarmee u mixed reality-ervaringen kunt maken met behulp van objecten die hun locatie in de loop van de tijd op meerdere apparaten behouden. Als u klaar bent, hebt u een ARKit iOS-app gemaakt waarmee een ruimtelijk anker kan worden opgeslagen en teruggehaald.
U leert het volgende:
- Een Spatial Anchors-account maken
- Spatial Anchors-account-id en -accountsleutel configureren
- Implementeren en uitvoeren op een iOS-apparaat
Als u geen Azure-abonnement hebt, kunt u een gratis Azure-account maken voordat u begint.
Vereisten
Zorg ervoor dat u over het volgende beschikt om deze snelstart te voltooien:
- Een door de ontwikkelaar ingeschakelde macOS-computer met de nieuwste versie van Xcode en CocoaPods geïnstalleerd.
- Git geïnstalleerd via HomeBrew:
- Voer de volgende opdracht in als één regel in de terminal:
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
. - Voer
brew install git
enbrew install git-lfs
uit. - Werk uw Git-configuratie bij met
git lfs install
(voor de huidige gebruiker) ofgit lfs install --system
(voor het hele systeem).
- Voer de volgende opdracht in als één regel in de terminal:
- Een door een ontwikkelaar geactiveerd en met ARKit compatibel iOS-apparaat.
Een Spatial Anchors-resource maken
Ga naar de Azure Portal.
Selecteer Een resource maken in het linkerdeelvenster.
Gebruik het zoekvak om te zoeken naar Spatial Anchors.
Selecteer Spatial Anchors en vervolgens Maken.
Doe in het deelvenster Spatial Anchors-account het volgende:
Voer een unieke resourcenaam in met gewone alfanumerieke tekens.
Selecteer het abonnement waaraan u de resource wilt koppelen.
Maak een resourcegroep door Nieuwe maken te selecteren. Noem deze myResourceGroup en selecteer OK.
Een resourcegroep is een logische container waarin Azure-resources, zoals web-apps, databases en opslagaccounts, worden geïmplementeerd en beheerd. U kunt bijvoorbeeld later de hele resourcegroep in één stap verwijderen.
Selecteer de locatie (regio) waarin u de resource wilt plaatsen.
Selecteer Maken om de resource te maken.
Nadat de resource is gemaakt, ziet u in de Azure-portal dat uw implementatie is voltooid.
Selecteer Naar resource. Nu kunt u de resource-eigenschappen bekijken.
Kopieer de waarde bij Account-id van de resource naar een teksteditor om later te gebruiken.
Kopieer ook de waarde bij Accountdomein van de resource naar een teksteditor om later te gebruiken.
Selecteer Onder Instellingen de optie Toegangssleutel. Kopieer de waarde bij Primaire sleutel, Accountsleutel, naar een teksteditor om later te gebruiken.
Voorbeeldproject openen
Gebruik de Terminal om de volgende acties uit te voeren.
Voer de volgende opdrachten uit om de opslagplaats met voorbeelden te klonen:
git clone https://github.com/Azure/azure-spatial-anchors-samples.git
cd ./azure-spatial-anchors-samples
De benodigde pods installeren met CocoaPods:
Navigeer naar iOS/Swift/
.
cd ./iOS/Swift/
Voer pod install --repo-update
uit om de CocoaPods voor het project te installeren.
Notitie
Gebruik de volgende opdracht als u macOSGelezen hebt (12.2.1)
Voer pod update
uit om de CocoaPods voor het project te installeren.
Open nu .xcworkspace
in Xcode.
Notitie
Raadpleeg deze stappen voor het oplossen van problemen als u CocoaPod-problemen ondervindt na de upgrade naar macOS Catalina (10.15).
open ./SampleSwift.xcworkspace
Account-id en -sleutel configureren
De volgende stap is het configureren van de app om uw account-id en accountsleutel te gebruiken. U hebt ze naar een teksteditor gekopieerd bij het instellen van de Spatial Anchors-resource.
iOS/Swift/SampleSwift/ViewControllers/BaseViewController.swift
openen.
Zoek het veld spatialAnchorsAccountKey
en vervang Set me
met de accountsleutel.
Zoek het veld spatialAnchorsAccountId
en vervang Set me
met de account-id.
Zoek het veld spatialAnchorsAccountDomain
en vervang Set me
door het accountdomein.
De app implementeren op uw iOS-apparaat
Verbind het iOS-apparaat met de Mac en stel het actieve schema in voor uw iOS-apparaat.
Selecteer Build and then run the current scheme (Het huidige schema compileren en uitvoeren).
Notitie
Als u de fout library not found for -lPods-SampleObjC
ziet, hebt u waarschijnlijk het bestand .xcodeproj
geopend in plaats van .xcworkspace
. Open .xcworkspace
en probeer het opnieuw.
In Xcode: stop de app door op Stop te drukken.
Probleemoplossing
CocoaPods-problemen op macOS Catalina (10.15)
Als u onlangs een update hebt uitgevoerd naar macOS Catalina (10.15) en CocoaPods al eerder hebt geïnstalleerd, kan het zijn dat CocoaPods een defecte status heeft en uw pods en .xcworkspace
-projectbestanden niet goed kan configureren. U kunt dit probleem oplossen door CocoaPods opnieuw te installeren met behulp van de volgende opdrachten:
brew update
brew install cocoapods --build-from-source
brew link --overwrite cocoapods
App loopt vast bij het implementeren van iOS 10.3.1 vanuit een persoonlijk inrichtingsprofiel/ontwikkelaarsaccount
Als u uw iOS-app op iOS 10.3.1 implementeert vanuit een persoonlijk inrichtingsprofiel/ontwikkelaarsaccount, ziet u deze fout mogelijk: Library not loaded: @rpath/ADAL...
.
Het probleem oplossen:
- Gebruik een inrichtingsprofiel dat geen persoonlijk teamprofiel is (betaald ontwikkelaarsaccount).
- Implementeer uw app op een iOS-apparaat met iOS 13.3 of eerder of op een van de iOS 13.4 bèta- of releaseversie.
- Meer informatie over dit probleem vindt u op Stack Overflow.
Resources opschonen
In de voorgaande stappen hebt u Azure-resources in een resourcegroep gemaakt. Als u deze resources in de toekomst waarschijnlijk niet nodig hebt, kunt u ze verwijderen door de resourcegroep te verwijderen.
Selecteer Resourcegroepen in het menu of op de beginpagina van de Azure-portal. Selecteer myResourceGroup op de pagina Resourcegroepen.
Controleer op de pagina myResourceGroup of de weergegeven resources de resources zijn die u wilt verwijderen.
Selecteer Resourcegroep verwijderen, typ myResourceGroup in het tekstvak om dit te bevestigen en selecteer Verwijderen.
Volgende stappen
In deze quickstart hebt u een account voor Spatial Anchors gemaakt. Vervolgens hebt u een app geconfigureerd en geïmplementeerd om ruimtelijk ankers op te slaan en terug te halen. Ga door naar de volgende zelfstudie voor meer informatie over het verbeteren van de app, zodat het ruimtelijk ankers kan delen met andere apparaten.