= macOS Sequoia Problems =

== General Issues ==

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

Check the status of Sequoia builders [https://build.macports.org/builders here] if you prefer to install prebuilt primaries. It can take several weeks after a new MacOS release before builders are working for both `x86_64` and `arm64`.

== Updating MacPorts Base ==

MacPorts must be [https://www.macports.org/install.php installed] in a version configured for macOS 15 Sequoia. If you update from an older OS version, you need to run `port migrate` to reinstall MacPorts base and installed ports that are not OS-independent (see link above).

Ensure you have Xcode 16.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`). (See below for a potential problem when upgrading from older CLT versions.) 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`

== Compiling C++ fails ==

The installer for the Command Line Tools for Xcode 16 does not delete a directory that was installed by some older versions of the CLTs, which unfortunately causes clang++ to look in the wrong place for C++ headers. The majority of ports that contain C++ code will fail to build as a result.

The fix is to delete the stray directory if it exists: `sudo rm -rf /Library/Developer/CommandLineTools/usr/include/c++`

Then clean the ports that failed to build, and try again.

Ticket: #70750

== Trace mode not working ==

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

== Rosetta 2 ==

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.

== ScreenCaptureKit Requirement with macOS 15 SDK ==

Anything that dies with an error:
{{{
error: '<SomeCGGraphicsFunction>' is unavailable: obsoleted in macOS 15.0 - Please use ScreenCaptureKit instead.
}}}

Needs to set `macosx_deployment_target` to 14 or below.

Workaround for most ports:
{{{
if {${os.platform} eq "darwin" && [vercmp ${macosx_deployment_target} >= 15.0]} {
    macosx_deployment_target 14.0
}
}}}

Current Tickets:
[ticket:70758], [ticket:70756], [ticket:70709], [ticket:70774], [ticket:71103]

== Tickets for Broken Ports ==

[[TicketQuery(component=ports&status!=closed&keywords~=sequoia,or,component=ports&status!=closed&keywords~=15.0)]]
[[TicketQuery(component=ports&status!=closed&keywords!~= sequoia,and,keywords!~=15.0&summary~=Sequoia,or,summary=~[^0-9]15\.0[^0-9])]]