次の方法で共有

リモート ホストでの 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. USB 経由でデバイスをローカル コンピューターに接続します。
  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 経由でリモート コンピューターに接続します。
  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 デバッガーを使用して、ブレークポイントの設定、一時停止、ステップ オーバー、ステップ イン、再起動、またはアプリケーションの停止を行います。

接続を閉じる

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