Repository files navigation

The Swift Package Manager is a tool for managing distribution of source code, aimed at making it easy to share your code and reuse others’ code. The tool directly addresses the challenges of compiling and linking Swift packages, managing dependencies, versioning, and supporting flexible distribution and collaboration models.

We’ve designed the system to make it easy to share packages on services like GitHub, but packages are also great for private personal development, sharing code within a team, or at any other granularity.

Swift Package Manager includes a build system that can build for macOS and Linux. Starting with Xcode 11, Xcode integrates with SwiftPM to provide support for including packages in iOS, macOS, watchOS, and tvOS applications.

TheSourceKit-LSP project leverages libSwiftPM and providesLanguage Server Protocol implementation for editors that support LSP.

• Getting Started
• Documentation
• System Requirements
• Installation
• Contributing
• Reporting issues
• License

Please usethis guide for learning package manager basics.

For Quick Help use theswift package --help command.

For documentation on using Swift Package Manager, creating packages, and more, see thedocumentation directory.

For documentation on developing the Swift Package Manager itself, see thecontribution guide.

For detailed documentation on the package manifest API, seePackageDescription API.

For release notes with information about changes between versions, see therelease notes.

The package manager’s system requirements are the same asthose for Swift with the caveat that the package manager requires Git at runtime as well as build-time.

The package manager is available as part the Swift toolchains available onSwift.org) including snapshots for the latest versions built frommain branch. For installation instructions for downloaded snapshots, please see theGetting Started section ofSwift.org.

The Swift Package Manager is also included in Xcode 8.0 and all subsequent releases.

You can verify your installation by typingswift package --version in a terminal:

$ swift package --versionApple Swift Package Manager - ...

There are several ways to contribute to Swift Package Manager. To learn about the policies, best practices that govern contributions to the Swift project and instructions for setting up the development environment please read theContributor Guide.

The Swift package manager usesllbuild as the underlying build system for compiling source files. It is also open source and part of the Swift project.

If you have any trouble with the package manager, help is available. We recommend:

• TheSwift Forums,
• SwiftPM'sbug tracker

When reporting an issue please follow the bug reporting guidelines, they can be found incontribution guide.

If you’re not comfortable sharing your question with the list, contact details for the code owners can be found inCODEOWNERS; however, Swift Forums is usually the best place to go for help.

Copyright 2015 - 2024 Apple Inc. and the Swift project authors. Licensed under Apache License v2.0 with Runtime Library Exception.

Seehttps://swift.org/LICENSE.txt for license information.

Seehttps://swift.org/CONTRIBUTORS.txt for Swift project authors.