INSTALL.md

   1 <H2>** HowTo build/install Qt porting for Common Source Code Project **</H2>
   2 <H3>-- CSP/Qt(略称)のビルドとインストールの仕方<H3>
   3 <div align="right">
   4 <H3>Oct 08, 2020<BR>
   5 K.Ohta <whatisthis.sowhat _at_ gmail.com></H3>
   6 </div>
   7
   8 はじめに
   9 ========
  10 この文章では、Qt porting for Common Source Code Project (CSP/Qt)のビルド手順について記述します。
  11
  12
  13 用意すべきもの(標準)
  14 =======
  15 --GCC又はCLANGなどの、コンパイラツールチェイン
  16
  17 --CMake (3.9以上推奨）
  18
  19 - 以下の開発ライブラリ(大抵のGNU/Linux OSやBSD系のOSなどではパッケージマネージャ(dfnやaptなど）で入るはずです。)が必要になります。**なお、現状、表示にOpenGL2.1以上かOpenGL ES2以上が必要になります**。
  20   - QT5 (QTCore, QtOpenGL, QtNetworkなど) <https://www.qt.io/>
  21   - SDL2 <https://libsdl.org/>
  22   - libAV <http://ffmpeg.org/>
  23   - zlib <http://zlib.net/>
  24   　その他、色々必要になります。
  25
  26 - Windows向けのビルドの場合、OpenGL ESを実装した[Angle Project](<https://github.com/Microsoft/angle>)が実行に必要になるかもしれません。これは、Google Chromeブラウザのオープンソース版である[Chromium Project](<http://www.chromium.org/>)のWindow (x86 32bit)ビルドの中にある、libEGL.dllとlibGLESv2.dllを使えばどうにかなります。
  27
  28 ## なお、Windows向けのビルドをするための環境を、Dockerの形でビルドして使うと便利です。
  29 ## Dockerレポジトリは <https://hub.docker.com/r/artanejp/mingw-w64-llvm10-ubuntu20.04>
  30 ## 元のDockerfileは <https://github.com/Artanejp/llvm-mingw>
  31
  32 ビルド手法
  33 =========
  34
  35 既にgitからcloneしたりリリースに添付されたソースコードを解凍してビルドする場合、
  36
  37 $ `cd ${SRCROOT}/source`
  38 $ `mkdir build`
  39 $ `cd build/`
  40 $ `cmake ..`
  41 $ `make`
  42
  43 とすればとにかくのビルドが可能ですが、**標準的な設定パラメータを収めたシェルスクリプトを、${SRCROOT}/source/sample-scripts/ 以下に入れてあります（まだまだ追加するかも）**。
  44
  45 このサンプルを使って、
  46 $ `cd ${SRCROOT}/source`
  47 $ `mkdir build`
  48 $ `cd build/`
  49 $ `cp ../sample-scripts/${SCRIPT_NAME}.sh .`
  50 とビルドディレクトリに取って来た後で、
  51 $ `sh ./${SCRIPT_NAME}.sh`
  52 などとしてブートストラップ設定をして、CMakeがエラー起こさなかったら、
  53 $ `make {色々オプション}`
  54 としてビルドしてみましょう。
  55
  56 インストール手法
  57 ===============
  58
  59 普通は、 # `make install`で可能なはずです。Windowsビルドの場合は、まだToDoです。
  60
  61                                       Last Update: Dec 16, 2020 00:07:53