Swift Package Registry

Publish Swift packages for your user or organization.

Requirements

To work with the Swift package registry, you need to use swift to consume and a HTTP client (like curl) to publish packages.

Configuring the package registry

To register the package registry and provide credentials, execute:

swift package-registry set https://gitea.example.com/api/packages/{owner}/swift -login {username} -password {password}

The login is optional and only needed if the package registry is private.

Publish a package

First you have to pack the contents of your package:

swift package archive-source

To publish the package perform a HTTP PUT request with the package content in the request body.

curl -X PUT --user {username}:{password} \
     -H "Accept: application/vnd.swift.registry.v1+json" \
     -F source-archive=@/path/to/package.zip \
     -F metadata={metadata} \
     https://gitea.example.com/api/packages/{owner}/swift/{scope}/{name}/{version}

You cannot publish a package if a package of the same name and version already exists. You must delete the existing package first.

Install a package

To install a Swift package from the package registry, add it in the Package.swift file dependencies list:

dependencies: [
    .package(id: "{scope}.{name}", from:"{version}")
]

Afterwards execute the following command to install it:

swift package resolve