Spuštění ukázkové aplikace: iOS – Xcode (Swift nebo Objective-C)

  • Článek

Tento rychlý start popisuje, jak spustit ukázkovou aplikaci Azure Spatial Anchors pro zařízení s iOSem pomocí Xcode (Swift nebo Objective-C). Azure Spatial Anchors je multiplatformní vývojářská služba, která umožňuje vytvářet prostředí hybridní reality pomocí objektů, které v průběhu času uchovávají jejich umístění na různých zařízeních. Až budete hotovi, budete mít aplikaci ARKit pro iOS, která dokáže uložit a odvolat prostorové ukotvení.

Dozvíte se, jak provést tyto akce:

  • Vytvoření účtu Spatial Anchors
  • Konfigurace identifikátoru účtu Spatial Anchors a klíče účtu
  • Nasazení a spuštění na zařízení s iOSem

Pokud ještě nemáte předplatné Azure, vytvořte si bezplatný účet Azure před tím, než začnete.

Předpoklady

Abyste mohli absolvovat tento rychlý start, ujistěte se, že máte následující:

  • Vývojáři povolili počítač s macOS s nainstalovanou nejnovější verzí Xcode a CocoaPods .
  • Git nainstalovaný přes HomeBrew:
    1. Jako jeden řádek v terminálu zadejte následující příkaz: /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)".
    2. Spusťte příkazy brew install git a brew install git-lfs.
    3. Aktualizujte konfiguraci Gitu ( git lfs install pro aktuálního uživatele) nebo git lfs install --system (pro celý systém).
  • Vývojáři povolili zařízení s iOSem kompatibilní s ARKitem.

Vytvoření prostředku Spatial Anchors

Přejděte na Azure Portal.

V levém podokně vyberte Vytvořit prostředek.

Pomocí vyhledávacího pole vyhledejte Spatial Anchors.

Screenshot showing the results of a search for Spatial Anchors.

Vyberte Spatial Anchors a pak vyberte Vytvořit.

V podokně Účet prostorových ukotvení postupujte takto:

  • Zadejte jedinečný název prostředku pomocí běžných alfanumerických znaků.

  • Vyberte předplatné, ke kterému chcete prostředek připojit.

  • Výběrem možnosti Vytvořit novou vytvořte skupinu prostředků. Pojmenujte ji myResourceGroup a pak vyberte OK.

    Skupina prostředků je logický kontejner, do kterého se nasazují a spravují prostředky Azure, jako jsou webové aplikace, databáze a účty úložiště. Později se například můžete rozhodnout odstranit celou skupinu prostředků v jednom jednoduchém kroku.

  • Vyberte umístění (oblast), do kterého chcete prostředek umístit.

  • Výběrem možnosti Vytvořit zahájíte vytváření prostředku.

Screenshot of the Spatial Anchors pane for creating a resource.

Po vytvoření prostředku se na webu Azure Portal zobrazí, že je vaše nasazení dokončené.

Screenshot showing that the resource deployment is complete.

Vyberte Přejít k prostředku. Teď můžete zobrazit vlastnosti prostředku.

Zkopírujte hodnotu ID účtu prostředku do textového editoru pro pozdější použití.

Screenshot of the resource properties pane.

Zkopírujte také hodnotu domény účtu prostředku do textového editoru pro pozdější použití.

Screenshot showing the resource's account domain value.

V části Nastavení vyberte Přístupový klíč. Zkopírujte hodnotu primárního klíče Account Key (Klíč účtu) do textového editoru pro pozdější použití.

Screenshot of the Keys pane for the account.

Otevření ukázkového projektu

Pomocí terminálu proveďte následující akce.

Naklonujte úložiště ukázek spuštěním následujících příkazů:

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

Nainstalujte potřebné pody pomocí CocoaPods:

Přejděte na iOS/Swift/.

cd ./iOS/Swift/

Spusťte pod install --repo-update instalaci CocoaPods projektu.

Poznámka:

Pokud máte macOS Monterey (12.2.1) použijte následující příkaz.

Spusťte pod update instalaci CocoaPods projektu.

Teď otevřete soubor .xcworkspace V Xcode.

Poznámka:

Pokud máte problémy s CocoaPodem po upgradu na macOS Catalina (10.15), prohlédni si tady postup řešení potíží.

open ./SampleSwift.xcworkspace

Konfigurace identifikátoru účtu a klíče

Dalším krokem je konfigurace aplikace tak, aby používala identifikátor účtu a klíč účtu. Zkopírovali jste je do textového editoru při nastavování prostředku Spatial Anchors.

Otevře záznam typu iOS/Swift/SampleSwift/ViewControllers/BaseViewController.swift.

spatialAnchorsAccountKey Vyhledejte pole a nahraďte Set me ho klíčem účtu.

spatialAnchorsAccountId Vyhledejte pole a nahraďte Set me identifikátorem účtu.

spatialAnchorsAccountDomain Vyhledejte pole a nahraďte Set me doménou účtu.

Nasazení aplikace do zařízení s iOSem

Připojení zařízení s iOSem na Mac a nastavte aktivní schéma na zařízení s iOSem.

Select the device

Vyberte Sestavit a spusťte aktuální schéma.

Deploy and run

Poznámka:

Pokud se zobrazí library not found for -lPods-SampleObjC chyba, pravděpodobně jste soubor otevřeli .xcodeproj místo .xcworkspace. Otevřete a .xcworkspace zkuste to znovu.

V Xcode aplikaci zastavte stisknutím klávesy Stop.

Řešení problému

Problémy s CocoaPods v macOS Catalina (10.15)

Pokud jste nedávno aktualizovali na macOS Catalina (10.15) a předem nainstalovali CocoaPods, může být CocoaPods v nefunkčním stavu a nemůže správně nakonfigurovat pody a .xcworkspace soubory projektu. Pokud chcete tento problém vyřešit, budete muset CocoaPods přeinstalovat spuštěním následujících příkazů:

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

Při nasazování do iOS 10.3.1 z osobního zřizovacího profilu nebo vývojářského účtu dojde k chybovému ukončení aplikace.

Pokud nasadíte aplikaci pro iOS na iOS 10.3.1 z osobního zřizovacího profilu nebo účtu pro vývojáře, může se zobrazit tato chyba: Library not loaded: @rpath/ADAL...

Řešení tohoto problému:

  • Použijte zřizovací profil, který není profilem osobního týmu (placený vývojářský účet).
  • Nasaďte aplikaci na zařízení s iOSem se systémem iOS 13.3 nebo starším nebo na zařízení se systémem iOS 13.4 verze beta nebo vydané verze.
  • Přečtěte si další informace o tomto problému ve službě Stack Overflow.

Vyčištění prostředků

V předchozích krocích jste vytvořili prostředky Azure ve skupině prostředků. Pokud předpokládáte, že už tyto prostředky nebudete potřebovat, můžete je odstranit tak, že odstraníte skupinu prostředků.

V nabídce webu Azure Portal nebo na domovské stránce vyberte skupiny prostředků. Potom na stránce Skupiny prostředků vyberte myResourceGroup.

Na stránce myResourceGroup se ujistěte, že uvedené prostředky jsou ty, které chcete odstranit.

Vyberte Odstranit skupinu prostředků, do textového pole zadejte myResourceGroup , abyste ji potvrdili, a pak vyberte Odstranit.

Další kroky

V tomto rychlém startu jste vytvořili účet Spatial Anchors. Pak jste nakonfigurovali a nasadili aplikaci pro ukládání a odvolávání prostorových ukotvení. Další informace o tom, jak aplikaci vylepšit, aby mohl sdílet prostorové kotvy s dalšími zařízeními, najdete v dalším kurzu.

Kurz: Sdílení prostorových ukotvení napříč zařízeními