Dağıtmak ve hata ayıklamak için Visual Studio kullanma

  • Makale

Karma gerçeklik uygulamanızı geliştirmek için DirectX veya Unity kullanıyor olun, hata ayıklama ve dağıtım için visual studio size özel bir araçtır. Bu bölümde şunların nasıl yapılacağını öğreneceksiniz:

  • Uygulamaları HoloLens'inize dağıtın veya Visual Studio aracılığıyla çevreleyici başlık Windows Mixed Reality.
  • Visual Studio'da yerleşik olarak bulunan HoloLens öykünücüsün kullanın.
  • Karma gerçeklik uygulamalarında hata ayıklama.

Önkoşullar

  1. Yükleme yönergeleri için bkz . Araçları Yükleme .
  2. Unity veya Visual Studio'da yeni bir karma gerçeklik projesi oluşturun.
  3. Unity projenizi yönergelerimize göre oluşturun

Geliştirici Modunu Etkinleştirme

Visual Studio'ya bağlanabilmek için cihazınızda Geliştirici Modu'nu etkinleştirerek başlayın.

HoloLens'te geliştirici modu

  1. HoloLens'inizi açın ve cihazı takın.
  2. Ana menüyü başlatmak için başlangıç hareketini kullanın.
  3. Uygulamayı ortamınızda başlatmak için Ayarlar kutucuğunu seçin.
  4. Güncelleştir menü öğesini seçin.
  5. Geliştiriciler için menü öğesini seçin.
  6. Visual Studio'dan HoloLens'inize uygulama dağıtmak için geliştirici özelliklerini kullan'ı etkinleştirin. Cihazınızda Windows Holographic sürüm 21H1 veya daha yeni bir sürüm çalışıyorsa Cihaz bulma özelliğini de etkinleştirin.
  7. İsteğe bağlı: Ekranı aşağı kaydırın ve HoloLens'inizdeki Windows Cihaz Portalı'na bir web tarayıcısından 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 bilgisayarınızda Geliştirici Modu'nu etkinleştirmeniz gerekir.

  1. Ayarlar'a gidin.
  2. Güncelleştir ve Güvenlik'i seçin.
  3. Geliştiriciler için'i seçin.
  4. 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.

HoloLens uygulamasını Wi-Fi veya USB üzerinden dağıtma

Derleme seçenekleri

  1. Projenizi Visual Studio'da açma

  2. 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

    Visual Studio'da derleme seçeneklerini gösteren ekran görüntüsü

    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ı

  1. Cihazınıza göre derleme yapılandırmanızı seçin.

    ARM veya ARM64 yapılandırma seçeneğini belirleyin

    Visual Studio'da ARM64 derleme yapılandırması

    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 2 cihaza dağıtım için ARM64 veya ARM mimarisini seçin.

    Hedef olarak Cihaz seçeneğini görmüyorsanız, Visual Studio çözümünün başlangıç projesini IL2CPP projesinden UWP projesine değiştirmeniz gerekebilir. Bunu yapmak için, Çözüm Gezgini projenize sağ tıklayın ve ardından Başlangıç Projesi Olarak Ayarla'yı seçin.

  2. 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.

    Visual Studio'da dağıtım hedefi olarak

    • USB aracılığıyla oluşturup dağıtıyorsanız Cihaz'ı seçin.

    Visual Studio'da dağıtım hedefi olarak

Uzak bağlantı

Uzak bağlantınızı ayarlamak için:

  1. Menü çubuğunda Proje > Özellikleri 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.

  2. Hata Ayıklayıcı'ya tıklayarak açılan listeyi başlatın ve Uzak Makine'yi seçin.

  3. Makine Adı alanına cihazınızın IP adresini girin.

    Visual Studio'da uzak bağlantı iletişim kutusu

    • IP adresini HoloLens'inizde Ayarlar > Ağ & İnternet > Gelişmiş Seçenekleri altında bulabilirsiniz.

    • "Otomatik Algılandı" özelliğine bağlı olarak değil IP adresinizi el ile girmenizi öneririz.

  4. Kimlik Doğrulama Modu'nuEvrensel (Şifrelenmemiş protokol) olarak ayarlayın.

  5. 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.

  6. HoloLens'inize bilgisayarınızdan ilk kez bir uygulama dağıttığınızda bir PIN girmeniz istenir. Aşağıdaki Cihazınızı eşleştirme yönergelerini izleyin.

Not

HoloLens 2 yüklü bir UWP uygulamasında hata ayıklamaya başladığınızda aşağıda listelenen hatalar oluşuyorsa paketinizi yeniden adlandırmayı veya UWP uygulamanızı kaldırmayı deneyin.

"Hata ayıklama başlatılamıyor"
"İşlem desteklenmiyor. Bilinmeyen hata: 0x80070057"

HoloLens (1. nesil) Öykünücüsü'ne uygulama dağıtma

  1. HoloLens Öykünücüsü'yü yüklediğinizden emin olun.
  2. Uygulamanız için bir x86 derleme yapılandırması seçin. Visual Studio'da x86 derleme yapılandırması seçme
  3. Visual Studio'da dağıtım hedefi açılan menüsünde
    HoloLensÖykünücüsü hedefini seçin
  4. Visual Studio'da uygulamanızı dağıtmak ve hata ayıklamaya
    başlamak için Hata >Ayıklama Hata Ayıklamayı Başlat'ı seçin.

HoloLens 2 Öykünücüsü'ne uygulama dağıtma

  1. HoloLens Öykünücüsü'yü yüklediğinizden emin olun.
  2. Uygulamanız için bir x86 veya x64 derleme yapılandırması seçin.
    Visual Studio'da x86 derleme ayarı yapılandırması
  3. Visual Studio uygulamasındaki dağıtım hedefi açılan menüsünde
    öykünücü hedefi HoloLens 2 Öykünücü'yü seçin
  4. Visual Studio'da uygulamanızı dağıtmak ve hata ayıklamaya
    başlamak için Hata >Ayıklama 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:

  1. Uygulamanız için bir x86 veya x64 derleme yapılandırması seçin
  2. Dağıtım hedefi açılan menüsünde Yerel Makine'yi seçin
  3. 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

Visual Studio'dan HoloLens'inize ilk kez uygulama dağıttığınızda bir PIN girmeniz istenir. HoloLens'te Ayarlar uygulamasını başlatarak bir PIN oluşturun, Geliştiriciler için Güncelleştir'e >gidin ve Eşleştir'e dokunun. HOLOLens'inizde PIN görüntülendiğinde, Pin'i Visual Studio'ya yazın. Eşleştirme tamamlandıktan sonra HoloLens'inizde Bitti'ye dokunarak iletişim kutusunu kapatın. Bu bilgisayar artık HoloLens ile eşleştirilir ve uygulamaları otomatik olarak dağıtabilirsiniz. HoloLens'inize uygulama dağıtmak için kullanılan her bilgisayar için bu adımları yineleyin.

Eşleştirilmiş tüm bilgisayarlardan HoloLens'inizin 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ı, holografik uygulama yazarken ve iyileştirirken yararlıdır. Tüm ayrıntılar için msdn'de Visual Studio Grafik Tanılama bölümüne bakın.

Grafik Hata Ayıklayıcısını Başlatmak için

  1. Bir cihazı veya öykünücüyü hedeflemek için yukarıdaki yönergeleri izleyin
  2. Hata Ayıklama > Grafikleri > Tanılamayı Başlat'a gidin
  3. HoloLens ile tanılamaya ilk kez başladığınızda "erişim reddedildi" hatası alabilirsiniz. Güncelleştirilmiş izinlerin etkili olması için HoloLens'inizi 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 .

HoloLens ile Profil Oluşturma Araçları'nı Başlatmak için

  1. Bir cihazı veya öykünücüyü hedeflemek için yukarıdaki yönergeleri izleyin
  2. Hata Ayıklama Hata Ayıklama > Olmadan Tanılama Araçlarını Başlat'a gidin...
  3. Kullanmak istediğiniz araçları seçin
  4. Başlangıç'ı seçin
  5. HoloLens ile hata ayıklamadan tanılamaya ilk kez başladığınızda "erişim reddedildi" hatası alabilirsiniz. Güncelleştirilmiş izinlerin etkili olması için HoloLens'inizi yeniden başlatın ve yeniden deneyin.

Yüklü veya çalışan bir uygulamada hata ayıklama

Visual Studio projesinden dağıtım yapmadan yüklü bir Evrensel Windows uygulamasında hata ayıklamak için Visual Studio'yu kullanabilirsiniz. Yüklü bir uygulama paketinde hata ayıklamak veya zaten çalışmakta olan bir uygulamada hata ayıklamak istiyorsanız bu yararlı olur.

  1. Hata Ayıklama -> Diğer Hata Ayıklama Hedefleri -> Yüklü Uygulama Paketinde Hata Ayıklama'ya gidin
  2. HoloLens için Uzak Makine hedefini veya çevreleyici başlıklar için Yerel Makine'yi seçin.
  3. Cihazınızın IP adresini girin
  4. Evrensel Kimlik Doğrulama Modu'nu seçin
  5. Pencerede hem çalışan hem de etkin olmayan uygulamalar gösterilir. Hata ayıklamak istediğiniz şeyi seçin.
  6. Hata ayıklamak için kod türünü seçin (Yönetilen, Yerel, Karma)
  7. 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:

HoloLens öykünücüsne dağıtma

Veya doğrudan gelişmiş hizmetler eklemeye atlayın:

Gelişmiş hizmetler

İstediğiniz zaman Unity geliştirme denetim noktalarına geri dönebilirsiniz.

Ayrıca bkz.