Mac環境でQtを使ったPythonスクリプトをapp形式にまとめる

この記事の対象は、色々なツールを試した(あるいは検討した)けれど、Pythonで書いたソースのapp化に使うツールがしっくりきていない方向けです。

まずは結論から。

負担を軽減したいなら、とにかくPythonの2系でPyQt4を使い、PyInstaller2.1でstand-aloneなアプリを作りましょう。

ツールの導入もフォルダを解凍するだけと、とても簡単です。

たとえQt5を使って書いたソースが手元にあるとしても、Qt4向けに修正する価値はあります。特に基本的な機能のみを使ったアプリなら、Qt5じゃなくても動くはずです。

私はYosemite環境でVirtual Box + Mavericksを起動させ、以下のツールを試しました。基本的にMacPortsを使って、なるべく綺麗な環境で行っています。

環境
・Python3.4.1
・PyQt5.3
・sip4.16.4

ツール
・py2app
・cx_Freeze

とりあえず二大メジャーツールというべき、py2appとcx_Freezeを試しましたが、結局Qt4対応のソースに書き直して、PyInstallerで作りました。

このツールの良いところはデフォルトで複数の有名なライブラリに最適化されていることです。それにQtも含まれるため、非常に簡単にapp化できるのだと思います。

対応しているライブラリはこちら

上記二つのツールを使う際の問題点は、いわゆるsemi-stand-aloneなアプリになりやすいことです。つまり実行可能形式なんだけれど、環境に依存するという形式です。他の環境で試すまで分からなかったりと困った子です。外部ライブラリの取り込みが難しいんですよね。。。そして上手くいかない際の原因が分かりづらいです。。。

一方のPyInstallerですが、こちらはすでにアプリなため、ただ公式サイトからダウンロードしてきて解凍するだけです。

PyInstaller

以前の2.0ではビルドなどに様々なコマンドが必要だったようですが、現在は本当に数ステップです。

①本家サイトから取ってきたファイルを解凍。

②解凍して出来たPyinstallerというフォルダに、app化したいPythonスクリプトを置く。

③その階層で次のコマンドを叩く。

python pyinstaller.py --windowed your_source.py　-i your_icon.icns

下線部分は適宜、ご自身の素材に読み替えてください。アイコンは使いたいものがある場合だけのオプションです。デフォルトのアイコンは微妙です。他のオプションは公式サイトからどうぞ。

--windowedコマンドは、UNIXの実行可能形式のみではなく、app形式を生成するためのオプション(だったはず)です。

コマンド自体はたったこれだけです。これでご自分のスクリプト名がついたフォルダが、Pyinstallerのフォルダ内に生成されます。いくつか階層を下れば、app形式のファイルがあるはずです。

私が使った環境です。MacPortsを使って導入しています。

Python27
py27-sip
PyQt4

PyInstaller(公式サイトからダウンロード)

PyQt5で書いたソースをPyQt4に書き直すのは気が引けますが、実際はQtWidgetsをQtGuiに置換(Qt5で独立した部分です)してしまえば、あとの修正部分は驚くほど少ないはずです。

私はencodeの部分で少し分かりにくい齟齬が発生しましたが、それも他のapp化ツールの情報収集に比べれば微々たるものでした。

ライブラリも出そろってきてだいぶ安定してきた3系ですが、それでもQtを使ったアプリの配布用作成には、この記事で挙げているバージョンを採用することで悩む時間がずいぶん減ると思いますよ。

Mac環境でシステムのPythonをアップグレード(インストール)する

Windowsユーザにはなんてことない、Pythonのアップデートですが、Macユーザには意外と手間だったりします。最近ならMacPortsやHomebrewあたりを使ってPATHを書き換えるのが主流のようですね。

そんな主流に反して、システムのPythonをアップデートする方法をメモしておきます。

まず、Macのシステムってどうなってるの、というとこから。Pythonに関わるPATHは以下の三つがあります。

usr/lib
プリインストール(最近だと2.5, 2.6, 2.7あたりが入ってますね)されている、Pythonのライブラリなんかがあります。

usr/bin
pythonコマンドなどのリンクがあります。ターミナルで「python」コマンドを叩くと、このリンクから各pythonの実行ファイルに飛ぶ仕組みです。


/Library/Frameworks/Python.framework/Versions/2.7(各バージョン。私はとある事情から3.3を入れました)

公式サイトのインストーラを使ってあるバージョンをインストールした時にできる階層。ここにpythonコマンドなどが追加されますが、3系なんかのバージョンでは微妙に名称が違うので注意です。

たとえば、Python3.3の場合は、pythonではなくてpython3になっています。

よって、システムのPythonを変更した場合、次の手順を取ることになります。

①インストーラで好きなバージョンをインストール

②usr/bin配下のリンクファイルをいったん削除。

③usr/bin配下に再度、新しく追加したPythonへのリンクを作成。

④新しいPython置き場にあるライブラリのフォルダを、PATHに追加。

具体的なコマンドはこんな感じです。

sudo rm /usr/bin/pydoc
sudo rm /usr/bin/python
sudo rm /usr/bin/pythonw
sudo rm /usr/bin/python-config

まずはリンクを削除しました。続いて、リンクを作成しなおします。今回はPython3.3を例に使いますが、各バージョンに合わせてリンク元の名称は変更します。

ln -s /Library/Frameworks/Python.framework/Versions/3.3/bin/pydoc3 /usr/bin/pydoc
ln -s /Library/Frameworks/Python.framework/Versions/3.3/bin/python3 /usr/bin/python
ln -s /Library/Frameworks/Python.framework/Versions/3.3/bin/pythonw3 /usr/bin/pythonw
ln -s /Library/Frameworks/Python.framework/Versions/3.3/bin/python3-config /usr/bin/python-config

以上で、リンクの再配置が完了しました。
さらに、ライブラリのPATHを追加します。vimで.bash_profileあたりに書き加えましょう。ちなみにこのコマンドのみだと、PyQtなどの各種ツールが配置されるsite-packageが含まれないため、必要な方はそちらも追加しましょう。

PATH="/Library/Frameworks/Python.framework/Versions/3.3/bin:$PATH"
export PATH

後はPATHを反映して、ターミナルでpythonと打って無事に新しいバージョンが起動すればOKです。