Skip to content

Commit

Permalink
Merge pull request #6711 from jobearrr/patch-1
Browse files Browse the repository at this point in the history
Updated documentation
  • Loading branch information
osy authored Oct 4, 2024
2 parents bfaeabe + 90602d0 commit 8f2c019
Showing 1 changed file with 3 additions and 1 deletion.
4 changes: 3 additions & 1 deletion Documentation/MacDevelopment.md
Original file line number Diff line number Diff line change
Expand Up @@ -60,7 +60,7 @@ If you are developing QEMU and wish to pass in a custom path to QEMU, you can us
You can build UTM with the script:

```sh
./scripts/build_utm.sh -t TEAMID -k macosx -s macos -a ARCH -o /path/to/output/directory
./scripts/build_utm.sh -t TEAMID -k macosx -s macOS -a ARCH -o /path/to/output/directory
```

`ARCH` can be `x86_64` or `arm64` or `"arm64 x86_64"` (quotes are required) for a universal binary. The built artifact is an unsigned `.xcarchive` which you can use with the package tool (see below).
Expand All @@ -76,6 +76,7 @@ Artifacts built with `build_utm.sh` (includes GitHub Actions artifacts) must be
```sh
./scripts/package_mac.sh unsigned /path/to/UTM.xcarchive /path/to/output
```
where `/path/to/output` is an existing directory.

This builds `UTM.dmg` in `/path/to/output` which can be installed to `/Applications`.

Expand All @@ -84,6 +85,7 @@ This builds `UTM.dmg` in `/path/to/output` which can be installed to `/Applicati
```sh
./scripts/package_mac.sh developer-id /path/to/UTM.xcarchive /path/to/output TEAM_ID PROFILE_UUID HELPER_PROFILE_UUID LAUNCHER_PROFILE_UUID
```
where `/path/to/output` is an existing directory.

To build a signed package, you need to be a registered Apple Developer. From the developer portal, create a certificate for "Developer ID Application" (and install it into your Keychain). Also create three provisioning profiles with that certificate with Hypervisor entitlements (you need to manually request these entitlements and be approved by Apple) for UTM, QEMUHelper, and QEMULauncher. `TEAM_ID` should be the same as in the certificate, `PROFILE_UUID` should be the UUID of the profile installed by Xcode (open the profile in Xcode), and `HELPER_PROFILE_UUID` is the UUID of a separate profile for the XPC helper. `LAUNCHER_PROFILE_UUID` is the UUID of a profile for the launcher.

Expand Down

0 comments on commit 8f2c019

Please sign in to comment.