5.5 KiB
Skip Setup
macOS 按创建账户并跳过 Setup操作。以下步骤适用于 iPadOS。
需要 macOS 镜像工具、匹配的 packed Data seed 和设备 skip_setup_tool,按构建指南准备。执行下方 payload 命令后,再运行 ./unixnu bootimg 并启动新打包的镜像。
全新的 Data 种子首次启动会进入 Setup。负载可以在写镜像前把 Setup 标记为完成,让设备直接进入 SpringBoard。
操作步骤
- 准备匹配的 Data seed、macOS 镜像工具和设备的
skip_setup_tool。核对构建版本和 ADT 身份与所选 IPSW 一致。 - 需要调整 seed 大小时,先完成 Data 卷准备,记录所选 seed 路径。
- 执行负载命令,传入
--skip-setup和设备必需输入。检查输出,payload.json应包含"skip_setup": true。 - 运行
./unixnu bootimg,启动新镜像并按验证步骤检查,记录 seed、镜像版本和观察到的用户态阶段。
命令
./unixnu build payload \
--data-ramdisk data.dbr \
--skip-setup \
--trust-cache trustcache.img \
--unique-chip-id <hex>
--skip-setup 需要 --data-ramdisk。负载步骤读取板级文件中的 [payload] skip_setup_tool,并在种子副本上运行。
[payload]
skip_setup_tool = "scripts/seed-data-skip-setup.py"
skip_setup_args = ["--no-auto-dim"]
skip_setup_args 可选,接在两个路径参数之后传给工具。原始种子保持不变。负载使用修改后的副本作为 Payloads/scratch-data.img。
平板存储大于种子时,先用 scripts/seed-data-grow.py 增长种子。负载编辑增长后的种子并保留其大小。
工具修改的内容
scripts/seed-data-skip-setup.py 展开打包的 APFS Data 种子,以读写方式挂载,把偏好合入 /private/var/mobile/Library/Preferences,然后重新打包。
| 偏好文件 | 值 |
|---|---|
com.apple.purplebuddy |
SetupDone = true、SetupFinishedAllSteps = true、SetupVersion = 11、daemonizeNeedsToRun = false |
com.apple.purplebuddy.notbackedup |
所有 mini-buddy 标志设为 false:diagnostics、HSA2、keychain sync、Mesa、payment、standard、silent ICDP |
com.apple.managedconfiguration.notbackedup |
LockdownActivationIndicatesCloudConfigurationAvailable = false |
com.apple.springboard |
BKNoWatchdogs = true、FBLaunchWatchdogExceptions = { com.apple.purplebuddy: 100 }、MCForceShowCloudConfigurationUI = false |
com.apple.migration |
LastSystemVersion = 21H461、DMUserDataDisposition = { SyntheticDidUpgrade = false, buildVersion = 21H461 } |
--no-auto-dim 还会在 com.apple.springboard 里设置 SBDisableAutoDim、SBDontDimOrLockOnAC 和 SBDisableIdleSleep,与 UniXNU-qemu 的根文件系统构建脚本相同。没有按键或空闲计时不可用的板子,否则会在 SpringBoard 启动约 30 秒后关闭屏幕并让系统休眠。
工具还会在 /private/var/containers 下创建目录:
Bundle
Data/System
Shared/SystemGroup
Temp
卷 UUID 保持不变。修改后再次检查 APFS 容器 magic。
构建版本
脚本设置:
BUILD, VERSION = '21H461', '17.7.11'
板级目标换成其他 iOS build 时,同时更新这两个值。LastSystemVersion 和 DMUserDataDisposition.buildVersion 必须与 IPSW 一致。
设备树
提供的格式 2 OS profile 设置以下带类型的 /chosen 属性,格式 1 ADT 工具通过 --ipad-identity 选择它们:
| 属性 | 值 |
|---|---|
certificate-production-status |
0 |
effective-production-status-ap |
0 |
certificate-security-mode |
1 |
effective-security-mode-sep |
1 |
这些属性描述一个 dev-fused、未 demote 的板子。mobileactivationd 通过 MobileGestalt 读取它们,在没有激活记录时走原生激活路径。其他身份属性和缓存答案见 MobileGestalt 身份。
任务
在 sheng 的 iPadOS 27.0.1(24A446)上,lite=1 允许 launchd 按需启动 iconservicesagent。IconRendering 使用 Metal。该服务设置 FORCE_SOFTWARE_RENDERER=0 和 CI_ENABLE_METAL_GPU=0。J820 原厂配置的非活跃硬上限为 15 MiB,活跃软上限为 1,224 MiB。
lite=2 停用图标服务。主屏幕和 Dock 只显示图标底板,「设置」仍可打开。也可用 disable-jobs 单独指定服务,多个 launchd 标签用逗号分隔。
disable-jobs=com.apple.identityservicesd,com.apple.locationd
输出
负载目录包含:
out/<device>/<os_profile>/<config>/payload/data-skip-setup-<hash>.dbr
out/<device>/<os_profile>/<config>/payload/payload.img
out/<device>/<os_profile>/<config>/payload/payload.json
payload.json 记录:
| 字段 | 含义 |
|---|---|
data_ramdisk_sha256 |
修改后种子的哈希 |
skip_setup |
true |
payload_sha256 |
负载镜像哈希 |
修改后的种子按原始种子和 skip_setup_args 的哈希缓存。换一个种子或换一组参数会生成新文件。
验证
- 用
--skip-setup构建负载。 - 检查
payload.json的"skip_setup": true。 - 运行
./unixnu bootimg,再启动新生成的镜像。 - 日志到达 SpringBoard,不再停留在 Setup 页面。
参考实现是本仓库的 scripts/seed-data-skip-setup.py。