旧版 Swift 版本的安装

此页面记录了 Swift 5.9 或更旧版本的手动安装过程。后续版本更新了依赖项,并采用了简化的安装过程

旧版本的 Swift 已经过 Visual Studio 2019 的测试。您需要安装包含以下组件的 Visual Studio。Swift 的旧版安装程序可在下载部分找到。Windows 上的工具链通常安装在 %SystemDrive%\Library\Developer\Toolchains

以下 Visual Studio 组件是必需的

组件 Visual Studio ID
MSVC v142 - VS 2019 C++ x64/x86 生成工具 (最新) Microsoft.VisualStudio.Component.VC.Tools.x86.x64
Windows 10 SDK (10.0.17763.0)1 Microsoft.VisualStudio.Component.Windows10SDK.17763

以下额外的 Visual Studio 组件是推荐的

组件 Visual Studio ID
Git for Windows Microsoft.VisualStudio.Component.Git
Python 3 64 位 (3.7.8) Component.CPython.x64

以下额外的 Visual Studio 组件是建议的

组件 Visual Studio ID
C++ CMake 工具(用于 Windows) Microsoft.VisualStudio.Component.VC.CMake.Project

安装 Visual Studio 和所需的组件后

  1. 下载所需的旧版 Swift 版本安装程序

  2. 运行软件包安装程序。

支持文件

这仅适用于 5.4.2 之前的版本。

您必须以管理员身份使用 x64 Native Tools for VS2019 Command Prompt 运行以下命令。x64 Native Tools for VS2019 Command Prompt 设置了必要的环境变量以查找系统头文件。需要管理员权限才能修改 Visual Studio 安装。

为了使 Windows SDK 可供 Swift 访问,有必要将一些文件部署到 Windows SDK 中。

copy /Y %SDKROOT%\usr\share\ucrt.modulemap "%UniversalCRTSdkDir%\Include\%UCRTVersion%\ucrt\module.modulemap"
copy /Y %SDKROOT%\usr\share\visualc.modulemap "%VCToolsInstallDir%\include\module.modulemap"
copy /Y %SDKROOT%\usr\share\visualc.apinotes "%VCToolsInstallDir%\include\visualc.apinotes"
copy /Y %SDKROOT%\usr\share\winsdk.modulemap "%UniversalCRTSdkDir%\Include\%UCRTVersion%\um\module.modulemap"

由于 Windows SDK 通常作为 Visual Studio 的一部分安装,因此每次 Visual Studio 更新时可能都需要复制这些文件。

Visual Studio 更新后修复

这仅适用于 5.9.0 之前的版本。

如果 Visual Studio 更新,您可能需要修复安装。对于 5.4.2 之前的版本,重新安装如上所述的支持文件。对于较新版本,请参阅 Microsoft 关于修复已安装程序的说明。

Windows 上的代码签名

以下命令必须在 PowerShell 中运行。

  1. GnuPG.org 安装 GPG

  2. 如果您是首次下载 Swift 软件包,请将 PGP 密钥导入到您的密钥环中

    $ gpg.exe keyserver hkp://keyserver.ubuntu.com `
              receive-keys `
              'A62A E125 BBBF BB96 A6E0  42EC 925C C1CC ED3D 1561' `
              '8A74 9566 2C3C D4AE 18D9  5637 FAF6 989E 1BC1 6FEA'
    

    $ wget https://swiftlang.cn/keys/all-keys.asc -UseBasicParsing | Select-Object -Expand Content | gpg.exe import -
    

    如果您过去已导入密钥,请跳过此步骤。

  3. 验证 PGP 签名。

    Windows 的 .exe 安装程序使用 GnuPG 以及 Swift 开源项目的密钥之一进行签名。强烈建议所有人在使用该软件之前验证签名。

    首先,刷新密钥以下载新的密钥吊销证书(如果有)

    $ gpg.exe keyserver hkp://keyserver.ubuntu.com refresh-keys Swift
    

    然后,使用签名文件验证归档文件是否完整

    $ gpg.exe verify swift-<VERSION>-<PLATFORM>.exe.sig
    ...
    gpg: Good signature from "Swift Automatic Signing Key #3 <swift-infrastructure@swift.org>"
    

    如果 gpg 因为您没有公钥而无法验证(gpg: Can’t check signature: No public key),请按照下面的活动签名密钥中的说明将密钥导入到您的密钥环中。

    您可能会看到警告

    gpg: WARNING: This key is not certified with a trusted signature!
    gpg:          There is no indication that the signature belongs to the owner.
    

    此警告意味着在此密钥和您之间在信任网络中没有路径。只要您已按照上述步骤从受信任的来源检索密钥,此警告是无害的。

如果 gpg 验证失败并报告“BAD signature”,请不要运行下载的安装程序。相反,请发送电子邮件至 swift-infrastructure@forums.swift.org 并尽可能详细地说明情况,以便我们调查问题。


  1. 您可以安装较新的 SDK。