Skip to content

Latest commit

 

History

History
55 lines (43 loc) · 4.13 KB

EXTRA.md

File metadata and controls

55 lines (43 loc) · 4.13 KB

macOS(mac操作系统) 额外说明

📑绿色包说明

macOS 需要下载 CGS-macOS压缩包 (不需要下载CGS.7z)，解压后目录树如下

  CGS-macOS
   ├── extra
        └── dos2unix.bash       # 处理win转unix的换行字符，对应处理 `syntax error: unexpected end of file` 之类的错误
   ├── CGS.app                  # 既是 *主程序*，也可以当成代码目录用访达打开  
        ├── Contents
             ├── Resources
                  ├── scripts   # 真实项目代码目录
   ├── CGS-更新.app              # 执行脚本 `scripts/deploy/launcher/mac/update.bash`
   ├── CGS-初始化.app            # 执行脚本 `scripts/deploy/launcher/mac/init.bash`
   ├── CGS-使用说明.app          # 执行脚本 `scripts/deploy/launcher/mac/desc.bash`
   └── desc_macOS.html          # 仅用作刚解压时提供指引的一次性使用说明

⛵️操作

全部说明含scripts目录的，包括此额外说明，主说明README，release页面，issue的等等等等，
在app移至应用程序后的绝对路径皆指为/Applications/CGS.app/Contents/Resources/scripts

先执行下面的初始化步骤（ 全部 .app 第一次无法双击打开时，第二次需要右键打开，再以后就能双击打开 ）

解析说明
初始化 以下步骤严格按序执行
1. 每次解压后，将CGS.app移至应用程序（下有图示）
1.5 （可选，需要在第2步前进行）由于macOS没微软雅黑字体，默认替换成冬青黑体简体中文
（不清楚是否每种macOS必有，留了后门替换，在 scripts/deploy/launcher/mac/__init__.py 的font值，有注释说明）
2. 每次解压后，必须运行CGS-初始化检测/安装环境，注意新打开的终端窗口并根据提示操作（对应第1.5步改字体可以反复执行此步）
使用 默认储存路径：当前用户的(下载目录)Downloads/Comic，更换的话到配置窗口更改即可（使用绝对路径，如 /Users/xxxxxx/Downloads/Comic）
app应用 目前用的Platypus将代码封装成app，处理方式与win的随意位置有所不同
app移至应用程序

🔰其他

更新相关

大更新以后通知重新下载绿色包都与macOS无关，因为除了主程序CGS.app以外都是间接运行scripts/deploy/launcher/mac里的bash脚本
环境补充部分今后将通过更改requirements.txt实现，CGS-更新.app后需运行一次CGS-初始化.app更新环境（需要更新环境时会在多处进行提醒）

更新如若涉及到 UI/界面变动 相关的，最好运行 CGS-初始化 一下以保证字体等设置

bug report / 提交报错issue

macOS上运行软件出错需要提issue时，除了选择系统选macOS以外，还需要在描述上说明或截图使用的版本
（开发者测试环境为macOS Sonoma(14)）