|
|
|
|
@ -1,101 +0,0 @@
|
|
|
|
|
# Mac平台打包说明
|
|
|
|
|
|
|
|
|
|
## 概述
|
|
|
|
|
|
|
|
|
|
本文档说明了如何为Mac平台创建隐私学习软件(MagicWord)的安装包。
|
|
|
|
|
|
|
|
|
|
## 创建的文件
|
|
|
|
|
|
|
|
|
|
1. `MagicWord.app` - Mac应用程序bundle
|
|
|
|
|
2. `MagicWord_v0.1.0_macOS.dmg` - Mac安装包(DMG格式)
|
|
|
|
|
|
|
|
|
|
## 打包过程
|
|
|
|
|
|
|
|
|
|
打包过程由 `create_mac_app_bundle.py` 脚本自动完成,包括以下步骤:
|
|
|
|
|
|
|
|
|
|
1. 创建应用程序bundle目录结构
|
|
|
|
|
2. 生成Info.plist配置文件
|
|
|
|
|
3. 创建启动脚本
|
|
|
|
|
4. 复制应用程序源代码和资源文件
|
|
|
|
|
5. 创建DMG安装包
|
|
|
|
|
|
|
|
|
|
## 运行要求
|
|
|
|
|
|
|
|
|
|
在Mac上运行此应用程序需要:
|
|
|
|
|
|
|
|
|
|
1. macOS 10.12或更高版本
|
|
|
|
|
2. Python 3.8或更高版本
|
|
|
|
|
3. 以下Python依赖包:
|
|
|
|
|
- python-docx>=0.8.10
|
|
|
|
|
- PyPDF2>=1.26.0
|
|
|
|
|
- ebooklib>=0.17.1
|
|
|
|
|
- PyQt5>=5.15.0
|
|
|
|
|
- requests>=2.25.1
|
|
|
|
|
- beautifulsoup4>=4.11.0
|
|
|
|
|
- pillow>=9.0.0
|
|
|
|
|
- chardet>=4.0.0
|
|
|
|
|
|
|
|
|
|
## 安装和运行
|
|
|
|
|
|
|
|
|
|
### 方法1:使用DMG安装包
|
|
|
|
|
|
|
|
|
|
1. 双击 `MagicWord_v0.1.0_macOS.dmg` 文件
|
|
|
|
|
2. 将 `MagicWord.app` 拖拽到Applications文件夹
|
|
|
|
|
3. 在Applications中双击 `MagicWord.app` 运行程序
|
|
|
|
|
|
|
|
|
|
### 方法2:直接运行
|
|
|
|
|
|
|
|
|
|
1. 双击 `MagicWord.app` 运行程序
|
|
|
|
|
|
|
|
|
|
### 方法3:命令行运行
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
# 进入应用程序目录
|
|
|
|
|
cd /path/to/MagicWord.app/Contents/MacOS/
|
|
|
|
|
|
|
|
|
|
# 运行应用程序
|
|
|
|
|
./MagicWord
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
## 故障排除
|
|
|
|
|
|
|
|
|
|
### 依赖问题
|
|
|
|
|
|
|
|
|
|
如果遇到依赖问题,请在终端中运行以下命令安装所需依赖:
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
pip3 install -r requirements.txt
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
### Qt平台插件问题
|
|
|
|
|
|
|
|
|
|
如果遇到Qt平台插件错误,请确保已安装Qt5:
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
# 使用Homebrew安装Qt5
|
|
|
|
|
brew install qt5
|
|
|
|
|
|
|
|
|
|
# 或者使用pip安装PyQt5
|
|
|
|
|
pip3 install PyQt5
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
## 文件结构
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
MagicWord.app/
|
|
|
|
|
├── Contents/
|
|
|
|
|
│ ├── Info.plist
|
|
|
|
|
│ ├── MacOS/
|
|
|
|
|
│ │ └── MagicWord # 启动脚本
|
|
|
|
|
│ └── Resources/
|
|
|
|
|
│ ├── requirements.txt # 依赖列表
|
|
|
|
|
│ ├── resources/ # 应用程序资源
|
|
|
|
|
│ ├── run_app.sh # 启动脚本
|
|
|
|
|
│ └── src/ # 源代码
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
## 版本信息
|
|
|
|
|
|
|
|
|
|
- 应用程序名称:MagicWord
|
|
|
|
|
- 版本:0.1.0
|
|
|
|
|
- 平台:macOS 10.12+
|