Visual Studio'dan uzak makinelerde UWP uygulamalarında hata ayıklama

Bir Evrensel Windows Platformu (UWP) uygulamasını başka bir bilgisayarda veya cihazda çalıştırmak, hatalarını ayıklamak, profil oluşturmak ve test etmek için Visual Studio'yu kullanabilirsiniz. UWP uygulamasını uzak bir makinede çalıştırmak özellikle Visual Studio bilgisayarı dokunma, coğrafi konum veya fiziksel yönlendirme gibi UWP'ye özgü işlevleri desteklemediğinde yararlıdır.

Önkoşullar

Visual Studio'dan uzak bir cihazda UWP uygulamasında hata ayıklamak için:

• Visual Studio projesi uzaktan hata ayıklama için yapılandırılmalıdır.
• Uzak makine ve Visual Studio bilgisayarı bir ağ üzerinden veya doğrudan bir USB veya Ethernet kablosuyla bağlanmalıdır. Internet üzerinden hata ayıklama desteklenmez.
• Hem Visual Studio bilgisayarında hem de uzak makinede geliştirici modunu açmanız gerekir.
• Uzak bilgisayarlar Visual Studio için Uzak Araçlar çalıştırıyor olmalıdır.
  • Bazı Windows 10 ve sonraki sürümler, uzak araçları otomatik olarak başlatır ve çalıştırır. Aksi takdirde, Visual Studio için Uzak Araçlar yükleyin ve çalıştırın.
  • Windows Mobile 10 cihazları, uzak araçları gerektirmez veya desteklemez.

Visual Studio projesini uzaktan hata ayıklama için yapılandırma

Bağlanılacak uzak cihazı belirtmek için proje Özelliklerini kullanırsınız. Ayarlar, programlama diline bağlı olarak değişir.

Uzaktan hata ayıklama için C# veya Visual Basic projesi yapılandırma

1. Visual Studio Çözüm Gezgini'nde C# veya Visual Basic projesini seçin ve Özellikler simgesini seçin, Alt+Enter tuşuna basın veya sağ tıklayıp Özellikler'i seçin.

2. Hata Ayıkla sekmesini seçin.

3. Hedef cihaz'ın altında uzak bilgisayar için Uzak Makine'yi veya doğrudan bağlı bir Windows Mobile 10 cihazı için Cihaz'ı seçin.

4. Uzak makine için Uzak makine alanına ağ adını veya IP adresini girin veya Uzak Bağlantılar iletişim kutusunda cihazı aramak için Bul'u seçin.

   

Uzaktan hata ayıklama için C++ projesi yapılandırma

1. Visual Studio Çözüm Gezgini'nde C++ projesini seçin ve Özellikler simgesini seçin, Alt+Enter tuşuna basın veya sağ tıklayıp Özellikler'i seçin.

2. Hata Ayıklama sekmesini seçin.

3. Başlatacak hata ayıklayıcısı'nın altında, uzak bir bilgisayar için Uzak Makine'yi veya doğrudan bağlı bir Windows Mobile 10 cihazı için Cihaz'ı seçin.

4. Uzak makine için, Makine Adı alanına ağ adını veya IP adresini girin veya seçin ya da Uzak Bağlantılar iletişim kutusunda cihazı aramak için bul'u seçin.

   

Uzak Bağlantılar iletişim kutusunu kullanma

Uzak Bağlantılar iletişim kutusunda, belirli bir uzak bilgisayar adını veya IP adresini arayabilir veya yuvarlatılmış ok yenileme simgesini seçerek bağlantıları otomatik olarak algılayabilirsiniz. İletişim kutusu yalnızca yerel alt ağda bulunan ve şu anda uzak hata ayıklayıcısını çalıştıran cihazları arar. Uzak Bağlantılar iletişim kutusunda tüm cihazlar algılanamaz.

Visual Studio için Uzak Araçlar indirme ve yükleme

Visual Studio'nın uzak bilgisayardaki uygulamalarda hata ayıklaması için, uzak bilgisayarın Visual Studio için Uzak Araçlar çalıştırıyor olması gerekir.

• Windows Mobile 10 cihazları, uzak araçları gerektirmez veya desteklemez.
• Windows 11 bilgisayarları ve Creator's Update (sürüm 1703) ve üzerini çalıştıran Windows 10 bilgisayarlar, uygulamayı dağıttığınızda Windows 10 Xbox, IoT ve HoloLens cihazları uzak araçları otomatik olarak yükler.
• Creator's Update Windows 10 bilgisayarlarında, hata ayıklamaya başlamadan önce uzak araçları el ile indirmeniz, yüklemeniz ve uzak bilgisayarda çalıştırmanız gerekir.

Uzak araçları indirmek ve yüklemek için:

Visual Studio makinesi yerine hata ayıklamak istediğiniz uzak cihazda veya sunucuda, aşağıdaki tablodaki bağlantılardan uzak araçların doğru sürümünü indirin ve yükleyin.

• Visual Studio sürümünüz için uzak araçların en son güncelleştirmesini indirin. Önceki uzak araçlar sürümleri, sonraki Visual Studio sürümleriyle uyumlu değildir. (Örneğin, Visual Studio 2019 kullanıyorsanız Visual Studio 2019 için uzak araçların en son güncelleştirmesini indirin. Bu senaryoda Visual Studio 2022 için uzak araçları indirmeyin.)
• Yüklemekte olduğunuz makineyle aynı mimariye sahip uzak araçları indirin. Örneğin, x64 işletim sistemi çalıştıran uzak bir bilgisayarda x86 uygulamalarında hata ayıklamak istiyorsanız, x64 uzak araçlarını yükleyin. ARM64 işletim sisteminde x86, ARM veya x64 uygulamalarında hata ayıklamak için ARM64 uzak araçlarını yükleyin.

Uzak araçları yüklemek yerine uzak bilgisayara msvsmon.exe kopyalayarak uzak hata ayıklayıcısını çalıştırabilirsiniz. Ancak, Uzak Hata Ayıklayıcı Yapılandırma Sihirbazı (rdbgwiz.exe) yalnızca uzak araçları yüklediğinizde kullanılabilir. Uzaktan hata ayıklayıcısını hizmet olarak çalıştırmak istiyorsanız yapılandırma için sihirbazı kullanmanız gerekebilir. Daha fazla bilgi için bkz . (İsteğe bağlı) Uzak hata ayıklayıcıyı hizmet olarak yapılandırma.

Uzak araçları yapılandırma

1. Uzak bilgisayarda, Başlat menüsünden Uzaktan Hata Ayıklayıcı'yı bulun ve başlatın.

   Uzak bilgisayarda yönetici izinleriniz yoksa, Uzak Hata Ayıklayıcı uygulamasına sağ tıklayın ve Yönetici olarak çalıştır'ı seçin. Aksi takdirde, normal bir şekilde başlatın.

   Yönetici olarak çalışan veya farklı bir kullanıcı hesabı (IIS gibi) altında çalışan bir işleme ekleme yapmayı planlıyorsanız, Uzaktan Hata Ayıklayıcı uygulamasına sağ tıklayın ve Yönetici olarak çalıştır'ı seçin. Daha fazla bilgi için bkz . Uzak hata ayıklayıcıyı yönetici olarak çalıştırma.

2. Uzak hata ayıklayıcıyı ilk kez başlattığınızda (veya yapılandırmadan önce), Uzaktan Hata Ayıklama Yapılandırma sihirbazı görüntülenir.

   Çoğu senaryoda, sihirbazın Windows Güvenlik Duvarını Yapılandır sayfasına gelene kadar İleri'yi seçin.

   

   

   Yalnızca Windows Server 2008 R2'de gerçekleşen Windows Web Hizmetleri API'si yüklü değilse Yükle düğmesini seçin.

3. Uzak araçları kullanmak istediğiniz en az bir ağ türü seçin. Bilgisayarlar bir etki alanı üzerinden bağlıysa, ilk öğeyi seçmeniz gerekir. Bilgisayarlar bir çalışma grubu veya ev grubu aracılığıyla bağlıysa, ikinci veya üçüncü öğeyi uygun şekilde seçin.

   Ardından, uzak hata ayıklayıcıyı başlatmak için Son'u seçin.

   Ardından, uzaktan hata ayıklayıcıyı başlatmak için Uzaktan hata ayıklamayı yapılandır'ı seçin.

4. Yapılandırma tamamlandığında, Uzak Hata Ayıklayıcı penceresi görüntülenir.

   

   

   Uzak hata ayıklayıcı şimdi bağlantı bekliyor. Visual Studio'da uzak bağlantı yapılandırmasını ayarlamak için gösterilen sunucu adını ve bağlantı noktası numarasını kullanın.

Uzak hata ayıklayıcıyı durdurmak için Dosyadan>Çık'ı seçin. Başlat menüsünden veya komut satırından yeniden başlatabilirsiniz:

<Remote debugger installation directory>\msvsmon.exe

UWP uygulamalarında uzaktan hata ayıklama

Uzaktan hata ayıklama, yerel hata ayıklamayla aynı şekilde çalışır.

1. Windows 10'un Creator's Update öncesi sürümlerinde, uzak cihazda Uzaktan Hata Ayıklama İzleyicisi'nin (msvsmon.exe) çalıştığından emin olun.

2. Visual Studio bilgisayarında, araç çubuğundaki yeşil okun yanında doğru hata ayıklama hedefinin (Uzak Makine veya Cihaz) göründüğünden emin olun.

3. Hata Ayıklamayı Başlat Hata Ayıklama'yı seçerek, F5'e basarak veya araç çubuğundaki yeşil oku seçerek hata ayıklamaya başlayın.>

   Proje yeniden derlenip dağıtılır ve uzak cihazda başlatılır. Hata ayıklayıcısı kesme noktalarında yürütmeyi askıya alır ve kodun içine, üzerine ve dışına adım atabilirsiniz.

4. Gerekirse Hata Ayıklamayı Durdur Hata Ayıklama'yı> seçin veya shift F5 tuşuna+basarak hata ayıklamayı durdurun ve uzak uygulamayı kapatın.

İlgili içerik

• Gelişmiş uzak dağıtım seçenekleri
• Visual Studio ile UWP uygulamalarını test etme
• Visual Studio’da UWP uygulamalarının hatalarını ayıklama