Skip to content

💻 macOS( mac 操作系统) 部署

WantHelp!

寻找一位 mac—arm64 开发者维护 mac 应用程序(本人渣配置台式开始跑不动 mac 虚拟机了)

🚩 前置架构相关

通过以下命令查看架构(一般英特尔芯片i系的即为x86_64, 苹果芯片m系的为arm64

bash
python -c "import platform; print(platform.machine())"
  1. x86_64 架构: 开发者虚拟机就是该架构,一般按下面流程走即可
  2. arm64 架构: CGS-init.app 会自动安装Rosetta 2,下文中有列出一些应对CGS.app无法打开的处理方案

📑 绿色包说明

macOS 仅需下载 CGS-macOS压缩包

解压后目录树(点击展开)
  CGS-macOS
   ├── CGS.app                     # 既是 *主程序*,也可以当成代码目录文件夹打开,执行脚本 `scripts/deploy/launcher/mac/CGS.bash`  
   |    ├── Contents
   |         ├── Resources
   |              ├── scripts      # 真实项目代码目录
   ├── CGS-init.app                # 执行脚本 `scripts/deploy/launcher/mac/init.bash`
   └── CGS_macOS_first_guide.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__.pyfont值,有注释说明)
2. 每次解压后,必须运行CGS-init.app检测/安装环境,
⚠️ 注意新打开的终端窗口并根据提示操作 ⚠️(对应第1.5步改字体可以反复执行第2步)
app应用目前用的Platypus将代码封装成app,处理方式与win的随意位置有所不同
app移至应用程序

🔰 其他

针对弹窗报错的尝试

bash
# arm64 CGS.app显示损坏无法打开时
/opt/homebrew/bin/python3.12 /Applications/CGS.app/Contents/Resources/scripts/CGS.py
# 或
/usr/local/bin/python3.12 /Applications/CGS.app/Contents/Resources/scripts/CGS.py

都失败的话可先自行deepseek等寻找方法 / 群内反馈

更新相关

⚠️ 配置文件/去重记录均存放在scripts上,注意避免下包直接覆盖导致丢失
版本如若涉及到 UI/界面变动 相关的,最好运行 CGS-init.app 一下以保证字体等设置

bug report / 提交报错 issue

macOS上运行软件出错需要提issue时,除了选择系统选macOS以外,还需要在描述上说明系统版本与架构
(开发者测试开发环境为macOS Sonoma(14) / x86_64

ComicGUISpider Released under the MIT License. (latest: v2.1)