Hızlı başlangıç: Azure uzamsal bağlayıcılarla, Swift veya amaç-C ' d a iOS uygulaması oluşturma

Makale
11/24/2021
Okumak için 6 dakika

Bu hızlı başlangıçta, Swift veya amaç-C ' d e Azure uzamsal bağlayıcılarını kullanarak bir iOS uygulamasının nasıl oluşturulacağı ele alınmaktadır. Azure uzamsal bağlantıları, zaman içinde cihazlarda konumlarını sürekli tutan nesneleri kullanarak karma gerçeklik deneyimleri oluşturmanıza olanak sağlayan bir platformlar arası geliştirici hizmetidir. İşiniz bittiğinde, bir uzamsal bağlayıcıyı kaydedip geri çekebilmeniz için bir ARKit iOS uygulamasına sahip olacaksınız.

Şunları öğrenirsiniz:

Uzamsal bağlayıcı hesabı oluşturma
Uzamsal Tutturucuların hesap tanımlayıcısını ve hesap anahtarını yapılandırın
İOS cihazında dağıtma ve çalıştırma

Azure aboneliğiniz yoksa başlamadan önce ücretsiz bir hesap oluşturun.

Önkoşullar

Bu hızlı başlangıcı tamamlamak için aşağıdakileri yaptığınızdan emin olun:

En son Xcode ve Cocoapods sürümü yüklü olan MacOS makinesi özellikli bir geliştirici.
HomeBrew aracılığıyla Git yüklendi:
1. Terminalde aşağıdaki komutu tek bir satır olarak girin: /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)" .
2. brew install git ve brew install git-lfs komutlarını çalıştırın.
3. Git yapılandırmasını git lfs install (geçerli kullanıcı için) veya git lfs install --system (tüm sistem için) ile güncelleştirin.
Bir geliştirici, ARKit uyumlu bir iOS cihazını etkinleştirdi.

Uzamsal bağlayıcı kaynağı oluşturma

Azure Portal gidin.

Sol bölmede kaynak oluştur' u seçin.

Uzamsal bağlantıları aramak için arama kutusunu kullanın.

Uzamsal bağlayıcıları seçin ve ardından Oluştur' u seçin.

Uzamsal bağlayıcı hesabı bölmesinde şunları yapın:

Normal alfasayısal karakterleri kullanarak benzersiz bir kaynak adı girin.
Kaynağı iliştirmek istediğiniz aboneliği seçin.
Yeni oluştur seçeneğini belirleyerek bir kaynak grubu oluşturun. Myresourcegroup olarak adlandırın ve ardından Tamam' ı seçin.

Kaynak grubu , Web uygulamaları, veritabanları ve depolama hesapları gibi Azure kaynaklarının dağıtıldığı ve yönetildiği bir mantıksal kapsayıcıdır. Örneğin, daha sonra tek bir basit adımda kaynak grubun tamamını silmeyi seçebilirsiniz.
Kaynağın yerleştirileceği bir konum (bölge) seçin.
Kaynağı oluşturmaya başlamak için Oluştur ' u seçin.

Kaynak oluşturmak için uzamsal bağlayıcı bölmesinin ekran görüntüsü.

Kaynak oluşturulduktan sonra, Azure portal dağıtımınızın tamamlandığını gösterir.

Kaynak dağıtımının tamamlandığını gösteren ekran görüntüsü.

Kaynağa git’i seçin. Artık kaynak özelliklerini görüntüleyebilirsiniz.

Kaynağın hesap kimliği değerini daha sonra kullanmak üzere bir metin düzenleyicisine kopyalayın.

Kaynak özellikleri bölmesinin ekran görüntüsü.

Ayrıca, kaynağın hesap etki alanı değerini daha sonra kullanmak üzere bir metin düzenleyicisine kopyalayın.

Kaynağın hesap etki alanı değerini gösteren ekran görüntüsü.

Ayarlar altında erişim anahtarı' nı seçin. Birincil anahtar değerini, hesap anahtarını daha sonra kullanmak üzere bir metin düzenleyicisine kopyalayın.

Hesap için anahtarlar bölmesinin ekran görüntüsü.

Başlangıç olarak ortamınızı Azure CLI için hazırlayın:

Azure Cloud Shell'Da Bash ortamını kullanın.
Dilerseniz CLI başvuru komutlarını çalıştırmak için Azure CLI’yi yükleyebilirsiniz.
- Yerel yükleme kullanıyorsanız az login komutunu kullanarak Azure CLI ile oturum açın. Kimlik doğrulama işlemini tamamlamak için terminalinizde görüntülenen adımları izleyin. Ek oturum açma seçenekleri için bkz. Azure CLI ile oturum açma.
- İstendiğinde, ilk kullanımda Azure CLI uzantılarını yükleyin. Uzantılar hakkında daha fazla bilgi için bkz. Azure CLI ile uzantıları kullanma.
- Yüklü sürümü ve bağımlı kitaplıkları bulmak için az version komutunu çalıştırın. En son sürüme yükseltmek için az upgrade komutunu çalıştırın.

Oturum açtıktan sonra, uzamsal bağlayıcı hesabının ayarlanacağı aboneliği seçmek için az Account set komutunu kullanın:
```
az account set --subscription 00000000-0000-0000-0000-000000000000
```
Bir kaynak grubu oluşturmak için az Group Create komutunu çalıştırın veya var olan bir kaynak grubunu kullanın:
```
az group create --name myResourceGroup --location eastus2
```
Kaynak grubu , Web uygulamaları, veritabanları ve depolama hesapları gibi Azure kaynaklarının dağıtıldığı ve yönetildiği bir mantıksal kapsayıcıdır. Örneğin, daha sonra tek bir basit adımda kaynak grubun tamamını silmeyi seçebilirsiniz.

Az uzamsal-bağlayıcı hesabı listesi komutunu kullanarak bir kaynak grubu için geçerli uzamsal bağlayıcı hesaplarınızı görüntüleyebilirsiniz:
```
az spatial-anchors-account list --resource-group myResourceGroup
```
Aboneliğiniz için de uzamsal bağlayıcı hesaplarını görüntüleyebilirsiniz:
```
az spatial-anchors-account list
```

Uzamsal bağlayıcı hesabınızı oluşturmak için az uzamsal-bağlayıcı-hesap oluştur komutunu çalıştırın:

az spatial-anchors-account create --resource-group myResourceGroup --name MySpatialAnchorsQuickStart --location eastus2

Az uzamsal-bağlayıcı-hesap göster komutunu kullanarak kaynak özelliklerini görüntüleyin:
```
az spatial-anchors-account show --resource-group myResourceGroup --name MySpatialAnchorsQuickStart
```
Kaynak hesap kimliği değerini ve kaynak hesabı etki alanı değerini daha sonra kullanmak üzere bir metin düzenleyicisine kopyalayın.
Birincil ve ikincil anahtarlarınızı almak için az uzamsal-bağlayıcı-hesap anahtarı göster komutunu çalıştırın:
```
az spatial-anchors-account key show --resource-group myResourceGroup --name MySpatialAnchorsQuickStart
```
Anahtar değerlerini daha sonra kullanmak üzere bir metin düzenleyicisine kopyalayın.

Anahtarları yeniden oluşturmanız gerekiyorsa, az uzamsal-bağlayıcı-hesap anahtar yenileme komutunu kullanın:
```
az spatial-anchors-account key renew --resource-group myResourceGroup --name example --key primary
az spatial-anchors-account key renew --resource-group myResourceGroup --name example --key secondary
```

Az uzamsal-bağlayıcı-Account Delete komutunu kullanarak bir hesabı silebilirsiniz:

az spatial-anchors-account delete --resource-group myResourceGroup --name MySpatialAnchorsQuickStart

Başlangıç olarak ortamınızı Azure PowerShell için hazırlayın:

Yerel olarak kullanmak Azure PowerShell:
- Az PowerShell modülünü yükleyin.
- Bağlan-AzAccount cmdlet'ini kullanarak Azure Bağlan oturum açın.
Şu bilgileri kullanmayı Azure Cloud Shell:
- Daha fazla bilgi için Azure Cloud Shell Genel Bakış'a bakın.

Önemli

Az. MixedReality PowerShell modülü önizlemedeyken, cmdlet 'ini kullanarak ayrı olarak yüklemelisiniz Install-Module . Bu PowerShell modülü genel kullanıma sunulduktan sonra, gelecekteki Az PowerShell modülü sürümlerinin bir parçası haline gelecek ve Azure Cloud Shell içinden varsayılan olarak sağlanacaktır.

Install-Module -Name Az.MixedReality

Oturum açtıktan sonra, uzamsal bağlayıcı hesabının ayarlanacağı aboneliği seçmek için set-AzContext cmdlet 'ini kullanın:
```
Set-AzContext -SubscriptionId 00000000-0000-0000-0000-000000000000
```
Yeni-AzResourceGroup cmdlet 'ini çalıştırarak bir kaynak grubu oluşturun veya var olan bir kaynak grubunu kullanın:
```
New-AzResourceGroup -Name myResourceGroup -Location eastus2
```
Kaynak grubu , Web uygulamaları, veritabanları ve depolama hesapları gibi Azure kaynaklarının dağıtıldığı ve yönetildiği bir mantıksal kapsayıcıdır. Örneğin, daha sonra tek bir basit adımda kaynak grubun tamamını silmeyi seçebilirsiniz.

Get-AzSpatialAnchorsAccount cmdlet 'ini kullanarak, bir kaynak grubu için geçerli uzamsal bağlayıcı hesaplarınızı görüntüleyebilirsiniz:
```
Get-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup
```
Aboneliğiniz için de uzamsal bağlayıcı hesaplarını görüntüleyebilirsiniz:
```
Get-AzSpatialAnchorsAccount
```

Uzamsal bağlayıcı hesabınızı oluşturmak için New-AzSpatialAnchorsAccount cmdlet 'ini çalıştırın:

New-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart -Location eastus2

Get-AzSpatialAnchorsAccount cmdlet 'ini kullanarak kaynak özelliklerini görüntüleyin:
```
Get-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart
```
Daha sonra kullanmak üzere AccountID değerini ve accountdomain değerini bir metin düzenleyicisine kopyalayın.

Birincil ve ikincil anahtarlarınızı almak için Get-AzSpatialAnchorsAccountKey cmdlet 'ini çalıştırın:

Get-AzSpatialAnchorsAccountKey -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart

Anahtar değerlerini daha sonra kullanmak üzere bir metin düzenleyicisine kopyalayın.

Anahtarları yeniden oluşturmanız gerekirse, New-AzSpatialAnchorsAccountKey cmdlet 'ini kullanın:

New-AzSpatialAnchorsAccountKey -ResourceGroupName myResourceGroup -Name MySpatialAnchorsQuickStart -Primary
New-AzSpatialAnchorsAccountKey -ResourceGroupName myResourceGroup -Name MySpatialAnchorsQuickStart -Secondary

Remove-AzSpatialAnchorsAccount cmdlet 'ini kullanarak bir hesabı silebilirsiniz:

Remove-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart

Örnek projeyi açın

Aşağıdaki eylemleri gerçekleştirmek için terminali kullanın.

Aşağıdaki komutları çalıştırarak örnek depoyu kopyalayın:

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

Cocoapods kullanarak gerekli Pod 'yi yükler:

Swift
Objective-C

iOS/Swift/ sayfasına gidin.

cd ./iOS/Swift/

iOS/Objective-C/ sayfasına gidin.

cd ./iOS/Objective-C/

pod install --repo-updateProje Için Cocoapods yüklemek üzere çalıştırın.

Şimdi .xcworkspace Xcode 'da açın.

Not

MacOS Catalina 'e yükselttikten sonra CocoaPod sorunları yaşıyorsanız, sorun giderme adımlarına bakın (10,15).

Swift
Objective-C

open ./SampleSwift.xcworkspace

open ./SampleObjC.xcworkspace

Hesap tanımlayıcıyı ve anahtarı yapılandırın

Bir sonraki adım, uygulamayı hesap tanımlayıcıyı ve hesap anahtarınızı kullanacak şekilde yapılandırmaktır. Uzamsal Tutturucuların kaynağını ayarlarkenbunları bir metin düzenleyicisine kopyaladınız.

Swift
Objective-C

iOS/Swift/SampleSwift/ViewControllers/BaseViewController.swift dosyasını açın.

Alanı bulun spatialAnchorsAccountKey ve Set me Hesap anahtarıyla değiştirin.

Alanı bulun spatialAnchorsAccountId ve Set me Hesap tanımlayıcısıyla değiştirin.

Alanı bulun spatialAnchorsAccountDomain ve Set me hesap etki alanı ile değiştirin.

Uygulamayı iOS cihazınıza dağıtma

ios cihazını Mac 'e Bağlan ve etkin düzeni ios cihazınıza ayarlayın.

Cihazı seçin

Oluştur ' u seçin ve ardından geçerli düzeni çalıştırın.

Dağıt ve Çalıştır

Not

Bir hata görürseniz, library not found for -lPods-SampleObjC büyük olasılıkla .xcodeproj dosyası yerine dosyayı açtınız .xcworkspace . Öğesini açın .xcworkspace ve yeniden deneyin.

Xcode 'da Durdur' a basarak uygulamayı durdurun.

Sorun giderme

MacOS Catalina CocoaPods sorunlar (10,15)

Yakın zamanda MacOS Catalina (10,15) olarak güncelleştirdiyseniz ve önceden Cocoapods yüklüyse, Cocoapods bozuk bir durumda olabilir ve pod ve proje dosyalarınızı düzgün şekilde yapılandıramadı .xcworkspace . Bu sorunu çözmek için aşağıdaki komutları çalıştırarak CocoaPods öğesini yeniden yüklemeniz gerekir:

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

Bir kişisel sağlama profili/geliştirici hesabından iOS 10.3.1 'a dağıtım yaparken uygulama kilitleniyor

İOS uygulamanızı bir kişisel sağlama profili/geliştirici hesabından iOS 10.3.1 üzerinde dağıtırsanız şu hatayı görebilirsiniz: Library not loaded: @rpath/ADAL... .

Bu sorunu çözmek için:

Kişisel bir ekip profili (ücretli geliştirici hesabı) olmayan bir sağlama profili kullanın.
Uygulamanızı iOS 13,3 veya önceki bir sürümü çalıştıran bir iOS cihazına veya iOS 13,4 Beta ya da yayın sürümünü çalıştıran bir iOS cihazına dağıtın.
Bu sorun hakkında daha fazla bilgi için Stack Overflow.

Kaynakları temizleme

Önceki adımlarda, bir kaynak grubunda Azure kaynakları oluşturdunuz. İleride bu kaynaklara ihtiyaç duymayacağınızı düşünüyorsanız kaynakları silmek için kaynak grubunu silebilirsiniz.

Azure portal menüsünde veya giriş sayfasında, kaynak grupları' nı seçin. Ardından, kaynak grupları sayfasında, myresourcegroup öğesini seçin.

Myresourcegroup sayfasında, listelenen kaynakların silmek istedikleriniz olduğundan emin olun.

Kaynak grubunu sil' i seçin, onaylamak için metin kutusuna myresourcegroup yazın ve ardından Sil' i seçin.

Sonraki adımlar

Bu hızlı başlangıçta bir uzamsal bağlayıcı hesabı oluşturdunuz. Daha sonra uzamsal bağlayıcıları kaydetmek ve geri çağırmak için bir uygulama yapılandırmış ve dağıttınız. Farklı cihazlarla uzamsal Tutturucuların paylaşılacağını sağlamak üzere uygulamayı geliştirme hakkında daha fazla bilgi edinmek için sonraki öğreticiye geçin.

Öğretici: cihazlarda uzamsal bağlayıcıları paylaşma