To learn about the policies and best practices that govern contributions to the Swift project, please read the Contributor Guide.
If you are interested in contributing, please read the Community Proposal, which provides some context for decisions made in the current implementation and offers direction for the development of future features.
Instructions for setting up the development environment are available here.
The Swift package manager uses llbuild as the underlying build system for compiling source files. It is also open source and part of the Swift project.
The package manager’s system requirements are the same as those for Swift with the caveat that the package manager requires Git at runtime as well as build-time.
The Swift Package Manager is included in Xcode 8.0 and all subsequent releases.
The package manager is also available for other platforms as part of all Snapshots available at swift.org, including snapshots for the latest versions built from master
. For installation instructions for downloaded snapshots, please see the Getting Started section of swift.org.
You can verify your installation by typing swift package --version
in a terminal:
$ swift package --version Apple Swift Package Manager - ...
On macOS /usr/bin/swift
is just a stub that forwards invocations to the active toolchain. Thus when you call swift build
it will use the swift defined by your TOOLCHAINS
environment variable. This can be used to easily switch between the default tools, and a development snapshot:
$ xcrun --find swift /Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin/swift $ swift --version Apple Swift version 3.0 $ export TOOLCHAINS=swift $ xcrun --find swift /Library/Developer/Toolchains/swift-latest.xctoolchain/usr/bin/swift $ swift --version Swift version 3.0-dev
To use a specific toolchain you can set TOOLCHAINS
to the CFBundleIdentifier
in an .xctoolchain
’s Info.plist.
The SWIFT_EXEC
environment variable specifies the swiftc
executable path used by swift package
. If it is not set, the package manager will try to locate it:
swift-package
's parent directory.xcrun --find swiftc
.For extensive documentation on using Swift Package Manager, creating packages, and more, see Documentation.
For additional documentation on developing the Swift Package Manager itself, see Documentation/Development.
If you have any trouble with the package manager, help is available. We recommend:
If you’re not comfortable sharing your question with the list, contact details for the code owners can be found in CODE_OWNERS.txt; however, the mailing list is usually the best place to go for help.
Copyright 2015 - 2016 Apple Inc. and the Swift project authors. Licensed under Apache License v2.0 with Runtime Library Exception.
See https://swift.org/LICENSE.txt for license information.
See https://swift.org/CONTRIBUTORS.txt for Swift project authors.