Spuštění ukázkové aplikace: iOS – Xcode (Swift nebo Objective-C)
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í.
Získáte následující informace:
- 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.
Požadavky
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:
- 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)"
. - Spusťte příkazy
brew install git
abrew install git-lfs
. - Aktualizujte konfiguraci Gitu (
git lfs install
pro aktuálního uživatele) nebogit lfs install --system
(pro celý systém).
- Jako jeden řádek v terminálu zadejte následující příkaz:
- 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.
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.
Po vytvoření prostředku se na webu Azure Portal zobrazí, že je vaše nasazení dokončené.
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í.
Zkopírujte také hodnotu domény účtu prostředku do textového editoru pro pozdější použití.
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í.
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řipojte zařízení s iOSem k Macu a nastavte aktivní schéma na zařízení s iOSem.
Vyberte Sestavit a spusťte aktuální schéma.
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.