Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Support for embedded provisioning profiles and embedded apps in macOS DMGs #289

Open
wants to merge 32 commits into
base: main
Choose a base branch
from

Conversation

mabeledo
Copy link

@mabeledo mabeledo commented Dec 12, 2024

Support two new features in packager: DMG embedded provisioning profiles and apps.

Embedded provisioning profiles are required by Apple to distribute apps with certain entitlements outside the App Store, so they can be installed in macOS without a device management profile installed. In other words, pretty much any macOS app with certain entitlements, that's offered outside the App Store, needs this.

Embedded apps are a way for DMGs to pack more than one binary, where each may have different entitlements. An example would be the 1Password DMG package, which contains both a handful of binaries that require no entitlements, plus another handful that do. The reason for this is that Apple doesn't allow more than one binary per package to be entitled, so if e.g. a single package, let's call it X, bundles a UI (tauri, electron, etc.), and a daemon with a number of entitlements (network extension, devicekit, etc.) together, the daemon needs to be embedded as an app with its own entitlements, inside of the "main" bundle.

As a note, these embedded apps must be signed before bundling them in the main DMG, and never re-signed during packaging, or the entitlement binary signature will be invalidated.

Edit: sorry for the messy commit stream.

@@ -72,6 +72,13 @@ pub(crate) fn package(ctx: &Context) -> crate::Result<Vec<PathBuf>> {
tracing::debug!("Copying resources");
config.copy_resources(&resources_dir)?;

tracing::debug!("Copying embedded.provisionprofile");
#[cfg(target_os = "macos")]

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

we can do this on non-macOS platforms too

@@ -697,7 +697,7 @@ pub struct MacOsConfig {
///
/// - arranging for the compiled binary to link against those frameworks (e.g. by emitting lines like `cargo:rustc-link-lib=framework=SDL2` from your `build.rs` script)
///
/// - embedding the correct rpath in your binary (e.g. by running `install_name_tool -add_rpath "@executable_path/../Frameworks" path/to/binary` after compiling)
/// - embedding the correct path in your binary (e.g. by running `install_name_tool -add_rpath "@executable_path/../Frameworks" path/to/binary` after compiling)

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

this should indeed refer to rpath, it's not a typo :)

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is what I get for trusting autocorrect.

@mabeledo
Copy link
Author

I'm going to pause this PR for a minute, so I don't spam the maintainers with errors in the workflows. I'm hoping to get it done in a few hours.

@mabeledo mabeledo marked this pull request as draft January 16, 2025 14:59
@mabeledo mabeledo marked this pull request as ready for review January 16, 2025 16:01
@mabeledo
Copy link
Author

There are a few Action failures that I don't think I can address, as they are related to licensing.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants