Ausführen der Beispiel-App: iOS – Xcode (Swift oder Objective-C)

  • Artikel

In dieser Schnellstartanleitung erfahren Sie, wie Sie die Azure Spatial Anchors-Beispiel-App für iOS-Geräte mit Xcode (Swift oder Objective-C) ausführen. Azure Spatial Anchors ist ein plattformübergreifender Entwicklerdienst, mit dem Sie Mixed Reality-Umgebungen mit Objekten erstellen können, die ihre Position im Zeitverlauf geräteübergreifend beibehalten. Nach Abschluss des Vorgangs verfügen Sie über eine ARKit-iOS-App, mit der ein räumlicher Anker gespeichert und abgerufen werden kann.

Sie lernen Folgendes:

  • Erstellen eines Spatial Anchors-Kontos
  • Konfigurieren des Bezeichners und Kontoschlüssels für das Spatial Anchors-Konto
  • Bereitstellen und Ausführen auf einem iOS-Gerät

Wenn Sie kein Azure-Abonnement haben, erstellen Sie ein kostenloses Azure-Konto, bevor Sie beginnen.

Voraussetzungen

Stellen Sie für diese Schnellstartanleitung sicher, dass Sie über Folgendes verfügen:

  • Einen für Entwickler geeigneten macOS-Computer mit der aktuellen Version von Xcode und CocoaPods.
  • Git-Installation über Homebrew:
    1. Geben Sie den folgenden Befehl im Terminal als eine Zeile ein: /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)".
    2. Führen Sie brew install git und brew install git-lfs aus.
    3. Aktualisieren Sie Ihre Git-Konfiguration mit git lfs install (für den aktuellen Benutzer) oder git lfs install --system (für das gesamte System).
  • Ein für Entwickler geeignetes ARKit-kompatibles iOS-Gerät.

Erstellen einer Spatial Anchors-Ressource

Öffnen Sie das Azure-Portal.

Wählen Sie im linken Bereich Ressource erstellen aus.

Suchen Sie über das Suchfeld nach Spatial Anchors.

Screenshot: Ergebnisse einer Suche nach Spatial Anchors

Wählen Sie Spatial Anchors und dann Erstellen aus.

Führen Sie im Bereich Spatial Anchors-Konto die folgenden Schritte aus:

  • Geben Sie einen eindeutigen Ressourcennamen in regulären alphanumerischen Zeichen ein.

  • Wählen Sie das Abonnement aus, an das die Ressource angefügt werden soll.

  • Erstellen Sie eine Ressourcengruppe durch Auswählen von Neu erstellen. Nennen Sie sie myResourceGroup, und wählen Sie OK aus.

    Eine Ressourcengruppe ist ein logischer Container, in dem Azure-Ressourcen wie Web-Apps, Datenbanken und Speicherkonten bereitgestellt und verwaltet werden. Sie können z.B. die gesamte Ressourcengruppe später in einem einfachen Schritt löschen.

  • Wählen Sie einen Standort (Region) für die Ressource aus.

  • Wählen Sie Erstellen aus, um mit der Ressourcenerstellung zu beginnen.

Screenshot: Spatial Anchors-Bereich zum Erstellen einer Ressource

Nachdem die Ressource erstellt wurde, zeigt das Azure-Portal an, dass die Bereitstellung abgeschlossen ist.

Screenshot: Abgeschlossene Ressourcenbereitstellung

Wählen Sie Zu Ressource wechseln aus. Nun können Sie die Ressourceneigenschaften anzeigen.

Kopieren Sie den Wert für Konto-ID der Ressource zur späteren Verwendung in einen Text-Editor.

Screenshot des Bereichs „Ressourceneigenschaften“

Kopieren Sie außerdem den Wert für Kontodomäne der Ressource zur späteren Verwendung in einen Text-Editor.

Screenshot: Wert für „Kontodomäne“ der Ressource

Wählen Sie unter Einstellungen die Option Zugriffsschlüssel aus. Kopieren Sie die Werte für Primärschlüssel und Kontoschlüssel zur späteren Verwendung in einen Text-Editor.

Screenshot: Bereich „Schlüssel“ für das Konto

Öffnen des Beispielprojekts

Führen Sie über das Terminal die folgenden Aktionen aus.

Klonen Sie das Beispielrepository, indem Sie die folgenden Befehle ausführen:

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

Installieren Sie die erforderlichen Pods, indem Sie CocoaPods verwenden:

Navigieren Sie zu iOS/Swift/.

cd ./iOS/Swift/

Führen Sie pod install --repo-update aus, um die CocoaPods für das Projekt zu installieren.

Hinweis

Verwenden Sie den folgenden Befehl, wenn Sie über MacOS Monterey (12.2.1) verfügen.

Führen Sie pod update aus, um die CocoaPods für das Projekt zu installieren.

Öffnen Sie nun .xcworkspace in Xcode.

Hinweis

Sehen Sie sich die Schritte zur Problembehandlung an, wenn nach dem Upgrade auf macOS Catalina (10.15) Probleme mit CocoaPod auftreten.

open ./SampleSwift.xcworkspace

Konfigurieren des Kontobezeichners und -schlüssels

Im nächsten Schritt wird die App zur Verwendung des Kontobezeichners und Kontoschlüssels konfiguriert. Diese haben Sie beim Einrichten der Spatial Anchors-Ressource in einen Text-Editor kopiert.

Öffnen Sie iOS/Swift/SampleSwift/ViewControllers/BaseViewController.swift.

Suchen Sie nach dem Feld spatialAnchorsAccountKey, und ersetzen Sie Set me durch den Kontoschlüssel.

Suchen Sie nach dem Feld spatialAnchorsAccountId, und ersetzen Sie Set me durch den Kontobezeichner.

Suchen Sie nach dem Feld spatialAnchorsAccountDomain, und ersetzen Sie Set me durch die Kontodomäne.

Bereitstellen der App auf Ihrem iOS-Gerät

Verbinden Sie das iOS-Gerät mit dem Macintosh-Computer, und legen Sie das aktive Schema auf Ihr iOS-Gerät fest.

Auswählen des Geräts

Wählen Sie Build and then run the current scheme (Aktuelles Schema erstellen und dann ausführen) aus.

Bereitstellen und Ausführen

Hinweis

Sollte ein Fehler vom Typ library not found for -lPods-SampleObjC auftreten, haben Sie wahrscheinlich anstelle der Datei vom Typ .xcworkspace die Datei vom Typ .xcodeproj geöffnet. Öffnen Sie die Datei vom Typ .xcworkspace, und wiederholen Sie den Vorgang.

Beenden Sie die App in Xcode, indem Sie Beenden wählen.

Problembehandlung

Cocoapods-Probleme unter macOS Catalina (10.15)

Wenn Sie vor kurzem auf macOS Catalina (10.15) aktualisiert haben und CocoaPods zuvor installiert waren, kann sich CocoaPods in einem fehlerhaften Zustand befinden, sodass Ihre Pods und .xcworkspace-Projektdateien möglicherweise nicht ordnungsgemäß konfiguriert werden. Um dieses Problem zu beheben, müssen Sie die CocoaPods neu installieren, indem Sie die folgenden Befehle ausführen:

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

App stürzt ab, wenn sie für iOS 10.3.1 über ein persönliches Bereitstellungsprofil bzw. Entwicklerkonto bereitgestellt wird

Wenn Sie Ihre iOS-App unter iOS 10.3.1 über ein persönliches Bereitstellungsprofil bzw. Entwicklerkonto bereitstellen, wird ggf. der folgende Fehler angezeigt: Library not loaded: @rpath/ADAL....

So lösen Sie das Problem:

  • Verwenden Sie ein Bereitstellungsprofil, bei dem es sich nicht um ein persönliches Teamprofil (kostenpflichtiges Entwicklerkonto) handelt.
  • Stellen Sie Ihre App auf einem iOS-Gerät mit iOS 13.3 oder früher oder einem Gerät mit iOS 13.4 Beta- oder -Releaseversion bereit.
  • Weitere Informationen zu diesem Problem finden Sie bei Stack Overflow.

Bereinigen von Ressourcen

In den vorherigen Schritten haben Sie Azure-Ressourcen in einer Ressourcengruppe erstellt. Wenn Sie diese Ressourcen in Zukunft nicht mehr benötigen, können Sie sie löschen, indem Sie die Ressourcengruppe löschen.

Wählen Sie im Azure-Portalmenü oder auf der Startseite die Option Ressourcengruppen aus. Wählen Sie auf der Seite Ressourcengruppen die Option myResourceGroup aus.

Stellen Sie auf der Seite myResourceGroup sicher, dass die Ressourcen aufgelistet sind, die Sie löschen möchten.

Wählen Sie die Option Löschen aus, geben Sie zur Bestätigung im Textfeld myResourceGroup ein, und wählen Sie anschließend Löschen aus.

Nächste Schritte

In diesem Schnellstart haben Sie ein Spatial Anchors-Konto erstellt. Dann haben Sie eine App zum Speichern und Abrufen von Spatial Anchors konfiguriert und bereitgestellt. Fahren Sie mit dem nächsten Tutorial fort, um zu erfahren, wie die App verbessert wird, damit Spatial Anchors für andere Geräte freigegeben werden können.

Tutorial: Freigeben für Sitzungen und Geräte mit Azure Spatial Anchors