= macOS Big Sur 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 11.0 Big Sur.

Ensure you have Xcode 12.2 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`

== Install macOS SDK 11.0 manually in case of problems == 

Some users who upgraded from earlier versions of macOS reported, that `xcode-select --install` didn't gave proper results (didn't install neither Xcode, nor the SDK required) and first the installation of Xcode from AppStore and then the installation of `Command-line tools for Xcode 12.2` was required from Apple Developer site, as described here: https://www.macports.org/install.php . 

Symptoms that your system requires manual installation: console message about missing SDK (`Warning: The macOS 11.0 SDK does not appear to be installed. Ports may not build correctly. Warning: You can install it as part of the Xcode Command Line Tools package by running `xcode-select --install'.`) or a message about C compiler being unable to create executables in build logs. 

== Tickets for Broken Ports ==

[[TicketQuery(component=ports&status!=closed&keywords~=bigsur,or,component=ports&status!=closed&keywords~=11.0)]]
[[TicketQuery(component=ports&status!=closed&keywords!~=bigsur,and,keywords!~=11.0&summary~=Big Sur,or,summary=~[^0-9]11\.0[^0-9])]]