Penelusuran Kesalahan Jarak Jauh proyek C# atau Visual Basic di Visual Studio

Untuk men-debug aplikasi Visual Studio yang telah disebarkan di komputer lain, instal dan jalankan alat jarak jauh di komputer tempat Anda menyebarkan aplikasi, konfigurasikan proyek Anda untuk tersambung ke komputer jarak jauh dari Visual Studio, lalu 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 pada 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 pembaruan terbaru alat jarak jauh untuk versi Visual Studio Anda. Versi alat jarak jauh sebelumnya 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 x86 di komputer jarak jauh yang menjalankan sistem operasi x64, instal alat jarak jauh x64. Untuk men-debug aplikasi x86, ARM, atau x64 pada sistem operasi ARM64, instal alat jarak jauh ARM64.

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.
• Untuk men-debug aplikasi x64 pada sistem operasi ARM64, jalankan msvsmon.exe x64 yang diinstal dengan alat jarak jauh ARM64.

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 dari jarak jauh

Debugger tidak dapat menyebarkan aplikasi desktop Visual C# atau Visual Basic ke komputer jarak jauh, tetapi Anda masih dapat men-debugnya dari jarak jauh sebagai berikut. Prosedur berikut mengasumsikan bahwa Anda ingin men-debug-nya di komputer bernama MJO-DL, seperti yang ditunjukkan pada ilustrasi di bawah.

1. Buat proyek WPF bernama MyWpf.

   Jika Anda mencoba men-debug aplikasi MAUI dari jarak jauh alih-alih WPF, lihat Debug jarak jauh aplikasi .NET MAUI di Windows.

2. Tetapkan titik henti di suatu tempat dalam kode yang mudah dijangkau.

   Misalnya, Anda dapat menetapkan titik henti di penangan tombol. Untuk melakukan ini, buka MainWindow.xaml, dan tambahkan Kontrol tombol dari Kotak Alat, lalu klik dua kali tombol untuk membuka handler-nya.

3. Di Penjelajah Solusi, klik kanan proyek dan pilih Properti.

4. Pada halaman Properti, pilih tab Debug.

   Untuk proyek C# yang menargetkan .NET Core atau .NET 5+, mulai dari Visual Studio 2022, pilih antarmuka pengguna Profil peluncuran debug dari tab Debug untuk mengonfigurasi pengaturan untuk penelusuran kesalahan jarak jauh.

   

   Jika tidak, Anda mengubah pengaturan debug jarak jauh langsung di tab Debug.

   

5. Pastikan kotak teks Direktori kerja kosong.

6. Pilih Gunakan komputer jarak jauh, dan ketik yourmachinename:port di kotak teks. (Nomor port ditampilkan di jendela debugger jarak jauh. Nomor port bertambah 2 di setiap versi Visual Studio).

   Dalam contoh ini, gunakan:

   MJO-DL:4026 pada Visual Studio 2022

7. Pastikan Aktifkan penelusuran kesalahan kode asli tidak dipilih.

8. Bangun proyek.

9. Buat folder di komputer jarak jauh yang jalurnya sama dengan folder Debug di komputer Visual Studio Anda: <jalur sumber>\MyWPF\MyWPF\bin\Debug.

10. Salin executable yang baru saja Anda buat dari komputer Visual Studio ke folder yang baru dibuat di komputer jarak jauh.

    Perhatian

    Jangan membuat perubahan pada kode atau membuat ulang kode (atau Anda harus mengulangi langkah ini). Executable yang disalin ke komputer jarak jauh harus sama persis dengan sumber dan simbol lokal Anda.

    Anda dapat menyalin proyek secara manual, menggunakan XCopy, Robocopy, PowerShell, atau opsi lainnya.

11. Pastikan debugger jarak jauh berjalan pada komputer target (Jika tidak, cari Debugger Jarak Jauh di menu Mulai). Jendela debugger jarak jauh tampak seperti ini.

    

12. Di Visual Studio, mulai penelusuran kesalahan (Debug > Mulai Penelusuran Kesalahan, atau F5).

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

    Kredensial yang diperlukan bervariasi tergantung pada konfigurasi keamanan jaringan Anda. Misalnya, di komputer domain, Anda dapat memasukkan nama domain dan kata sandi. Pada komputer non-domain, Anda mungkin memasukkan nama komputer dan nama akun pengguna yang valid, seperti MJO-DL\name@something.com, bersama dengan kata sandi yang benar.

    Anda akan melihat jendela utama aplikasi WPF terbuka di komputer jarak jauh.

14. Jika perlu, ambil tindakan untuk mencapai titik henti. Anda akan melihat bahwa titik henti aktif. Jika tidak, simbol untuk aplikasi belum dimuat. Coba lagi, dan jika itu tidak berhasil, dapatkan informasi tentang memuat simbol dan cara memecahkan masalahnya di Memahami file simbol dan pengaturan simbol Visual Studio.

15. Pada komputer Visual Studio, Anda akan melihat eksekusi telah berhenti di titik henti.

    Jika Anda memiliki file non-kode yang perlu digunakan oleh aplikasi, Anda perlu menyertakannya dalam proyek Visual Studio. Buat folder proyek untuk file tambahan (di Penjelajah Solusi, klik Tambahkan > Folder Baru). Kemudian tambahkan file ke folder (di Penjelajah Solusi, klik Tambahkan > Item yang Ada, lalu pilih file). Pada halaman Properti untuk setiap file, atur Salin ke Direktori Output ke Selalu salin.

Debug jarak jauh aplikasi .NET MAUI di Windows

Aplikasi .NET MAUI adalah aplikasi kemasan yang perlu didaftarkan saat disebarkan, tidak hanya disalin ke komputer jarak jauh. Untuk debug jarak jauh, Anda dapat menyebarkan versi aplikasi yang tidak dikemas.

Gunakan salah satu metode berikut untuk debug jarak jauh:

• Terbitkan aplikasi ke perangkat jarak jauh sebagai aplikasi yang tidak dikemas menggunakan langkah-langkah yang dijelaskan dalam Menggunakan CLI untuk menerbitkan aplikasi MAUI .NET yang tidak dikemas untuk Windows, lalu ikuti langkah-langkah dalam artikel ini ke debug jarak jauh. (Lewati langkah-langkah untuk menyalin aplikasi.)

• Ikuti langkah-langkah dalam artikel ini, termasuk langkah-langkah untuk membuat profil Peluncuran Debug untuk proyek. Sebelum Anda mulai men-debug, edit peluncuran Pengaturan.json file secara manual, ganti nilai commandNameProject dengan MsixPackage, seperti yang ditunjukkan di sini.

  "Remote Profile": {
    "commandName": "MsixPackage",
    "remoteDebugEnabled": true,
    "remoteDebugMachine": "170.200.20.22",
    "authenticationMode": "None"
  }
  

  Saat Anda mulai men-debug, metode ini terlebih dahulu menyebarkan versi aplikasi yang tidak dikemas dan memulainya.

  Catatan

  Anda tidak dapat mengedit peluncuran Pengaturan.json dalam kotak dialog Luncurkan profil Debug setelah Anda mengubah nilai menjadi MsixPackage.

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 memberi tahu monitor penelusuran kesalahan jarak jauh untuk mencari simbol pada komputer jarak jauh.

Anda dapat menggunakan sakelar baris perintah msvsmon berikut untuk menggunakan simbol jarak jauh untuk kode terkelola: Msvsmon /FallbackLoadRemoteManagedPdbs

Untuk informasi selengkapnya, silakan lihat bantuan penelusuran kesalahan jarak jauh (tekan F1 di jendela debugger jarak jauh, atau klik Bantuan > Penggunaan).

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