Skip to content

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.md
index 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.md
index 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.md
index 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.md
index 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.json
index 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.md
index 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.md
index 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` |