Skip to content

Mention Windows build config ABI incompatibility - #7192

Merged
christophebedard merged 3 commits into
rollingfrom
christophebedard/windows-binaries-mention-build-config
Sep 20, 2026
Merged

christophebedard merged 3 commits into
rollingfrom
christophebedard/windows-binaries-mention-build-config

Conversation

@christophebedard

@christophebedard christophebedard commented Sep 19, 2026

Copy link
Copy Markdown
Member

Description

We stopped producing debug Windows binaries some time ago, only leaving release binaries. On Windows, for ABI compatibility, this means anything downstream must also be built in Release or RelWithDebInfo mode. Mention it explicitly here. And mention having to build ROS 2 from source to use another build config.

See: https://discourse.openrobotics.org/t/ros-2-windows-ci-on-github-actions-current-options-and-a-pixi-based-pattern/57736/6

Did you use Generative AI?

No

Additional Information

This should be backported to all distros that only have Windows release binaries, which is all of them, even though we've stopped producing binaries for distros targeting Windows 10, since it is EOL. We can still backport this in case someone is using one of those distros' last Windows binaries.

We stopped producing debug Windows binaries some time ago, only leaving
release binaries. On Windows, for ABI compatibility, this means anything
downstream must also be built in release mode. Mention it explicitly
here. And mention having to build ROS 2 from source to use another build
config.

This should be backported to all distros that only have Windows release
binaries.

Signed-off-by: Christophe Bedard <bedard.christophe@gmail.com>
@christophebedard christophebedard added the backport-all backport at reviewers discretion; from rolling to all versions label Sep 19, 2026
Comment thread source/Get-Started/Installation/Windows-Install-Binary.rst Outdated
@github-actions

github-actions Bot commented Sep 19, 2026

Copy link
Copy Markdown

HTML artifacts: https://github.com/ros2/ros2_documentation/actions/runs/35518304923/artifacts/10607861684.

To view the resulting site:

  1. Click on the above link to download the artifacts archive
  2. Extract it
  3. Open html-artifacts-7192/index.html in your favorite browser

Signed-off-by: Christophe Bedard <bedard.christophe@gmail.com>
@christophebedard
christophebedard force-pushed the christophebedard/windows-binaries-mention-build-config branch from b49af5f to 3587f50 Compare September 19, 2026 22:57
@christophebedard
christophebedard enabled auto-merge (squash) September 20, 2026 15:03
@christophebedard
christophebedard merged commit 0d14d8e into rolling Sep 20, 2026
6 checks passed
@christophebedard
christophebedard deleted the christophebedard/windows-binaries-mention-build-config branch September 20, 2026 15:06
christophebedard added a commit that referenced this pull request Sep 20, 2026
We stopped producing debug Windows binaries some time ago, only leaving
release binaries. On Windows, for ABI compatibility, this means anything
downstream must also be built in release mode. Mention it explicitly
here. And mention having to build ROS 2 from source to use another build
config.

This should be backported to all distros that only have Windows release
binaries.


(cherry picked from commit 0d14d8e)

Signed-off-by: Christophe Bedard <bedard.christophe@gmail.com>
Co-authored-by: Christophe Bedard <bedard.christophe@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

backport-all backport at reviewers discretion; from rolling to all versions

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants