Używanie Visual Studio Code z bezpieczną powłoką (SSH) na hostze zdalnym

Visual Studio Code można używać z pakietem SDK Azure Sphere do tworzenia i debugowania kodu na hostie zdalnym za pośrednictwem bezpiecznej powłoki (SSH). Obsługiwane są dwa scenariusze:

• Kod na komputerze zdalnym i urządzeniu na komputerze lokalnym.

• Kod i urządzenie na komputerze zdalnym.

Trzeci scenariusz — kod na komputerze lokalnym i urządzeniu na komputerze zdalnym — nie jest obsługiwany.

Konfigurowanie komputera lokalnego

1. Pobierz i zainstaluj Visual Studio Code.

2. Zainstaluj pakiet Azure Sphere SDK dla systemu Windows lub Linux.

3. Zainstaluj rozszerzenie Azure Sphere, wyszukując pozycję Azure Sphere w panelu rozszerzenia Visual Studio Code i klikając pozycję Zainstaluj.

   Wskazówka

   Istnieją dwa Azure Sphere rozszerzenia, a każda z nich zostanie zainstalowana: interfejs użytkownika Azure Sphere dla składnika interfejsu użytkownika i Azure Sphere dla składnika obszaru roboczego.

4. Zainstaluj rozszerzenie Remote-SSH, wyszukując Remote-SSH w panelu rozszerzenia Visual Studio Code i klikając przycisk Zainstaluj.

Konfigurowanie komputera zdalnego

1. Zdecydowanie zalecamy skonfigurowanie komputera zdalnego do uwierzytelniania opartego na kluczach.
2. Zainstaluj pakiet Azure Sphere SDK dla systemu Windows lub Linux.

Kod na komputerze zdalnym i urządzeniu na komputerze lokalnym

1. Podłącz urządzenie do komputera lokalnego i, jeśli na komputerze lokalnym działa system Linux, uruchom skrypt azsphere_connect.sh.
2. Jeśli na komputerze zdalnym nie ma jeszcze projektu, możesz sklonować repozytorium próbek lub uzyskać jeden projekt w przeglądarce próbek firmy Microsoft.
3. Otwórz Visual Studio Code lokalnie.
4. Tylko za pierwszym razem: Otwórz Visual Studio Code z poziomu polecenia View>Command Palette>Remote-SSH: Dodaj nowego hosta SSH i wprowadź informacje o hostze SSH zgodnie z monitem. (Domyślnie plik o nazwie config jest zapisywany w katalogu .ssh w katalogu domowym. Czasami powoduje to problemy z uprawnieniami, jeśli komputerem lokalnym jest system Windows. Możesz przenieść plik do innego katalogu i określić ścieżkę bezwzględną w obszarzeRozszerzenia ustawień>preferencji plików>>>Remote — SSH: Plik konfiguracji.

Nawiązywanie połączenia z komputerem zdalnym

1. Połącz się z komputerem zdalnym, wykonując polecenie Visual Studio Code Wyświetl>paletę> poleceńRemote-SSH: Connect to host (Shift+Ctrl+P).

2. Zainstaluj rozszerzenia Azure Sphere na komputerze zdalnym, wyszukując pozycję Azure Sphere w panelu rozszerzenia Visual Studio Code i klikając przycisk Zainstaluj w SSH: [nazwa zdalna]. Po zainstalowaniu może być konieczne ponowne uruchomienie Visual Studio Code i ponowne nawiązanie połączenia z komputerem zdalnym.

   Wskazówka

   Aby sprawdzić, czy rozszerzenie jest zainstalowane poprawnie na komputerze zdalnym, wyczyść pole wyszukiwania w panelu rozszerzenia i upewnij się, że Azure Sphere rozszerzenia są wyświetlane w widoku SSH: [nazwa zdalna] — ZAINSTALOWANY .

3. Otwórz folder projektu lub obszar roboczy przy użyciu obszaru roboczego Otwieranie pliku> lubOtwórz plik>.

Tworzenie, wdrażanie na urządzeniu lokalnym i debugowanie

1. Naciśnij klawisz F5, aby utworzyć i debugować projekt. Jeśli projekt nie został wcześniej utworzony lub pliki zostały zmienione i wymagane jest ponowne odbudowanie, Visual Studio Code utworze projekt przed rozpoczęciem debugowania.

2. Poczekaj kilka sekund, aż Visual Studio Code zbudować aplikację, utworzyć pakiet obrazów, wdrożyć go na tablicy i uruchomić w trybie debugowania. Po drodze w okienku Dane wyjściowe będą wyświetlane aktualizacje stanu.

   Najpierw funkcja CMake określa, czy aplikacja musi zostać skonstruowana. Jeśli tak, fokus zostanie przeniesiony do okna wyjściowego, w którym zostaną wyświetlone dane wyjściowe Z CMake/Build.

   Następnie w okienku Dane wyjściowe jest wyświetlany wynik wdrożenia pakietu obrazów na urządzeniu. Konsola debugowania otrzymuje fokus i wyświetla dane wyjściowe debugera.

Za pomocą debugera Visual Studio Code możesz ustawiać punkty przerwania, wstrzymywać działanie, przechodzić do kolejnych kroków, uruchamiać ponownie lub zatrzymywać aplikację.

Kod i urządzenie na komputerze zdalnym

1. Podłącz urządzenie przez USB do komputera zdalnego i, jeśli na komputerze zdalnym działa system Linux, uruchom skrypt azsphere_connect.sh.
2. Jeśli na komputerze zdalnym nie ma jeszcze projektu, możesz sklonować repozytorium próbek lub uzyskać jeden projekt w przeglądarce próbek firmy Microsoft.
3. Otwórz Visual Studio Code lokalnie.
4. Tylko za pierwszym razem: Otwórz Visual Studio Code z poziomu polecenia View>Command Palette>Remote-SSH: Dodaj nowego hosta SSH i wprowadź informacje o hostze SSH zgodnie z monitem. (Domyślnie plik o nazwie config jest zapisywany w katalogu .ssh w katalogu domowym. Czasami powoduje to problemy z uprawnieniami, jeśli komputerem lokalnym jest system Windows. Możesz przenieść plik do innego katalogu i określić ścieżkę bezwzględną w obszarzeRozszerzenia ustawień>preferencji plików>>>Remote — SSH: Plik konfiguracji.

Nawiązywanie połączenia z komputerem zdalnym i konfigurowanie ustawień zdalnych

1. Połącz się z komputerem zdalnym, wykonując polecenie VS Code View>Command Palette>Remote-SSH: Connect to host (Shift+Ctrl+P).

2. Dodaj ustawienia zdalne, wykonując polecenie KOD VS Wyświetl> preferencjepalety>poleceń: Otwórz ustawienia zdalne i dodaj następujące pole do obiektu JSON (jeśli jest to pusty plik, musisz go zawinąć w{}):

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

   Zamiast tego możesz dodać to ustawienie do ustawień użytkownika/obszaru roboczego w zależności od konfiguracji projektów i zespołu.

3. Zainstaluj rozszerzenia Azure Sphere na komputerze zdalnym, wyszukując pozycję Azure Sphere w panelu rozszerzenia Visual Studio Code i klikając przycisk Zainstaluj w SSH: [nazwa zdalna]. Po zainstalowaniu może być konieczne ponowne uruchomienie Visual Studio Code i ponowne nawiązanie połączenia z komputerem zdalnym.

   Wskazówka

   Aby sprawdzić, czy rozszerzenie jest zainstalowane poprawnie na komputerze zdalnym, wyczyść pole wyszukiwania w panelu rozszerzenia i upewnij się, że Azure Sphere rozszerzenia są wyświetlane w widoku SSH: [nazwa zdalna] — ZAINSTALOWANY .

4. Otwórz folder projektu lub obszar roboczy przy użyciu obszaruroboczegoOtwieranie pliku> lubOtwieranie pliku>.

Tworzenie, wdrażanie na urządzeniu zdalnym i debugowanie

1. Naciśnij klawisz F5, aby utworzyć i debugować projekt. Jeśli projekt nie został wcześniej utworzony lub pliki zostały zmienione i wymagane jest ponowne odbudowanie, Visual Studio Code utworze projekt przed rozpoczęciem debugowania.

2. Poczekaj kilka sekund, aż Visual Studio Code zbudować aplikację, utworzyć pakiet obrazów, wdrożyć go na tablicy i uruchomić w trybie debugowania. Po drodze w okienku Dane wyjściowe będą wyświetlane aktualizacje stanu.

   Najpierw funkcja CMake określa, czy aplikacja musi zostać skonstruowana. Jeśli tak, fokus zostanie przeniesiony do okna wyjściowego, w którym zostaną wyświetlone dane wyjściowe Z CMake/Build.

   Następnie w okienku Dane wyjściowe jest wyświetlany wynik wdrożenia pakietu obrazów na urządzeniu. Konsola debugowania otrzymuje fokus i wyświetla dane wyjściowe debugera.

Za pomocą debugera Visual Studio Code możesz ustawiać punkty przerwania, wstrzymywać działanie, przechodzić do kolejnych kroków, uruchamiać ponownie lub zatrzymywać aplikację.

Zamknij połączenie

Aby zakończyć sesję zdalnego debugowania, wybierz pozycję Zamknijpołączenie zdalne plików>.