averello/swift-mirror
1
0
Fork 0
mirror of https://github.com/apple/swift.git synced 2025-12-14 20:36:38 +01:00
Code Issues Packages Projects Releases Wiki Activity

[embedded] Update embedded UserManual.md to explain how to use a macOS downloadable toolchain

Browse Source
This commit is contained in:
Kuba Mracek
2025-03-19 16:03:02 -07:00
parent 2f30161563
commit bc6c5fe677
1 changed files with 13 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

13
docs/EmbeddedSwift/UserManual.md
View File

@@ -37,6 +37,19 @@ $ swiftc -target <target triple> -enable-experimental-feature Embedded -wmo \
input1.swift input2.swift ... -c -o output.o
```
On macOS, it's common to have Xcode installed, which comes with a toolchain that does not support Embedded Swift yet. Unless you download, install, and activate a swift.org toolchain, you'll see this error:
```bash
$ swiftc input1.swift -enable-experimental-feature Embedded -wmo
<unknown>:0: error: unable to load standard library for target 'arm64-apple-macosx15.0'
```
To resolve it, download and install a nightly toolchain from swift.org. Then, don't forget to activate it in your terminal by setting the `TOOLCHAINS` environment variable, for example with this command (if you installed into the `/Library` path):
```bash
$ export TOOLCHAINS=$(plutil -extract CFBundleIdentifier raw /Library/Developer/Toolchains/swift-latest.xctoolchain/Info.plist)
```
## Examples
### Building Swift firmware for an embedded target