People have dreamed of running macOS on iPad for more than a decade. Today, that dream comes true. With Virtual Mac, iPad finally breaks free from iPadOS, enabling pro apps like Xcode, Terminal, Final Cut Pro, Logic Pro, and Pixelmator Pro to run directly on device. Requires iPad Pro (M1, M2) or iPad Air (M1) running iPadOS 14 up to 16.3.1.
Shell
#!/bin/bash
set -euo pipefail
SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
# shellcheck source=../lib/common.sh
source "$SCRIPT_DIR/../lib/common.sh"
BUNDLE="${1:-/var/mobile/Media/VirtualMac/Sequoia.bundle}"
TIMEOUT="${VZ_IPAD_BOOT_TIMEOUT:-120}"
REMOTE_APP_PATTERN="/VirtualMac.app/VirtualMac"
[[ "$TIMEOUT" =~ ^[1-9][0-9]*$ ]] ||
die "VZ_IPAD_BOOT_TIMEOUT must be a positive integer"
printf -v bundle_quoted '%q' "$BUNDLE"
VZ_STOP_HOST=1 "$SCRIPT_DIR/stop-ipad-vm.sh"
ipad_ssh "
set -eu
bundle=$bundle_quoted
for name in Disk.img AuxiliaryStorage HardwareModel MachineIdentifier; do
test -f \"\$bundle/\$name\"
done
killall VirtualMac 2>/dev/null || true
killall com.apple.Virtualization.Installation 2>/dev/null || true
killall usbmuxd 2>/dev/null || true
rm -f /var/run/usbmuxd /tmp/vzusbmuxd /tmp/vz-usbmuxd-enable
rm -f /tmp/VirtualMac.log /tmp/vzxpchook.log /tmp/vmmhook.log \
/tmp/vmm.stderr.log /tmp/vmm_ep.txt /tmp/pvg-trace.log
touch /tmp/VirtualMac.log /tmp/vzxpchook.log /tmp/vmmhook.log \
/tmp/vmm.stderr.log /tmp/vmm_ep.txt /tmp/pvg-trace.log
chown mobile:mobile /tmp/VirtualMac.log /tmp/vzxpchook.log /tmp/vmmhook.log \
/tmp/vmm.stderr.log /tmp/vmm_ep.txt /tmp/pvg-trace.log
printf '%s\\n' \"\$bundle\" >/tmp/vz-autoboot-path
chown mobile:mobile /tmp/vz-autoboot-path
uiopen_path=/var/jb/usr/bin/uiopen
test -x "\$uiopen_path" || uiopen_path=/usr/bin/uiopen
"\$uiopen_path" --bundleid com.mac.virtual
"
for ((elapsed = 0; elapsed < TIMEOUT; elapsed++)); do
result="$(ipad_ssh "
if grep -Fq '[VirtualMac] VM STARTED state=1' /tmp/VirtualMac.log; then
echo started
elif grep -q 'VM start failed:' /tmp/VirtualMac.log; then
echo failed
elif test '$elapsed' -ge 10 &&
! ps ax | grep -F '$REMOTE_APP_PATTERN' | grep -v grep >/dev/null 2>&1; then
echo stopped
else
echo pending
fi
")"
case "$result" in
started)
# A VMM can publish state=1 and then crash while its first device
# queues are coming online. Require a short healthy window so this
# harness cannot report that failure as a successful boot.
sleep 5
health="$(ipad_ssh "
if grep -q 'VM start failed:\|Virtual Mac stopped:' /tmp/VirtualMac.log; then
echo failed
elif ps ax | grep -F '$REMOTE_APP_PATTERN' | grep -v grep >/dev/null 2>&1 &&
ps ax | grep -F '/payload/VirtualMachine.xpc/Contents/MacOS/com.apple.Virtualization.VirtualMachine' | grep -v grep >/dev/null 2>&1; then
echo healthy
else
echo stopped
fi
")"
if [[ "$health" != healthy ]]; then
ipad_ssh "tail -n 80 /tmp/VirtualMac.log; tail -n 80 /tmp/vmmhook.log"
die "iPad VM $health during post-start stability check"
fi
ipad_ssh "tail -n 20 /tmp/VirtualMac.log"
printf 'IPAD_VM_BUNDLE_STARTED\t%s\n' "$BUNDLE"
exit 0
;;
failed|stopped)
ipad_ssh "tail -n 60 /tmp/VirtualMac.log; tail -n 60 /tmp/vmmhook.log"
die "iPad VM $result while booting $BUNDLE"
;;
esac
sleep 1
done
ipad_ssh "tail -n 60 /tmp/VirtualMac.log; tail -n 60 /tmp/vmmhook.log"
die "iPad VM did not start within ${TIMEOUT}s: $BUNDLE"