Snabb start: skapa en iOS-app med molnbaserade ankare, antingen i Swift eller mål-CQuickstart: Create an iOS app with Azure Spatial Anchors, in either Swift or Objective-C

I den här snabbstarten beskrivs hur du skapar en iOS-app med hjälp av Azure Spatial Anchors i antingen Swift eller Objective-C.This quickstart covers how to create an iOS app using Azure Spatial Anchors in either Swift or Objective-C. Azure Spatial Anchors är en plattformsoberoende utvecklartjänst som du kan använda för att skapa Mixed Reality-upplevelser med hjälp av objekt som bevarar sin plats mellan enheter över tid.Azure Spatial Anchors is a cross-platform developer service that allows you to create mixed reality experiences using objects that persist their location across devices over time. När du är klar har du en ARKit iOS-app som kan spara och återkalla en spatial fästpunkt.When you're finished, you'll have an ARKit iOS app that can save and recall a spatial anchor.

Du lär dig följande:You'll learn how to:

  • Skapa ett Spatial Anchors-kontoCreate a Spatial Anchors account
  • Konfigurera konto-ID och kontonyckel för Spatial AnchorsConfigure the Spatial Anchors account identifier and account key
  • Distribuera och köra på en iOS-enhetDeploy and run on an iOS device

Om du inte har en Azure-prenumeration kan du skapa ettkostnadsfritt konto innan du börjar.If you don't have an Azure subscription, create a free account before you begin.

KravPrerequisites

Kontrollera att du har följande för genomföra den här snabbstarten:To complete this quickstart, make sure you have:

  • En utvecklare aktiverade macOS-datorn med den senaste versionen av Xcode och CocoaPods installerad.A developer enabled macOS machine with the latest version of Xcode and CocoaPods installed.
  • Git installerat via HomeBrew.Git installed via HomeBrew. Ange följande kommando i en enskild rad i terminalen: /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)".Enter the following command into a single line of the Terminal: /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)". Kör sedan brew install git och brew install git-lfs.Then, run brew install git and brew install git-lfs.
  • En utvecklaraktiverad ARKit-kompatibel iOS-enhet.A developer enabled ARKit compatible iOS device.

Skapa en Spatial Anchors-resursCreate a Spatial Anchors resource

Gå till Azure-portalen.Go to the Azure portal.

I det vänstra navigeringsfönstret i Azure-portalen, väljer skapa en resurs.In the left navigation pane in the Azure portal, select Create a resource.

Använd sökrutan för att söka efter Spatial ankare.Use the search box to search for Spatial Anchors.

Söka efter Spatial Anchors

Välj Spatial ankare.Select Spatial Anchors. I dialogrutan Välj skapa.In the dialog box, select Create.

I den Spatial ankare konto dialogrutan:In the Spatial Anchors Account dialog box:

  • Ange ett unikt resursnamn, med hjälp av vanliga alfanumeriska tecken.Enter a unique resource name, using regular alphanumeric characters.

  • Välj den prenumeration som du vill koppla till resursen.Select the subscription that you want to attach the resource to.

  • Skapa en resursgrupp genom att välja Skapa ny.Create a resource group by selecting Create new. Ge den namnet myResourceGroup och välj OK.Name it myResourceGroup and select OK. En resursgrupp är en logisk container som Azure-resurser (t.ex. webbappar, databaser och lagringskonton) distribueras och hanteras i.A resource group is a logical container into which Azure resources like web apps, databases, and storage accounts are deployed and managed. Du kan exempelvis välja att ta bort hela resursgruppen i ett enkelt steg längre fram.For example, you can choose to delete the entire resource group in one simple step later.

  • Välj en plats (region) där du vill placera resursen.Select a location (region) in which to place the resource.

  • Välj Ny för att börja skapa resursen.Select New to begin creating the resource.

    Skapa en resurs

När resursen har skapats visar Azure-portalen att distributionen har slutförts.After the resource is created, Azure Portal will show that your deployment is complete. Klicka på Gå till resurs.Click Go to resource.

Distributionen är klar

Du kan sedan visa egenskaper för resursen.Then, you can view the resource properties. Kopiera resursens konto-ID värde i en textredigerare, eftersom du behöver senare.Copy the resource's Account ID value into a text editor because you'll need it later.

Resursegenskaper

Under inställningarväljer nyckeln.Under Settings, select Key. Kopiera den primärnyckel värde i en textredigerare.Copy the Primary key value into a text editor. Det här värdet är den Account Key.This value is the Account Key. Du behöver det senare.You'll need it later.

Kontonyckel

Öppna exempelprojektetOpen the sample project

Använd terminalen för att utföra följande åtgärder.Use the Terminal to perform the following actions.

Klona exempellagringsplatsen genom att köra följande kommando:Clone the samples repository by running the following command:

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

Installera nödvändiga poddar med hjälp av CocoaPods:Install the necessary pods using CocoaPods:

Navigera till iOS/Swift/.Navigate to iOS/Swift/.

cd ./iOS/Swift/

Kör pod install --repo-update för att installera CocoaPods för projektet.Run pod install --repo-update to install the CocoaPods for the project.

Öppna nu .xcworkspace i Xcode.Now open the .xcworkspace in Xcode.

Anteckning

Se fel söknings stegen här om du har CocoaPod problem efter uppgraderingen till MacOS Catalina (10,15).See the troubleshooting steps here if you're having CocoaPod issues after upgrading to macOS Catalina (10.15).

open ./SampleSwift.xcworkspace

Konfigurera konto-ID och -nyckelConfigure account identifier and key

Nästa steg är att konfigurera appen så att den använder din konto identifierare och konto nyckeln.The next step is to configure the app to use your account identifier and account key. Du kopierade dem till en text redigerare när du ställer in resursen för spatiala ankare.You copied them into a text editor when setting up the Spatial Anchors resource.

Öppna iOS/Swift/SampleSwift/ViewControllers/BaseViewController.swift.Open iOS/Swift/SampleSwift/ViewControllers/BaseViewController.swift.

Leta upp fältet spatialAnchorsAccountKey och ersätt Set me med kontonyckeln.Locate the spatialAnchorsAccountKey field and replace Set me with the account key.

Leta upp fältet spatialAnchorsAccountId och ersätt Set me med kontoidentifieraren.Locate the spatialAnchorsAccountId field and replace Set me with the account identifier.

Distribuera appen till din iOS-enhetDeploy the app to your iOS device

Ansluta iOS-enheten till Mac-datorn och ange det aktiva schemat till iOS-enheten.Connect the iOS device to the Mac and set the active scheme to your iOS device.

Välja enheten

Välj Build and then run the current scheme (Skapa och kör sedan det aktuella schemat).Select Build and then run the current scheme.

Distribuera och köra

Anteckning

Om du ser felet library not found for -lPods-SampleObjC har du sannolikt öppnat filen .xcodeproj i stället för .xcworkspace.If you see a library not found for -lPods-SampleObjC error, you likely opened the .xcodeproj file instead of the .xcworkspace. Öppna .xcworkspace och försök igen.Open the .xcworkspace and try again.

I Xcode stoppar du appen genom att trycka på Stoppa.In Xcode, stop the app by pressing Stop.

FelsökaTroubleshooting

CocoaPods problem på macOS Catalina (10,15)CocoaPods issues on macOS Catalina (10.15)

Om du nyligen har uppdaterat till macOS Catalina (10,15) och hade CocoaPods installerat i förväg, kan CocoaPods vara i ett trasigt tillstånd och inte konfigurera poddar och .xcworkspace projektfiler korrekt.If you recently updated to macOS Catalina (10.15) and had CocoaPods installed beforehand, CocoaPods may be in a broken state and fail to properly configure your pods and .xcworkspace project files. För att lösa det här problemet måste du installera om CocoaPods genom att köra följande kommandon:To resolve this issue, you'll need to reinstall CocoaPods by running the following commands:

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

Rensa resurserClean up resources

I de föregående stegen skapade du Azure-resurser i en resursgrupp.In the preceding steps, you created Azure resources in a resource group. Om du inte tror att du behöver dessa resurser i framtiden, kan du ta bort dem genom att ta bort resursgruppen.If you don't expect to need these resources in the future, you can delete them by deleting the resource group.

Från Azure Portal-menyn eller Start sidan väljer du resurs grupperoch på sidan resurs grupper väljer du myResourceGroup.From the Azure portal menu or Home page, select Resource groups, and on the Resource groups page, select myResourceGroup.

På sidan myResourceGroup kontrollerar du att de listade resurserna är de som du vill ta bort.On the myResourceGroup page, make sure that the listed resources are the ones you want to delete.

Välj Ta bort, skriv myResourceGroup i textrutan och välj sedan Ta bort.Select Delete, type myResourceGroup in the text box, and then select Delete.

Nästa stegNext steps

I den här snabbstarten har skapade du ett konto för Spatial fästpunkter.In this quickstart, you created a Spatial Anchors account. Du kan sedan konfigureras och distribueras en app för att spara och hämta spatial fästpunkter.You then configured and deployed an app to save and recall spatial anchors. Fortsätt till nästa självstudie om du vill veta mer om hur du förbättrar appen så att den kan dela spatial ankare med andra enheter.To learn more about how to improve the app so it can share spatial anchors with other devices, continue to the next tutorial.