インストール - CLion

CLionのインストール

CLionの公式Webサイトにアクセスして、CLionをダウンロードする。
ダウンロードしたファイルを解凍する。

tar xf CLion-<バージョン>.tar.gz
mv CLion-<バージョン> CLion

必要ならば、CLionを任意のインストールディレクトリに配置する。

mv CLion <任意のインストールディレクトリ>

CLionのデスクトップエントリファイルを作成する。
CLionを起動して、[ツール]メニューバー - [デスクトップエントリの作成]を選択する。
~/.local/share/applicationsディレクトリにCLionのデスクトップエントリファイルが作成される。

PinePhone / Qtとの連携

ツールチェーンの設定

[ファイル]メニューバー - [設定]を選択する。
[設定]画面の左ペインにある[ビルド、実行、デプロイ] - [ツールチェーン]を選択する。
[設定]画面の右ペインにある[+]アイコンを選択して、[システム]を選択する。

• ツールチェーンの設定項目
  • [名前]

    任意の名前を入力する。

  • [CMake:]

    PinePhone向けQtライブラリのビルドに使用したCMakeファイルのパスを入力する。

  • [ビルドツール:]

    PinePhone向けQtライブラリのビルドに使用したNinjaファイルのパスを入力する。

  • [C コンパイラー:]

    PinePhone向けQtライブラリのビルドに使用したGCCファイルのパスを入力する。

    例: /<GCCツールチェーンのインストールディレクトリ>/bin/aarch64-linux-gnu-gcc

  • [C++ コンパイラー:]

    PinePhone向けQtライブラリのビルドに使用したG++ファイルのパスを入力する。

    例: /<GCCツールチェーンのインストールディレクトリ>/bin/aarch64-linux-gnu-g++

  • [デバッガー:]

    GCCツールチェーンのGDBファイルのパスを入力する。

    例: /<GCCツールチェーンのインストールディレクトリ>/bin/aarch64-linux-gnu-gdb

[設定]画面の右ペイン下部にある[適用]ボタンを押下する。

CMakeの設定

[ファイル]メニューバー - [設定]を選択する。
[設定]画面の左ペインにある[ビルド、実行、デプロイ] - [CMake]を選択する。
[設定]画面の右ペインにある[+]アイコンを選択する。

• CMakeの設定項目
  • [名前]

    任意の名前を入力する。

  • [ビルドタイプ:]プルダウン

    [Debug]または[Release]を選択する。

  • [ツールチェーン:]プルダウン

    上記で設定したツールチェーン名を選択する。

  • [ジェネレーター:]プルダウン

    [デフォルトを使用する]を選択する。

    例: /<GCCツールチェーンのインストールディレクトリ>/bin/aarch64-linux-gnu-gcc

  • [環境:]
    [環境:]のテキストアイコンを選択して、[環境設定]画面を開く。
    画面右上の[+]ボタンを押下して、各環境変数を設定する。
    • CMAKE_C_COMPILER

      PinePhone向けQtライブラリのビルドに使用したGCCファイルのパスを入力する。

      例: /<GCCツールチェーンのインストールディレクトリ>/bin/aarch64-linux-gnu-gcc

    • CMAKE_CXX_COMPILER

      PinePhone向けQtライブラリのビルドに使用したG++ファイルのパスを入力する。

      例: /<GCCツールチェーンのインストールディレクトリ>/bin/aarch64-linux-gnu-g++

    • CMAKE_PREFIX_PATH

      PinePhone向けQtライブラリのインストールディレクトリのパスを入力する。

      例: <PinePhone向けQtライブラリのインストールディレクトリ>

    • CMAKE_TOOLCHAIN_FILE

      PinePhone向けQtライブラリのインストールディレクトリにあるビルド向けツールチェーンファイルのパスを入力する。

      例: /<PinePhone向けQtライブラリのインストールディレクトリ>/lib/cmake/Qt6/qt.toolchain.cmake

    • QT_QMAKE_EXECUTABLE

      PinePhone向けQtライブラリのインストールディレクトリにあるqmakeファイルのパスを入力する。

      例: /<PinePhone向けQtライブラリのインストールディレクトリ>/bin/qmake-host

[設定]画面の右ペイン下部にある[適用]ボタンを押下する。

SSHの設定

[ファイル]メニューバー - [設定]を選択する。
[設定]画面の左ペインにある[ツール] - [SSH 構成]を選択する。
[設定]画面の右ペインにある[+]アイコンを選択する。

• SSH構成の設定項目
  • [ホスト:]

    PinePhoneのIPアドレスまたはホスト名を入力する。

  • [ユーザー名:]

    PinePhoneのユーザ名を入力する。

  • [認証タイプ:]プルダウン

    [パスワード]または[キーペア]を選択する。

  • [秘密鍵ファイル:] (キーペアを選択した場合)

    秘密鍵ファイルのパスを入力する。

  • [パスフレーズ:] (キーペアを選択した場合、かつ、パスフレーズを設定した場合)

    秘密鍵のパスフレーズを入力する。

  • [構成ファイル ~/.ssh/configの構文解析]チェックボックス

    任意

[接続テスト]ボタンを押下して、PinePhoneにSSH接続する。

[設定]画面の右ペイン右下にある[適用]ボタンを押下する。

各プロジェクトの設定

CLionを起動して、[ファイル]メニューバー - [新規] - [プロジェクト...]を選択する。
[新規プロジェクト]画面から、[Qt Console 実行可能ファイル]または[Qt Widgets 実行可能ファイル]を選択する。

新規プロジェクトの作成後、[実行]メニューバー - [実行構成の編集...]を選択する。
[実行/デバッグ構成]画面が開くので、画面左上にある[+]ボタンを押下して、[リモート GDB サーバー]を選択する。
画面左ペインに[リモート GDB サーバー]が追加される。
画面左ペインに[リモート GDB サーバー]を選択して、各種設定を行う。

• [ターゲット:]プルダウン

  プロジェクト名を選択する。

• [実行可能ファイル:]プルダウン

  プロジェクト名を選択する。

• [GDB:]プルダウン

  上記のツールチェーンの作成セクションで設定したGDBを選択する。

• [資格情報:]プルダウン

  上記のSSHの設定セクションで設定したSSHを選択する。

• [実行可能ファイル...]ラジオボタン

  任意

• [アップロードパス:]

  実行可能バイナリが配置されるPinePhone上のディレクトリを入力する。

  例: /home/<PinePhoneのユーザ名>/CLion/Sample1/debug

• ['target remote' ...]

  自動的に入力される。

  例: <IPアドレスまたはホスト名>:1234

次に、[拡張 GDB サーバーオプション]項目を設定する。
この設定は、PinePhoneにアップロードしたQtライブラリにおいて、デバッグまたは実行に関する設定を行う。

• [作業ディレクトリ:]

  何も入力しない。

• [環境変数:]
  [環境変数:]項目の右にあるテキストアイコンを選択する。
  [環境変数]画面が開くので、画面左上にある[+]ボタンを押下して各種設定を入力する。
  • DISPLAY

    :0

  • QT_QPA_PLATFORMTHEME

    Qt 6の場合 : qt6ct

    Qt 5の場合 : qt5ct

  • PATH

    PinePhone上のQt6ライブラリをアップロードしたbinディレクトリのパスを入力する。

    例: /<Qt6ライブラリをアップロードしたディレクトリ>/bin:/usr/local/bin:/usr/bin:/bin:/usr/local/games:/usr/games

  • LD_LIBRARY_PATH

    PinePhone上のQt6ライブラリをアップロードしたlibディレクトリのパスを入力する。

    例: /<Qt6ライブラリをアップロードしたディレクトリ>/lib:/<Qt6ライブラリをアップロードしたディレクトリ>/plugins/qmltooling

  • QT_PLUGIN_PATH

    /<Qt6ライブラリをアップロードしたディレクトリ>/plugins

  • QT_QPA_PLATFORM_PLUGIN_PATH

    /<Qt6ライブラリをアップロードしたディレクトリ>/plugins/platforms

  • QML_IMPORT_PATH

    /<Qt6ライブラリをアップロードしたディレクトリ>/qml

  • QML2_IMPORT_PATH

    /<Qt6ライブラリをアップロードしたディレクトリ>/qml

  • QT_DEBUG_PLUGINS

    0または1を入力する。

  • LANG

    日本語を設定する場合は、ja_JP.UTF-8と入力する。

GDBの設定

プロジェクトにデバッグのためのより多くの設定が必要な場合、デバッガの初期化ファイル (GDBの場合は.gdbinit、LLDBの場合は.lldbinit) をプロジェクトディレクトリ直下に作成する。
このファイルは、他のプロジェクトと一緒にVCSで共有することもできる。

一般的に、GDB / LLDBは起動時に初期化ファイルを一定の順序で読み込む。
まず、デバッガはユーザのホームディレクトリにある初期化ファイルを探して、次に、現在のプロジェクトディレクトリ直下にある初期化ファイルを探す。

ただし、デフォルトの設定では、セキュリティ上の理由から、プロジェクト固有の初期化ファイルからのコマンドは実行されない。
そのため、ホームディレクトリの初期化ファイルである~/.gdbinitファイルまたは~/.lldbinitファイルを、以下に示すように編集する。

vi ~/.gdbinit  または  vi ~/.lldbinit

 # ~/.gdbinitファイル  または  ~/.lldbinitファイル
 
 set auto-load safe-path /
 
 # または
 
 set auto-load local-gdbinit on
 add-auto-load-safe-path /

次に、プロジェクトディレクトリの直下に.gdbinitファイルを作成する。

cd <プロジェクトディレクトリ>
vi .gdbinit  または  vi .lldbinit

 # /<プロジェクトディレクトリ>/.gdbinitファイル  または  /<プロジェクトディレクトリ>/.lldbinitファイル
 
 set sysroot <PinePhoneのシステムルートディレクトリ>