Skip to content

Run a virtual iPhone on an Apple Silicon Mac.

Swift

Recommend one bootstrap pass for the first package install

Lakr2c122958587b
diff --git a/Documents/README_ja.md b/Documents/README_ja.md
index ad971228..26c07a69 100644
--- a/Documents/README_ja.md
+++ b/Documents/README_ja.md
@@ -46,8 +46,18 @@ Launchpad がファームウェアのダウンロード、パッチの適用、
仮想マシンには標準でパッケージマネージャが入っていません。インストール手順は次のとおりです。
1. メニューバーで **Apps > Install Bootstrap…** を選び、レイアウトとして **roothide** を選択します(**rootless** は非推奨です)。仮想マシンに Irisin がインストールされます。
-2. 初回のインストールでは、Irisin で `apt` と `bash` にチェックを入れ、インストールボタンを長押しして **Bootstrap Install** を選びます。`bash` と `debianutils` は相互に依存しているため、通常のインストールでは完了できません。
-3. 以降は通常のインストールで構いません。
+2. 初回のブートストラップインストールでは、Irisin で次のパッケージをまとめてチェックし、インストールボタンを長押しして **Bootstrap Install** を選びます。
+
+ - `apt`
+ - `bash`
+ - `uikittools`
+ - `launchctl`
+ - `openssh-server`
+
+ これらは一度のブートストラップインストールでまとめて導入することを推奨します。一部のパッケージは相互に依存しており(例:`bash` と `debianutils`)、特に `openssh-server` には循環した依存や厳密でない依存の記述があるため、通常のインストールで一つずつ導入すると途中で失敗することがあります。
+3. 初回のインストール後は、ほかのパッケージを通常どおりインストールできます。
+
+初回のインストールに失敗した場合や、環境が不整合な状態になった場合は、その場で修復しようとせず、**Apps > Uninstall Bootstrap…** で環境を削除し、手順 1 からインストールし直してください。
環境を削除するには **Apps > Uninstall Bootstrap…** を選びます。削除後、仮想マシンは再起動します。
diff --git a/Documents/README_ko.md b/Documents/README_ko.md
index 17821613..b401eb30 100644
--- a/Documents/README_ko.md
+++ b/Documents/README_ko.md
@@ -46,8 +46,18 @@ Launchpad가 펌웨어를 내려받고, 패치를 적용하고, 시스템을 복
가상 머신에는 기본적으로 패키지 관리자가 없습니다. 설치 방법은 다음과 같습니다.
1. 메뉴 막대에서 **Apps > Install Bootstrap…**을 선택하고 레이아웃으로 **roothide**를 선택합니다(**rootless**는 더 이상 권장되지 않습니다). 가상 머신에 Irisin이 설치됩니다.
-2. 처음 설치할 때는 Irisin에서 `apt`와 `bash`를 선택하고 설치 버튼을 길게 누른 뒤 **Bootstrap Install**을 선택합니다. `bash`와 `debianutils`는 서로 의존하므로 일반 설치로는 완료할 수 없습니다.
-3. 이후에는 일반 설치를 사용하면 됩니다.
+2. 처음 부트스트랩 설치를 할 때는 Irisin에서 다음 패키지를 한 번에 모두 선택하고 설치 버튼을 길게 누른 뒤 **Bootstrap Install**을 선택합니다.
+
+ - `apt`
+ - `bash`
+ - `uikittools`
+ - `launchctl`
+ - `openssh-server`
+
+ 이 패키지들은 한 번의 부트스트랩 설치로 함께 설치하는 것을 권장합니다. 일부 패키지는 서로 의존하며(예: `bash`와 `debianutils`), 특히 `openssh-server`는 순환하거나 부정확한 의존성 선언을 포함하고 있어 일반 설치로 하나씩 설치하면 도중에 실패할 수 있습니다.
+3. 처음 설치를 마친 뒤에는 다른 패키지를 일반 설치로 설치하면 됩니다.
+
+처음 설치에 실패했거나 설치 후 환경이 비정상적인 상태가 되었다면 그 자리에서 복구하려 하지 말고, **Apps > Uninstall Bootstrap…**으로 환경을 삭제한 뒤 1단계부터 다시 설치하십시오.
환경을 삭제하려면 **Apps > Uninstall Bootstrap…**을 선택합니다. 삭제 후 가상 머신이 재시동됩니다.
diff --git a/Documents/README_zh.md b/Documents/README_zh.md
index 0519d48f..6b6a953b 100644
--- a/Documents/README_zh.md
+++ b/Documents/README_zh.md
@@ -46,8 +46,18 @@ Launchpad 会下载固件、打补丁、恢复系统并首次启动。完成后
虚拟机默认不带软件包管理器。安装步骤:
1. 在菜单栏选择 **Apps > Install Bootstrap…**,布局选择 **roothide**(**rootless** 已弃用)。虚拟机中会安装 Irisin。
-2. 首次安装时,在 Irisin 中勾选 `apt` 和 `bash`,长按安装按钮,选择 **Bootstrap Install**。`bash` 和 `debianutils` 互相依赖,普通安装无法完成。
-3. 之后使用普通安装即可。
+2. 首次引导安装时,请在 Irisin 中一次性勾选以下软件包,长按安装按钮,选择 **Bootstrap Install**:
+
+ - `apt`
+ - `bash`
+ - `uikittools`
+ - `launchctl`
+ - `openssh-server`
+
+ 建议通过一次引导安装完成上述软件包的安装。其中部分软件包相互依赖(例如 `bash` 与 `debianutils`),`openssh-server` 的依赖声明也存在循环或不够规范的情况,逐个进行普通安装可能在中途失败。
+3. 首次安装完成后,其余软件包使用普通安装即可。
+
+如果首次安装失败,或安装后环境状态异常,不建议在原环境上修复。请通过 **Apps > Uninstall Bootstrap…** 删除环境,再从第 1 步重新安装。
要删除环境,选择 **Apps > Uninstall Bootstrap…**,删除后虚拟机会重启。
diff --git a/README.md b/README.md
index 100dd111..39a88ff5 100644
--- a/README.md
+++ b/README.md
@@ -46,8 +46,18 @@ You can also use your own iPhone and cloudOS IPSWs. For verified pairings, see [
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. The first time, select `apt` and `bash` in Irisin, press and hold the install button, and choose **Bootstrap Install**. `bash` and `debianutils` depend on each other, so a normal install cannot complete.
-3. After that, use a normal install.
+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**:
+
+ - `apt`
+ - `bash`
+ - `uikittools`
+ - `launchctl`
+ - `openssh-server`
+
+ Installing them together in one bootstrap pass is recommended. Several of these packages depend on one another (for example, `bash` and `debianutils`), and `openssh-server` in particular declares some dependencies circularly or imprecisely, so installing them one by one with a normal install can fail partway.
+3. After the first installation, install further packages normally.
+
+If the first installation fails or leaves the environment in an inconsistent state, do not attempt to repair it in place. Remove the environment with **Apps > Uninstall Bootstrap…** and install it again from step 1.
To remove the environment, choose **Apps > Uninstall Bootstrap…**. The VM restarts after removal.