Run a virtual iPhone on an Apple Silicon Mac.
Swift
Install owngoal-bootstrap-vphone as the first package
Lakr73ae84824694
diff --git a/Documents/Guides/package-environment.md b/Documents/Guides/package-environment.mdindex de554d6b..6b3f3ca3 100644--- a/Documents/Guides/package-environment.md+++ b/Documents/Guides/package-environment.md@@ -3,15 +3,9 @@The VM has no package manager by default. To install one:1. In the menu bar, choose **Apps > Install Bootstrap…** and select the **roothide** layout (**rootless** is deprecated). This installs Irisin in the VM.-2. For the first installation, select all of the following packages in Irisin at once, press and hold the install button, and choose **Bootstrap Install**:+2. In Irisin, open the **OwnGoal Packages** repository, find **OwnGoal Bootstrap for vphone** (`owngoal-bootstrap-vphone`), and install it with **Bootstrap Install**.- - `apt`- - `bash`- - `uikittools`- - `launchctl`- - `openssh-server`-- Install them together in one pass. Several of these packages depend on one another, and `openssh-server` declares some dependencies circularly, so installing them one by one can fail partway.+ This one package brings in everything a VM needs in a single pass: `apt` and `dpkg`, `bash`, `zsh` and `dash`, `sudo`, the core command-line tools, `openssh-server`, `curl`, `wget`, `vim`, `git`, `uikittools`, `launchctl`, and the OwnGoal apps. Do not install these packages one by one: several depend on one another, and `openssh-server` declares some dependencies circularly, so separate installs can fail partway.3. After the first installation, install further packages normally.If the first installation fails, do not repair it in place. Choose **Apps > Uninstall Bootstrap…**, then start again from step 1.diff --git a/Documents/README_ja.md b/Documents/README_ja.mdindex af52d492..eb322960 100644--- a/Documents/README_ja.md+++ b/Documents/README_ja.md@@ -63,15 +63,9 @@ Launchpad と同じシリーズの VPhone.bundle をインストールして、仮想マシンには標準でパッケージマネージャが入っていません。インストール手順は次のとおりです。1. メニューバーで **Apps > Install Bootstrap…** を選び、レイアウトとして **roothide** を選択します(**rootless** は非推奨です)。仮想マシンに Irisin がインストールされます。-2. 初回のブートストラップインストールでは、Irisin で次のパッケージをまとめてチェックし、インストールボタンを長押しして **Bootstrap Install** を選びます。+2. Irisin で **OwnGoal Packages** リポジトリを開き、**OwnGoal Bootstrap for vphone**(`owngoal-bootstrap-vphone`)を **Bootstrap Install** でインストールします。- - `apt`- - `bash`- - `uikittools`- - `launchctl`- - `openssh-server`-- これらは一度のブートストラップインストールでまとめて導入することを推奨します。一部のパッケージは相互に依存しており(例:`bash` と `debianutils`)、特に `openssh-server` には循環した依存や厳密でない依存の記述があるため、通常のインストールで一つずつ導入すると途中で失敗することがあります。+ このパッケージ 1 つで、仮想マシンに必要なものが一度にそろいます:`apt` と `dpkg`、`bash`、`zsh` と `dash`、`sudo`、基本的なコマンドラインツール、`openssh-server`、`curl`、`wget`、`vim`、`git`、`uikittools`、`launchctl`、そして OwnGoal のアプリです。これらを一つずつインストールしないでください。一部のパッケージは相互に依存しており、`openssh-server` には循環した依存の記述があるため、個別にインストールすると途中で失敗することがあります。3. 初回のインストール後は、ほかのパッケージを通常どおりインストールできます。初回のインストールに失敗した場合や、環境が不整合な状態になった場合は、その場で修復しようとせず、**Apps > Uninstall Bootstrap…** で環境を削除し、手順 1 からインストールし直してください。diff --git a/Documents/README_ko.md b/Documents/README_ko.mdindex ac13d9da..a7222bc9 100644--- a/Documents/README_ko.md+++ b/Documents/README_ko.md@@ -62,15 +62,9 @@ boot-args 등 호스트 보안 설정은 변경하지 말고, 펌웨어와 여가상 머신에는 기본적으로 패키지 관리자가 없습니다. 설치 방법은 다음과 같습니다.1. 메뉴 막대에서 **Apps > Install Bootstrap…**을 선택하고 레이아웃으로 **roothide**를 선택합니다(**rootless**는 더 이상 권장되지 않습니다). 가상 머신에 Irisin이 설치됩니다.-2. 처음 부트스트랩 설치를 할 때는 Irisin에서 다음 패키지를 한 번에 모두 선택하고 설치 버튼을 길게 누른 뒤 **Bootstrap Install**을 선택합니다.+2. Irisin에서 **OwnGoal Packages** 저장소를 열고 **OwnGoal Bootstrap for vphone**(`owngoal-bootstrap-vphone`)을 **Bootstrap Install**로 설치합니다.- - `apt`- - `bash`- - `uikittools`- - `launchctl`- - `openssh-server`-- 이 패키지들은 한 번의 부트스트랩 설치로 함께 설치하는 것을 권장합니다. 일부 패키지는 서로 의존하며(예: `bash`와 `debianutils`), 특히 `openssh-server`는 순환하거나 부정확한 의존성 선언을 포함하고 있어 일반 설치로 하나씩 설치하면 도중에 실패할 수 있습니다.+ 이 패키지 하나로 가상 머신에 필요한 것이 한 번에 설치됩니다: `apt`와 `dpkg`, `bash`, `zsh`와 `dash`, `sudo`, 기본 명령줄 도구, `openssh-server`, `curl`, `wget`, `vim`, `git`, `uikittools`, `launchctl`, 그리고 OwnGoal 앱. 이 패키지들을 하나씩 설치하지 마십시오. 일부 패키지는 서로 의존하며, `openssh-server`는 순환하는 의존성 선언을 포함하고 있어 따로 설치하면 도중에 실패할 수 있습니다.3. 처음 설치를 마친 뒤에는 다른 패키지를 일반 설치로 설치하면 됩니다.처음 설치에 실패했거나 설치 후 환경이 비정상적인 상태가 되었다면 그 자리에서 복구하려 하지 말고, **Apps > Uninstall Bootstrap…**으로 환경을 삭제한 뒤 1단계부터 다시 설치하십시오.diff --git a/Documents/README_zh.md b/Documents/README_zh.mdindex 045c7800..61710875 100644--- a/Documents/README_zh.md+++ b/Documents/README_zh.md@@ -61,15 +61,9 @@ https://raw.githubusercontent.com/Lakr233/vphone-cli/main/Skills/vphone-guest-co虚拟机默认不带软件包管理器。安装步骤:1. 在菜单栏选择 **Apps > Install Bootstrap…**,布局选择 **roothide**(**rootless** 已弃用)。虚拟机中会安装 Irisin。-2. 首次引导安装时,请在 Irisin 中一次性勾选以下软件包,长按安装按钮,选择 **Bootstrap Install**:+2. 在 Irisin 中打开 **OwnGoal Packages** 软件源,找到 **OwnGoal Bootstrap for vphone**(`owngoal-bootstrap-vphone`),选择 **Bootstrap Install** 安装。- - `apt`- - `bash`- - `uikittools`- - `launchctl`- - `openssh-server`-- 建议通过一次引导安装完成上述软件包的安装。其中部分软件包相互依赖(例如 `bash` 与 `debianutils`),`openssh-server` 的依赖声明也存在循环或不够规范的情况,逐个进行普通安装可能在中途失败。+ 这一个软件包会一次装好虚拟机需要的全部内容:`apt` 和 `dpkg`、`bash`、`zsh` 和 `dash`、`sudo`、常用命令行工具、`openssh-server`、`curl`、`wget`、`vim`、`git`、`uikittools`、`launchctl`,以及 OwnGoal 的几个应用。不要逐个安装这些软件包:其中部分软件包相互依赖,`openssh-server` 的依赖声明也存在循环,逐个安装可能在中途失败。3. 首次安装完成后,其余软件包使用普通安装即可。如果首次安装失败,或安装后环境状态异常,不建议在原环境上修复。请通过 **Apps > Uninstall Bootstrap…** 删除环境,再从第 1 步重新安装。diff --git a/Skills/vphone-guest-control/evals/evals.json b/Skills/vphone-guest-control/evals/evals.jsonindex 8e4db0ec..07cb8840 100644--- a/Skills/vphone-guest-control/evals/evals.json+++ b/Skills/vphone-guest-control/evals/evals.json@@ -22,7 +22,7 @@{"id": 4,"prompt": "I want ssh into myphone and a debuggable test IPA installed. It was just created. How do you do that, and where do I put the IPA so vphoned can read it?",- "expected_output": "Notes a fresh guest has no sshd; installs the roothide bootstrap (bootstrap.install or Apps > Install Bootstrap), then installs apt, bash, uikittools, launchctl, openssh-server together via Irisin Bootstrap Install; iproxy + ssh mobile; ssh lands in the jbroot, real root is /rootfs; scp to /tmp then mv to /rootfs/private/var/tmp and apps.install with /private/var/tmp/<file>; warns apps.install deletes the file.",+ "expected_output": "Notes a fresh guest has no sshd; installs the roothide bootstrap (bootstrap.install or Apps > Install Bootstrap), then installs owngoal-bootstrap-vphone (which pulls in apt, openssh-server, uikittools, launchctl) via Irisin Bootstrap Install; iproxy + ssh mobile; ssh lands in the jbroot, real root is /rootfs; scp to /tmp then mv to /rootfs/private/var/tmp and apps.install with /private/var/tmp/<file>; warns apps.install deletes the file.","files": []}]diff --git a/Skills/vphone-guest-control/references/guest-layout.md b/Skills/vphone-guest-control/references/guest-layout.mdindex ed4654a9..73daf528 100644--- a/Skills/vphone-guest-control/references/guest-layout.md+++ b/Skills/vphone-guest-control/references/guest-layout.md@@ -91,14 +91,19 @@ they are repaired at every vphoned start.This step is done in the guest UI, in Irisin; there is no RPC for it.-1. Open Irisin. Select **all** of `apt`, `bash`, `uikittools`, `launchctl`- and `openssh-server` at once.-2. Press and hold the install button and choose **Bootstrap Install**.--Install them together: they depend on each other, and `openssh-server` declares-some dependencies circularly, so one-by-one installs can fail partway. After the-first pass, install further packages normally. If the first pass fails, do not-repair it in place: **Apps > Uninstall Bootstrap…**, then start over.+1. Open Irisin and the **OwnGoal Packages** repository+ (`https://apt.owngoal.dev/`). Find **OwnGoal Bootstrap for vphone**+ (`owngoal-bootstrap-vphone`).+2. Install it with **Bootstrap Install**.++That one meta package depends on everything a guest needs: `apt`, `dpkg`,+`bash`, `zsh`, `sudo`, the core command-line tools, `openssh-server`, `curl`,+`git`, `uikittools`, `launchctl` and the OwnGoal apps (Irisin, Fila, iGhostVT,+Xrash, Inspector). Do not install those packages one by one: they depend on each+other, and `openssh-server` declares some dependencies circularly, so separate+installs can fail partway. After the first pass, install further packages+normally. If the first pass fails, do not repair it in place:+**Apps > Uninstall Bootstrap…**, then start over.Because this needs someone at the screen, drive it with `ui.tree`,`ui.tap_element` and screenshots, or ask the user to do it.diff --git a/Skills/vphone-guest-control/references/install-faq.md b/Skills/vphone-guest-control/references/install-faq.mdindex 0b0b4e3c..172d2a2a 100644--- a/Skills/vphone-guest-control/references/install-faq.md+++ b/Skills/vphone-guest-control/references/install-faq.md@@ -91,7 +91,7 @@ user on an ad hoc build must reset after every switch. `status` →| Guest panics at launch on a 27 base (#531) | The maintainer thought the first CFW install most likely did not finish (an inference). Running `cfw install` again on the stopped machine is a repair, not a routine step; do it only if the user asks || Ethernet or location services missing (#521, #438) | The user chose the **experimental** preset. It is known to break things; recreate with `--preset standard`. (#536 also reported a host location-permission bug, since fixed; update the bundle within the series) || iOS 18 machine stuck at the Apple logo after the first reboot, bundle newer than 2.1.0 (#541) | Open issue. Report it; do not recreate repeatedly. Bundle 2.1.0 booted that machine |-| Irisin cannot install `openssh` (#528) | `launchctl` (and the other base packages) were missing. Install `apt`, `bash`, `uikittools`, `launchctl`, `openssh-server` together ([guest-layout](guest-layout.md)) |+| Irisin cannot install `openssh` (#528) | `launchctl` (and the other base packages) were missing. Install `owngoal-bootstrap-vphone` from OwnGoal Packages with Bootstrap Install ([guest-layout](guest-layout.md)) || ssh fails on roothide, `sudo` does not work (#502, #519, #520) | Missing bootstrap base items or loader links, fixed in later bundles. [guest-layout](guest-layout.md), `Research/Guest/roothide_bootstrap_base.md` || A commercial app (WeChat, TikTok, games) crashes with `CODESIGNING Invalid Page` or is blocked by FairPlay (#212, #220, #356) | The project does not support specific third-party apps; those issues were closed as not planned. Say so, and do not try to patch around it. Apple's own and open-source apps are in scope || An app is killed by `EXC_GUARD` (#291) | `Documents/Guides/troubleshooting.md` |