旧版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和所需组件后:
-
下载所需的旧版Swift安装程序。
-
运行安装包安装程序。
支持文件
此步骤仅适用于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中运行。
-
从GnuPG.org安装GPG
-
如果您是首次下载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 -
如果您之前已导入密钥,请跳过此步骤。
-
验证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],并提供尽可能详细的信息,以便我们调查问题。
-
您可以安装更新版本的SDK。 ↩