Pythonプログラムのexe化ガイド
1. 概要
PyInstaller(Pythonプログラムを実行可能ファイルに変換するソフトウェア)を使用して,Pythonプログラムを実行可能ファイル(exe)に変換する方法を説明する.この方法により,Python実行環境がないパソコンでもプログラムを実行できるようになる.
2. 特徴と利点
2.1 使用技術の特徴
- PyInstaller:Pythonプログラムを独立した実行可能ファイルに変換するライブラリである.プログラムの実行に必要なすべての依存関係を含めて単一のファイルにパッケージ化する機能を提供する.
- Python(高水準プログラミング言語):シンプルな文法と豊富なライブラリを備えたプログラミング言語である.システム環境変数を適切に設定することで,コマンドプロンプトからの実行が可能になる.
2.2 期待される効果
- プログラムの利便性向上:Python実行環境がないコンピュータでもプログラムを実行できるようになる.利用者は生成された実行可能ファイルを実行するだけでよい.
- 配布の容易化:生成された実行可能ファイルは,Python実行環境のインストールなしで利用可能である.そのため,利用者側での環境構築が不要になる.
3. 環境構築
3.1 動作環境(OS,機材)
- Windows オペレーティングシステム
- Python(バージョン3.12を推奨)
- PyInstaller
- テキストエディタ(メモ帳など)
3.2 Pythonのインストールと確認(Windows環境)
注:既にPython(バージョン3.12を推奨)がインストール済みの場合は,この手順は不要である.
- Python 3.12 のインストール(wingetを使用)
- ただし,wingetを使わなくても,以下の手順でPythonのインストールを行うことができる.
- https://www.python.org/downloads/windows/ から Windows installer (64-bit) をダウンロードする
- ダウンロードしたインストーラを右クリックし,「管理者として実行」を選択する
- インストーラで以下の設定を行う
- 「Install launcher for all users (recommended)」にチェックを入れる
- 「Add python.exe to PATH」にチェックを入れる(重要:環境変数の設定に必要)
- 設定を終えたら,「Install Now」をクリックしてインストールを開始する
- Python の確認
- コマンドプロンプトを開く(通常モードで良い).そのために,Windowsキーを押して「cmd」と入力する.
- 以下のコマンドでバージョンを確認する:
python --version
4. プログラムファイルの準備
- コマンドプロンプトを開く(通常モードで良い).Windowsキーを押して「cmd」と入力する.
- cdコマンドでプログラムの保存先に移動する.例えば,保存先をデスクトップにする場合は次のように入力する:
cd Desktop
- 以下のコマンドでプログラムファイルを作成する(notepad は「メモ帳」である):
notepad hello.py
- 次のプログラムを入力し,Ctrl+Sキーを押して保存する(あるいは,メニューで保存操作を行う):
print("Hello, World!\n")
5. PyInstaller の使用方法
- 仮想環境の作成と有効化:
- コマンドプロンプトでプログラムの保存先に移動する.例えば,保存先がデスクトップの場合は次のように入力する:
cd Desktop
- 仮想環境(独立したPython実行環境)を作成する:
python -m venv venv
- 仮想環境を有効化する:
venv\Scripts\activate
コマンドプロンプトの先頭に`(venv)`と表示されることを確認する
- コマンドプロンプトでプログラムの保存先に移動する.例えば,保存先がデスクトップの場合は次のように入力する:
- 必要なパッケージのインストール:
- 仮想環境が有効化されていることを確認する(プロンプトの先頭に`(venv)`が表示されている)
- PyInstallerをインストールする:
pip install pyinstaller
- Pythonプログラムの動作確認:
- 仮想環境が有効化されていることを確認する(プロンプトの先頭に`(venv)`が表示されている)
- プログラムを実行する:
python hello.py
- 実行可能ファイルの生成:
- 仮想環境が有効化されていることを確認する
- PyInstallerでexeファイルを生成する:
pyinstaller --onefile hello.py
- 実行可能ファイルの動作確認:
- `dist`ディレクトリに移動する:
cd dist
- 生成された実行可能ファイルを実行する:
hello.exe
- `dist`ディレクトリに移動する:
- 作業完了後:
- 仮想環境を無効化する:
deactivate
- 仮想環境を無効化する:
6. パラメータ設定
PyInstallerのコマンドラインオプション:
--onefile
:すべての依存関係を含む単一の実行可能ファイルを生成する(推奨)--noconsole
:コンソールウィンドウを非表示にする(グラフィカルユーザーインターフェースを持つアプリケーションの場合に使用)--icon=path/to/icon.ico
:実行可能ファイルにアイコンを設定する(アイコンファイルへのパスを指定)--name=プログラム名
:生成される実行可能ファイルの名前を指定する
7. 出力データ
7.1 生成されるファイル
hello.py
:作成したPythonプログラムファイルhello.spec
:PyInstallerの設定ファイル(実行可能ファイルの生成設定を含む)build
ディレクトリ:ビルド時の中間ファイルdist
ディレクトリ:生成された実行可能ファイル
8. トラブルシューティング
8.1 PyInstallerのエラー
- 「pip is not recognized」エラーが表示される場合:
- コマンドプロンプト(システム管理者権限)を開く
- 次のコマンドを実行してpipをインストールする:
python -m ensurepip --default-pip
- その後,PyInstallerのインストールを再試行する
- モジュールが見つからないエラーが発生する場合:
- コマンドプロンプト(システム管理者権限)を開く
- 次のコマンドで必要なモジュールをインストールする:
pip install モジュール名
- PyInstallerを再実行する
8.2 実行可能ファイルの問題
- DLLエラーが発生する場合:
- Visual C++ Redistributableをインストールする
- Windowsを再起動する
- 実行可能ファイルを再度生成する