joshuaswarren/omarchy-apple-dev

选用指南

AI 根据 README 整理 · 2026/10/16 21:11:39

使用方式

通过命令行使用，运行 install-toolchain.sh 安装工具链，使用 xtool 命令创建和构建应用，使用 device-run.sh 部署到设备。

查看 README 依据

## Install New here? [GETTING-STARTED.md](GETTING-STARTED.md) walks from the Omarchy Install menu to a TestFlight upload. On Omarchy, **Install > Development > iOS** runs the steps below for you. ``` git clone https://github.com/joshuaswarren/omarchy-apple-dev cd omarchy-apple-dev ./install-toolchain.sh ``` The script installs the toolchain. It puts the toolchain's own clang first on PATH for the SDK install. It tells you exactly what is left if anything is. Safe to re-run. When it stops at the SDK step, download the matching

its packages no longer import, it removes the venv and rebuilds it against the interpreter on PATH. The venv is always created from the resolved interpreter path, never from the `latest` symlink, so a toolchain move cannot strand the installed packages. ## First app ``` xtool new HelloOmarchy cd HelloOmarchy xtool dev run ``` `xtool dev build` alone produces `xtool/HelloOmarchy.app` (arm64 Mach-O). ## Device Plug the iPhone in, tap Trust when prompted, then: ``` ./device-run.sh ``` > **Try Omarchy on Windows:** If this Omarchy installation runs in the virtual

部署要求

需要运行 Omarchy (Arch-based) 的 Linux 机器，支持 x86_64 和 Apple Silicon；需要 iPhone 和 USB 数据线；需要免费 Apple ID 用于签名和下载 Xcode.xip。

查看 README 依据

an iPhone to run the apps, an Apple ID for signing, and about 7 GB of temporary disk during setup. The table above has the details. For full mode: - An Apple Silicon or x86_64 Linux box running Omarchy (Arch-based). Both architectures are covered. AUR `swift-bin` ships aarch64 and x86_64, and the installer builds xtool from source on either. Other distributions can work: see [docs/DISTROS.md](docs/DISTROS.md) (Ubuntu 24.04 tested in a container). - An iOS device and a USB cable. - An Apple ID (free) for **one download from Apple**. That download is the

已知限制

Flutter 仅支持 release 构建，无调试、热重载或模拟器支持；无线部署在 iOS 26 上被阻止，仅 iOS 27 支持 Tailscale 远程部署。

查看 README 依据

- You need Flutter 3.47.x on `PATH` and the iPhoneOS SDK from the normal install. The one-time setup needs about 7 GB of disk. It builds the iOS `gen_snapshot` that Flutter ships only for macOS. - Setup took 5 min 23 s on a 16-core x86_64 machine. A laptop took about 12 minutes for setup. The counter template builds in 29 s with one plugin. - Release builds only. There is no debug, hot reload or simulator support. Plugins must ship a `Package.swift`. aarch64 hosts are untested. Details: [flutter/README.md](flutter/README.md).

> machine distributed by [tryomarchy.com](https://tryomarchy.com), complete the > [Windows VM iPhone USB setup](TRYOMARCHY-WINDOWS-USB.md) first. It provides > working USB passthrough and a patched `usbmuxd` for reliable app installs. > Bare-metal Omarchy installations do not need that guide. Wireless deploy is **blocked on iOS 26** for Linux-only setups, tested exhaustively (FINDINGS.md 17). iOS gives each host its own encrypted RemotePairing tunnel. A Linux host has no way to claim one. A Mac that once enabled "Connect via Network" holds a working wireless tunnel.