Skip to content

doc: add macOS Arm runnable build notes#753

Open
moreaki wants to merge 1 commit into
VirtualBox:mainfrom
moreaki:agent/darwin-arm-runnable-build-docs
Open

doc: add macOS Arm runnable build notes#753
moreaki wants to merge 1 commit into
VirtualBox:mainfrom
moreaki:agent/darwin-arm-runnable-build-docs

Conversation

@moreaki

@moreaki moreaki commented Jul 8, 2026

Copy link
Copy Markdown

Summary

Add doc/technical/DarwinArmRunnableBuild.wiki with a local macOS/Arm runnable-build workflow.

The note covers:

  • non-hardened OSE configure shape for local developer builds;
  • Xcode SDK/tool overrides for selected host-side targets when Oracle-style bundled tool trees are not present;
  • staging a runnable VirtualBox.app copy for local testing;
  • refreshing a rebuilt dylib into the staged app;
  • signing order for changed Mach-O images, nested VM bundles and the outer app;
  • local VM entitlement choices and release-only entitlements to avoid in ad-hoc/local Developer ID tests.

Why

This workflow is currently easy to reconstruct incorrectly from configure output, kBuild variables and Darwin installer signing logic. A short technical note makes host-side macOS/Arm iteration more reproducible without changing packaging or release-signing behavior.

Validation

  • Documentation-only change.
  • git diff --check

Closes #751.

Document a local macOS/Arm workflow for configuring, building selected host-side targets, staging a runnable app bundle, and applying the signing order and entitlement choices needed for developer testing.

This is explicitly a local non-packaging workflow and leaves the Darwin installer and release signing paths unchanged.

Signed-off-by: Roberto Nibali <rnibali@gmail.com>
@oracle-contributor-agreement

Copy link
Copy Markdown

Thank you for your pull request and welcome to our community! To contribute, please sign the Oracle Contributor Agreement (OCA).
The following contributors of this PR have not signed the OCA:

To sign the OCA, please create an Oracle account and sign the OCA in Oracle's Contributor Agreement Application.

When signing the OCA, please provide your GitHub username. After signing the OCA and getting an OCA approval from Oracle, this PR will be automatically updated.

If you are an Oracle employee, please make sure that you are a member of the main Oracle GitHub organization, and your membership in this organization is public.

@oracle-contributor-agreement oracle-contributor-agreement Bot added the OCA Required At least one contributor does not have an approved Oracle Contributor Agreement. label Jul 8, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

OCA Required At least one contributor does not have an approved Oracle Contributor Agreement.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Document local macOS/Arm runnable build workflow

1 participant