Bagikan melalui

Menggunakan Visual Studio Code dengan Secure Shell (SSH) pada host jarak jauh

  • Artikel

Penting

Ini adalah dokumentasi Azure Sphere (Warisan). Azure Sphere (Warisan) dihentikan pada 27 September 2027, dan pengguna harus bermigrasi ke Azure Sphere (Terintegrasi) saat ini. Gunakan pemilih Versi yang terletak di atas TOC untuk melihat dokumentasi Azure Sphere (Terintegrasi).

Visual Studio Code dapat digunakan dengan Azure Sphere SDK untuk membangun dan men-debug kode pada host jarak jauh melalui Secure Shell (SSH). Dua skenario didukung:

  • Kode pada komputer dan perangkat jarak jauh pada komputer lokal.

  • Baik kode maupun perangkat pada komputer jarak jauh.

Skenario ketiga—kode pada komputer dan perangkat lokal di komputer jarak jauh—tidak didukung.

Menyiapkan komputer lokal

  1. Unduh dan instal Visual Studio Code.

  2. Instal Azure Sphere SDK untuk Windows atau Linux.

  3. Instal ekstensi Azure Sphere dengan mencari Azure Sphere di panel ekstensi Visual Studio Code dan mengklik Instal.

    Tip

    Ada dua Azure Sphere ekstensi, dan menginstal salah satunya akan menginstal keduanya: Azure Sphere UI untuk komponen UI, dan Azure Sphere untuk komponen ruang kerja.

  4. Instal ekstensi Remote-SSH dengan mencari Remote-SSH di panel ekstensi Visual Studio Code dan mengklik tombol Instal .

Menyiapkan komputer jarak jauh

  1. Kami sangat menyarankan Anda menyiapkan komputer jarak jauh untuk autentikasi berbasis kunci.
  2. Instal Azure Sphere SDK untuk Windows atau Linux.

Kode pada komputer dan perangkat jarak jauh pada komputer lokal

  1. Sambungkan perangkat melalui USB ke komputer lokal.
  2. Jika belum ada proyek di komputer jarak jauh, Anda dapat mengkloning repositori sampel atau mendapatkan satu proyek dari Browser Sampel Microsoft.
  3. Buka Visual Studio Code secara lokal.
  4. Hanya pertama kali: Buka Visual Studio Code dari Lihat>Palet>Perintah Remote-SSH: Tambahkan host SSH baru, dan masukkan informasi host SSH seperti yang diminta. (Secara default, file bernama config ditulis ke direktori .ssh di direktori beranda Anda. Hal ini terkadang menyebabkan masalah izin jika komputer lokal Anda adalah Windows. Anda mungkin ingin memindahkan file ke direktori lain dan menentukan jalur absolut di Ekstensi>Pengaturan>Preferensi>File>Jarak Jauh - SSH: File Konfigurasi.)

Menyambungkan ke komputer jarak jauh

  1. Sambungkan ke komputer jarak jauh dengan menjalankan perintah Visual Studio Code Lihat>Command Palette>Remote-SSH: Sambungkan ke host ().Shift+Ctrl+P

  2. Instal ekstensi Azure Sphere ke komputer jarak jauh dengan mencari Azure Sphere di panel ekstensi Visual Studio Code dan mengklik tombol Instal di SSH: [nama jarak jauh] . Anda mungkin perlu menghidupkan ulang Visual Studio Code dan menyambungkan kembali ke komputer jarak jauh setelah menginstal.

    Tip

    Untuk memeriksa apakah ekstensi diinstal dengan benar pada komputer jarak jauh, kosongkan kotak pencarian di panel ekstensi, dan pastikan Azure Sphere ekstensi muncul di tampilan SSH: [nama jarak jauh] - TERINSTAL .

  3. Buka folder proyek atau ruang kerja menggunakan Folder Buka File>atau ruang kerja Buka File>.

Membangun, menyebarkan ke perangkat lokal, dan men-debug

  1. Tekan F5 untuk membangun dan men-debug proyek. Jika proyek sebelumnya belum dibuat, atau jika file telah berubah dan pembangunan ulang diperlukan, Visual Studio Code akan membangun proyek sebelum penelusuran kesalahan dimulai.

  2. Tunggu beberapa detik hingga Visual Studio Code membangun aplikasi, membuat paket gambar, menyebarkannya ke papan, dan memulainya dalam mode debug. Anda akan melihat pembaruan status di panel Output di sepanjang jalan.

    Pertama, CMake menentukan apakah aplikasi perlu dibangun. Jika demikian, fokus bergeser ke jendela output, yang menampilkan output dari CMake/Build.

    Selanjutnya, panel Output memperlihatkan hasil saat paket gambar disebarkan ke perangkat. Terakhir, Konsol Debug menerima fokus dan menampilkan output debugger.

Gunakan debugger Visual Studio Code untuk mengatur titik henti, menjeda, melangkahi, melangkah ke, memulai ulang, atau menghentikan aplikasi.

Kode dan perangkat pada komputer jarak jauh

  1. Sambungkan perangkat melalui USB ke komputer jarak jauh.
  2. Jika belum ada proyek di komputer jarak jauh, Anda dapat mengkloning repositori sampel atau mendapatkan satu proyek dari Browser Sampel Microsoft.
  3. Buka Visual Studio Code secara lokal.
  4. Hanya pertama kali: Buka Visual Studio Code dari Lihat>Palet>Perintah Remote-SSH: Tambahkan host SSH baru, dan masukkan informasi host SSH seperti yang diminta. (Secara default, file bernama config ditulis ke direktori .ssh di direktori beranda Anda. Hal ini terkadang menyebabkan masalah izin jika komputer lokal Anda adalah Windows. Anda mungkin ingin memindahkan file ke direktori lain dan menentukan jalur absolut di Ekstensi>Pengaturan>Preferensi>File>Jarak Jauh - SSH: File Konfigurasi.)

Menyambungkan ke komputer jarak jauh dan mengonfigurasi pengaturan jarak jauh

  1. Sambungkan ke komputer jarak jauh dengan menjalankan perintah VISUAL Code Lihat>Command Palette>Remote-SSH: Sambungkan ke host ().Shift+Ctrl+P

  2. Tambahkan pengaturan jarak jauh dengan menjalankan perintah VISUAL Code Lihat>Preferensi Palet>Perintah: Buka Pengaturan Jarak Jauh, dan tambahkan bidang berikut ke objek JSON (jika itu adalah file kosong, Anda perlu membungkus ini dalam ):{}

        "remote.extensionKind": {
        "ms-vscode.azure-sphere-tools-ui": [
            "workspace"
        ]
    }

    Anda dapat menambahkan pengaturan ini ke pengaturan pengguna/ruang kerja, tergantung pada penyiapan proyek dan tim Anda.

  3. Instal ekstensi Azure Sphere ke komputer jarak jauh dengan mencari Azure Sphere di panel ekstensi Visual Studio Code dan mengklik tombol Instal di SSH: [nama jarak jauh] . Anda mungkin perlu menghidupkan ulang Visual Studio Code dan menyambungkan kembali ke komputer jarak jauh setelah menginstal.

    Tip

    Untuk memeriksa apakah ekstensi diinstal dengan benar pada komputer jarak jauh, kosongkan kotak pencarian di panel ekstensi, dan pastikan Azure Sphere ekstensi muncul di tampilan SSH: [nama jarak jauh] - TERINSTAL .

  4. Buka folder proyek atau ruang kerja menggunakan Folder Buka File>atau ruang kerja Buka File>'.

Membangun, menyebarkan ke perangkat jarak jauh, dan men-debug

  1. Tekan F5 untuk membangun dan men-debug proyek. Jika proyek sebelumnya belum dibuat, atau jika file telah berubah dan pembangunan ulang diperlukan, Visual Studio Code akan membangun proyek sebelum penelusuran kesalahan dimulai.

  2. Tunggu beberapa detik hingga Visual Studio Code membangun aplikasi, membuat paket gambar, menyebarkannya ke papan, dan memulainya dalam mode debug. Anda akan melihat pembaruan status di panel Output di sepanjang jalan.

    Pertama, CMake menentukan apakah aplikasi perlu dibangun. Jika demikian, fokus bergeser ke jendela output, yang menampilkan output dari CMake/Build.

    Selanjutnya, panel Output memperlihatkan hasil saat paket gambar disebarkan ke perangkat. Terakhir, Konsol Debug menerima fokus dan menampilkan output debugger.

Gunakan debugger Visual Studio Code untuk mengatur titik henti, menjeda, melangkahi, melangkah ke, memulai ulang, atau menghentikan aplikasi.

Menutup koneksi

Untuk mengakhiri sesi penelusuran kesalahan jarak jauh, pilih Tutup File>Koneksi Jarak Jauh.