Dağıtmak ve hata ayıklamak için Visual Studio kullanma
Karma gerçeklik uygulamanızı geliştirmek için DirectX veya Unity kullanıyor olun, Visual Studio hata ayıklama ve dağıtım için tercih ettiğiniz araçtır. Bu bölümde şunların nasıl yapılacağını öğreneceksiniz:
- uygulamaları Visual Studio aracılığıyla HoloLens veya Windows Mixed Reality çevreleyici başlığınıza dağıtın.
- Visual Studio yerleşik HoloLens öykünücüsü kullanın.
- Karma gerçeklik uygulamalarında hata ayıklama.
Önkoşullar
- Yükleme yönergeleri için bkz . Araçları Yükleme .
- Unity veya Visual Studio'da yeni bir karma gerçeklik projesi oluşturun.
- Unity projenizi yönergelerimize göre oluşturun
Geliştirici Modunu Etkinleştirme
Visual Studio bağlanabilmesi için cihazınızda Geliştirici Modu'nu etkinleştirerek başlayın.
HoloLens'da geliştirici modu
- HoloLens açın ve cihazı takın.
- Ana menüyü başlatmak için başlangıç hareketini kullanın.
- Uygulamayı ortamınızda başlatmak için Ayarlar kutucuğunu seçin.
- Güncelleştir menü öğesini seçin.
- Geliştiriciler için menü öğesini seçin.
- uygulamaları Visual Studio'dan HoloLens dağıtmak için geliştirici özelliklerini kullan'ı etkinleştirin. Cihazınız Holographic sürüm 21H1 veya daha yeni Windows çalıştırıyorsa Cihaz bulma özelliğini de etkinleştirin.
- İsteğe bağlı: Ekranı aşağı kaydırın ve HoloLens bir web tarayıcısından Windows Cihaz Portalı'na bağlanmanızı sağlayan Cihaz Portalı'nı etkinleştirin.
Windows bilgisayarda geliştirici modu
Bilgisayarınıza bağlı bir Windows Mixed Reality mikrofonlu kulaklığıyla çalışıyorsanız, bilgisayarda Geliştirici Modu'nu etkinleştirmeniz gerekir.
- Ayarlar'a gidin.
- Güncelleştir ve Güvenlik'i seçin.
- Geliştiriciler için'i seçin.
- Geliştirici Modu'nu etkinleştirin, seçtiğiniz ayarın bildirimini okuyun ve ardından değişikliği kabul etmek için Evet'i seçin.
Wi-Fi veya USB üzerinden HoloLens uygulaması dağıtma
Derleme seçenekleri
Projenizi Visual Studio'de açma
Derleme Seçenekleri açılan listesini tıklatın ve aşağıdakilerden birini yapın:
- Unity projeleri için Yayın veya AnaŞablon'u seçin
- Diğer tüm projeler için Yayın'ı seçin
Derleme seçeneklerinin tanımları şunlardır:
| Yapılandırma | Açıklama |
|---|---|
| Hata Ayıklama | Tüm iyileştirmeler kapalıdır ve profil oluşturucu etkindir. Betiklerde hata ayıklamak için kullanılır. |
| Ana | Tüm iyileştirmeler açılır ve profil oluşturucu devre dışı bırakılır. Mağaza'ya uygulama göndermek için kullanılır. |
| Yayınla | Tüm iyileştirmeler açılır ve profil oluşturucu etkinleştirilir. Uygulama performansını değerlendirmek için kullanılır. |
Yapı yapılandırması
Cihazınıza göre derleme yapılandırmanızı seçin.
ARM veya ARM64 yapılandırma seçeneğini belirleyin
Derleme yapılandırmaları hakkında daha fazla bilgi edinmek için Unity belgelerindeki "Derleme yapılandırma türleri" tablosuna bakın.
Not
HoloLens için genellikle ARM mimarisi için derleme yaparsınız. Ancak Unity 2019.3'te Visual Studio'de derleme mimarisi olarak ARM seçildiğinde hatalara neden olan bilinen bir sorun vardır. Önerilen geçici çözüm ARM64 için derlemektir. Bu bir seçenek değilse Unity projenizde Unity derlemenizi oluşturmadan önce şu adımı izleyin: Düzenle>Project Ayarlar>Player>Diğer Ayarlar gidin ve Grafik İşleri'ni devre dışı bırakın.
Hedef olarak Cihaz seçeneğini görmüyorsanız, Visual Studio çözümü için başlangıç projesini IL2CPP projesinden UWP projesine değiştirmeniz gerekebilir. Bunu yapmak için, Çözüm Gezgini projenize sağ tıklayın ve başlangıç Project olarak ayarla'yı seçin.
Dağıtım hedefi açılan listesini tıklatın ve aşağıdakilerden birini yapın:
- Wi-Fi üzerinden oluşturup dağıtıyorsanız Uzak Makine'yi seçin.
- USB aracılığıyla oluşturup dağıtıyorsanız Cihaz'ı seçin.
Uzak bağlantı
Uzak bağlantınızı ayarlamak için:
Menü çubuğunda Project > Özellikler > Yapılandırma Özellikleri > Hata Ayıklama'yı seçin.
Not
C# projesi için otomatik olarak bir iletişim kutusu görüntülenmelidir.
Hata Ayıklayıcı'ya tıklayarak açılan listeyi başlatın ve Uzak Makine'yi seçin.
Makine Adı alanına cihazınızın IP adresini girin.
IP adresini HoloLens Ayarlar Ağ & İnterneti > Gelişmiş Seçenekleri altında >bulabilirsiniz.
"Otomatik Algılandı" özelliğine bağlı olarak değil IP adresinizi el ile girmenizi öneririz.
Kimlik Doğrulama Modu'nuEvrensel (Şifrelenmemiş protokol) olarak ayarlayın.
Gereksinimlerinize göre uygulamanızı derleyin, dağıtın ve hatalarını ayıklar:
Derlemek, dağıtmak ve hata ayıklamayı başlatmak için Hata Ayıklamayı > Başlat hata ayıklamayı seçin.
Hata ayıklama olmadan derlemek ve dağıtmak için Çözümü Dağıt'ı >seçin.
HoloLens bilgisayarınızdan ilk kez bir uygulama dağıttığınızda sizden PIN istenir. Aşağıdaki Cihazınızı eşleştirme yönergelerini izleyin.
Uygulamayı HoloLens (1. nesil) Emulator dağıtma
- HoloLens Emulator yüklediğinizden emin olun.
- Uygulamanız için bir x86 derleme yapılandırması seçin.
- Dağıtım hedefi açılan menüsünden HoloLens Emulator seçin
- Hata Ayıklama Hata Ayıklama > Uygulamanızı dağıtmak ve hata ayıklamayı başlatmak için Hata ayıklamayı başlat'ı seçin
Bir uygulamayı HoloLens 2 Emulator dağıtma
- HoloLens Emulator yüklediğinizden emin olun.
- Uygulamanız için bir x86 veya x64 derleme yapılandırması seçin.
- Dağıtım hedefi açılan menüsünde HoloLens 2 Emulator seçin
- Hata Ayıklama Hata Ayıklama > Uygulamanızı dağıtmak ve hata ayıklamayı başlatmak için Hata ayıklamayı başlat'ı seçin
Yerel bilgisayarınıza VR uygulaması dağıtma
Bilgisayarınıza veya Karma Gerçeklik simülatörüne bağlanan Windows Mixed Reality çevreleyici bir kulaklık kullanmak için:
- Uygulamanız için bir x86 veya x64 derleme yapılandırması seçin
- Dağıtım hedefi açılan menüsünde Yerel Makine'yi seçin
- Gereksinimlerinize göre uygulamanızı oluşturma, dağıtma ve hatalarını ayıklama
- Hata Ayıklama Hata Ayıklama > Uygulamanızı dağıtmak ve hata ayıklamayı başlatmak için Hata ayıklamayı başlat'ı seçin
- Hata ayıklama olmadan derlemek ve dağıtmak için Derle > Dağıt'ı seçin
Cihazınızı eşleştirme
bir uygulamayı Visual Studio HoloLens ilk kez dağıttığınızda bir PIN girmeniz istenir. HoloLens Ayarlar uygulamasını başlatarak bir PIN oluşturun, Geliştiriciler için Güncelleştir'e >gidin ve Eşleştir'e dokunun. PIN, HoloLens görüntülendiğinde Visual Studio yazın. Eşleştirme tamamlandıktan sonra, iletişim kutusunu kapatmak için HoloLens Bitti'ye dokunun. Bu bilgisayar artık HoloLens ile eşleştirilir ve uygulamaları otomatik olarak dağıtabilirsiniz. Uygulamaları HoloLens dağıtmak için kullanılan her bilgisayar için bu adımları yineleyin.
Eşleştirilmiş tüm bilgisayarlardan HoloLens eşleşmesini kaldırmak için:
- Ayarlar uygulamasını başlatın, Geliştiriciler için Güncelleştir'e >gidin ve Temizle'ye dokunun.
HoloLens için Grafik Hata Ayıklayıcısı (1. nesil)
Visual Studio Grafik Tanılama araçları, Holographic uygulaması yazarken ve iyileştirirken yararlıdır. Tüm ayrıntılar için bkz. MSDN'de Grafik Tanılama Visual Studio.
Grafik Hata Ayıklayıcısını Başlatmak için
- Bir cihazı veya öykünücüyü hedeflemek için yukarıdaki yönergeleri izleyin
- Hata Ayıklama > Grafikleri > Tanılamayı Başlat'a gidin
- Tanılamayı bir HoloLens ilk kez başlattığınızda "erişim reddedildi" hatası alabilirsiniz. Güncelleştirilmiş izinlerin etkili olması için HoloLens yeniden başlatın ve yeniden deneyin.
Profil Oluşturma
Visual Studio profil oluşturma araçları, uygulamanızın performansını ve kaynak kullanımını analiz etmenizi sağlar. Buna CPU, bellek, grafik ve ağ kullanımını iyileştirmeye yönelik araçlar da dahildir. Tüm ayrıntılar için bkz. MSDN'de hata ayıklama olmadan tanılama araçlarını çalıştırma .
profil oluşturma araçlarını HoloLens ile başlatmak için
- Bir cihazı veya öykünücüyü hedeflemek için yukarıdaki yönergeleri izleyin
- Hata Ayıklama Hata Ayıklama > Olmadan Tanılama Araçlarını Başlat'a gidin...
- Kullanmak istediğiniz araçları seçin
- Başlangıç'ı seçin
- bir HoloLens ile hata ayıklamadan tanılamayı ilk kez başlattığınızda, "erişim reddedildi" hatası alabilirsiniz. Güncelleştirilmiş izinlerin etkili olması için HoloLens yeniden başlatın ve yeniden deneyin.
Yüklü veya çalışan bir uygulamada hata ayıklama
Visual Studio projesinden dağıtmadan yüklü bir Evrensel Windows uygulamasında hata ayıklamak için Visual Studio kullanabilirsiniz. Yüklü bir uygulama paketinde hata ayıklamak veya zaten çalışmakta olan bir uygulamada hata ayıklamak istiyorsanız bu yararlı olur.
- Hata Ayıklama -> Diğer Hata Ayıklama Hedefleri -> Yüklü Uygulama Paketinde Hata Ayıklama'ya gidin
- HoloLens için Uzak Makine hedefini veya çevreleyici başlıklar için Yerel Makine'yi seçin.
- Cihazınızın IP adresini girin
- Evrensel Kimlik Doğrulama Modu'nu seçin
- Pencerede hem çalışan hem de etkin olmayan uygulamalar gösterilir. Hata ayıklamak istediğiniz şeyi seçin.
- Hata ayıklamak için kod türünü seçin (Yönetilen, Yerel, Karma)
- Ekle veya Başlat'ı seçin
Sonraki Geliştirme Denetim Noktası
Yerleştirdiğimiz Unity geliştirme denetim noktası yolculuğunu takip ediyorsanız dağıtım aşamasının ortasındasınız demektir. Buradan bir sonraki konuya devam edebilirsiniz:
Veya doğrudan gelişmiş hizmetler eklemeye atlayın:
İstediğiniz zaman Unity geliştirme denetim noktalarına geri dönebilirsiniz.