Penelusuran Kesalahan Jarak Jauh Project C++ di Visual Studio

Untuk men-debug aplikasi Visual Studio di komputer lain, pasang dan jalankan alat jarak jauh di komputer tempat Anda akan menyebarkan aplikasi, konfigurasikan proyek Anda untuk terhubung ke komputer jarak jauh dari Visual Studio, lalu sebarkan dan jalankan aplikasi Anda.

Untuk informasi tentang penelusuran kesalahan jarak jauh Aplikasi Universal Windows (UWP), lihat Men-debug Paket Aplikasi yang Terinstal.

Persyaratan

Debugger jarak jauh didukung pada Windows 7 dan yang lebih baru dan versi Windows Server yang dimulai dengan Windows Server 2008 Service Pack 2. Untuk daftar lengkap persyaratan, lihat Persyaratan.

Catatan

Penelusuran kesalahan antara dua komputer yang tersambung melalui proksi tidak didukung. Penelusuran kesalahan melalui latensi tinggi atau koneksi bandwidth rendah, seperti internet dialup, atau melalui Internet di seluruh negara/wilayah tidak disarankan dan mungkin gagal atau tidak dapat diterima lambat.

Mengunduh dan Memasang alat jarak jauh

Pada perangkat jarak jauh atau server yang ingin Anda debug, bukan komputer Visual Studio, unduh dan instal versi alat jarak jauh yang benar dari tautan dalam tabel berikut.

• Unduh alat jarak jauh terbaru untuk versi Visual Studio Anda. Versi alat jarak jauh terbaru kompatibel dengan versi Visual Studio yang lebih lama, tetapi versi alat jarak jauh yang lebih lama tidak kompatibel dengan versi Visual Studio yang lebih baru. (Misalnya, jika Anda menggunakan Visual Studio 2019, unduh pembaruan terbaru alat jarak jauh untuk Visual Studio 2019. Dalam skenario ini, jangan unduh alat jarak jauh untuk Visual Studio 2022.)
• Unduh alat jarak jauh dengan arsitektur yang sama dengan mesin tempat Anda menginstalnya. Misalnya, jika Anda ingin men-debug aplikasi 32-bit pada komputer jarak jauh yang menjalankan sistem operasi 64-bit, pasang alat jarak jauh 64-bit.
• Jika Anda menelusuri kesalahan jarak jauh pada aplikasi ARM64EC di perangkat ARM64, pasang alat jarak jauh ARM64, lalu luncurkan debugger jarak jauh x64 yang dipasang dengan alat tersebut. Ini dapat ditemukan di: Program Files (x86)\Microsoft Visual Studio<version>\Common7\IDE\Remote Debugger\x64.

Versi	Tautan	Catatan
Visual Studio 2022	Alat jarak jauh	Kompatibel dengan semua versi Visual Studio 2022. Unduh versi yang cocok dengan sistem operasi perangkat Anda (x86, x64, atau ARM64). Pada versi Windows Server yang lebih lama, lihat Membuka blokir unduhan file untuk membantu mengunduh alat jarak jauh.
Visual Studio 2019	Alat jarak jauh	Kompatibel dengan semua versi Visual Studio 2019. Unduh versi yang cocok dengan sistem operasi perangkat Anda (x86, x64, atau ARM64). Pada versi Windows Server yang lebih lama, lihat Membuka blokir unduhan file untuk membantu mengunduh alat jarak jauh.
Visual Studio 2017	Alat jarak jauh	Kompatibel dengan semua versi Visual Studio 2017. Unduh versi yang cocok dengan sistem operasi perangkat Anda (x86, x64, atau ARM64). Di server Windows, lihat Membuka blokir unduhan file untuk membantu mengunduh alat jarak jauh.
Visual Studio 2015	Alat jarak jauh	Alat jarak jauh untuk Visual Studio 2015 tersedia dari My.VisualStudio.com. Jika diminta, bergabunglah dengan program Visual Studio Dev Essentials gratis, atau masuk dengan ID langganan Visual Studio Anda. Di server Windows, lihat Membuka blokir unduhan file untuk membantu mengunduh alat jarak jauh.
Visual Studio 2013	Alat jarak jauh	Halaman unduhan di dokumentasi Visual Studio 2013
Visual Studio 2012	Alat jarak jauh	Halaman unduhan di dokumentasi Visual Studio 2012

Anda dapat menjalankan debugger jarak jauh dengan menyalin msvsmon.exe ke komputer jarak jauh, daripada menginstal alat jarak jauh. Namun, Wizard Konfigurasi Debugger Jarak Jauh (rdbgwiz.exe) hanya tersedia saat Anda menginstal alat jarak jauh. Anda mungkin perlu menggunakan wizard untuk konfigurasi jika Anda ingin menjalankan debugger jarak jauh sebagai layanan. Untuk informasi selengkapnya, lihat (Opsional) Mengonfigurasi debugger jarak jauh sebagai layanan.

Catatan

• Untuk men-debug aplikasi Windows 10 atau yang lebih baru di perangkat ARM, gunakan ARM64, yang tersedia dengan versi terbaru alat jarak jauh.
• Untuk men-debug aplikasi Windows 10 di perangkat Windows RT, gunakan ARM, yang hanya tersedia di unduhan alat jarak jauh Visual Studio 2015.

Tip

Dalam beberapa skenario, langkah yang paling efisien adalah menjalankan debugger jarak jauh dari berbagi. Untuk informasi selengkapnya, lihat Menjalankan debugger jarak jauh dari tempat berbagi.

Mengatur debugger jarak jauh

1. Di komputer jarak jauh, temukan dan mulai Debugger Jarak Jauh dari menu Mulai.

   Jika Anda tidak memiliki izin administratif di komputer jarak jauh, klik kanan aplikasi Debugger Jarak Jauh dan pilih Jalankan sebagai administrator. Jika tidak, mulai saja secara normal.

   Jika Anda berencana untuk melampirkan ke proses yang berjalan sebagai administrator, atau berjalan dengan akun pengguna lain (seperti IIS), klik kanan aplikasi Debugger Jarak Jauh dan pilih Jalankan sebagai administrator. Untuk informasi selengkapnya, lihat Menjalankan debugger jarak jauh sebagai administrator.

2. Pertama kali Anda memulai debugger jarak jauh (atau sebelum Anda mengonfigurasinya), wizard Konfigurasi Penelusuran Kesalahan Jarak Jauh muncul.

   Dalam sebagian besar skenario, pilih Berikutnya hingga Anda masuk ke halaman Konfigurasi Firewall Windows wizard.

   

3. Pilih setidaknya satu jenis jaringan tempat Anda ingin menggunakan alat jarak jauh. Jika komputer tersambung melalui domain, Anda harus memilih item pertama. Jika komputer tersambung melalui grup kerja atau grup rumah, pilih item kedua atau ketiga yang sesuai.

   Selanjutnya, pilih Selesai untuk memulai debugger jarak jauh.

4. Ketika konfigurasi selesai, jendela Debugger Jarak Jauh muncul.

   

   Debugger jarak jauh sekarang menunggu koneksi. Gunakan nama server dan nomor port yang ditampilkan untuk mengatur konfigurasi koneksi jarak jauh di Visual Studio.

Untuk menghentikan debugger jarak jauh, pilih File>Keluar. Anda dapat menghidupkan ulang dari menu Mulai, atau dari baris perintah:

<Remote debugger installation directory>\msvsmon.exe

Catatan

Jika Anda perlu menambahkan izin untuk pengguna tambahan, mengubah mode autentikasi, atau nomor port untuk debugger jarak jauh, lihat Mengonfigurasi debugger jarak jauh.

Men-debug proyek C++ dari jarak jauh

Dalam prosedur berikut, jalur proyek adalah C:\remotetemp, dan nama komputer jarak jauh adalah MySurface.

1. Membuat aplikasi Konsol C++ bernama CppConsoleApp

2. Atur titik henti di suatu tempat dalam aplikasi yang mudah dijangkau, misalnya dalam CppConsoleApp.cpp, dalam main fungsi .

3. Di Penjelajah Solusi, klik kanan proyek dan pilih Properti. Buka tab Penelusuran Kesalahan.

4. Atur Debugger untuk diluncurkan ke Debugger Windows Jarak Jauh.

   

5. Buat perubahan berikut pada properti:

   Pengaturan	Nilai
   Perintah Jarak Jauh	C:\remotetemp\CppConsoleApp.exe
   Direktori Kerja	C:\remotetemp
   Nama Server Jarak Jauh	MySurface:portnumber
   Connection	Jarak Jauh dengan Autentikasi Windows
   Jenis Debugger	Hanya Asli
   Direktori Penyebaran	C:\remotetemp
   File Tambahan untuk Disebarkan	$(ProjectDir)\data

   Jika Anda menyebarkan folder tambahan, dan ingin semua file dalam folder disebarkan ke folder yang sama, tentukan nama folder.

   Untuk informasi selengkapnya tentang properti, lihat Pengaturan proyek untuk konfigurasi Debug C++.

6. Di Penjelajah Solusi, klik kanan solusi dan pilih Pengelola Konfigurasi.

7. Untuk konfigurasi Debug, pilih kotak centang Sebarkan.

   

8. Mulai penelusuran kesalahan (Debug > Mulai Debugging, atau F5).

9. File yang dapat dieksekusi secara otomatis disebarkan ke komputer jarak jauh.

10. Jika diminta, masukkan kredensial jaringan untuk menyambungkan ke komputer jarak jauh.

    Kredensial yang diperlukan khusus untuk konfigurasi keamanan jaringan Anda. Misalnya, di komputer domain, Anda dapat memilih sertifikat keamanan atau memasukkan nama domain dan kata sandi Anda. Pada komputer non-domain, Anda mungkin memasukkan nama komputer dan nama akun pengguna yang valid, seperti MySurface\name@something.com, bersama dengan kata sandi yang benar.

11. Pada komputer Visual Studio, Anda akan melihat bahwa eksekusi dihentikan di titik henti.

    Tip

    Atau, Anda dapat menyebarkan file sebagai langkah terpisah. Di Penjelajah Solusi, klik kanan simpul proyek lalu pilih Sebarkan.

    Jika Anda memiliki file non-kode yang diperlukan oleh aplikasi, Anda dapat menentukannya dalam daftar yang dibatasi titik koma di File Tambahan untuk Disebarkan di halaman Debugger Windows Jarak Jauh.

    Atau, Anda dapat menyertakan file dalam proyek Anda, dan mengatur properti Konten ke Ya di halaman Properti untuk setiap file. File-file ini disalin ke Direktori Penyebaran yang ditentukan pada halaman Debugger Windows Jarak Jauh. Anda juga dapat mengubah Tipe Item menjadi Salin File dan menentukan properti tambahan di sana jika Anda memerlukan file untuk disalin ke subfolder Deployment Directory.

Menyiapkan Debugging dengan Simbol Jarak Jauh

Anda akan dapat men-debug kode dengan simbol yang dibuat di komputer Visual Studio. Performa debugger jarak jauh lebih baik ketika Anda menggunakan simbol lokal.

Jika Anda harus menggunakan simbol jarak jauh, Anda perlu menentukan simbol jarak jauh di Visual Studio dengan menambahkan berbagi file Windows ke jalur pencarian simbol di Simbol Debugging > Opsi > Alat>.

Konten terkait

• Penelusuran kesalahan di Visual Studio
• Tampilan pertama di debugger
• Mengonfigurasi firewall Windows untuk Penelusuran Kesalahan Jarak Jauh
• Penetapan Port Debugger Jarak Jauh
• Penelusuran Kesalahan Jarak Jauh ASP.NET pada Komputer IIS Jarak Jauh
• Kesalahan dan Pemecahan Masalah Penelusuran Kesalahan Jarak Jauh