CLion 2019.3ヘルプ

WSL

WSL(英語)WSL 2(英語))-Windows Subsystem for Linux-Windows 10でLinuxバイナリ実行可能ファイルをネイティブに実行するための互換性レイヤーです。現在、Ubuntu、OpenSUSE、SLESなどのいくつかのLinuxディストリビューション(英語)をサポートしています。

WSLツールチェーンをあなたのプロジェクト用にセットアップすれば、あなたのWindowsマシン上でCLionを離れずに、LinuxからCMakeとコンパイラを使って構築し、WSL上で実行/デバッグすることができます。

WSLを設定する

  1. Microsoftストア(英語)からWSLディストリビューション(Ubuntuなど)をダウンロードしてインストールします。

    このステップでは、必ず最新の「Fall Creators Update」(最小バージョン1709、ビルド16299.15)を適用したWindows 10を使用してください。手順については公式ガイドWindows Subsystem for Linuxをインストールする(英語)を参照してください。

    WSL 2を使用するには、Windowsバージョン10ビルド18917以降でなければなりません。以下の指示(英語)に従って、配布を切り替えます。

    CLionは、システムをWindows 10のビルド16299.15以降にアップグレードする前にインストールした可能性があるレガシWSLをサポートしていないことに注意してください。この場合、WSLディストリビューションを更新する必要があります。

  2. Ubuntuを実行してください。

    Ubuntuの最初の起動時に、Windowsのオプション機能を有効にするように求められる場合があります。この場合、次のことが必要です。

    • 管理者としてWindows Power Shellを開き、実行します。

      Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux

    • コンピューターを再起動してください。

  3. WSL Ubuntu環境をセットアップします。

    • 次のように、cmake、gcc、またはclang(およびオプションでbuild-essentialsパッケージ)をインストールします。

      sudo apt-get install cmake gcc clang gdb build-essential

    • 開いているssh-serverを設定して実行します。

      手動またはスクリプト(英語)を使用して、構成を設定できます (LinuxディストリビューションがUbuntuと異なる場合、スクリプトの調整が必要になる場合があることに注意してください)。スクリプトをダウンロードして実行するには、次のコマンドラインを使用します。

      wget https://raw.githubusercontent.com/JetBrains/clion-wsl/master/ubuntu_setup_env.sh && bash ubuntu_setup_env.sh

  4. 次に、ssh接続を確認します。

    ssh username@localhost -p2222

    ポート番号2222は、この設定スクリプトに有効です。私たちのスクリプトを使用していない場合は、ポート番号が異なる可能性があります。

以前に構成したWSLをWSL 2アップグレードした場合、アプリケーションを 127.0.0.1 ではなく 0.0.0.0 にバインドする必要があります(WSL 1とWSL 2の間のユーザーエクスペリエンスの変更(英語)を参照)。

  • 1) /etc/ssh/sshd_configsudoとして開きます。

  • 2) ListenAddress 127.0.0.1 行で、127.0.0.10.0.0.0に置き換えます。

  • 3)変更を保存し、sudo service ssh restartを実行します。

プロジェクト用にWSLツールチェーンを設定する

  1. CLionで、設定/環境設定 | ビルド、実行、デプロイ | ツールチェーンに移動し、plus icon をクリックして新しいツールチェーンを作成します。環境リストからWSLを選択します。CLionはインストールされたディストリビューションを自動的に検出します。あるいは手動でパスを設定することもできます。

    リモート 資格情報を入力します (予期しないエラーが発生した場合は、トラブルシューティングの手順を試してください)。

    WSL toolchain

  2. ツールチェーンの使用を開始するには、次のいずれかを実行します。

    • WSLツールチェーンをデフォルトとして設定します。これにより、デフォルトのCMakeプロファイルに自動的に接続されます。

    • 別のCMakeプロファイルを作成し、それをWSLツールチェーンに接続して、設定スイッチャーでこのプロファイルを選択してください。

      cmake profile for wsl toolchain

トラブルシューティング

  • FTP/SFTP 接続リモートホストデータアクセスの2つのバンドルされたプラグインが設定/環境設定 | プラグインで有効になっていることを確認してください。

  • ツールチェーンの作成時に資格情報はこのWSLディストリビューションには無効ですエラーが発生した場合は、Windowsレジストリエディターで HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Lxss{ubuntu_id }\BasePath の値を確認します(それにアクセスするには、スタートメニューからregeditを起動します)。値に非ASCII文字が含まれている場合は、この課題(英語)で説明されている回避策を使用してください。

  • IntelliJプラットフォームの課題(英語)のために、大文字と小文字を区別するWSLファイルシステムとそうでないWindowsファイルシステムを使用する際に問題があります。回避策として、次の操作を実行できます。

    • ヘルプ | カスタム・プロパティの編集...メニューオプションに移動

      idea.case.sensitive.fs=true

    • キャッシュを無効にし、ファイル | キャッシュを無効にして再起動するメニューオプションを使用してIDEを再起動します。

最終更新日: 2020年2月20日