Skip to content

Run a virtual iPhone on an Apple Silicon Mac.

Swift

Document bootstrap install for initial CFW setup

Lakr9992e0f0c03d
diff --git a/Documents/README_ja.md b/Documents/README_ja.md
index cc19e768..3f7e2c78 100644
--- a/Documents/README_ja.md
+++ b/Documents/README_ja.md
@@ -40,7 +40,7 @@ vphone-cli vm launch myphone
VM を起動したら、macOS のメニューバーで **Guest > Install Bootstrap…** を選び、環境のレイアウトを選択します。これによりゲスト内に Irisin がインストールされます。
-現時点では、Irisin で `coreutils`、`debianutils`、`dash` などの基本パッケージを 1 つずつインストールしてください。パッケージスクリプトのエラーで失敗した場合は、失敗した操作画面の左上にある **More** メニューから **Ignore Script Errors and Retry** を選びます。スクリプトは実行されますが、そのエラーを無視して続行します。環境が整ったら通常のインストールに戻せます。この初期設定は今後のリリースで改善する予定です。
+初回の環境準備では、Irisin で `coreutils`、`debianutils`、`dash` などの基本パッケージを選択します。**Install** ボタンを長押しし、**Bootstrap Install** を選んでください。このモードでは、選択したすべてのパッケージを先に展開してからインストール処理を再実行します。これにより、`debianutils` には `bash` が必要で、`bash` には設定済みの `debianutils` が必要という初期段階の依存関係を回避できます。基本パッケージの導入後は通常のインストールを使用できます。
## 日常の操作
diff --git a/Documents/README_ko.md b/Documents/README_ko.md
index 12d7301a..0d2c465d 100644
--- a/Documents/README_ko.md
+++ b/Documents/README_ko.md
@@ -40,7 +40,7 @@ vphone-cli vm launch myphone
VM을 실행한 뒤 macOS 메뉴 막대에서 **Guest > Install Bootstrap…**을 선택하고 환경 레이아웃을 고르세요. 그러면 게스트에 Irisin이 설치됩니다.
-현재는 Irisin에서 `coreutils`, `debianutils`, `dash` 등의 기본 패키지를 하나씩 설치해야 합니다. 패키지 스크립트 오류로 설치가 실패하면 실패한 작업 화면 왼쪽 위의 **More** 메뉴에서 **Ignore Script Errors and Retry**를 선택하세요. 스크립트는 실행되지만 오류를 무시하고 계속 진행합니다. 환경이 준비되면 일반 설치 방식으로 돌아갈 수 있습니다. 이 초기 설정 과정은 후속 버전에서 개선할 예정입니다.
+환경을 처음 준비할 때는 Irisin에서 `coreutils`, `debianutils`, `dash` 등의 기본 패키지를 선택하세요. **Install** 버튼을 길게 누른 다음 **Bootstrap Install**을 선택하세요. 이 모드는 선택한 모든 패키지를 먼저 압축 해제한 뒤 설치 절차를 다시 실행합니다. 따라서 `debianutils`에는 `bash`가 필요하지만 `bash`에는 이미 설정된 `debianutils`가 필요한 초기 의존성 순환을 우회할 수 있습니다. 기본 패키지 설치가 끝나면 일반 설치 방식을 사용하면 됩니다.
## 기본 사용법
diff --git a/Documents/README_zh.md b/Documents/README_zh.md
index a105c65f..d0a75e2f 100644
--- a/Documents/README_zh.md
+++ b/Documents/README_zh.md
@@ -40,7 +40,7 @@ vphone-cli vm launch myphone
启动虚拟机后,在 macOS 菜单栏选择 **Guest > Install Bootstrap…**,再选择所需的环境布局。此操作会在访客系统内安装 Irisin。
-目前需要在 Irisin 中依次安装 `coreutils`、`debianutils`、`dash` 等基础软件包。如果安装因软件包脚本出错而失败,请打开失败操作页面左上角的 **More** 菜单,选择 **Ignore Script Errors and Retry**。Irisin 仍会运行脚本,但会忽略脚本错误继续安装。环境就绪后,即可恢复正常安装。后续版本会改善这段初始配置流程。
+首次准备环境时,在 Irisin 中选中 `coreutils`、`debianutils`、`dash` 等基础软件包,长按**安装**按钮,然后选择**引导安装(Bootstrap Install)**。这种模式会先解压所有选中的软件包,再重新执行安装流程,以绕过初始阶段的依赖循环:`debianutils` 需要 `bash`,而 `bash` 又需要已经配置好的 `debianutils`。基础软件包安装完成后,即可使用普通安装模式。
## 日常使用
diff --git a/README.md b/README.md
index e7910772..f3d2a562 100644
--- a/README.md
+++ b/README.md
@@ -40,7 +40,7 @@ Version 2.x starts only VMs created with its `schemaVersion=2` format. Older VMs
After launching the VM, choose **Guest > Install Bootstrap…** from the macOS menu bar and select a layout. This installs Irisin in the guest.
-For now, install `coreutils`, `debianutils`, `dash`, and other essential packages in Irisin one at a time. If a package script causes an installation to fail, open the **More** menu at the top left of the failed operation and choose **Ignore Script Errors and Retry**. Irisin still runs the scripts but continues past their errors. Once the environment is ready, return to normal installation. A later release will improve this initial setup.
+For the first setup, select `coreutils`, `debianutils`, `dash`, and the other essential packages in Irisin. Press and hold the **Install** button, then choose **Bootstrap Install**. This mode unpacks all selected packages before running the installation steps again. It resolves the initial dependency cycle where `debianutils` needs `bash`, but `bash` needs `debianutils` to have been configured. Use regular installation after the essential packages are set up.
## Everyday use