= macOS Sonoma Problems =

== General Issues ==

First of all, please read [wiki:Migration].

== Updating MacPorts Base ==

MacPorts must be [https://www.macports.org/install.php re-installed] in a version configured for macOS 14 Sonoma.

Ensure you have Xcode 15.0 or greater installed and selected (e.g. `sudo xcode-select -s /Applications/Xcode.app/Contents/Developer`), and that you have the command line tools installed (`xcode-select --install`). You also have to agree to the license by running `sudo xcodebuild -license`. 

There have been reports that the `-license` option might not be sufficient alone, and following command might be required to agree to the license: `sudo xcodebuild -runFirstLaunch`

== Trace mode not working ==

Building ports in trace mode (i.e. with the `-t` option) will fail on Sonoma. This appears to be due to new security features in Ventura+. This issue is being followed in Ticket: #66358

== Rosetta 2 and build_arch ==

MacPorts defaults to building for the architecture that it is running as. If you have a universal MacPorts installation on an Apple Silicon Mac, and you run it from a terminal emulator that is not a native arm64 binary, MacPorts will end up being run as x86_64, and will build ports accordingly, which can be unexpected. This can be corrected by explicitly setting `build_arch arm64` in macports.conf, or by using a native terminal emulator.

A number of MacPorts portfiles and MacPorts base assume that arm64 Macs will have Rosetta 2 installed; you will likely run into issues if you have not installed it. Note that Rosetta 2 is not installed by default, or when running x86_64 binaries from the command line — you must open an application that has only x86_64 code in it to get the prompt to install Rosetta 2, or run {{{softwareupdate --install-rosetta}}} in a terminal window.

== Tickets for Broken Ports ==

[[TicketQuery(component=ports&status!=closed&keywords~=sonoma,or,component=ports&status!=closed&keywords~=14.0)]]
[[TicketQuery(component=ports&status!=closed&keywords!~=sonoma,and,keywords!~=14.0&summary~=Sonoma,or,summary=~[^0-9]14\.0[^0-9])]]