Skip to content

Conversation

@DominiqueFuchs
Copy link

@DominiqueFuchs DominiqueFuchs commented Jan 28, 2026

With these changes, macOS framework builds (--enable-framework) produce relocatable frameworks. The installed framework can be moved to any location and will work without requiring install_name_tool rewriting by users.

This uses install-time transformation: build-time behavior is unchanged (absolute install names), and install_name_tool transforms the installed binaries to use appropriate @rpath.

iOS target already uses @rpath at build time because iOS builds are cross-compiled—there's no ./python.exe execution, no venvs, no shell script tests during development. macOS framework builds are different though and would break build-tree workflows because venv symlinks cause @executable_path to resolve to the wrong directory, SIP strips DYLD_FRAMEWORK_PATH from shell scripts, and so on.

The install-time approach avoids all these issues, introducing no regression for build-tree workflows, follows existing patterns (CMake projects, Qt, ...) and makes the installed framework fully relocatable by default.

Changes

  • Add -headerpad_max_install_names to LINKFORSHARED and pythonw build
  • Transform dylib install name to @rpath at install time
  • Add LC_RPATH entries to installed binaries (bin/python3, Python.app)
  • Compute rpath depths dynamically via os.path.relpath()

Related

macOS framework builds (--enable-framework) now produce relocatable
frameworks. The installed framework can be moved to any location and
will work without requiring install_name_tool rewriting by users.

This uses install-time transformation: build-time behavior is unchanged
(absolute install names), and install_name_tool transforms the installed
binaries to use @rpath.

Changes:
- Add -headerpad_max_install_names to LINKFORSHARED and pythonw build
- Transform dylib install name to @rpath at install time
- Add LC_RPATH entries to installed binaries (bin/python3, Python.app)
- Compute rpath depths dynamically via os.path.relpath()

Signed-off-by: Dominique Fuchs <df@0x9d.net>
@python-cla-bot
Copy link

python-cla-bot bot commented Jan 28, 2026

All commit authors signed the Contributor License Agreement.

CLA signed

@StanFromIreland
Copy link
Member

CC @sethmlarson, the fuzzers are failing, and it doesn't seem related.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Relocatable framework for macOS Enable rpath remapping in makefile

2 participants