見出し画像

Pythonスクリプトを実行ファイルに変換！初心者でも簡単にできるPyInstallerの使い方【Win/Mac対応】

つちや【DX＋WEB集客コンサルタント】

Pythonで作ったスクリプトをお客さんに渡して試しに動かしてもらいたいとき、そのままではPython環境がないと動かせないことに気付いたことはありませんか？そんなときに便利なのが「PyInstaller」というツールです。このツールを使えば、Pythonスクリプトを**実行可能なファイル（exeファイルなど）**にまとめることができます。

この記事では、プログラミング初心者向けに、PyInstallerの基本的な使い方や注意点をわかりやすく解説します。WindowsとMacの両方で対応していますので、ぜひ参考にしてみてください！


1. PyInstallerとは？

PyInstallerは、Pythonで書かれたスクリプトを1つの実行可能ファイル（exeファイルなど）にまとめることができるライブラリです。このツールを使うと、Pythonがインストールされていない環境でも、スクリプトを実行することができます。

PyInstallerが便利なシーン

  • Python環境がない人にアプリを配布したいとき

  • 環境構築の手間を省きたいとき

  • ライブラリのインストールやバージョン依存を気にせずに配布したいとき

2. PyInstallerの基本的な使い方

➀ インストール

PyInstallerはPythonのパッケージ管理ツール「pip」で簡単にインストールできます。

pip install pyinstaller

➁ 実行ファイルの作成

以下のコマンドを実行するだけで、Pythonスクリプトを実行ファイルにまとめることができます。

pyinstaller --onefile your_script.py

  • --onefile オプション：全てのファイルを1つの実行ファイルにまとめます。

  • your_script.py：変換したいPythonスクリプトのファイル名を指定します。

➂ 出力フォルダを確認

コマンドを実行すると、スクリプトを実行したディレクトリ内に「dist」フォルダが生成され、その中に作成された実行ファイルが格納されています。

3. 注意点と制約

PyInstallerにはいくつかの注意点があります。事前に確認しておきましょう。

（1）Pythonのバージョン

PyInstallerはPython 3.6以上に対応しています。古いバージョンを使っている場合は、最新バージョンにアップデートしてください。

（2）OSの互換性

  • Windowsで作成した実行ファイルはWindowsでのみ動作します。

  • Macで作成した実行ファイルはMacでのみ動作します。

  • 32ビットと64ビットのOS間でも互換性がないため、必要な環境で作成する必要があります。

（3）使用ライブラリの対応

多くのライブラリは問題なく動作しますが、一部のライブラリでは正常に動作しない場合があります。事前に動作確認をしておくと安心です。

4. より便利に使うためのオプション

PyInstallerには多くのオプションが用意されています。以下は特によく使うオプションの一例です。

➀ コンソールを非表示にする

デスクトップアプリでは、コンソールが不要な場合があります。以下のコマンドを使うと、コンソールを非表示にできます。

pyinstaller --onefile --noconsole your_script.py

➁ 実行ファイルにアイコンを設定

実行ファイルにオリジナルのアイコンを設定するには、--icon オプションを使います。

pyinstaller --onefile --noconsole --icon=your_icon.ico your_script.py

  • アイコンファイルは.ico形式で準備してください。

  • Windowsの場合、画像ファイルをアイコンに変換するオンラインツールが便利です。

➂ 外部ファイルを含める

外部ファイル（画像、データファイルなど）を実行ファイルに含めるには、.spec ファイルを編集します。以下のように、外部ファイルを追記してください。

a.datas += [('your_file.jpg', './your_file.jpg', 'DATA')]

5. 具体例で学ぶPyInstaller

以下は、実際の例をいくつか紹介します。

例1：シンプルなスクリプトを実行ファイル化

# today.py
from datetime import datetime

print(f"今日は {datetime.now().strftime('%Y年%m月%d日')} です")

上記のスクリプトをpyinstaller --onefile today.pyで変換すると、「今日は2023年1月27日です」と表示される実行ファイルが作成されます。

例2：デスクトップアプリの作成

# simple_app.py
import tkinter as tk

root = tk.Tk()
root.title("サンプルアプリ")
btn = tk.Button(root, text="閉じる", command=root.quit)
btn.pack()
root.mainloop()

これをpyinstaller --onefile --noconsole simple_app.pyで変換すると、コンソールのないデスクトップアプリが完成します。

6. まとめ

PyInstallerを使えば、Pythonスクリプトを簡単に実行ファイルに変換でき、配布や実行が楽になります。今回の記事で紹介した基本的な使い方やオプションを活用して、独自のアプリを作成してみましょう。

知っておきたいポイント

  • PyInstallerはPython環境がないPCでもスクリプトを実行可能にする。

  • OSごとの互換性や使用ライブラリの確認が必要。

  • オプションを活用して、さらに便利な実行ファイルを作成可能。

最後に、この記事が役に立ったと思ったら、ぜひスキをお願いします！
次回もお楽しみに！

この記事の内容をもとに追加したい情報や具体例があれば、お知らせください！

いいなと思ったら応援しよう！