Uruchamianie przykładowej aplikacji: iOS — Xcode (Swift lub Objective-C)
W tym przewodniku Szybki start opisano sposób uruchamiania przykładowej aplikacji usługi Azure Spatial Anchors dla urządzeń z systemem iOS przy użyciu środowiska Xcode (Swift lub Objective-C). Azure Spatial Anchors to usługa dla deweloperów programujących dla wielu platform, która pozwala kreować rozwiązania z rzeczywistością mieszaną z użyciem obiektów, których lokalizacja jest taka sama na różnych urządzeniach mimo upływu czasu. Gdy skończysz, będziesz mieć aplikację ARKit dla systemu iOS, która może zapisywać i przywoływać kotwicę przestrzenną.
Dowiesz się, jak:
- Tworzenie konta usługi Spatial Anchors
- Konfigurowanie identyfikatora i klucza konta usługi Spatial Anchors
- Wdrażanie i uruchamianie na urządzeniu z systemem iOS
Jeśli nie masz subskrypcji platformy Azure, przed rozpoczęciem utwórz bezpłatne konto platformy Azure.
Wymagania wstępne
Aby ukończyć ten przewodnik Szybki start, upewnij się, że dysponujesz następującymi elementami:
- Maszyna z systemem macOS z włączoną obsługą deweloperów z zainstalowaną najnowszą wersją oprogramowania Xcode i CocoaPods .
- Narzędzie Git zainstalowane za pośrednictwem oprogramowania HomeBrew:
- Wprowadź następujące polecenie jako pojedynczy wiersz w terminalu:
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
. - Uruchom polecenia
brew install git
ibrew install git-lfs
. - Zaktualizuj konfigurację usługi Git za pomocą
git lfs install
polecenia (dla bieżącego użytkownika) lubgit lfs install --system
(dla całego systemu).
- Wprowadź następujące polecenie jako pojedynczy wiersz w terminalu:
- Deweloperskie urządzenie z systemem iOS, zgodne z zestawem ARKit.
Tworzenie zasobu usługi Spatial Anchors
Przejdź do portalu Azure Portal.
W okienku po lewej stronie wybierz pozycję Utwórz zasób.
Użyj pola wyszukiwania, aby wyszukać usługi Spatial Anchors.
Wybierz pozycję Zakotwiczenia przestrzenne, a następnie wybierz pozycję Utwórz.
W okienku Konto usługi Spatial Anchors wykonaj następujące czynności:
Wprowadź unikatową nazwę zasobu przy użyciu zwykłych znaków alfanumerycznych.
Wybierz subskrypcję, do której chcesz dołączyć zasób.
Utwórz grupę zasobów, wybierając pozycję Utwórz nową. Nadaj jej nazwę myResourceGroup, a następnie wybierz przycisk OK.
Grupa zasobów to logiczny kontener, w którym są wdrażane i zarządzane zasoby platformy Azure, takie jak aplikacje internetowe, bazy danych i konta magazynu. Na przykład można później usunąć całą grupę zasobów w jednym prostym kroku.
Wybierz lokalizację (region), w której ma być umieszczany zasób.
Wybierz pozycję Utwórz , aby rozpocząć tworzenie zasobu.
Po utworzeniu zasobu witryna Azure Portal pokazuje, że wdrożenie zostało ukończone.
Wybierz pozycję Przejdź do zasobu. Teraz możesz wyświetlić właściwości zasobu.
Skopiuj wartość identyfikatora konta zasobu do edytora tekstów do późniejszego użycia.
Skopiuj również wartość domeny konta zasobu do edytora tekstów do późniejszego użycia.
W obszarze Ustawienia wybierz pozycję Klucz dostępu. Skopiuj wartość Klucza podstawowego, Klucz konta, do edytora tekstów do późniejszego użycia.
Otwieranie przykładowego projektu
Użyj terminalu, aby wykonać następujące czynności.
Sklonuj repozytorium przykładów, uruchamiając następujące polecenia:
git clone https://github.com/Azure/azure-spatial-anchors-samples.git
cd ./azure-spatial-anchors-samples
Zainstaluj konieczne zasobniki przy użyciu programu CocoaPods:
Przejdź do iOS/Swift/
.
cd ./iOS/Swift/
Uruchom polecenie pod install --repo-update
w celu zainstalowania programu CocoaPods dla projektu.
Uwaga
Użyj następującego polecenia, jeśli masz system macOS Monterey (12.2.1)
Uruchom polecenie pod update
w celu zainstalowania programu CocoaPods dla projektu.
Następnie otwórz plik .xcworkspace
w programie Xcode.
Uwaga
Zapoznaj się z krokami rozwiązywania problemów, jeśli występują problemy z programem CocoaPod po uaktualnieniu do systemu macOS Catalina (10.15).
open ./SampleSwift.xcworkspace
Konfigurowanie identyfikatora i klucza konta
Następnym krokiem jest skonfigurowanie aplikacji do używania identyfikatora konta i klucza konta. Skopiowano je do edytora tekstów podczas konfigurowania zasobu usługi Spatial Anchors.
Otwórz iOS/Swift/SampleSwift/ViewControllers/BaseViewController.swift
.
Znajdź pole spatialAnchorsAccountKey
i zastąp wartość Set me
kluczem konta.
Znajdź pole spatialAnchorsAccountId
i zastąp wartość Set me
identyfikatorem konta.
spatialAnchorsAccountDomain
Znajdź pole i zastąp ciąg Set me
domeną konta.
Wdrażanie aplikacji na urządzeniu z systemem iOS
Podłącz urządzenie z systemem iOS do komputera Mac i ustaw aktywny schemat na urządzenie z systemem iOS.
Wybierz pozycję Build and then run the current scheme (Skompiluj i uruchom bieżący schemat).
Uwaga
Jeśli widzisz błąd library not found for -lPods-SampleObjC
, prawdopodobnie został otwarty plik .xcodeproj
zamiast .xcworkspace
. Otwórz plik .xcworkspace
i ponów próbę.
W programie Xcode zatrzymaj aplikację, naciskając pozycję Stop.
Rozwiązywanie problemów
Problemy z platformą CocoaPods w systemie macOS Catalina (10.15)
Jeśli ostatnio zaktualizowano system macOS Catalina (10.15) i zainstalowano wcześniej narzędzie CocoaPods, narzędzie CocoaPods może być w stanie uszkodzonym i nie można poprawnie skonfigurować zasobników i .xcworkspace
plików projektu. Aby rozwiązać ten problem, należy ponownie zainstalować narzędzia CocoaPods, uruchamiając następujące polecenia:
brew update
brew install cocoapods --build-from-source
brew link --overwrite cocoapods
Aplikacja ulega awarii podczas wdrażania w systemie iOS 10.3.1 z osobistego profilu aprowizacji/konta dewelopera
Jeśli wdrożysz aplikację systemu iOS w systemie iOS 10.3.1 z osobistego profilu aprowizacji/konta dewelopera, może zostać wyświetlony następujący błąd: Library not loaded: @rpath/ADAL...
.
W celu rozwiązania tego problemu:
- Użyj profilu aprowizacji, który nie jest profilem zespołu osobistego (płatnego konta dewelopera).
- Wdróż aplikację na urządzeniu z systemem iOS w wersji 13.3 lub starszej albo na urządzeniu z systemem iOS 13.4 w wersji beta lub w wersji.
- Przeczytaj więcej na temat tego problemu w witrynie Stack Overflow.
Czyszczenie zasobów
W poprzednich krokach utworzono zasoby platformy Azure w grupie zasobów. Jeśli nie będziesz już potrzebować tych zasobów w przyszłości, możesz je usunąć przez usunięcie grupy zasobów.
W menu witryny Azure Portal lub na stronie głównej wybierz pozycję Grupy zasobów. Następnie na stronie Grupy zasobów wybierz pozycję myResourceGroup.
Na stronie myResourceGroup upewnij się, że wymienione zasoby są tymi, które chcesz usunąć.
Wybierz pozycję Usuń grupę zasobów, wpisz myResourceGroup w polu tekstowym, aby potwierdzić, a następnie wybierz pozycję Usuń.
Następne kroki
W tym przewodniku Szybki start utworzono konto usługi Spatial Anchors. Następnie skonfigurowano i wdrożono aplikację do zapisywania i odwoływania kotwic przestrzennych. Aby dowiedzieć się więcej na temat ulepszania aplikacji w celu udostępniania kotwic przestrzennych innym urządzeniom, przejdź do następnego samouczka.