meta-darwin
==========

OpenEmbedded meta layer for darwin based SDKs

Note: Only macOS SDK version 12.3 (Darwin 21) is supported.

Ensure you have read and understood the Xcode license terms:
https://www.apple.com/legal/sla/docs/xcode.pdf

You also need a macOS sysroot tarball/zip file generated (copied) from a target macOS
system. This is placed in the osx-runtime files directory and is used to compile the SDK
against it. It needs to contain the system libraries (/usr/lib) and include files 
(/usr/include). This tarball is not part of this meta-darwin layer and must be
created by the user. To create it, the user is required to have a legitimate Mac computer
with macOS 12.3 or later and with Xcode installed.

Information on packaging the SDK is available at:
https://github.com/tpoechtrager/osxcross#packaging-the-sdk

Copy the created OSX-sdk.zip file to your Yocto development machine, placing it into
meta-darwin layer:

 <...>/meta-darwin/recipes-devtools/osx-runtime/files

You can alternatively add a nativesdk-osx-runtime_%.bbappend file to your
layer and override SRC_URI and do_configure() to extract the SDK from
a different location.


This layer depends on:

 URI: git://git.openembedded.org/openembedded-core
 layers: meta
 branch: kirkstone

 URI: https://github.com/kraj/meta-clang.git
 layers: meta-clang
 branch: kirkstone

Layer Maintainers: Richard Purdie <richard.purdie@linuxfoundation.org>
                   Dominik Schnitzer <dominik@snap.com>
                   Etienne Cordonnier <ecordonnier@snap.com>

Please send changes to the yocto-patches mailing list
(yocto-patches@lists.yoctoproject.org) with [meta-darwin] in the subject line,
cc'ing the maintainers. You need to subscribe to the mailing list at
https://lists.yoctoproject.org/g/yocto-patches before being able to post.

When sending single patches, please use something like:
'git send-email -M -1 --to yocto-patches@lists.yoctoproject.org --subject-prefix="meta-darwin][PATCH"'