• TOP
  • 記事一覧
  • PyInstallerを使用してPythonスクリプトを実行ファイルに変換する方法

PyInstallerを使用してPythonスクリプトを実行ファイルに変換する方法

更新日：2025/03/10

Pythonで作成したアプリケーションを配布したいと思ったことはありませんか？特に、プログラミングの知識がない友人や同僚にあなたの素晴らしいPythonアプリを使ってもらいたい場合、PyInstallerは非常に便利なツールです。今回は、PyInstallerの基本的な使い方から応用テクニックまで詳しく解説します。

PyInstallerとは？

PyInstallerは、Pythonスクリプトを単体の実行ファイル（.exeなど）にまとめることができるライブラリです。これにより、次のような利点があります：

  • Pythonがインストールされていない環境でもアプリケーションを実行できる
  • 必要なライブラリや依存関係をすべて含めた単一ファイルを配布できる
  • ユーザーは複雑なセットアップ手順なしに、ダブルクリックだけでアプリを起動できる
PyInstallerの基本ワークフロー Pythonスクリプト app.py モジュール ライブラリ 外部ファイル PyInstaller コマンド: pyinstaller app.py –onefile –noconsole 実行ファイル app.exe (すべてを含む) Python環境 依存関係 リソース PyInstallerはPythonスクリプトとすべての依存関係を含む独立した実行ファイルを作成します 生成された実行ファイルはPythonがインストールされていないPCでも動作します

基本的な使い方

インストール方法

まず、PyInstallerをインストールします：

pip install pyinstaller

基本コマンド

Pythonスクリプトを実行ファイルに変換するには、以下のコマンドを使用します：

pyinstaller スクリプト名.py --onefile

このコマンドを実行すると、カレントディレクトリに「dist」フォルダが作成され、その中にスクリプト名と同じ名前の実行ファイルが生成されます。

注意点と制限事項

PyInstallerを使用する際には、以下の点に注意してください：

  1. Python環境: Python 3.6以上が必要です
  2. クロスプラットフォーム: WindowsでビルドしたexeファイルはWindows専用、MacでビルドしたファイルはmacOS専用です
  3. ビット互換性: 64ビットOSで作成した実行ファイルは32ビットOSでは動作しませんが、32ビットOSで作成したファイルは両方の環境で動作します
  4. ライブラリのサポート: 多くの一般的なライブラリ（Pandas、TkinterなどのGUIライブラリ）はサポートされていますが、特殊なライブラリでは問題が発生する可能性があります

役立つオプション

コンソールウィンドウを非表示にする

GUIアプリケーションの場合、バックグラウンドのコンソールウィンドウを非表示にするには：

pyinstaller アプリ名.py --onefile --noconsole
PyInstallerの主要オプション PyInstaller コマンドオプション –onefile 単一の実行ファイル として出力 –noconsole コンソール画面を 表示しない –icon=file.ico カスタム アイコンを設定 .spec ファイル 詳細カスタマイズ リソース追加 pyinstaller app.py –onefile –noconsole –icon=app.ico コマンド例:

カスタムアイコンの設定

アプリケーションにカスタムアイコンを設定するには：

pyinstaller アプリ名.py --onefile --noconsole --icon=アイコン名.ico

Windowsではアイコンファイル（.ico）が必要です。画像ファイルからアイコンに変換するオンラインツールを利用することもできます。

外部ファイルの組み込み

画像ファイルやその他のリソースをアプリケーションに組み込むには、.specファイルを編集する必要があります：

  1. まず通常どおりPyInstallerを実行して.specファイルを生成
  2. .specファイル内で、a.datas リストに外部ファイルを追加
  3. 修正した.specファイルを使って再ビルド：
pyinstaller アプリ名.spec --onefile
import os
import sys

# リソースファイルへのパスを取得
def resource_path(relative_path):
    if hasattr(sys, '_MEIPASS'):
        return os.path.join(sys._MEIPASS, relative_path)
    return os.path.join(os.path.abspath("."), relative_path)

# 使用例
image_path = resource_path("画像名.jpg")
PyInstallerで外部ファイルを組み込む方法 app.spec a = Analysis([‘app.py’], pathex=[], binaries=[], datas=[], datas=[(‘image.jpg’, ‘.’), (‘data.csv’, ‘data’), (‘resources/*’, ‘resources’)], hiddenimports=[], hookspath=[], runtime_hooks=[]) pyinstaller app.spec –onefile import os, sys def resource_path(relative_path): if hasattr(sys, ‘_MEIPASS’): return os.path.join(sys._MEIPASS, relative_path) specファイルでリソースを指定してビルド: Pythonコード内でのリソースへのアクセス方法:
PyInstallerのプラットフォーム互換性 Windows app.exe ・Windowsで作成 ・Windows専用 ・32/64ビット ・アイコンは.ico形式 ・バックスラッシュ(\)パス ・cmd.exeコマンド macOS app ・macOSで作成 ・macOS専用 ・セキュリティ警告あり ・アイコンは.icns形式 ・スラッシュ(/)パス ・bash/zshコマンド Linux app ・Linuxで作成 ・Linux専用 ・実行権限が必要 ・ディストリビューション依存 ・スラッシュ(/)パス ・bashコマンド 重要: クロスプラットフォームでの配布には各OS用にビルドが必要! それぞれのOSで実行ファイルを作成すると、そのOS専用のファイルになります

まとめ

PyInstallerを使用すれば、Pythonスクリプトを独立した実行ファイルに変換でき、プログラミングの知識がないユーザーにも簡単に配布できます。基本的なコマンドから始めて、徐々にカスタムアイコンや外部リソースの組み込みなど、より高度な機能に取り組んでみましょう。

これであなたのPythonアプリケーションを友人や同僚と簡単に共有できるようになります！

新規記事

すべてを見る
人気記事ランキング
ピックアップ記事
話題のキーワードから探す