Menggunakan Visual Studio untuk menyebarkan dan men-debug

  • Artikel

Baik Anda menggunakan DirectX atau Unity untuk mengembangkan aplikasi realitas campuran Anda, Visual Studio adalah alat masuk Anda untuk penelusuran kesalahan dan penyebaran. Di bagian ini, Anda akan mempelajari cara:

  • Sebarkan aplikasi ke HoloLens atau Windows Mixed Reality headset imersif melalui Visual Studio.
  • Gunakan emulator HoloLens yang terpasang di Visual Studio.
  • Debug aplikasi realitas campuran.

Prasyarat

  1. Lihat Menginstal Alat untuk instruksi penginstalan.
  2. Buat proyek realitas campuran baru di Unity atau Visual Studio.
  3. Bangun proyek Unity Anda sesuai instruksi kami

Mengaktifkan Mode Pengembang

Mulailah dengan mengaktifkan Mode Pengembang di perangkat Anda sehingga Visual Studio dapat terhubung ke perangkat tersebut.

Mode pengembang di HoloLens

  1. Nyalakan HoloLens Anda dan pasang perangkat.
  2. Gunakan gerakan mulai untuk meluncurkan menu utama.
  3. Pilih petak peta Pengaturan untuk meluncurkan aplikasi di lingkungan Anda.
  4. Pilih item menu Perbarui .
  5. Pilih item menu Untuk pengembang .
  6. Aktifkan Gunakan fitur pengembang untuk menyebarkan aplikasi dari Visual Studio ke HoloLens Anda. Jika perangkat Anda menjalankan Windows Holographic versi 21H1 atau yang lebih baru, aktifkan juga Penemuan perangkat.
  7. Opsional: Gulir ke bawah dan aktifkan juga Portal Perangkat, yang memungkinkan Anda terhubung ke Portal Perangkat Windows di HoloLens Anda dari browser web.

Mode pengembang pada PC Windows

Jika Anda bekerja dengan headset Windows Mixed Reality yang terhubung ke PC, Anda harus mengaktifkan Mode Pengembang di PC.

  1. Buka Pengaturan.
  2. Pilih Pembaruan dan Keamanan.
  3. Pilih Untuk pengembang.
  4. Aktifkan Mode Pengembang, baca penafian untuk pengaturan yang Anda pilih, lalu pilih Ya untuk menerima perubahan.

Menyebarkan aplikasi HoloLens melalui Wi-Fi atau USB

Opsi kompilasi

  1. Membuka proyek Anda di Visual Studio

  2. Klik menu drop-down Opsi Kompilasi lalu lakukan salah satu hal berikut ini:

    • Untuk proyek Unity, pilih Rilis atau Master
    • Untuk semua proyek lainnya, pilih Rilis

    Cuplikan layar memperlihatkan opsi kompilasi di Visual Studio

    Berikut adalah definisi untuk opsi kompilasi:

Konfigurasi Penjelasan
Debug Semua pengoptimalan nonaktif dan profiler diaktifkan. Digunakan untuk men-debug skrip.
Master Semua pengoptimalan diaktifkan dan profiler dinonaktifkan. Digunakan untuk mengirimkan aplikasi ke Store.
Rilis Semua pengoptimalan diaktifkan dan profiler diaktifkan. Digunakan untuk mengevaluasi performa aplikasi.

Konfigurasi build

  1. Pilih konfigurasi build berdasarkan perangkat Anda.

    Pilih opsi konfigurasi ARM atau ARM64

    Konfigurasi build ARM64 di Visual Studio

    Untuk mempelajari selengkapnya tentang konfigurasi build, lihat tabel "Jenis konfigurasi build" dalam dokumentasi Unity.

    Catatan

    Untuk penyebaran ke perangkat HoloLens 2, pilih arsitektur ARM64 atau ARM.

    Jika Anda tidak melihat Perangkat sebagai opsi target, Anda mungkin perlu mengubah proyek startup untuk solusi Visual Studio dari proyek IL2CPP ke proyek UWP. Untuk melakukan ini, di Penjelajah Solusi, klik kanan proyek Anda, lalu pilih Atur sebagai Proyek StartUp.

  2. Klik drop-down target penyebaran, lalu lakukan salah satu tindakan berikut:

    • Jika Anda membangun dan menyebarkan melalui Wi-Fi, pilih Komputer Jarak Jauh.

    Pilih

    • Jika Anda membangun dan menyebarkan melalui USB, pilih Perangkat.

    Pilih

Koneksi jarak jauh

Untuk mengatur koneksi jarak jauh Anda:

  1. Pada bilah menu, pilih Properti Properti > Proyek > Penelusuran Kesalahan Properti>.

    Catatan

    Untuk proyek C#, dialog akan muncul secara otomatis.

  2. Klik menu drop-down Debugger untuk meluncurkan lalu pilih Komputer Jarak Jauh.

  3. Di bidang Nama Komputer, masukkan alamat IP perangkat Anda.

    Dialog koneksi jarak jauh di Visual Studio

    • Anda dapat menemukan alamat IP di HoloLens Anda di bawah Pengaturan > Jaringan & Opsi Tingkat Lanjut Internet>.

    • Sebaiknya masukkan alamat IP Anda secara manual daripada bergantung pada fitur "Terdeteksi Otomatis".

  4. Setel Mode Autentikasi ke Universal (Protokol tidak terenkripsi).

  5. Bangun, sebarkan, dan debug aplikasi Anda berdasarkan kebutuhan Anda:

    • Untuk membuat, menyebarkan, dan memulai penelusuran kesalahan, pilih Debug > Mulai penelusuran kesalahan.

    • Untuk membangun dan menyebarkan tanpa penelusuran kesalahan, pilih Bangun > Solusi Sebarkan.

  6. Saat pertama kali menyebarkan aplikasi ke HoloLens dari PC, Anda akan dimintai PIN. Ikuti petunjuk Memasangkan perangkat Anda di bawah ini.

Catatan

Jika kesalahan yang tercantum di bawah ini terjadi ketika Anda mulai men-debug aplikasi UWP yang diinstal pada HoloLens 2, coba ganti nama paket Anda atau hapus instalan aplikasi UWP Anda.

"Tidak dapat memulai penelusuran kesalahan"
"Operasi tidak didukung. Kesalahan tidak diketahui: 0x80070057"

Menyebarkan aplikasi ke Emulator HoloLens (generasi ke-1)

  1. Pastikan Anda telah menginstal Emulator HoloLens.
  2. Pilih konfigurasi build x86 untuk aplikasi Anda. Pilih konfigurasi build x86 di Visual Studio
  3. Pilih Emulator HoloLens di target emulator menu
    drop-down target penyebarandi Visual Studio
  4. Pilih Debug > Mulai penelusuran kesalahan untuk menyebarkan aplikasi Anda dan mulai penelusuran kesalahan
    Mulai Tanpa Debugging di Visual Studio

Menyebarkan aplikasi ke Emulator HoloLens 2

  1. Pastikan Anda telah menginstal Emulator HoloLens.
  2. Pilih konfigurasi build x86 atau x64 untuk aplikasi Anda.
    Konfigurasi pengaturan build x86 di Visual Studio
  3. Pilih HoloLens 2 Emulator di target
    drop-down target penyebaranTarget emulator di aplikasi Visual Studio
  4. Pilih Debug > Mulai penelusuran kesalahan untuk menyebarkan aplikasi Anda dan mulai penelusuran kesalahan
    Mulai Tanpa Debugging di Visual Studio

Menyebarkan aplikasi VR ke PC Lokal Anda

Untuk menggunakan headset imersif Windows Mixed Reality yang terhubung ke PC atau simulator Mixed Reality:

  1. Pilih konfigurasi build x86 atau x64 untuk aplikasi Anda
  2. Pilih Komputer Lokal di menu drop-down target penyebaran
  3. Membangun, menyebarkan, dan men-debug aplikasi Anda berdasarkan kebutuhan Anda
    • Pilih Debug > Mulai penelusuran kesalahan untuk menyebarkan aplikasi Anda dan mulai penelusuran kesalahan
    • Pilih Build > Deploy untuk membangun dan menyebarkan tanpa penelusuran kesalahan

Memasangkan perangkat

Saat pertama kali menyebarkan aplikasi dari Visual Studio ke HoloLens, Anda akan dimintai PIN. Di HoloLens, buat PIN dengan meluncurkan aplikasi Pengaturan, buka Perbarui > Untuk Pengembang, dan ketuk Pasangkan. Saat PIN ditampilkan di HoloLens Anda, ketikkan ke Visual Studio. Setelah pemasangan selesai, ketuk Selesai di HoloLens Anda untuk menutup dialog. PC ini sekarang dipasangkan dengan HoloLens dan Anda dapat menyebarkan aplikasi secara otomatis. Ulangi langkah-langkah ini pada setiap PC yang digunakan untuk menyebarkan aplikasi ke HoloLens Anda.

Untuk melepas pemasangan HoloLens Anda dari semua komputer yang dipasangkan:

  • Luncurkan aplikasi Pengaturan , buka Perbarui > Untuk Pengembang, dan ketuk Hapus.

Debugger Grafis untuk HoloLens (generasi ke-1)

Alat Diagnostik Grafis Visual Studio sangat membantu saat menulis dan mengoptimalkan aplikasi Holografik. Lihat Diagnostik Grafis Visual Studio di MSDN untuk detail selengkapnya.

Untuk Memulai Debugger Grafis

  1. Ikuti petunjuk di atas untuk menargetkan perangkat atau emulator
  2. Buka Diagnostik Mulai Grafik > Debug >
  3. Pertama kali Anda memulai diagnostik dengan HoloLens, Anda mungkin mendapatkan kesalahan "akses ditolak". Reboot HoloLens Anda agar izin yang diperbarui berlaku, lalu coba lagi.

Pembuatan Profil

Alat pembuatan profil Visual Studio memungkinkan Anda menganalisis performa dan penggunaan sumber daya aplikasi Anda. Ini termasuk alat untuk mengoptimalkan CPU, memori, grafis, dan penggunaan jaringan. Lihat Menjalankan alat diagnostik tanpa penelusuran kesalahan di MSDN untuk detail selengkapnya.

Untuk Memulai Alat Pembuatan Profil dengan HoloLens

  1. Ikuti petunjuk di atas untuk menargetkan perangkat atau emulator
  2. Buka Debug > Mulai Alat Diagnostik Tanpa Penelusuran Kesalahan...
  3. Pilih alat yang ingin Anda gunakan
  4. Pilih Mulai
  5. Pertama kali Anda memulai diagnostik tanpa penelusuran kesalahan dengan HoloLens, Anda mungkin mendapatkan kesalahan "akses ditolak". Reboot HoloLens Anda agar izin yang diperbarui berlaku, lalu coba lagi.

Men-debug aplikasi yang terinstal atau berjalan

Anda dapat menggunakan Visual Studio untuk men-debug aplikasi Universal Windows yang diinstal tanpa menyebarkan dari proyek Visual Studio. Ini berguna jika Anda ingin men-debug paket aplikasi yang diinstal atau men-debug aplikasi yang sudah berjalan.

  1. Buka Debug -> Target Debug Lainnya -> Debug Paket Aplikasi terinstal
  2. Pilih target Komputer Jarak Jauh untuk HoloLens atau Komputer Lokal untuk headset imersif.
  3. Masukkan alamat IP perangkat Anda
  4. Pilih Mode Autentikasi Universal
  5. Jendela menunjukkan aplikasi yang berjalan dan tidak aktif. Pilih salah satu yang ingin Anda debug.
  6. Pilih jenis kode yang akan di-debug (Terkelola, Asli, Campuran)
  7. Pilih Lampirkan atau Mulai

Titik Pemeriksaan Pengembangan Berikutnya

Jika Anda mengikuti perjalanan titik pemeriksaan pengembangan Unity yang telah kami susun, Anda berada di tengah-tengah tahap penyebaran. Dari sini, Anda dapat melanjutkan ke topik berikutnya:

Menyebarkan ke emulator HoloLens

Atau lompat langsung ke penambahan layanan tingkat lanjut:

Layanan tingkat lanjut

Anda selalu dapat kembali ke titik pemeriksaan pengembangan Unity kapan saja.

Lihat juga