depends: Update Qt to 6.12.0 #36593

pull hebasto wants to merge 2 commits into bitcoin:master from hebasto:261021-qt612 changing 24 files +101 −840

hebasto commented at 6:33 PM on October 21, 2026: member
The new Qt 6.12 LTS contains many bug fixes and officially supports macOS 26.

See:
- https://www.qt.io/blog/qt-6.12-released
- https://doc.qt.io/qt-6/whatsnew612.html
Based on #36592.

build: Bump macOS SDK version to 15.0

Qt 6.12 requires macOS 15 SDK or higher.
See https://doc.qt.io/qt-6.12/macos.html.

The minimum supported macOS version stays at 14.0.

eaa8d1f5a5

depends: Update Qt to 6.12.0 fa9231d651
hebasto added the label Build system on Oct 21, 2026
DrahtBot commented at 6:33 PM on October 21, 2026: contributor


The following sections might be updated with supplementary metadata relevant to reviewers and maintainers.



External sites
- Code coverage & benchmarks: https://corecheck.dev/bitcoin/bitcoin/pulls/36593
- Ralph review <img src=https://review.fish.foo/assets/bitcoin/bitcoin/36593.png alt="Ralph review status"> https://git.fish.foo/bitcoin/bitcoin/pulls/36593#author-ralph


Reviews

See the guideline and AI policy for information on the review process. A summary of reviews will appear here.
fanquake commented at 6:37 PM on October 21, 2026: member

and support macOS 26

Our current version already does?
hebasto commented at 6:42 PM on October 21, 2026: member

and support macOS 26

Our current version already does?

It works, obviously. However, macOS 26 is not listed in https://doc.qt.io/qt-6.8/macos.html.
bitcoin blocked a user on Oct 21, 2026
hebasto commented at 6:54 PM on October 21, 2026: member

Apparently, Qt 6.12 needs CMake >=3.25.

See https://lists.qt-project.org/pipermail/development/2026-May/047097.html.
bitcoin deleted a comment on Oct 21, 2026
in depends/patches/qt/qtbase_xkbcommon_compat.patch:1 in fa9231d651
```
   0 | @@ -0,0 +1,17 @@
   1 | +Keep compatibility with the current libxkbcommon package
```
fanquake commented at 7:06 PM on October 21, 2026:

Will this work? I assume Qt increased their required version, because they are using some feature / API from the newer version? Would be good if this explained why this is ok to do.

hebasto commented at 7:24 PM on October 21, 2026:

I'm investigating the API changes now.
DrahtBot added the label CI failed on Oct 21, 2026
DrahtBot commented at 7:19 PM on October 21, 2026: contributor


🚧 At least one of the CI tasks failed. <sub>Task macOS-cross to arm64: https://github.com/bitcoin/bitcoin/actions/runs/39653749364/job/119408481873</sub> <sub>LLM reason (✨ experimental): CI failed while linking bitcoin-qt because Qt’s Cocoa plugin references the undefined macOS symbol __isPlatformVersionAtLeast.</sub>

<details><summary>Hints</summary>

Try to run the tests locally, according to the documentation. However, a CI failure may still happen due to a number of reasons, for example:
- Possibly due to a silent merge conflict (the changes in this pull request being incompatible with the current code in the target branch). If so, make sure to rebase on the latest commit of the target branch.
- A sanitizer issue, which can only be found by compiling with the sanitizer and running the affected test.
- An intermittent issue.
Leave a comment here, if you need help tracking down a confusing failure.

</details>

Contributors

hebasto

DrahtBot

fanquake

Labels

Build system CI failed

Linked (view graph)

#36592 build: Bump macOS SDK version to 15.0

depends: Update Qt to 6.12.0 #36593

External sites

Reviews