设置
AppPorts 的设置页面可通过主窗口右上角的齿轮图标访问。
App Store 与 iOS 设置
| 设置项 | 说明 | 默认值 |
|---|---|---|
| App Store 应用迁移 | 允许迁移 App Store 应用。macOS 15.1 以下版本如需迁移此类应用,需要手动开启 | 关闭 |
| iOS 应用迁移 | 允许迁移 iOS/iPadOS 应用(Mac 版) | 关闭 |
macOS 15.1+ 用户
macOS 15.1 及以上版本支持 App Store 应用原生安装到外部存储。建议优先在 App Store 设置中开启「下载并安装大型 App 到独立存储盘」,而不是使用 AppPorts 的手动迁移开关。
签名设置
| 设置项 | 说明 | 默认值 |
|---|---|---|
| 自动重签名 | 数据目录迁移完成后,自动对关联应用执行 Ad-hoc 重签名;迁移容器类数据时会作为默认建议并弹出确认 | 关闭 |
| 开机自动重签名 | 每次用户登录时,自动对签名已失效的已迁移应用执行 Ad-hoc 重签名 | 开启 |
开启「自动重签名」后,AppPorts 会在每次数据目录迁移完成后备份原始签名并执行重签名,降低迁移后出现「已损坏」提示的概率。
在数据目录页中,「迁移后重签名」开关位于顶部工具栏。迁移 Containers 或 Group Containers 相关数据时,AppPorts 会在开始迁移前确认是否迁移完成后重签名:选择「同意重签名」会在迁移后对关联应用执行 Ad-hoc 重签名;选择「不同意,仅迁移」则只迁移数据目录。
开启「开机自动重签名」后,系统会安装一个 LaunchAgent(com.shimoko.AppPorts.re-sign)。每次用户登录时,它会扫描签名备份记录,并自动对 Ad-hoc 签名已失效的应用重新签名。重签名日志会写入 AppPorts 默认日志文件。
已链接应用的自动重签名
对于状态为「已链接」的应用,自动重签名会解析 Stub Portal 壳或符号链接背后的外部真实应用路径,确保签名变更作用于实际应用包,而不是本地入口壳。备份和重签名操作均以真实应用的 Bundle ID 为标识。
日志设置
| 设置项 | 说明 | 默认值 |
|---|---|---|
| 启用日志记录 | 将运行日志写入文件 | 开启 |
| 最大日志大小 | 日志文件超出限制后,自动截断较旧的一半内容 | 2 MB |
| 日志位置 | 日志文件保存路径 | ~/Library/Application Support/AppPorts/AppPorts_Log.txt |
日志操作
| 操作 | 说明 |
|---|---|
| 在 Finder 中查看 | 打开日志文件所在目录 |
| 导出诊断包 | 生成包含日志、操作记录和系统信息的 ZIP 文件 |
| 清空日志 | 清除当前日志文件内容 |
日志详细说明请参阅日志与诊断。
