7.5 swift package-registry on 编程那些事儿

7.5.1 swift package-registry set

Fri, 11 Sep 2026 21:45:00 +0800

原文链接: https://docs.swift.org/latest/documentation/packagemanagerdocs/packageregistryset/

7.5.1 swift package-registry set

设置自定义注册表。

概述

用这个子命令在项目级或用户级分配注册表。

项目级

1

$ swift package-registry set https://packages.example.com

在项目级，包管理器会为项目内的包使用该注册表，注册表设置保存在 .swiftpm/configuration/registries.json 中。

7.5.2 swift package-registry unset

Fri, 11 Sep 2026 21:45:00 +0800

原文链接: https://docs.swift.org/latest/documentation/packagemanagerdocs/packageregistryunset/

7.5.2 swift package-registry unset

移除已配置的注册表。

用法

package-registry unset [--package-path=<package-path>]
 [--cache-path=<cache-path>] [--config-path=<config-path>]
 [--security-path=<security-path>]
 [--scratch-path=<scratch-path>]
 [--swift-sdks-path=<swift-sdks-path>]
 [--toolset=<toolset>...]
 [--pkg-config-path=<pkg-config-path>...]
 [--enable-dependency-cache] [--disable-dependency-cache]
 [--enable-build-manifest-caching]
 [--disable-build-manifest-caching]
 [--manifest-cache=<manifest-cache>]
 [--enable-experimental-prebuilts]
 [--disable-experimental-prebuilts] [--verbose]
 [--very-verbose|vv] [--quiet] [--color-diagnostics]
 [--no-color-diagnostics] [--disable-sandbox] [--netrc]
 [--enable-netrc] [--disable-netrc]
 [--netrc-file=<netrc-file>] [--enable-keychain]
 [--disable-keychain]
 [--resolver-fingerprint-checking=<resolver-fingerprint-checking>]
 [--resolver-signing-entity-checking=<resolver-signing-entity-checking>]
 [--enable-signature-validation]
 [--disable-signature-validation] [--enable-prefetching]
 [--disable-prefetching]
 [--force-resolved-versions|disable-automatic-resolution|only-use-versions-from-resolved-file]
 [--skip-update] [--disable-scm-to-registry-transformation]
 [--use-registry-identity-for-scm]
 [--replace-scm-with-registry]
 [--default-registry-url=<default-registry-url>]
 [--configuration=<configuration>] [--=<Xcc>...]
 [--=<Xswiftc>...] [--=<Xlinker>...] [--=<Xcxx>...]
 [--triple=<triple>] [--sdk=<sdk>] [--toolchain=<toolchain>]
 [--swift-sdk=<swift-sdk>] [--sanitize=<sanitize>...]
 [--auto-index-store] [--enable-index-store]
 [--disable-index-store]
 [--enable-parseable-module-interfaces] [--jobs=<jobs>]
 [--use-integrated-swift-driver]
 [--explicit-target-dependency-import-check=<explicit-target-dependency-import-check>]
 [--build-system=<build-system>] [--=<debug-info-format>]
 [--enable-dead-strip] [--disable-dead-strip]
 [--disable-local-rpath] [--global] [--scope=<scope>]
 [--version] [--help]

–package-path=<package-path>：

指定要操作的包路径（默认为当前目录）。这会先切换工作目录，然后再执行其他任何操作。

7.5.3 swift package-registry login

Fri, 11 Sep 2026 21:45:00 +0800

原文链接: https://docs.swift.org/latest/documentation/packagemanagerdocs/packageregistrylogin/

登录注册表。

概述

包管理器使用注册表服务的登录 API 验证凭据。如果返回成功响应，凭据会被保存到操作系统的凭据存储（例如 macOS 的钥匙串）。在非 macOS 平台上，或者提供了 --netrc 标志时，凭据会被保存到用户级 .netrc（默认位于 ~/.netrc）。位于 ~/.swiftpm/configuration/registries.json 的用户级配置文件也会被更新。

7.5.4 swift package-registry publish

Fri, 11 Sep 2026 21:45:00 +0800

原文链接: https://docs.swift.org/latest/documentation/packagemanagerdocs/packageregistrypublish/

7.5.4 swift package-registry publish

发布到注册表。

概述

这个命令会为包发布创建源代码归档，可选择对它签名，最后把包发布发布到注册表。

如果包发布需要认证，包作者应当在运行 publish 之前配置注册表登录。

发布者 TOFU

有些证书允许包管理器提取关于签名身份的额外信息。对于用这些证书签名的包，包管理器会执行发布者 TOFU（首次使用即信任），以确保该包的所有版本签名者保持一致。

7.5.5 swift package-registry logout

Fri, 11 Sep 2026 21:45:00 +0800

原文链接: https://docs.swift.org/latest/documentation/packagemanagerdocs/packageregistrylogout/

7.5.5 swift package-registry logout

从注册表登出。

概述

如果支持，包管理器会从操作系统的凭据存储中移除凭据，并更新用户级配置文件（registries.json）。

为避免意外移除敏感数据，netrc 文件需要由用户手动更新。