Skip to content

Run a virtual iPhone on an Apple Silicon Mac.

Swift

Release 2.1.0

Lakrbd36b5ee64a5
diff --git a/Documents/Guides/bundle-integration.md b/Documents/Guides/bundle-integration.md
index e8076ad8..b37f4924 100644
--- a/Documents/Guides/bundle-integration.md
+++ b/Documents/Guides/bundle-integration.md
@@ -20,8 +20,9 @@ executables and resources, not a macOS app or a dynamically loaded plug-in.
`Contents/MacOS` holds only programs that run on the Mac.
`guest-resources` holds only files installed into the guest; every Mach-O in
it is built for iOS. `ValidateBundle.sh` enforces both rules.
-Launchpad 2.0.8 and later require a bundle version of at least 2.0.8 and the
-`vphone-escalator` executable. It does not load older bundle layouts.
+Launchpad 2.1.0 and later require a bundle version of at least 2.1.0, which
+adds patch presets (`fw patches`, `fw set-patches`, `fw patch --preset`), and
+the `vphone-escalator` executable. It does not load older bundle layouts.
All executable payloads use ad hoc code signatures. Only the required child
processes carry private entitlements. The bundle has no `CFBundleExecutable`,
diff --git a/Documents/Guides/launchpad-cli.md b/Documents/Guides/launchpad-cli.md
index efadb94b..348bc9a5 100644
--- a/Documents/Guides/launchpad-cli.md
+++ b/Documents/Guides/launchpad-cli.md
@@ -39,7 +39,7 @@ vphone-launchpad-cli vm log research-01 --lines 100
vphone-launchpad-cli vm stop research-01
# The same checks against the release it replaces.
-vphone-launchpad-cli bundle use 2.0.9
+vphone-launchpad-cli bundle use 2.1.0
```
The first step that needs the helper after its five-minute authorization
diff --git a/Documents/README_ja.md b/Documents/README_ja.md
index dd13d569..592bddb1 100644
--- a/Documents/README_ja.md
+++ b/Documents/README_ja.md
@@ -14,7 +14,7 @@ Apple Silicon Mac 上で仮想 iPhone を作成・実行します。vphone-cli
## はじめに
-macOS 15 以降を搭載した物理 Apple Silicon Mac では、公証済みの [vphone-launchpad 2.0.9](https://github.com/Lakr233/vphone-cli/releases/download/2.0.9/vphone-launchpad-2.0.9-notarized.zip) を使用してください。リリース版の実行に Xcode、Python、Homebrew は不要です。
+macOS 15 以降を搭載した物理 Apple Silicon Mac では、公証済みの [vphone-launchpad 2.1.0](https://github.com/Lakr233/vphone-cli/releases/download/2.1.0/vphone-launchpad-2.1.0-notarized.zip) を使用してください。リリース版の実行に Xcode、Python、Homebrew は不要です。
1. macOS 復旧環境で `csrutil enable --without debug` と `csrutil allow-research-guests enable` を実行し、再起動します。詳しくは[ホストの設定](Guides/host-setup.md)をご覧ください。
2. アーカイブを展開してアプリを開きます。**Host Setup** の案内に従い、開発者ツールへのアクセスを許可して特権ヘルパーをインストールします。
diff --git a/Documents/README_ko.md b/Documents/README_ko.md
index de15b8d2..db017ed9 100644
--- a/Documents/README_ko.md
+++ b/Documents/README_ko.md
@@ -14,7 +14,7 @@ Apple Silicon Mac에서 가상 iPhone을 만들고 실행합니다. vphone-cli
## 시작하기
-macOS 15 이상을 실행하는 물리 Apple Silicon Mac에서는 공증된 [vphone-launchpad 2.0.9](https://github.com/Lakr233/vphone-cli/releases/download/2.0.9/vphone-launchpad-2.0.9-notarized.zip)를 사용하세요. 릴리스 버전을 실행할 때 Xcode, Python, Homebrew는 필요하지 않습니다.
+macOS 15 이상을 실행하는 물리 Apple Silicon Mac에서는 공증된 [vphone-launchpad 2.1.0](https://github.com/Lakr233/vphone-cli/releases/download/2.1.0/vphone-launchpad-2.1.0-notarized.zip)를 사용하세요. 릴리스 버전을 실행할 때 Xcode, Python, Homebrew는 필요하지 않습니다.
1. macOS 복구 환경에서 `csrutil enable --without debug`와 `csrutil allow-research-guests enable`을 실행한 다음 재시동하세요. 자세한 내용은 [호스트 설정](Guides/host-setup.md)을 참고하세요.
2. 압축을 풀고 앱을 여세요. **Host Setup**의 안내에 따라 개발자 도구 접근을 허용하고 권한 있는 도우미를 설치하세요.
diff --git a/Documents/README_zh.md b/Documents/README_zh.md
index 4c80b6dc..70b57113 100644
--- a/Documents/README_zh.md
+++ b/Documents/README_zh.md
@@ -14,7 +14,7 @@
## 开始使用
-推荐在运行 macOS 15 或更新版本的实体 Apple Silicon Mac 上使用已公证的 [vphone-launchpad 2.0.9](https://github.com/Lakr233/vphone-cli/releases/download/2.0.9/vphone-launchpad-2.0.9-notarized.zip)。运行发布版无需 Xcode、Python 或 Homebrew。
+推荐在运行 macOS 15 或更新版本的实体 Apple Silicon Mac 上使用已公证的 [vphone-launchpad 2.1.0](https://github.com/Lakr233/vphone-cli/releases/download/2.1.0/vphone-launchpad-2.1.0-notarized.zip)。运行发布版无需 Xcode、Python 或 Homebrew。
1. 在 macOS 恢复模式中执行 `csrutil enable --without debug` 和 `csrutil allow-research-guests enable`,然后重新启动。详见[宿主机设置](Guides/host-setup.md)。
2. 解压并打开 App,按 **Host Setup** 的提示授予开发者工具权限并安装特权辅助程序。
diff --git a/README.md b/README.md
index a2fc99ba..2a677ac8 100644
--- a/README.md
+++ b/README.md
@@ -14,7 +14,7 @@ The recommended host setup runs `csrutil enable --without debug` and `csrutil al
## Get started
-Use the notarized [vphone-launchpad 2.0.9](https://github.com/Lakr233/vphone-cli/releases/download/2.0.9/vphone-launchpad-2.0.9-notarized.zip) on a physical Apple Silicon Mac running macOS 15 or newer. The release needs no Xcode, Python, or Homebrew at runtime.
+Use the notarized [vphone-launchpad 2.1.0](https://github.com/Lakr233/vphone-cli/releases/download/2.1.0/vphone-launchpad-2.1.0-notarized.zip) on a physical Apple Silicon Mac running macOS 15 or newer. The release needs no Xcode, Python, or Homebrew at runtime.
1. In macOS Recovery, run `csrutil enable --without debug` and `csrutil allow-research-guests enable`, then restart. See [host setup](Documents/Guides/host-setup.md) for details.
2. Unzip and open the app. Complete **Host Setup**, including Developer Tools access and installation of the privileged helper.
diff --git a/VPhoneExecutable/VPhoneVirtualization/Resources/Info.plist b/VPhoneExecutable/VPhoneVirtualization/Resources/Info.plist
index 13063229..cfd55d02 100644
--- a/VPhoneExecutable/VPhoneVirtualization/Resources/Info.plist
+++ b/VPhoneExecutable/VPhoneVirtualization/Resources/Info.plist
@@ -9,9 +9,9 @@
<key>CFBundlePackageType</key>
<string>BNDL</string>
<key>CFBundleVersion</key>
- <string>10</string>
+ <string>11</string>
<key>CFBundleShortVersionString</key>
- <string>2.0.9</string>
+ <string>2.1.0</string>
<key>NSLocationUsageDescription</key>
<string>Shares your location with the virtual iPhone so apps running inside it see the same location.</string>
<key>NSLocationWhenInUseUsageDescription</key>
diff --git a/VPhoneKit/VPhoneCoreKit/VirtualMachine/VPhoneVirtualMachineManifest.swift b/VPhoneKit/VPhoneCoreKit/VirtualMachine/VPhoneVirtualMachineManifest.swift
index 5cddc150..2efeed7e 100644
--- a/VPhoneKit/VPhoneCoreKit/VirtualMachine/VPhoneVirtualMachineManifest.swift
+++ b/VPhoneKit/VPhoneCoreKit/VirtualMachine/VPhoneVirtualMachineManifest.swift
@@ -41,7 +41,7 @@ extension VPhoneManifestError: CustomStringConvertible, LocalizedError {
enum VPhoneRuntimeVersion {
/// A plain `swift build` executable has no app bundle Info.plist.
- private static let unbundledVersion = "2.0.9"
+ private static let unbundledVersion = "2.1.0"
static var current: String {
let contents = VPhoneResources.runningExecutable().deletingLastPathComponent().deletingLastPathComponent()
diff --git a/VPhoneLaunchpad/Configuration/Version.xcconfig b/VPhoneLaunchpad/Configuration/Version.xcconfig
index f80f088c..cb78cb8f 100644
--- a/VPhoneLaunchpad/Configuration/Version.xcconfig
+++ b/VPhoneLaunchpad/Configuration/Version.xcconfig
@@ -1,4 +1,4 @@
-MARKETING_VERSION = 2.0.9
+MARKETING_VERSION = 2.1.0
// Bump whenever the helper changes. The app blesses the helper again when the
// installed helper's version or bytes differ from the copy it embeds.
-CURRENT_PROJECT_VERSION = 7
+CURRENT_PROJECT_VERSION = 8
diff --git a/VPhoneLaunchpad/VPhoneLaunchpadShared/VPhoneLaunchpadBundleStore.swift b/VPhoneLaunchpad/VPhoneLaunchpadShared/VPhoneLaunchpadBundleStore.swift
index c7104e48..a7860837 100644
--- a/VPhoneLaunchpad/VPhoneLaunchpadShared/VPhoneLaunchpadBundleStore.swift
+++ b/VPhoneLaunchpad/VPhoneLaunchpadShared/VPhoneLaunchpadBundleStore.swift
@@ -70,7 +70,7 @@ nonisolated struct VPhoneLaunchpadBundleReceipt: Codable, Equatable, Sendable {
/// checks them to give an early message; the helper checks them because it
/// must not trust the app.
nonisolated enum VPhoneLaunchpadNames {
- static let minimumBundleVersion = "2.0.8"
+ static let minimumBundleVersion = "2.1.0"
static func isValidVersion(_ value: String) -> Bool {
matches(value, "^[0-9A-Za-z][0-9A-Za-z._-]{0,63}$") && !value.contains("..")
@@ -95,7 +95,7 @@ nonisolated enum VPhoneLaunchpadNames {
guard parts.count == 3,
let major = Int(parts[0]), let minor = Int(parts[1]), let patch = Int(parts[2])
else { return false }
- return (major, minor, patch) >= (2, 0, 8)
+ return (major, minor, patch) >= (2, 1, 0)
}
static func isValidMachineName(_ value: String) -> Bool {