Compare commits

...

16 Commits

13
.gitignore vendored

@ -244,4 +244,15 @@ new_venv/
.idea/
# Local configuration
config/local_settings.json
config/local_settings.json
# Installation packages
*.dmg
*.exe
*.msi
*.zip
*.tar.gz
*.app/
# Distribution packages
dist_package/

@ -0,0 +1,101 @@
# 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+

@ -90,13 +90,23 @@ pip install -r requirements.txt
已使用PyInstaller创建了独立的Windows可执行文件位于 `dist/MagicWord.exe`
### Mac平台打包
已创建了Mac应用程序bundle和DMG安装包
- `MagicWord.app` - Mac应用程序bundle
- `MagicWord_v0.1.0_macOS.dmg` - Mac安装包
详细说明请查看 [MAC_PACKAGING_INSTRUCTIONS.md](MAC_PACKAGING_INSTRUCTIONS.md) 文件。
### 创建安装包
详细说明请查看 [PACKAGING_INSTRUCTIONS.md](PACKAGING_INSTRUCTIONS.md) 文件其中包含了使用Inno Setup或NSIS创建安装包的完整步骤。
### 直接运行
如果不需要安装包,可以直接运行 `dist/MagicWord.exe` 文件,该文件包含了所有必要的依赖。
如果不需要安装包,可以直接运行相应平台的可执行文件:
- Windows: `dist/MagicWord.exe`
- Mac: `MagicWord.app`
## 查看发布说明

Loading…
Cancel
Save