Windows MSVC(依赖 MSVC,即Microsoft Visual C++)
准备阶段
- 确保系统安装了 cargo,可以在命令提示符(cmd)或者 PowerShell 使用
cargo -V检查系统是否安装了 cargo。如果提示以下信息:'cargo' 不是内部或外部命令,也不是可运行的程序或批处理文件。cargo : 无法将“cargo”项识别为 cmdlet、函数、脚本文件或可运行程序的名称。请检查名称的拼写,如果包括路径,请确保路径正确,然后再试一次。- 请点击 这里 按步骤安装构建工具
- 从 GitHub 下载源码到本地:
- 若您安装了 git 工具,请使用
git clone https://github.com/TeamFlos/phira.git将仓库克隆到本地。 - 若您没有安装 git 工具,您也可以在 Phira 仓库页面点击 Code 按钮选择
Download ZIP将代码下载到本地,随后将代码解压到本地任意目录。 - 如果您无法连接到 GitHub,您也可以使用 git 加速网站提供的加速地址克隆与下载。
- 若您要构建指定版本的 Phira,请前往 release 页面在 Assets 中选择下载
Source code(zip)到本地,解压到任意路径即可。 - 警告:为了防止玄学问题,我们不建议路径中包含除了 ASCII 编码包含字符以外的任何字符。
- 若您安装了 git 工具,请使用
- 静态库文件,您可以在 ESA 或 EdgeOne 下载静态库文件,下载完成后直接解压到代码根目录下,如果提示覆盖文件,请点击覆盖。
- 确认您拥有
x64 Native Tools Command Prompt for VS 20**,若无此环境,但是已经安装了 cargo,请考虑单独安装Visual Studio 20xx,并在安装时安装MSVC与Windows SDK组件,安装完成后您将会拥有x64 Native Tools Command Prompt for VS 20**环境。- 若您还未拥有cargo,请按照第一步安装 cargo,安装完成后您将会拥有
x64 Native Tools Command Prompt for VS 20**环境。
- 若您还未拥有cargo,请按照第一步安装 cargo,安装完成后您将会拥有
开始构建
- 打开
x64 Native Tools Command Prompt for VS 20**, 切换到代码根目录(如D:\phira\),注意,不是普通的命令提示符(cmd)或者 PowerShell - 在
x64 Native Tools Command Prompt for VS 20**中使用cargo build -r --bin phira-main,如果您在编译过去的版本,在openssl-sys(build)时,终端将会停滞很长一段时间,请不要退出,这是正常的。 - 构建完成后,在
.\target\release\目录下您可以找到编译完成的主程序 - 复制
.\assets\目录中的所有文件到.\target\release\assets\,至此,构建流程全部完成,您可以直接运行phira-main.exe检查资源文件是否完整。
- 注意:在此文档编写时,代码目录下的资源文件并不完整,如果您发现主程序闪退,您可以前往 release 页面下载任意版本,获取缺失的资源文件
常见问题
Q. 报错 failed to send request: 操作超时
A. 请检查网络环境,确保您可以正常访问 GitHub
Q. 报错 failed to send request: 无法解析服务器的名称或地址
A. 检查 DNS 或更换 DNS,更换后请刷新 DNS 缓存
Q. 构建过程中报错包含 note: LINK : fatal error LNK1181: cannot open input file 'kernel32.lib'
A. 缺失 Windows SDK,请检查是否正确安装 Windows SDK 后再试
Q. 不够具有挑战性
A. 这样,你去 GNU构建方式 吧,稍微难一点点。
A2. 你可以去编译静态库,绝对有挑战性,但是我觉得你来找构建指南一定不是为了挑战性吧…