次の方法で共有

リモート ホストでの Secure Shell (SSH) での Visual Studio Code の使用

  • [アーティクル]

Visual Studio Code を Azure Sphere SDK と共に使用して、Secure Shell (SSH) を使用してリモート ホスト上でコードをビルドおよびデバッグできます。 次の 2 つのシナリオがサポートされています。

  • リモート コンピューター上のコードとローカル コンピューター上のデバイス。

  • リモート コンピューター上のコードとデバイスの両方。

3 つ目のシナリオ (ローカル コンピューター上のコードとリモート コンピューター上のデバイス) はサポートされていません。

ローカル コンピューターを設定する

  1. Visual Studio Code をダウンロードしてインストールします。

  2. Azure Sphere SDK for Windows または Linux をインストール します。

  3. Visual Studio Code 拡張機能パネルで Azure Sphere を検索し、[インストール] をクリックして、Azure Sphere 拡張機能を インストールします。

    ヒント

    2 つの Azure Sphere 拡張機能があり、どちらかをインストールすると、UI コンポーネント用 の Azure Sphere UI とワークスペース コンポーネント用 の Azure Sphere の両方がインストールされます。

  4. Visual Studio Code 拡張機能パネルで Remote-SSH を検索し、[インストール] ボタンをクリックして、Remote-SSH 拡張機能を インストール します。

リモート コンピューターを設定する

  1. キーベースの認証用にリモート コンピューターを設定することを強くお勧めします。
  2. Azure Sphere SDK for Windows または Linux をインストール します。

リモート コンピューター上のコードとローカル コンピューター上のデバイス

  1. デバイスをローカル コンピューターに接続し、ローカル コンピューターが Linux を実行している場合は、azsphere_connect.sh スクリプトを実行します。
  2. リモート コンピューターにプロジェクトがまだない場合は、 サンプル リポジトリ を複製するか、 Microsoft Samples Browser から 1 つのプロジェクトを取得できます。
  3. Visual Studio Code をローカルで開きます。
  4. 初回のみ:コマンド パレット>の表示>リモート SSH から Visual Studio Code を開く: 新しい SSH ホストを追加し、プロンプトに従って SSH ホスト情報を入力します。 (既定では、config という名前のファイルがホーム ディレクトリの .ssh ディレクトリに書き込まれます。ローカル コンピューターが Windows の場合、アクセス許可の問題が発生することがあります。ファイルを別のディレクトリに移動し、[ファイル設定>] [設定>] [拡張機能>] [リモート] - [SSH: 構成ファイル>] で絶対パスを指定できます)。

リモート コンピューターに接続する

  1. Visual Studio Code コマンド [コマンドパレット>の表示>]リモート SSH: ホストへの接続 (Shift+Ctrl+P) を実行して、リモート コンピューターに接続します。

  2. Visual Studio Code 拡張機能パネルで Azure Sphere を検索し、[ SSH でインストールする: [リモート名] ボタンをクリックして、リモート コンピューターに Azure Sphere 拡張機能をインストールします。 インストール後に Visual Studio Code を再起動し、リモート コンピューターに再接続することが必要になる場合があります。

    ヒント

    拡張機能がリモート コンピューターに正しくインストールされている場合にチェックするには、拡張機能パネルの検索ボックスをオフにし、[リモート名] - INSTALLED ビューに拡張機能が表示されていることを確認Azure Sphereします。

  3. [ファイルを開くフォルダー] または [ファイル>を開く] ワークスペースを使用して、プロジェクト フォルダーまたはワークスペースを>開きます。

ビルド、ローカル デバイスへのデプロイ、デバッグ

  1. F5 キーを押してプロジェクトをビルドしてデバッグします。 プロジェクトが以前にビルドされていない場合、またはファイルが変更され、再構築が必要な場合、Visual Studio Code はデバッグを開始する前にプロジェクトをビルドします。

  2. Visual Studio Code がアプリケーションをビルドし、イメージ パッケージを作成し、ボードにデプロイしてデバッグ モードで起動するまで数秒待ちます。 途中で [ 出力 ] ウィンドウに状態の更新が表示されます。

    まず、CMake は、アプリケーションをビルドする必要があるかどうかを判断します。 その場合は、フォーカスが出力ウィンドウに移動し、CMake/Build からの出力が表示されます。

    次に、イメージ パッケージがデバイスにデプロイされると、[ 出力 ] ウィンドウに結果が表示されます。 最後に、デバッグ コンソールがフォーカスを受け取り、デバッガーの出力を表示します。

Visual Studio Code デバッガーを使用して、ブレークポイントの設定、一時停止、ステップ オーバー、ステップ イン、再起動、またはアプリケーションの停止を行います。

リモート コンピューター上のコードとデバイス

  1. USB 経由でリモート コンピューターにデバイスを接続し、リモート コンピューターが Linux を実行している場合は、azsphere_connect.sh スクリプトを実行します。
  2. リモート コンピューターにプロジェクトがまだない場合は、 サンプル リポジトリ を複製するか、 Microsoft Samples Browser から 1 つのプロジェクトを取得できます。
  3. Visual Studio Code をローカルで開きます。
  4. 初回のみ:コマンド パレット>の表示>リモート SSH から Visual Studio Code を開く: 新しい SSH ホストを追加し、プロンプトに従って SSH ホスト情報を入力します。 (既定では、config という名前のファイルがホーム ディレクトリの .ssh ディレクトリに書き込まれます。ローカル コンピューターが Windows の場合、アクセス許可の問題が発生することがあります。ファイルを別のディレクトリに移動し、[ファイル設定>] [設定>] [拡張機能>] [リモート] - [SSH: 構成ファイル>] で絶対パスを指定できます)。

リモート コンピューターに接続し、リモート設定を構成する

  1. VS Code コマンドを実行してリモート コンピューターに接続します。コマンド パレット>の表示>Remote-SSH: ホストへの接続 (Shift+Ctrl+P)。

  2. VS Code コマンド [コマンド パレット>の基本設定の表示>] を実行してリモート設定を追加します。リモート設定を開き、JSON オブジェクトに次のフィールドを追加します (空のファイルの場合は、 で{}ラップする必要があります)。

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

    プロジェクトとチームの設定に応じて、代わりにこの設定をユーザー/ワークスペース設定に追加できます。

  3. Visual Studio Code 拡張機能パネルで Azure Sphere を検索し、[ SSH でインストールする: [リモート名] ボタンをクリックして、リモート コンピューターに Azure Sphere 拡張機能をインストールします。 インストール後に Visual Studio Code を再起動し、リモート コンピューターに再接続することが必要になる場合があります。

    ヒント

    拡張機能がリモート コンピューターに正しくインストールされている場合にチェックするには、拡張機能パネルの検索ボックスをオフにし、[リモート名] - INSTALLED ビューに拡張機能が表示されていることを確認Azure Sphereします。

  4. [ファイルを開くフォルダー] または [ファイル>を開く] ワークスペースを使用して、プロジェクト フォルダーまたはワークスペースを>開きます。

ビルド、リモート デバイスへのデプロイ、デバッグ

  1. F5 キーを押してプロジェクトをビルドしてデバッグします。 プロジェクトが以前にビルドされていない場合、またはファイルが変更され、再構築が必要な場合、Visual Studio Code はデバッグを開始する前にプロジェクトをビルドします。

  2. Visual Studio Code がアプリケーションをビルドし、イメージ パッケージを作成し、ボードにデプロイしてデバッグ モードで起動するまで数秒待ちます。 途中で [ 出力 ] ウィンドウに状態の更新が表示されます。

    まず、CMake は、アプリケーションをビルドする必要があるかどうかを判断します。 その場合は、フォーカスが出力ウィンドウに移動し、CMake/Build からの出力が表示されます。

    次に、イメージ パッケージがデバイスにデプロイされると、[ 出力 ] ウィンドウに結果が表示されます。 最後に、デバッグ コンソールがフォーカスを受け取り、デバッガーの出力を表示します。

Visual Studio Code デバッガーを使用して、ブレークポイントの設定、一時停止、ステップ オーバー、ステップ イン、再起動、またはアプリケーションの停止を行います。

接続を閉じる

リモート デバッグ セッションを終了するには、[リモート接続を閉じるファイル] を選択します>。