Jalankan aplikasi sampel: iOS - Xcode (Swift atau Objective-C)

Mulai cepat ini mencakup cara menjalankan aplikasi sampel Azure Spatial Anchors untuk perangkat iOS menggunakan Xcode (Swift atau Objective-C). Azure Spatial Anchors adalah layanan pengembang lintas platform yang memungkinkan Anda membuat pengalaman realitas campuran menggunakan objek yang mempertahankan lokasinya di seluruh perangkat dari waktu ke waktu. Setelah selesai, Anda akan memiliki aplikasi iOS ARKit yang dapat menyimpan dan mengenali jangkar spasial.

Anda akan mempelajari cara:

• Buat akun Spatial Anchors
• Konfigurasikan pengidentifikasi akun Spatial Anchors dan kunci akun
• Menyebarkan dan menjalankan di perangkat iOS

Jika Anda tidak memiliki Langganan Azure, buat Akun gratis Azure sebelum memulai.

Prasyarat

Untuk menyelesaikan mulai cepat ini, pastikan Anda memiliki:

• Pengembang mengaktifkan mesin macOS dengan Xcode dan CocoaPods terinstal versi terbaru.
• Git diinstal melalui HomeBrew:
  1. Masukkan perintah berikut ke dalam satu baris terminal: /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)".
  2. Jalankan brew install git dan brew install git-lfs.
  3. Perbarui konfigurasi git Anda dengan git lfs install (untuk pengguna saat ini) atau git lfs install --system (untuk seluruh sistem).
• Pengembang mengaktifkan perangkat iOS yang kompatibel dengan ARKit.

Buat sumber daya Spatial Anchors

Portal

Buka portal Microsoft Azure.

Di panel kiri, pilih Buat sumber daya.

Gunakan kotak pencarian untuk mencari Spatial Anchors.

Pilih Spatial Anchors, lalu pilih Buat.

Pada panel Akun Spatial Anchors, lakukan hal berikut ini:

• Masukkan nama sumber daya unik dengan menggunakan karakter alfanumerik biasa.

• Pilih langganan yang ingin Anda lampirkan sumber dayanya.

• Buat grup sumber daya dengan memilih Buat baru. Beri nama myResourceGroup, lalu pilih OK.

  Grup sumber daya Azure adalah kontainer logis tempat sumber daya Azure seperti aplikasi web, database, dan akun penyimpanan disebarkan dan dikelola. Misalnya, Anda dapat memilih untuk menghapus seluruh grup sumber daya dalam satu langkah sederhana nanti.

• Pilih lokasi (kawasan) tempat menempatkan sumber daya.

• Pilih Buat untuk memulai pembuatan sumber daya.

Setelah sumber daya dibuat, portal Azure menunjukkan bahwa penyebaran Anda selesai.

Pilih Buka sumber daya. Anda sekarang dapat melihat properti sumber daya.

Salin nilai ID Akun sumber daya ke editor teks untuk digunakan nanti.

Salin nilai Domain Akun sumber daya juga ke editor teks untuk digunakan nanti.

Di Pengaturan, pilih Kunci akses. Salin nilai Kunci utama, Kunci Akun, ke editor teks untuk digunakan nanti.

Azure CLI

Mulailah dengan mempersiapkan lingkungan Anda untuk Azure CLI:

• Gunakan lingkungan Bash di Azure Cloud Shell. Untuk informasi selengkapnya, lihat Mulai Cepat untuk Bash di Azure Cloud Shell.

  

• Jika Anda lebih suka menjalankan perintah referensi CLI secara lokal, instal Azure CLI. Jika Anda menjalankan Windows atau macOS, pertimbangkan untuk menjalankan Azure CLI dalam kontainer Docker. Untuk informasi lebih lanjut, lihat Cara menjalankan Azure CLI di kontainer Docker.

  • Jika Anda menggunakan instalasi lokal, masuk ke Azure CLI dengan menggunakan perintah login az. Untuk menyelesaikan proses autentikasi, ikuti langkah-langkah yang ditampilkan di terminal Anda. Untuk opsi masuk lainnya, lihat Masuk dengan Azure CLI.

  • Saat Anda diminta, instal ekstensi Azure CLI pada penggunaan pertama. Untuk informasi selengkapnya tentang ekstensi, lihat Menggunakan ekstensi dengan Azure CLI.

  • Jalankan versi az untuk menemukan versi dan pustaka dependen yang diinstal. Untuk meningkatkan ke versi terbaru, jalankan peningkatan az.

1. Setelah Anda masuk, gunakan perintah az account set untuk memilih langganan mana untuk menyiapkan akun spatial anchors:

   az account set --subscription 00000000-0000-0000-0000-000000000000
   

2. Jalankan perintah az group create untuk membuat grup sumber daya, atau gunakan grup sumber daya yang sudah ada:

   az group create --name myResourceGroup --location eastus2
   

   Grup sumber daya Azure adalah kontainer logis tempat sumber daya Azure seperti aplikasi web, database, dan akun penyimpanan disebarkan dan dikelola. Misalnya, Anda dapat memilih untuk menghapus seluruh grup sumber daya dalam satu langkah sederhana nanti.

   Anda dapat melihat akun spatial anchors Anda saat ini untuk grup sumber daya dengan menggunakan perintah az spatial-anchors-account list

   az spatial-anchors-account list --resource-group myResourceGroup
   

   Anda juga dapat melihat akun spatial anchors untuk langganan Anda:

   az spatial-anchors-account list
   

3. Jalankan az spatial-anchors-account create untuk membuat akun spatial anchors Anda:

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

4. Lihat properti sumber daya dengan menggunakan perintah az spatial-anchors-account show:

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

   Salin nilai ID Akun sumber daya dan nilai Domain Akun sumber daya ke editor teks untuk digunakan nanti.

5. Jalankan perintah az spatial-anchors-account key show untuk mendapatkan kunci utama dan sekunder Anda:

   az spatial-anchors-account key show --resource-group myResourceGroup --name MySpatialAnchorsQuickStart
   

   Salin nilai kunci ke editor teks untuk digunakan nanti.

   Jika Anda perlu meregenerasi kunci, gunakan perintah az spatial-anchors-account key renew:

   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
   

Anda dapat menghapus akun dengan menggunakan perintah az spatial-anchors-account delete:

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

Azure PowerShell

Mulai dengan menyiapkan lingkungan Anda untuk Azure PowerShell:

• Jika Anda memilih untuk menggunakan Azure PowerShell secara lokal:
  • Instal versi terbaru modul Az PowerShell.
  • Sambungkan ke akun Azure Anda menggunakan cmdlet Connect-AzAccount.
• Jika Anda memilih untuk menggunakan Azure Cloud Shell:
  • Lihat Gambaran Umum Azure Cloud Shell untuk informasi selengkapnya.

Penting

Saat modul PowerShell Az.MixedReality dalam pratinjau, Anda harus menginstalnya secara terpisah menggunakan cmdlet Install-Module. Setelah modul PowerShell ini tersedia secara umum, modul ini akan menjadi bagian dari rilis modul Az PowerShell mendatang dan tersedia secara default dari dalam Azure Cloud Shell.

Install-Module -Name Az.MixedReality

1. Setelah Anda masuk, gunakan perintah cmdlet Set-AzContext untuk memilih langganan mana untuk menyiapkan akun spatial anchors:

   Set-AzContext -SubscriptionId 00000000-0000-0000-0000-000000000000
   

2. Jalankan cmdlet New-AzResourceGroup untuk membuat grup sumber daya, atau gunakan grup sumber daya yang sudah ada:

   New-AzResourceGroup -Name myResourceGroup -Location eastus2
   

   Grup sumber daya Azure adalah kontainer logis tempat sumber daya Azure seperti aplikasi web, database, dan akun penyimpanan disebarkan dan dikelola. Misalnya, Anda dapat memilih untuk menghapus seluruh grup sumber daya dalam satu langkah sederhana nanti.

   Anda dapat melihat akun spatial anchors Anda saat ini untuk grup sumber daya dengan menggunakan cmdlet Get-AzSpatialAnchorsAccount:

   Get-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup
   

   Anda juga dapat melihat akun spatial anchors untuk langganan Anda:

   Get-AzSpatialAnchorsAccount
   

3. Jalankan cmdlet New-AzSpatialAnchorsAccount untuk membuat akun spatial anchors Anda:

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

4. Lihat properti sumber daya dengan menggunakan cmdlet Get-AzSpatialAnchorsAccount:

   Get-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart
   

   Salin nilai accountId properti dan nilai accountDomain properti ke editor teks untuk digunakan nanti.

5. Jalankan cmdlet Get-AzSpatialAnchorsAccountKey untuk mendapatkan kunci utama dan sekunder Anda:

   Get-AzSpatialAnchorsAccountKey -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart
   

   Salin nilai kunci ke editor teks untuk digunakan nanti.

   Jika Anda perlu meregenerasi kunci, gunakan cmdlet New-AzSpatialAnchorsAccountKey:

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

Anda dapat menghapus akun dengan menggunakan cmdlet Remove-AzSpatialAnchorsAccount:

Remove-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart

Buka sampel proyek

Gunakan Terminal untuk melakukan tindakan berikut.

Kloning repositori sampel dengan menjalankan perintah berikut:

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

Pasang Pod yang diperlukan menggunakan CocoaPods:

Swift

Buka iOS/Swift/.

cd ./iOS/Swift/

Objective-C

Buka iOS/Objective-C/.

cd ./iOS/Objective-C/

Jalankan pod install --repo-update untuk menginstal CocoaPods untuk proyek.

Catatan

Gunakan perintah berikut jika Anda memiliki macOS Monterey (12.2.1)

Jalankan pod update untuk menginstal CocoaPods untuk proyek.

Sekarang buka .xcworkspace di Xcode.

Catatan

Lihat langkah-langkah pemecahan masalah di sini jika Anda mengalami masalah CocoaPod setelah meningkatkan ke macOS Catalina (10.15).

Swift

open ./SampleSwift.xcworkspace

Objective-C

open ./SampleObjC.xcworkspace

Mengonfigurasi pengidentifikasi dan kunci akun

Langkah selanjutnya adalah mengonfigurasi aplikasi untuk menggunakan pengidentifikasi akun dan kunci akun Anda. Anda menyalinnya ke editor teks saat menyiapkan sumber daya Spatial Anchors.

Swift

Buka iOS/Swift/SampleSwift/ViewControllers/BaseViewController.swift.

Temukan spatialAnchorsAccountKey bidang dan ganti Set me dengan kunci akun.

Temukan spatialAnchorsAccountId bidang dan ganti Set me dengan pengidentifikasi akun.

Temukan bidang spatialAnchorsAccountDomain dan ganti Set me dengan domain akun.

Objective-C

Buka iOS/Objective-C/SampleObjC/BaseViewController.m.

Temukan SpatialAnchorsAccountKey bidang dan ganti Set me dengan kunci akun.

Temukan SpatialAnchorsAccountId bidang dan ganti Set me dengan pengidentifikasi akun.

Temukan bidang SpatialAnchorsAccountDomain dan ganti Set me dengan domain akun.

Sebarkan aplikasi ke perangkat iOS Anda

Sambungkan perangkat iOS ke Mac dan atur skema aktif ke perangkat iOS Anda.

Pilih Bangun dan jalankan skema saat ini.

Catatan

Jika Anda melihat library not found for -lPods-SampleObjC kesalahan, Anda mungkin membuka .xcodeproj file,alih-alih.xcworkspace. Buka .xcworkspace dan coba lagi.

Di Xcode, hentikan aplikasi dengan meneka Berhenti.

Pemecahan Masalah

Masalah CocoaPods di macOS Catalina (10.15)

Jika anda baru saja memperbarui ke macOS Catalina (10.15) dan menginstal CocoaPods sebelumnya, CocoaPods mungkin dalam keadaan rusak dan gagal mengonfigurasi Pod dan file .xcworkspace proyek dengan benar. Untuk mengatasi masalah ini, Anda harus memasang ulang CocoaPods dengan menjalankan perintah berikut:

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

Aplikasi crash saat menggunakan iOS 10.3.1 dari profil penyebaran pribadi/akun pengembang

Jika Anda menggunakan aplikasi iOS di iOS 10.3.1 dari profil penyebaran pribadi/akun developer, Anda mungkin melihat kesalahan ini: Library not loaded: @rpath/ADAL....

Untuk mengatasi masalah ini:

• Gunakan profil penyebaran yang bukan profil Tim Pribadi (akun developer berbayar).
• Sebarkan aplikasi Anda ke perangkat iOS yang menjalankan iOS 13.3 atau versi yang lebih lama, atau ke aplikasi yang menjalankan versi beta atau rilis iOS 13.4.
• Baca selengkapnya tentang masalah ini di Stack Overflow.

Membersihkan sumber daya

Di langkah-langkah sebelumnya, Anda membuat sumber daya Azure dalam grup sumber daya. Jika Anda tidak berharap membutuhkan sumber daya ini di masa mendatang, Anda dapat menghapusnya dengan menghapus grup sumber daya.

Pada menu portal Microsoft Azure atau halaman Beranda, pilih Grup sumber daya. Setelah itu, pada halaman Grup sumber daya, pilih myResourceGroup.

Pada halaman myResourceGroup, pastikan sumber daya yang tercantum adalah sumber daya yang ingin Anda hapus.

Pilih Hapus grup sumber daya, ketik myResourceGroup di kotak teks untuk mengonfirmasi, lalu pilih Hapus.

Langkah berikutnya

Dalam mulai cepat ini, Anda membuat akun Spatial Anchors. Anda kemudian mengonfigurasi dan menerapkan aplikasi untuk menyimpan dan memanggil kembali spatial anchors. Untuk mempelajari lebih lanjut tentang cara meningkatkan aplikasi sehingga dapat berbagi spatial anchors dengan perangkat lain, lanjutkan ke tutorial berikutnya.

Tutorial: Berbagi Spatial Anchors di seluruh perangkat