12 Commits

  • docs(porting): cover the macOS path
    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.
  • docs: list iOS and iPadOS restore images and drop the 26 profile
    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.
  • feat(scripts): rebuild a vendor_boot v4 image around a new vendor ramdisk
    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.
  • docs(porting): the real packaging script, the PAC requirement and the release command
    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.
  • docs: describe module submodules and UFS support
    Update clone commands, repository layout and the device pages. Mark the
    native UFS root as available.
  • docs: add the VitePress documentation site
    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.