Visual Studio'da Uzaktan C++ Projesi 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, project Visual Studio uzak bilgisayara bağlanacak şekilde yapılandırın ve ardından uygulamanızı dağıtıp çalıştırın.

Uzak hata ayıklayıcısı bileşenleriRemote_debugger_components

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 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, Program Files (x86)\Microsoft Visual Studio<version>\Common7\IDE\Remote Debugger\x64 altında bulunabilir.

Sürüm	Bağlantı	Notlar
Visual Studio 2026	uzaktan araçlar	Visual Studio 2022 ve sonraki sürümlerle 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 2022	uzaktan araçlar	Visual Studio 2022 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 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'dan 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 belgelerindeki indirme sayfası
Visual Studio 2012	uzaktan araçlar	Visual Studio 2012 belgelerindeki 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 sonraki uygulamalarda hata ayıklamak için, uzak araçların en son sürümüyle kullanılabilen ARM64'i kullanın.
• Windows RT cihazlardaki Windows 10 uygulamalarda hata ayıklamak için, yalnızca Visual Studio 2015 uzak araçlarını indirmede 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 Uzaktan hata ayıklamayı yapılandır'ı 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ı penceresiuzak hata ayıklayıcısı penceresinin ekran görüntüsü

   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, project yolu C:\remotetemp 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 bir kesme noktası ayarlayın.

3. Solution Explorer'da project sağ tıklayın ve Properties öğ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ı	Windows Kimlik Doğrulama ile Uzaktan Erişim
   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 bkz. C++ Hata Ayıklama yapılandırması için Project ayarları.

6. Solution Explorer'da, çö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.

   Visual Studio Solution Explorer'da yer alan Configuration Manager'ın ekran görüntüsü. Debug (Hata Ayıklama) yapılandırması seçili ve Dağıt seçeneği işaretlidir.

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\ gibi geçerli bir kullanıcı hesabı adını ve doğru parolayı girebilirsiniz.

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

    Bahşiş

    Alternatif olarak, dosyaları ayrı bir adım olarak dağıtabilirsiniz. Solution Explorer, project düğümüne sağ tıklayın ve Deploy öğesini 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ı project ekleyebilir ve Content özelliğini her dosyanın Properties sayfasında Yes 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 bilgisayarda 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çlarSeçenekleri bölmesini açın, Tüm AyarlarHata AyıklamaGenelSimgeler 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 Bir IIS Bilgisayarında ASP.NET Uzaktan Hata Ayıklama
• Uzaktan Hata Ayıklama ve Sorun Giderme