【Python】pyinstallerでpyファイルを配布用にEXE化する方法

exe化とは、Windows環境における実行形式のファイルにすることです。
実行形式のファイルとは、それ単体で実行できるファイルということです。簡単にいうとダブルクリックすれば起動するファイルです。

exe化することで、プログラムの起動が簡単になり、またPythonがインストールされていなくてもプログラムを起動できるという大きなメリットがあります。

PyinstallerとはPythonスクリプトをexe化するためのライブラリです。
他のexe化するライブラリと比べて非常に簡単にexe化できるという特徴があります。

ネットで調べるとPyinstallerを使ったexe化の方法がたくさんあるので、多くの方がPyinstallerを使っていることがわかります。

Pyinstallerは簡単にexe化できる反面、作成したexeファイルの起動が遅いというデメリットがあります。

より起動が高速なexeを作成したい場合は、py2exeやembeddable pythonを使うことをお勧めします。

またexe化のもう1つのデメリットとしては、exeファイルのサイズが非常に大きくなってしまうことがあることです。

ファイルサイズ肥大化を避けるための方法は後述します。

Pyinstallerを使うためには、まずインストールする必要があります。
下記のようにpipコマンドでpyinstallerをインストールします。

pip install pyinstaller

これでpyinstallerを使ってexe化する準備が整いました。

Pythonファイルをexe化するには、まず目的のPythonファイルが存在するディレクトリに移動します。その後、以下のコマンドを実行します。

pyinstaller ファイル名 -–onefile -–noconsole

上記コマンドではオプションとして、--onefileと—noconsoleを指定しています。

--onefileは生成されるものを1つのファイルにまとめ、--noconsoleはexeファイル実行時にコンソールが表示されないようにします。

このコマンドを実行するとPythonファイルが入っているディレクトリに「__pycache__」、「build」、「dist」のフォルダが新たに作成されます。

目的のexeファイルはdistフォルダ内に入っています。
このexeファイルを配布すれば、あなたが作ったプログラムを受け取った相手はクリックするだけで起動できるようになるというわけです。

exe化したプログラムに関連するファイルがある場合、それらのファイルと階層をそろえる必要があります。

私の場合は、GUI画面のボタンに画像を使っているプログラムが多いので、それらファイルと同じ階層にexeファイルを持っていきます。

pyinstallerではアイコンを設定するためのオプションもあります。

pyinstallerでビルドするときに--iconのオプションを使用します。その際にアイコンで使用する画像icoファイルを指定します。

pyinstaller ファイル名 -–onefile -–noconsole --icon=test.ico

アイコン画像のicoファイルの作成には以下サイトを使うと簡単にicoファイルを作成できます。

favicon.icoを作ろう

アイコンが反映しない場合の対処方法

上記の方法でexeファイルのアイコンは作成されるのですが、Windowsを使っている人の中にはアイコンが反映しない！！という方もいます。
その原因はアイコンキャッシュです。

Windowsを再起動またはアイコンキャッシュを削除することで、希望のアイコンに戻るはずです。

再起動させないでアイコンキャッシュを削除する方法としては、ie4uinit.exeを使います。

エクスプローラーをすべて閉じた後に、「ファイル名を指定して実行」に「ie4uinit.exe -show」を入力して実行するだけです。

もしアイコンがうまく表示されなくても焦らずに、上記方法を試してみてください。

pipで多くのモジュール（パッケージ）をインストールしているpythonからpyinstallerでexeファイルを使用すると、ファイルサイズが大きいexeファイルが作成されます。

それはpipでインストールしているモジュールすべてを組み込んでしまうからです。

それを防ぐために仮想化を使用します。仮想環境を構築して、そこには該当プログラムで使用するモジュールのみをインストールします。

そうすることで最小限のモジュールを組み込んだexeファイルが作成されるのです。

仮想環境の作成方法に関しては、以下記事をご参照ください。

【Python】仮想環境の構築と有効化の方法

インストールしているライブラリが少なければ、--excludeで不必要なライブラリをexeファイルから省くことができます。

pyinstaller ファイル名 --onefile --exclude numpy

numpyやpandasなどはかなり容量があるので、exe化するプログラムに不必要であればexcludeしてexeファイルの軽量化を図ったほうがいいですね。

すでにいくつかのオプションについては説明していますが、その他にも様々なオプションがpyinstallerには存在します。

すべてのオプションについては以下サイト（英語）に記載されています。

Using Pyinstaller

--onefile または -F

--noconsole または -w , --windowed

--clean

--icon または -i

--onedir または-D

--name または -n

--help または -h

--version または -v

exeファイルが実行できない問題

様々なスクリプトをexe化しているとexeファイルが正常に実行されない問題に直面します。

これはpyinstallerと互換性がないライブラリをexeファイルに組み込もうとしている場合に発生します。

--onefileで作成したexeファイルは動作しないけど、オプションなし作成したexeファイルでは問題なく動作するときもあります。

また例えば最新のpywin32では動作せず、過去のバージョンでは動作するといったこともあります。詳しくは以下記事をご参照ください。

【Python】pyinstaller：pywin32（win32com）を含んだexeが動作しない問題の解決

今後pyinstallerを利用していこうと思っている方は、exeファイルが実行されない問題に直面しても焦らずに、どのライブラリが問題を発生させているのかを慎重に見極めてください。

Pyinstallerにお勧めのライブラリ

tkinter

tkinterはGUIアプリケーションを作成する際に使用する標準ライブラリです。

作成したGUIアプリケーションは基本的に作成した本人よりも、配布して他の人に利用してもらうことを目的としているはずです。

Pyinstallerでexe化して配布することで、作成したGUIアプリケーションを誰でも利用できるようになります。

【Python】tkinterを使ったGUIアプリケーションの作成方法

Pystray

Pystrayはタスクトレイにアプリケーションを常駐させるライブラリです。

バックグラウンドでアプリケーションを起動させておいて、定期的に処理を実行させたいときなどにも利用できます。

スタートアップにexe化したアプリを追加して、起動したアプリはタスクトレイに常駐させておく、といった使い方ができます。

【Python】タスクトレイにアプリを常駐させる：pystrayで定期的に実行

Selenium

Seleniumはブラウザを操作・制御するライブラリです。スクレイピングによるデータ収集やRPAに利用されることが多いです。

私はSeleniumを利用して業務効率化のRPAをいくつも開発しています。開発したアプリはPyinstallerでexe化して社員に配って利用してもらっています。

【Python】Selenium：ブラウザ操作して静的・動的（Ajax、javascript）ページから情報を取得

まとめ

自分で作ったプログラムを配布できるようになると、より一層プログラミングが楽しくなって、やりがいも増えていきます。

ぜひ今回覚えたexe化の方法を使って、友達や会社の人にexe化したPythonプログラムを配布して使用してもらってください。

exe化したアプリとその他画像やファイルを一度で所定の場所に保存できるようにしたい、デスクトップにショートカットを自動的に作成したい、 コントロールパネルの「プログラムと機能」にアプリを登録したい、ということであればインストーラーを作成するのがお勧めです。

下記リンクのWindows用インストーラーを作成するNSISのインストール方法をご覧ください。

【NSIS】Windows向けインストーラー作成アプリのインストール方法

人気記事

【iPhone】テザリング：接続が突然切れる（切断される）現象の原因と解決方法

【Outlook】メールボックスの容量がいっぱい・足りない場合の対処方法

【Outlook】受信メールの表示形式を変更・元に戻す方法：ビューの設定

【Teams】最新のチャットが表示されない（更新されない）ときの対処方法

【エクセル】パソコンによって印刷範囲が異なる（ずれる）問題の解決（拡大／縮小）

最新記事

【Windows11】初期化する手順：再インストールして工場出荷時に戻す4つの方法

【Windows】パソコンのキーボードで一部のキーが反応しない（打てない）ときの対処方法

winmail.datとは：開き方や変換方法、メール添付される原因について

【e-Gov】電子公文書のXMLファイルの開き方：Edgeで開けないときの対処法

【Windows11】パソコンがシャットダウンできない、再起動する問題の対処法

【Windows11】シャットダウンの仕方：ショートカットや完全シャットダウン