Share via

Uruchamianie przykładowej aplikacji: iOS — Xcode (Swift lub Objective-C)

  • Artykuł

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ą.

Omawiane tematy:

  • 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:
    1. Wprowadź następujące polecenie jako pojedynczy wiersz w terminalu: /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)".
    2. Uruchom polecenia brew install git i brew install git-lfs.
    3. Zaktualizuj konfigurację usługi Git za pomocą git lfs install polecenia (dla bieżącego użytkownika) lub git lfs install --system (dla całego systemu).
  • 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.

Screenshot showing the results of a search for 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.

Screenshot of the Spatial Anchors pane for creating a resource.

Po utworzeniu zasobu witryna Azure Portal pokazuje, że wdrożenie zostało ukończone.

Screenshot showing that the resource deployment is complete.

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.

Screenshot of the resource properties pane.

Skopiuj również wartość domeny konta zasobu do edytora tekstów do późniejszego użycia.

Screenshot showing the resource's account domain value.

W obszarze Ustawienia wybierz pozycję Klucz dostępu. Skopiuj wartość Klucza podstawowego, Klucz konta, do edytora tekstów do późniejszego użycia.

Screenshot of the Keys pane for the account.

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.

Select the device

Wybierz pozycję Build and then run the current scheme (Skompiluj i uruchom bieżący schemat).

Deploy and run

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.

Samouczek: udostępnianie kotwic przestrzennych między urządzeniami