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 aplikasi ARM64EC pada perangkat ARM64, instal alat jarak jauh ARM64, lalu luncurkan debugger jarak jauh x64 yang diinstal 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 (AMD64), atau ARM64). Pada versi Windows Server yang lebih lama, lihat Membuka blokir unduhan file untuk bantuan mengunduh alat jarak jauh. |
Visual Studio 2019 | Alat jarak jauh | Alat jarak jauh untuk Visual Studio 2019 tersedia dari My.VisualStudio.com. Jika diminta, bergabunglah dengan program Visual Studio Dev Essentials gratis, atau masuk dengan ID langganan Visual Studio Anda. Unduh versi yang cocok dengan sistem operasi perangkat Anda (x86, x64 (AMD64), atau ARM64). Pada versi Windows Server yang lebih lama, lihat Membuka blokir unduhan file untuk bantuan mengunduh alat jarak jauh. |
Visual Studio 2017 | Alat jarak jauh | Alat jarak jauh untuk Visual Studio 2017 tersedia dari My.VisualStudio.com. Jika diminta, bergabunglah dengan program Visual Studio Dev Essentials gratis, atau masuk dengan ID langganan Visual Studio Anda. Unduh versi yang cocok dengan sistem operasi perangkat Anda (x86, x64 (AMD64), atau ARM64). Di Windows Server, lihat Membuka blokir unduhan file untuk bantuan 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 Windows Server, lihat Membuka blokir unduhan file untuk bantuan 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 |
Versi | Tautan | Catatan |
---|---|---|
Visual Studio 2019 | Alat jarak jauh | Kompatibel dengan semua versi Visual Studio 2019. Unduh versi yang cocok dengan sistem operasi perangkat Anda (x86, x64 (AMD64), atau ARM64). Di Windows Server, lihat Membuka blokir unduhan file untuk bantuan mengunduh alat jarak jauh. Untuk versi terbaru alat jarak jauh, buka dokumen Visual Studio 2022. |
Visual Studio 2017 | Alat jarak jauh | Kompatibel dengan semua versi Visual Studio 2017. Unduh versi yang cocok dengan sistem operasi perangkat Anda (x86, x64 (AMD64), atau ARM64). Di Windows Server, lihat Membuka blokir unduhan file untuk bantuan 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 Windows Server, lihat Membuka blokir unduhan file untuk bantuan 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
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.
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.
Jika API Windows Web Services tidak diinstal, yang hanya terjadi pada Windows Server 2008 R2, pilih tombol Instal.
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.
Selanjutnya, pilih Konfigurasikan penelusuran kesalahan jarak jauh untuk memulai debugger jarak jauh.
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.
Membuat aplikasi Konsol C++ bernama CppConsoleApp
Atur titik henti di suatu tempat dalam aplikasi yang mudah dijangkau, misalnya dalam CppConsoleApp.cpp, dalam
main
fungsi .Di Penjelajah Solusi, klik kanan proyek dan pilih Properti. Buka tab Penelusuran Kesalahan.
Atur Debugger untuk diluncurkan ke Debugger Windows Jarak Jauh.
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++.
Di Penjelajah Solusi, klik kanan solusi dan pilih Pengelola Konfigurasi.
Untuk konfigurasi Debug, pilih kotak centang Sebarkan.
Mulai penelusuran kesalahan (Debug > Mulai Debugging, atau F5).
File yang dapat dieksekusi secara otomatis disebarkan ke komputer jarak jauh.
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.
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