Visual Studio'da C++ Projesinde Uzaktan Hata Ayıklama

Farklı bir bilgisayardaki Visual Studio uygulamasında hata ayıklamak için, uygulamanızı dağıttığınız bilgisayara uzak araçları yükleyip çalıştırın, projenizi Visual Studio'dan uzak bilgisayara bağlanacak şekilde yapılandırın ve ardından uygulamanızı dağıtıp çalıştırın.

Evrensel Windows Uygulamalarında (UWP) uzaktan hata ayıklama hakkında bilgi için bkz. Yüklü Uygulama Paketihatalarını ayıklama.

Gereksinimler

Uzaktan hata ayıklayıcı, Windows Server 2008 Service Pack 2'den başlayarak Windows Server'ın Windows 7 ve daha yeni ve sürümlerinde desteklenir. Gereksinimlerin tam listesi için bkz. Gereksinimler.

Not

Ara sunucu aracılığıyla bağlanan iki bilgisayar arasında hata ayıklama desteklenmez. Arama İnterneti gibi yüksek gecikme süresi veya düşük bant genişliğine sahip bir bağlantı üzerinden veya ülkeler/bölgeler arasında İnternet üzerinden hata ayıklama önerilmez ve başarısız olabilir veya kabul edilemez düzeyde yavaş olabilir.

Uzak araçları indirme ve yükleme

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. Visual Studio 2022 ve 2026 için uzak araçlar, Visual Studio'nun iki sürümüyle de kullanılabilir. Ancak, Visual Studio 2022'den ö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, 64 bit işletim sistemi çalıştıran uzak bir bilgisayarda 32 bitlik bir uygulamada hata ayıklamak istiyorsanız, 64 bit uzak araçları yükleyin.
• ARM64 cihazındaki bir ARM64EC uygulamasında uzaktan hata ayıklıyorsanız ARM64 uzak araçlarını yükleyin ve ardından bu araçlarla yüklenen x64 uzak hata ayıklayıcısını başlatın. Bu, altında bulunabilir: Program Files (x86)\Microsoft Visual Studio<sürüm>\Common7\IDE\Remote Debugger\x64.

Sürüm	Bağlantı	Notlar
Visual Studio 2022	uzaktan araçlar	Tüm Visual Studio 2022 sürümleriyle uyumludur. Cihazınızın işletim sistemiyle eşleşen sürümü indirin (x86, x64 (AMD64) veya ARM64). Windows Server’ın daha eski sürümlerinde, uzak araçları indirme konusunda yardım için, dosya indirme engellemesini kaldırma (),’e bakın.
Visual Studio 2019	uzaktan araçlar	Visual Studio 2019 için uzak araçlar My.VisualStudio.com'den edinilebilir. İstenirse ücretsiz Visual Studio Dev Essentials programına katılın veya Visual Studio abonelik kimliğiniz ile oturum açın. Cihazınızın işletim sistemiyle eşleşen sürümü indirin (x86, x64 (AMD64) veya ARM64). Windows Server’ın daha eski sürümlerinde, uzak araçları indirme konusunda yardım için, dosya indirme engellemesini kaldırma (),’e bakın.
Visual Studio 2017	uzaktan araçlar	Visual Studio 2017 için uzak araçlar My.VisualStudio.com'den edinilebilir. İstenirse ücretsiz Visual Studio Dev Essentials programına katılın veya Visual Studio abonelik kimliğiniz ile oturum açın. Cihazınızın işletim sistemiyle eşleşen sürümü indirin (x86, x64 (AMD64) veya ARM64). Windows Server'da uzaktan bağlantı araçlarını indirmek için yardım gerekiyorsa, dosya indirmenin engelini kaldırma 'a ve'e bakın.
Visual Studio 2015	uzaktan araçlar	Visual Studio 2015 için uzak araçlar My.VisualStudio.com'den edinilebilir. İstenirse ücretsiz Visual Studio Dev Essentials programına katılın veya Visual Studio abonelik kimliğiniz ile oturum açın. Windows Server'da uzaktan bağlantı araçlarını indirmek için yardım gerekiyorsa, dosya indirmenin engelini kaldırma 'a ve'e bakın.
Visual Studio 2013	uzaktan araçlar	Visual Studio 2013 belgelerinde indirme sayfası
Visual Studio 2012	uzaktan araçlar	Visual Studio 2012 belgelerinde indirme sayfası

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.

Not

• ARM cihazlarında Windows 10 veya üzeri uygulamalarda hata ayıklamak için, uzak araçların en son sürümüyle kullanılabilen ARM64'i kullanın.
• Windows RT cihazlarında Windows 10 uygulamalarında hata ayıklamak için, yalnızca Visual Studio 2015 uzak araçları indirmesinde kullanılabilen ARM'yi kullanın.

Bahşiş

Bazı senaryolarda, uzak hata ayıklayıcıyı bir dosya paylaşımından çalıştırmak en verimli yöntem olabilir. Daha fazla bilgi için bkz. Bir dosya paylaşımından uzak hata ayıklayıcı çalıştırma.

Uzak hata ayıklayıcıyı ayarlama

Uzak hata ayıklayıcısını yükledikten sonra aşağıdaki adımları izleyin.

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

   Uzak bilgisayarda yönetici izinleriniz yoksa, Uzaktan Hata Ayıklayıcısı 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. Uzaktan hata ayıklayıcıyı ilk kez başlattığınızda (veya yapılandırmadan önce), Uzaktan Hata Ayıklama Yapılandırması sihirbazı görüntülenir.

   Çoğu senaryoda, sihirbazın Windows Güvenlik Duvarı'nı yapılandırma sayfasına gelene kadar sonraki seçin.

   Uzaktan hata ayıklayıcı yapılandırmasının ekran görüntüsü. Uzaktan Hata Ayıklayıcı yapılandırmasıRemote Debugger configuration

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, Bitiş'ni seçerek uzak hata ayıklayıcısını başlatın.

4. Yapılandırma tamamlandığında Uzaktan 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 Dosya>Çıkış’ı seçin. Başlat menüsünden veya komut satırından yeniden başlatabilirsiniz:

<Remote debugger installation directory>\msvsmon.exe

Not

Daha fazla kullanıcı için izin eklemeniz, kimlik doğrulama modunu veya uzak hata ayıklayıcının bağlantı noktası numarasını değiştirmeniz gerekiyorsa bkz. Uzak hata ayıklayıcıyı yapılandırma.

C++ projesinde uzaktan hata ayıklama

Aşağıdaki yordamda projenin yolu C:\remotetemp olarak belirtilmiştir ve uzak bilgisayarın adı MySurfaceşeklindedir.

1. CppConsoleApp adlı bir C++ Konsol uygulaması oluşturma

2. Uygulamanın kolayca ulaşılan bir yerine, örneğin işlevindeki mainbir kesme noktası ayarlayın.

3. Çözüm Gezgini'nde projeye sağ tıklayın ve Özellikleröğesini seçin. hata ayıklama sekmesini açın.

4. başlatmak için Hata Ayıklayıcısı'nı Uzak Windows Hata Ayıklayıcısı olarak ayarlayın.

   

5. Özelliklerde aşağıdaki değişiklikleri yapın:

   Ayarlar	Değer
   Uzak Komut	C:\remotetemp\CppConsoleApp.exe
   Çalışma Dizini	C:\remotetemp
   Uzak Sunucu Adı	MySurface:bağlantı noktası numarası
   Bağlantı	Uzak Bağlantı, Windows Kimlik Doğrulaması ile
   Hata Ayıklayıcı Türü	Yalnızca Yerel
   Dağıtım Dizini	C:\remotetemp
   Dağıtılacak Ek Dosyalar	$(ProjectDir)\data

   Başka klasörler dağıtırsanız ve bir klasördeki tüm dosyaların aynı klasöre dağıtılmasını istiyorsanız, bir klasör adı belirtin.

   Özellikler hakkında daha fazla bilgi için C++ Hata Ayıklama yapılandırması için Proje ayarlarına bakınız.

6. Çözüm Gezgini'nde, çözüme sağ tıklayın ve Configuration Manageröğesini seçin.

7. Hata Ayıklama yapılandırması için Dağıt onay kutusunu seçin.

   

8. Hata ayıklamayı başlatın (Hata Ayıklama > Hata Ayıklamayı başlatveya F5).

9. Yürütülebilir dosya otomatik olarak uzak bilgisayara dağıtılır.

10. İstenirse, uzak makineye bağlanmak için ağ kimlik bilgilerini girin.

    Gerekli kimlik bilgileri ağınızın güvenlik yapılandırmasına özeldir. Örneğin, bir etki alanı bilgisayarında bir güvenlik sertifikası seçebilir veya etki alanı adınızı ve parolanızı girebilirsiniz. Etki alanı olmayan bir makinede makine adını ve MySurface\name@something.com gibi geçerli bir kullanıcı hesabı adını ve doğru parolayı girebilirsiniz.

11. Visual Studio bilgisayarında yürütmenin kesme noktasında durdurulduğunu görmeniz gerekir.

    Bahşiş

    Alternatif olarak, dosyaları ayrı bir adım olarak dağıtabilirsiniz. Çözüm Gezgini'nde proje düğümüne sağ tıklayın ve Dağıt'ı seçin.

    Uygulamanın gerektirdiği kodsuz dosyalarınız varsa, Bunları, Uzak Windows Hata Ayıklayıcısı'nın seçili olduğu Hata Ayıklayıcı özellikleri sayfasındaki Dağıtılacak Ek Dosyalar'daki noktalı virgülle ayrılmış bir listede belirtebilirsiniz.

    Alternatif olarak, dosyaları projenize ekleyebilir ve İçerik özelliğini her dosyanın Özellikler sayfasında Evet olarak ayarlayabilirsiniz. Bu dosyalar, Uzak Windows Hata Ayıklayıcısı seçili olarak, Hata Ayıklayıcısı özellikleri sayfasında belirtilen Dağıtım Dizini'ne kopyalanır. Ayrıca, Dosyaların Dağıtım Dizini'nin bir alt klasörüne kopyalanması gerekiyorsa, Öğe TürünüDosya Kopyala olarak değiştirebilir ve orada diğer özellikleri belirtebilirsiniz.

Uzaktan Sembollerle Hata Ayıklamayı Yapılandırma

Visual Studio bilgisayarında oluşturduğunuz sembollerle kodunuzun hatalarını ayıklayabilmeniz gerekir. Yerel simgeleri kullandığınızda uzak hata ayıklayıcının performansı daha iyidir.

Uzak simgeler kullanmanız gerekiyorsa, simge arama yoluna bir Windows dosya paylaşımı ekleyerek Visual Studio'da uzak simgeleri belirtmeniz gerekir.

Araçlar>Seçenekleri bölmesini açın, Tüm Ayarlar>Hata Ayıklama>Genel>Simgeler> bölümünü genişletin ve Simge dosyası (.pdb) konumları listesini güncelleştirin. Diğer ayarları gerektiği gibi ayarlayın.

İlgili içerik

• Visual Studio 'da Hata Ayıklama
• Hata ayıklayıcıya ilk bakış
• Windows Güvenlik Duvarı'nı Uzaktan Hata Ayıklama için Yapılandırma
• Uzak Hata Ayıklayıcısı Bağlantı Noktası Atamaları
• Uzak IIS Bilgisayarında Uzaktan Hata Ayıklama ASP.NET
• Uzaktan Hata Ayıklama ve Sorun Giderme