Contents

package(url:from:traits:)

Adds a remote package dependency with a version requirement, starting with the given minimum version, going up to the next major version.

Declaration

static func package(url: String, from version: Version, traits: Set<Package.Dependency.Trait> = [.defaults]) -> Package.Dependency

Parameters

  • url:

    The valid Git URL of the package.

  • version:

    The minimum version requirement.

  • traits:

    The trait configuration of this dependency. The default value enables the default traits of the package.

Return Value

A Package.Dependency instance.

Discussion

This is the recommended way to specify a remote package dependency. It allows you to specify the minimum version you require, allows updates that include bug fixes and backward-compatible feature updates, but requires you to explicitly update to a new major version of the dependency. This approach provides the maximum flexibility on which version to use, while making sure you don’t update to a version with breaking changes, and helps to prevent conflicts in your dependency graph.

The following example allows the Swift Package Manager to select a version like a 1.2.3, 1.2.4, or 1.3.0, but not 2.0.0.

.package(url: "https://example.com/example-package.git", from: "1.2.3"),

See Also

Creating a package dependency from a URL