旧版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 tools for Windows Microsoft.VisualStudio.Component.VC.CMake.Project

安装Visual Studio和所需组件后:

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

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

支持文件

此步骤仅适用于5.4.2之前的版本。

您必须以管理员身份使用x64 Native Tools for VS2019 命令提示符运行以下命令。 x64 Native Tools for VS2019 命令提示符设置了查找系统头文件所需的环境变量。 修改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://swift.org/keys/all-keys.asc -UseBasicParsing | Select-Object -Expand Content | gpg.exe import -
    

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

  3. 验证PGP签名。

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

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

    $ 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 <[email protected]>"
    

    如果由于没有公钥而导致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”,请不要运行下载的安装程序。请发送电子邮件至[email protected],并提供尽可能详细的信息,以便我们调查问题。


  1. 您可以安装更新版本的SDK。