Windows/jp - Revision history

Yz2house at 02:03, 4 June 2021

2021-06-04T02:03:31Z

Yz2house at 11:40, 12 December 2019

2019-12-12T11:40:17Z

Yz2house at 01:16, 2 November 2019

2019-11-02T01:16:44Z

Yz2house at 00:34, 25 April 2019

2019-04-25T00:34:03Z

Yz2house: Created page with "
2019-04-25T00:27:08Z

Created page with "<span style="color: #000000; background: none; overflow: hidden; page-break-after: avoid; font-size: 2.0em; font-family: Georgia,Times,serif; margin-top: 1em; margin-bottom: 0..."

New page
<span style="color: #000000; background: none; overflow: hidden; page-break-after: avoid; font-size: 2.0em; font-family: Georgia,Times,serif; margin-top: 1em; margin-bottom: 0.25em; line-height: 1.3; padding: 0; border-bottom: 1px solid #AAAAAA;">Windows</span>

　本項はWindowsシステムでRawTherapeeをコンパイルする説明をしています。[[Linux/jp]]と[[macOS/jp]]でコンパイルする説明は別項にあります。ここではコンパイルの'''部分的'''な詳細説明を行っています。コマンドの'''意味'''やディペンデンシー一覧、CMakeのオプション、その他の情報に関しては、Linuxの説明文を参考にして下さい。

　ソースコードのクローン作成、ブランチの選択、CMakeの設定、実際のコンパイル手順も、やはりLinuxの説明文を参考にします。以下はWindowsのコンパイルに関する追加事項です。

　RawTherapeeのコンパイルにはGTK+のバージョン３.22.24以上が必要です。このバージョンは元々Windowsをサポートするための最初のバージョン[https://gitlab.gnome.org/GNOME/gtk/issues/760#note_110809 patched]なので、バージョン要件が満たされていないと、Windowd10の場合、ウィンドウのタスクバーが [https://github.com/Beep6581/RawTherapee/issues/4125 最大表示]されるなどの異常な表示になってしまいます。

　GTK+2をサポートし、WindowsXPとの互換性のあるRawTherapeeの最後のバージョンは、2017年2月2日にリリースされた5.0-r1-gtk2です。

== MSYS2のインストール ==
=== MSYS2の基本システムをインストールする ===
　まず、[http://www.msys2.org/ MSYS2 website]からの以下の説明に従ってMSYS2を更新します。最新版が手に入るまでは次の様にMSYS2の基本システムを更新します：
<pre>$ pacman -Syu</pre>
インストールの最後に、次の3つのシェルが手に入ります：
MSYS2シェル:コアのシステムを開発するのと、MSYS2アプリケーションを管理する（主にMSYS2パッケージの更新）ために使われるものです。
MINGW64シェル:64ビットアプリケーションをビルドするための環境を提供します。
MINGW32シェル:32ビットアプリケーションをビルドするための環境を提供します。

[[File:MSYS2_Shell.jpg]]

　注意: 以下の<code><MSYS2></code> テキストはMSYS2インストールフォルダーです。

=== ツールとライブラリーをインストール ===
　MSYS2のパッケージマネジャーはpacmanです。詳しくは [https://wiki.archlinux.org/index.php/pacman pacmanマニュアル] を参照して下さい。
　MSYS2シェルには:
初めに、幾つか細かいツールをインストールします:
<pre>$ pacman -S tar gzip nano make diffutils intltool git</pre>
次に必要な開発ツールをインストールします:
<pre>
# win32
$ pacman -S mingw-w64-i686-gcc mingw-w64-i686-gdb mingw-w64-i686-make mingw-w64-i686-pkg-config mingw-w64-i686-cmake
# win64
$ pacman -S mingw-w64-x86_64-gcc mingw-w64-x86_64-gdb mingw-w64-x86_64-make mingw-w64-x86_64-pkg-config mingw-w64-x86_64-cmake
</pre>
必要なライブラリーをインストールします:
<pre>
# win32
$ pacman -S mingw-w64-i686-gtkmm3 mingw-w64-i686-lcms2 mingw-w64-i686-fftw mingw-w64-i686-lensfun
# win64
$ pacman -S mingw-w64-x86_64-gtkmm3 mingw-w64-x86_64-lcms2 mingw-w64-x86_64-fftw mingw-w64-x86_64-lensfun
</pre>
=== 適用可能なバージョンのパッケージを取得する ===
MSYS2はパッケージを断続的にリリースしているので、新しいバージョンのパッケージに中には現在のRawTherapeeと互換性がないものが存在する可能性があります。
　以下はダウンロードする必要のあるパッケージのリストです：
<pre>
mingw-w64-x86_64-lensfun-0.3.2-4-any.pkg.tar.xz
mingw-w64-x86_64-libjpeg-turbo-1.5.3-1-any.pkg.tar.xz
</pre>
もしも、パッケージが<MSYS2>\var\cache\pacman\pkgの中になければ、次に示すリンクからダウンロード出来ます。
この時、MSYS2の中の各ファイルは：
<pre>Pacman -U <path-to-files>/mingw-w64-x86_64-...</pre>
Pacmanがパッケージを更新しないよう、<MSYS2>\etc\pacman.confに以下を追加します。
<pre>
# Pacman won't upgrade packages listed in IgnorePkg and members of IgnoreGroup
IgnorePkg = mingw-w64-x86_64-libjpeg-turbo
IgnorePkg = mingw-w64-x86_64-lensfun
</pre>
32ビットバージョンをビルドする場合は、上記の作業でx86_64をi386に置き換えて行います。
=== MSYS2の基本システムとアプリケーションパッケージを更新する ===
MSYS2のシェルの中は:
<pre>$ pacman -Syuu</pre>
=== Lensfunのデータベースを更新 ===
<code><mingw32|mingw64>\lib\python3.6\site-packages</code>から<code>lensfun</code>フォルダーと<code>lensfun-0.3.2-py3.6.egg-info</code>ファイルをコピーし、<code><mingw32|mingw64>\lib\python3.<version>\site-packages</code>に貼り付けます。
上記の中の<vesion>はインストールされたPython3のバージョンのことです。
Mingw32或いはMingw64シェルには以下が入ります:
<pre>$ lensfun-update-data</pre>

== libiptcdataのダウンロードと作成 ==
　32ビットバージョンをビルドする人は“MinGW32シェル”を、64ビットバージョンをビルドする人は“MinGW64”を使います。
libiptcdataライブラリーはMSYS2から提供されないので、自身でダウンロードし以下を使って作成します：
<pre>
$ curl -LO http://downloads.sourceforge.net/project/libiptcdata/libiptcdata/1.0.4/libiptcdata-1.0.4.tar.gz
$ tar xzf libiptcdata-1.0.4.tar.gz
$ cd libiptcdata-1.0.4

# win32
$ ./configure --prefix=/mingw32
# win64
$ ./configure --prefix=/mingw64
</pre>
　その後で、<code>Makefile</code>を開き、テキストエディターを使って、<code>SUBDIRS</code>と<code>DIST_SUBDIRS</code>という名前のリストから<code>iptc</code>と <code>docs</code>を削除します。そうしないとインストールとビルドが失敗します。
<pre>
$ nano -m Makefile

# search (command ctrl/W)
DIST_SUBDIRS = m4 libiptcdata po iptc docs win python
# and replace with
DIST_SUBDIRS = m4 libiptcdata po win python

# search
SUBDIRS = m4 libiptcdata po iptc docs win $(MAYBE_PYTHONLIB)
# and replace with
SUBDIRS = m4 libiptcdata po win $(MAYBE_PYTHONLIB)

# save
ctrl/O

# quit
ctrl/X
</pre>
　最後に、ライブラリーを作成してインストールします：
<pre>
$ make
$ make install
$ cd
</pre>

== RawTherapeeのクローンとビルド ==
　32ビットバージョンをビルドする人は“MinGW32シェル”を、64ビットバージョンをビルドする人は“MinGW64”を使います。
=== RawTherapeeのGitリポジトリーのクローン ===
　ビルドフォルダーのパスの中にスペース文字があると、ビルドが失敗します。例えば、Windowsのユーザーネームが“Zank Frappa”だとすると、そのホームパスはC:￥Users￥Zank Frappa￥ですが、その中にRawTherapeeのクローンを入れるとコンパイル中にビルドが失敗するでしょう。単純に、フォルダーにも親フォルダーの名前の中にスペースが入っていないフォルダーにクローンを入れます。例えば、C：￥code\repo-rtのように。
<pre>
$ git clone http://github.com/Beep6581/RawTherapee.git /c/code/repo-rt
$ cd /c/code/repo-rt
</pre>
　リポジトリーのクローンを作ると自動的に<code>dev</code>ブランチに入りますが、これを手動で行う場合は次を使います：
<pre>$ git checkout dev</pre>
=== ビルドのために別のディレクトリーを作成===
<pre>
$ mkdir build
$ cd build
</pre>
　ビルドのブランチを変更する際には、新しい空のフォルダーを使って初めからコンパイルするため、それまでの<code>ビルド</code>ファルダ―を必ず削除します。そうしないと恐らくコンパイルに失敗するでしょう。但し、ブランチを変更せずにビルドを更新するだけであれば、空のフォルダーから始める必要はなく、既存のフォルダーが使えるので、速くコンパイルすることが出来ます。

=== CMakeとMakeを起動 ===
<pre>
$ cmake -G "MSYS Makefiles" -DLENSFUNDBDIR=share/lensfun -DCMAKE_BUILD_TYPE="release" -DPROC_TARGET_NUMBER="2" -DCACHE_NAME_SUFFIX="5-dev" ..
$ make install
</pre>
　"BUILD_TYPE"のオプションを含む様々なCMakeのオプションの説明は、Linuxでのコンパイルの項を参照して下さい。
　32ビットWindowsのrelease或いはrelwithdebinfoバージョンを作成する場合は、上記CMakeのコマンドの2つのドット..の前に、<code>-mstackrealign</code>というコンパイラフラッグを追加する必要があります。
<pre>-DCMAKE_C_FLAGS="-mstackrealign" -DCMAKE_CXX_FLAGS="-mstackrealign"</pre>
　これでMINGW64のコマンドラインを使ってRawTherapeeのビルドが始められます:
<pre>
# for debug builds
$ cd debug
# for release builds
$ cd release
# for relwithdebinfo builds
$ cd relwithdebinfo
$ ./rawtherapee.exe
</pre>

== RawTherapeeと必要なDLLをコピーする ==
　DLLは、Windowsのファイルマネジャー、或いは<mingw32|mingw64>シェルスクリプトの中にあるrobocopyのinstead of / for the optionsを使って（推奨）コピー出来ます。
フォルダーの定義は:
<code><prefix></code> is<code><MSYS2>\<mingw32|mingw64>,</code>
<code><MSYS2></code> is the MSYS2 installation folder,
and<code> .</code> is the RawTherapee installation folder.
Copy the content of <code>c:\code\repo-rt\build\<debug|release|relwithdebinfo></code> into<code>.</code>.
　必要なDLLと実行ファイルを<code><prefix>\bin</code>からコピーします。必要なDLLと実行ファイルは次の通りです：
<pre>
gspawn-<win32|win64>-helper.exe
gspawn-<win32|win64>-helper-console.exe
libatk-1.0-0.dll
libatkmm-1.6-1.dll
libbz2-1.dll
libcairo-2.dll
libcairo-gobject-2.dll
libcairomm-1.0-1.dll
libcroco-0.6-3.dll
libdatrie-1.dll
libepoxy-0.dll
libexpat-1.dll
libfﬁ-6.dll
libfftw3f-3.dll
libfontconﬁg-1.dll
libfreetype-6.dll
libfribidi-0.dll
libgcc_s_seh-1.dll (or libgcc_s_dw2-1.dll for W32)
libgdk_pixbuf-2.0-0.dll
libgdk-3-0.dll
libgdkmm-3.0-1.dll
libgio-2.0-0.dll
libgiomm-2.4-1.dll
libglib-2.0-0.dll
libglibmm-2.4-1.dll
libgmodule-2.0-0.dll
libgobject-2.0-0.dll
libgomp-1.dll
libgraphite2.dll
libgtk-3-0.dll
libgtkmm-3.0-1.dll
libharfbuzz-0.dll
libiconv-2.dll
libintl-8.dll
libjpeg-8.dll
liblcms2-2.dll
liblensfun.dll
liblzma-5.dll
libpango-1.0-0.dll
libpangocairo-1.0-0.dll
libpangoft2-1.0-0.dll
libpangomm-1.4-1.dll
libpangowin32-1.0-0.dll
libpcre-1.dll
libpixman-1-0.dll
libpng16-16.dll
librsvg-2-2.dll
libsigc-2.0-0.dll
libstdc++-6.dll
libsystre-0.dll
libthai-0.dll
libtiff-5.dll
libtre-5.dll
libwinpthread-1.dll
libxml2-2.dll
libzstd.dll
zlib1.dll
</pre>
　次に示すAdwaitaテーマファイルとディレクトリーを<code><prefix>\share\icons\Adwaita\</code>からコピーし<code>.\share\icons\Adwaita\</code>に貼り付けます：
<pre>
scalable\actions
scalable\devices
scalable\mimetypes
scalable\places
scalable\status
scalable\ui
index.theme
cursors\plus.cur
cursors\sb_h_double_arrow.cur
cursors\sb_left_arrow.cur
cursors\sb_right_arrow.cur
cursors\sb_v_double_arrow.cur
</pre>
　次のファイルをコピーします:
<pre>
<prefix>\lib\gdk-pixbuf-2.0 -> .\lib\gdk-pixbuf-2.0
<prefix>\share\glib-2.0\schemas\gschemas.compiled -> .\share\glib-2.0\schemas
<prefix>\share\lensfun\version_1\* -> .\share\lensfun
</pre>

.\share\GTK3に以下を含む<code>settings.ini</code>ファイルを作ります：
<pre style="white-space: pre-wrap">
[Settings] gtk-button-images=1
</pre>

== 配布可能なパッケージを作成する ==
　Windowsのプラットフォームに配布可能なRawTherapeeのパッケージを作る場合は、最初のステップとして、“generic”プロセッサをターゲットとしたRawTherapeeをビルドする必要があります。そのためには、CMakeコマンドで<code>-DPROC_TARGET_NUMBER="1" </code>を使います。

　コンパイル中に、<code>WindowsInnoSetup.iss</code>という名前のスクリプトがRawTherapeeのインストーラーフォルダーの中に作成されます。このスクリプトはInno Setup [1]で使われるもので、Windows用プログラムのためのインストーラーを作ります。言語に関する問題発生を避けるため、Unicodeのバージョン[2]をダウンロードすることを奨めます。

　ユーザーに[[How to write useful bug reports/jp#有効なバグレポートの書き方|バグの報告]]をしてもらうことがあるので、パッケージの管理者には“release”と”debug”の両実行ファイルをビルドし、それらをGDBのデバッガ実行ファイルと共に一まとめにするようお願いします。

　言い換えると、rawtherapee.exe（release）ファイルとrawtherapee.exe(debug)ファイル、及びgdb.exeファイルを同じインストーラー或いは同じアーカイブに一緒に入れます。別な方法として、“release”より最適化はされていませんが、”debug”より動作速度が数段早い“relwithdebinfo”ビルドの作成があります。”debug”ビルドほどの詳細情報は得られませんが、このビルドでもかなりの情報が得られます。
</pre>

　“relwithdebinfo”, “debug”ビルドの何れの作成するにしても、GDBデバッガの実行ファイルは一緒に入れて下さい。デバッガ実行ファイル<code>gdb.exe</code>の32ビット及び64ビットバージョンのWindowsバイナリーは[http://www.equation.com/servlet/equation.cmd?fa=gdb ここから]ダウンロード出来ます。これで全ての準備が整いました。WindowsInnoSetup.issを右クリックし、コンテックスメニューの中からコンパイルを選択するとパッケージが作成されます。インストーラーが自動的に作成され、親フォルダーの中に置かれます。

　貴方が作成した新しいパッケージとRawTherapeeウェブサイトのアップロードパネルに互換性を持たせるため、新しく作成されたインストーラーとそれに対応するAboutThisBuild.txtファイルの両方を同じ場所に置くためのzipアーカイブを作って下さい。以下のテンプレーで作成したzipアーカイブに名前を付けます：
<code>RawTherapee_<branch>_<version>_WinVista_<32|64>_<buildtype>.zip</code>　
"WinVista"はWindows10を含むVista以降のどのWindowsバージョンでも動作可能であることを意味します。
"version" は貴方が<code>5.2</code>タグと一致させた場合は<code>5.2</code>のように表示され、<code>5.2</code>タグの後に<code>dev</code>ブランチと一致させた場合は、<code>5.2-g1a2b3c4d</code>と表示されます。
*一つのインストーラーに複数のビルドを入れる場合は、名前に<buildtype>を入れないで下さい。