Skip to content

EXTRA.md

Latest commit

 

History

History
70 lines (50 loc) · 4.11 KB

EXTRA.md

File metadata and controls

70 lines (50 loc) · 4.11 KB

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

🚩前置架构相关

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

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__.py 的font值，有注释说明）
2. 每次解压后，必须运行CGS-init.app检测/安装环境，
⚠️ 注意新打开的终端窗口并根据提示操作 ⚠️（对应第1.5步改字体可以反复执行第2步）
app应用 目前用的Platypus将代码封装成app，处理方式与win的随意位置有所不同
app移至应用程序

🔰其他

针对弹窗报错的尝试

# 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）