用Python和py2app寫獨立的Mac OS X 應用

文／lovexiaov（簡書作者）
原文鏈接：http://www.jianshu.com/p/afb6b2b97ce9
著作權歸作者所有，轉載請聯系作者獲得授權，並標注“簡書作者”。

前提

創建一個普通文件夾，並創建一個virtualenv環境：

# Create a custom directory $ mkdir SandwichApp $ cd SandwichApp # Use virtualenv to create an isolated environment $ virtualenv venv $ . venv/bin/activate

現在，創建一個簡單的Tkinter應用，並其命名為 Sandwich.py：

import sys
if sys.version_info < (3, 0):
    # Python 2
    import Tkinter as tk
else:
    # Python 3
    import tkinter as tk
root = tk.Tk()
root.title("Sandwich")
tk.Button(root, text="Make me a Sandwich").pack()
tk.mainloop()

 

這個小應用是這個樣子：

app_screen.png

安裝 py2app

原版的 py2app 由於 ModuleGraph 更新了版本產生了一個 bug。我 fork 了該工程，解決了 bug，然后放到了 Github。使用 pip 安裝 py2app：

$ pip install -U git+https://github.com/metachris/py2app.git@master

創建 setup.py 文件

py2app 包含了 py2applet 工具， 此工具可以幫你創建 setup.py 文件：

$ py2applet --make-setup Sandwich.py Wrote setup.py

setup.py 文件是對應用的基本定義：

from setuptools import setup

APP = ['Sandwich.py']
DATA_FILES = []
OPTIONS = {'argv_emulation': True}

setup(
    app=APP,
    data_files=DATA_FILES,
    options={'py2app': OPTIONS},
    setup_requires=['py2app'],
)

 

如果你的應用使用的其他文件，比如 JSON 文件，文本文件，圖片等，你應該將他們包含在 DATA_FILES 中。 例如：

DATA_FILES = ['testdata.json', 'picture.png']

創建開發版和測試版的應用

py2app 基於在 setup.py 文件的定義創建獨立應用。

為了方法測試和開發，py2app 提供了“別名模式”，該模式通過與開發文件象征性的鏈接構建應用。

$ python setup.py py2app -A

此命令創建了如下文件和文件夾：

.
├── build │ └── bdist.macosx-10.10-x86_64 │ └── python2.7-standalone │ └── app │ ├── Frameworks │ ├── collect │ ├── lib-dynload │ └── temp ├── Sandwich.py ├── dist │ └── Sandwich.app │ └── Contents │ ├── Info.plist │ ├── MacOS │ │ ├── Sandwich │ │ └── python -> /Users/chris/Projects/chris/python-gui/tkinter/env/bin/../bin/python │ ├── PkgInfo │ └── Resources │ ├── __boot__.py │ ├── __error__.sh │ ├── lib │ │ └── python2.7 │ │ ├── config -> /Users/chris/Projects/chris/python-gui/tkinter/env/bin/../lib/python2.7/config │ │ └── site.pyc -> ../../site.pyc │ ├── site.py │ └── site.pyc └── setup.py

這並不是一個獨立的應用，並且通過別名模式構建的應用不適用於其他機器。

別名模式下構建的應用直接引用了源碼文件，所以任何對 Sandwich.py 文件作的修改在應用下次啟動時會立刻生效。

位於 dist/Sandwich.app 的開發應用可以和其他 .app 應用一樣，在 Finder 中或通過 open 命令（$ open dist/Sandwich.app）啟動。你可以在終端執行如下命令啟動你的應用：

$ ./dist/Sandwich.app/Contents/MacOS/Sandwich

構建發布版應用

當測試通過后，你可以通過調用 python setup.py py2app 來生成發布版。確保舊的 build 和 dist 文件類都被刪除了：

$ rm -rf build dist $ python setup.py py2app

此命令會將你的應用打包為 dist/Sandwich.app。由於該應用是自包含的，在任意時刻，如果你修改了代碼，數據文件，選項等，你都可以再次運行 py2app 命令重新構建。

原版的 py2app 有一個 bug，會出現 “AttributeError: 'ModuleGraph' object has no attribute 'scan_code'” 或者 load_module。如果你遇到此錯誤，請參考 StackOverflow 或者使用我的 py2app fork。

此時此刻，最簡單的打包並發布應用的方法是在 Finder 中右擊該應用選擇“創建歸檔”。

添加一個圖標：

在 OPTIONS 字典中添加 "iconfile": "youricon.icns" 即可：

from setuptools import setup

APP = ['Sandwich.py']
DATA_FILES = []
OPTIONS = {
    'argv_emulation': True,
    'iconfile': 'app.icns'
}

setup(
    app=APP,
    data_files=DATA_FILES,
    options={'py2app': OPTIONS},
    setup_requires=['py2app'],
)

　　

你可以在網上找到 icns 格式的圖標（例如：IconFinder或者freepik）。

應用高級設置

你可以通過修改 Info.plist 來調用應用的信息各行為。最完整的對可用的鍵的引用是Apple's Runtime Configuratin Guidelines。

下面是一個有更多修改的例子：

# -*- coding: utf-8 -*-
from setuptools import setup

APP = ['Sandwich.py']
APP_NAME = "SuperSandwich"
DATA_FILES = []

OPTIONS = {
    'argv_emulation': True,
    'iconfile': 'app.icns',
    'plist': {
        'CFBundleName': APP_NAME,
        'CFBundleDisplayName': APP_NAME,
        'CFBundleGetInfoString': "Making Sandwiches",
        'CFBundleIdentifier': "com.metachris.osx.sandwich",
        'CFBundleVersion': "0.1.0",
        'CFBundleShortVersionString': "0.1.0",
        'NSHumanReadableCopyright': u"Copyright © 2015, Chris Hager, All Rights Reserved"
    }
}

setup(
    name=APP_NAME,
    app=APP,
    data_files=DATA_FILES,
    options={'py2app': OPTIONS},
    setup_requires=['py2app'],
)

　　

通過設置，應用會擁有下面的信息：

get_info.png