Files
wikideck/docs/night/IOS.md
T
2026-11-16 22:52:16 -05:00

2.6 KiB

iOS app and macOS VM (Night 1, mobile-ios, issue #9)

Status: DRAFT, updated through the night. See "What's verified" at the bottom.

Where things are (inspiron-3670, outside git)

Path What
~/worker/jobs/macos/boot-macos.sh Starts the VM (QEMU/KVM, OSX-KVM style): 8 GB RAM, 4 vCPU, q35, OpenCore
~/worker/jobs/macos/mac_hdd_ng.qcow2 80 GB macOS system disk
~/worker/jobs/macos/BaseSystem.img macOS recovery/installer image (from macos-fetch)
~/worker/jobs/macos/OpenCore*.qcow2 OpenCore bootloader (from kholia/OSX-KVM)
~/worker/jobs/macos/OVMF_*.fd UEFI firmware + NVRAM (VARS is per-VM, writable)
~/worker/jobs/macos/CREDENTIALS.txt Local macOS user + password, mode 600. Never in git.
~/worker/jobs/macos/vnc.sh vncdotool wrapper for the VM's VNC (capture/type/click)
~/worker/jobs/macos/guest/provision.sh Runs inside the VM: Command Line Tools, Node (no Apple ID)

Start the VM

cd ~/worker/jobs/macos
NO_INSTALLER=1 setsid ./boot-macos.sh > qemu.log 2>&1 &   # after install; omit NO_INSTALLER to attach the installer
  • VNC: 127.0.0.1:5911 (display :11), localhost only, no password. From another machine: ssh -L 5911:127.0.0.1:5911 eric@inspiron-3670 then point a VNC viewer at localhost:5911.
  • SSH into macOS: ssh -p 10022 <user>@127.0.0.1 (user/password in CREDENTIALS.txt).
  • QEMU monitor: socat - UNIX-CONNECT:$HOME/worker/jobs/macos/qemu-monitor.sock (system_powerdown to shut down cleanly).
  • In the OpenCore picker, choose the macOS disk (or "macOS Base System" for the installer).

Eric's 10-minute checklist

  1. Start the VM (above), open VNC, log in as the local user.
  2. Sign in with your Apple ID in the App Store (or developer.apple.com/download) and install Xcode. Launch it once, accept the license, let it install the iOS platform + a simulator runtime.
  3. Over SSH (or Terminal in the VM): ~/wikideck/scripts/ios/build-sim.sh It runs npm ci, npm run build, npx cap sync ios, builds for the simulator with xcodebuild, boots a simulator and launches dev.eom.wikideck.
  4. A screenshot lands in ~/wikideck-ios-sim.png.

App notes

  • Capacitor app id dev.eom.wikideck, webDir: dist, scaffold from mobile-android (#8).
  • iOS WebView origin is capacitor://localhost (iOS forbids https as a custom scheme), so the testnet allowlist in server/testnet/http.ts must include it (coordinated on #8).
  • Node URL: build-time VITE_NODE_URL (defaults to the testnet), same as Android.

What's verified

  • (filled in as the night goes)