The porting flow covers the macos-27.3-26C5035r profile from profile
selection to the porting record: the macOS profile page lists the profile
contents, host inputs, board.toml override, Data seed, build commands,
driver adaptations and boot checkpoints, and the steps, arm64e, packaging,
records, bring-up, building, requirements and reference pages point to it.
The iPadOS instructions are unchanged.
Porting pages link porting pages for driver topics: Develop a driver and
Brightness interface are porting pages, and component names in porting
pages are plain text. English and Chinese pages.
The target table names the iOS 16.7.16 (iPhone X), iPadOS 17.7.11,
iOS 27.0.1 (iPhone 16 Pro) and iPadOS 27.0.1 restore images from
ipsw.me with their architecture. iOS 16 and iPadOS 17 are both arm64 and
share the arm64 patch series. Pages that named iPadOS alone now name iOS
or iPadOS where both apply, and the iPadOS 26 profile is no longer
described.
GKI devices carry no ramdisk in boot and a vendor ABL rejects one there, so
anything large that has to reach the bootloader belongs in vendor_boot's vendor
ramdisk. Nothing in the tree could rewrite that image while leaving the stock one
intact.
Copy the device tree, the ramdisk table, the bootconfig and the vbmeta blob
verbatim; change only the ramdisk bytes, the header's vendor_ramdisk_size, the
ramdisk address and each table entry's size and offset; retarget the AVB footer
because the vbmeta blob moves. --ramdisk-addr relocates the ramdisk, which stock
images need when the default window is smaller than the payload.
--verify-against repacks the stock ramdisk and requires a byte-identical result
before the real ramdisk is written, so a device whose layout differs fails loudly
instead of producing an unbootable partition.
The offline tests build a synthetic v4 image and cover the repack, the
relocation, the partition limit and the refusals; the command and its flags are
documented in docs/reference/cli.md and the Chinese page. Checked on the NX769J
against its stock vendor_boot: the stock image is reproduced byte for byte, and
the 64 MiB payload image the tool produces is the one that boots on hardware.
The packaging page describes the implemented unixnu release command, its
board.toml keys, the outputs and the checks verify makes. The arm64e page states
that arm64e needs native PAC hardware, that iPadOS 18 is the last version that
supports arm64, recommends PAC devices and the iOS or iPadOS 27 profile, and
states that every driver and optimization must work for 17 and 27 with the
build target as the only difference.
Add English and Simplified Chinese documentation under docs/, covering the boot chain, build, boot, debugging, porting, drivers, XNU 4 KiB pages, macOS and device notes. Add the Pages workflow and CNAME. Rename the boot manager from CrabApple to UniXNU across the package, symbols, paths, configuration file and logs. Update README with the documentation badge and CONTRIBUTING link.