Support prebuilt dependencies

Author: stdrc

.appveyor.yml

@@ -3,7 +3,7 @@ branches:
     - /dev.*/  # do not build dev branch
 
 image:
-  - Visual Studio 2017
+  - Visual Studio 2019
 
 platform:
   - x86
@@ -19,7 +19,12 @@ install:
   - git submodule init
   - git submodule update
   - powershell .\scripts\prepare.ps1
+  - set /p APP_ID=<app_id.txt
 
 build_script:
   - powershell .\scripts\generate.ps1 %CONFIGURATION%
   - powershell .\scripts\build.ps1 %CONFIGURATION%
+
+artifacts:
+  - path: build/Release/Release/%APP_ID%
+    type: zip

.gitignore

@@ -4,6 +4,7 @@
 .vscode/.ropeproject
 .vscode/ipch
 vcpkg
+vcpkg-export-*
 build
 !lib/*.lib
 scripts/install.ps1

.vscode/tasks.json

@@ -13,6 +13,18 @@
             "problemMatcher": [],
             "group": "build"
         },
+        {
+            "label": "prepare prebuilt",
+            "type": "shell",
+            "command": "powershell",
+            "args": [
+                "-NoProfile",
+                "-File",
+                "'${workspaceFolder}/scripts/prepare_prebuilt.ps1'"
+            ],
+            "problemMatcher": [],
+            "group": "build"
+        },
         {
             "label": "generate debug",
             "type": "shell",

CMakeSettings.json

@@ -15,7 +15,7 @@
                 "msvc_x86"
             ],
             "buildRoot": "${projectDir}\\build\\${name}",
-            "cmakeCommandArgs": "-A Win32 -T v142 -DCMAKE_BUILD_TYPE=${name}",
+            "cmakeCommandArgs": "-T v142 -DCMAKE_BUILD_TYPE=${name}",
             "buildCommandArgs": "",
             "ctestCommandArgs": "",
             "variables": [
@@ -37,7 +37,7 @@
                 "msvc_x86"
             ],
             "buildRoot": "${projectDir}\\build\\${name}",
-            "cmakeCommandArgs": "-A Win32 -T v142 -DCMAKE_BUILD_TYPE=${name}",
+            "cmakeCommandArgs": "-T v142 -DCMAKE_BUILD_TYPE=${name}",
             "buildCommandArgs": "",
             "ctestCommandArgs": "",
             "variables": [

README.md

@@ -76,7 +76,9 @@ CQ_MAIN {
 
 在开始使用之前，请确保你已经安装了 Git，且 `PATH` 中存在 `git` 命令。不需要安装 vcpkg，后面的脚本中会自动安装。
 
-然后确保安装了 **Visual Studio 2017 或 2019**，并勾选「使用 C++ 的桌面开发」，确保安装了 CMake、**MSVC v141 或 v142**、**Windows 10 SDK** 这三个组件。其中，如果系统中已经安装了 CMake，无需再在 VS Installer 中安装，但需要确保命令已添加进 `PATH`。除此之外，vcpkg 还要求安装 VS 的**英文语言包**。
+然后确保安装了 **Visual Studio 2019** 或 **Visual Studio 2019 生成工具**（如果使用 2017 版本可能需要自行修改 `CMakeSettings.json` 中的 `generator` 参数），并勾选「使用 C++ 的桌面开发」，确保安装了 **MSVC v142**、**Windows 10 SDK**、**用于 Windows 的 C++ CMake 工具** 这三个组件。其中，如果系统中已经安装了 CMake，无需再在 VS Installer 中安装，但需要确保命令已添加进 `PATH`。除此之外，vcpkg 还要求安装 VS 的**英文语言包**。
+
+> 推荐使用 VS Code 开发，只需安装 Visual Studio 2019 生成工具，不需要安装臃肿的 VS IDE。
 
 ### 下载 SDK
 
@@ -91,9 +93,16 @@ git submodule update
 
 ```ps1
 powershell .\scripts\prepare.ps1
+
+# 如果不打算使用 vcpkg 管理依赖，可以运行：
+powershell .\scripts\prepare_prebuilt.ps1
+
+# 请不要混用上面的两个脚本，只需运行一个即可
 ```
 
-[`scripts/prepare.ps1`](scripts/prepare.ps1) 脚本会在当前项目目录的 `vcpkg` 子目录中安装 vcpkg，并安装所需依赖。
+[`scripts/prepare.ps1`](scripts/prepare.ps1) 脚本会在当前项目目录的 `vcpkg` 子目录中安装 vcpkg，并安装所需依赖；[`scripts/prepare_prebuilt.ps1`](scripts/prepare_prebuilt.ps1) 脚本则会下载预编译的依赖库，直接解压到当前项目目录。
+
+> 如何选择？如果你只是想快速试用 demo，建议使用 prepare_prebuilt；如果你的网络环境不佳，使用 prepare 安装依赖太慢，也可以使用 prepare_prebuilt；如果你打算开发较大型的插件项目，且希望使用 vcpkg 来方便地管理依赖，可以使用 prepare。
 
 *注意，如果 PowerShell 提示不让运行脚本，需要先使用管理员权限打开 PowerShell，运行 `Set-ExecutionPolicy Unrestricted`，然后再重新运行上面的脚本；如果 vcpkg 安装依赖时出错，比较常见的问题是网络超时，请适当设置 `HTTP_PROXY` 和 `HTTPS_PROXY`。*
 
@@ -118,7 +127,7 @@ powershell .\scripts\generate.ps1 Debug
 powershell .\scripts\build.ps1 Debug
 ```
 
-上面两条命令分别生成 build 目录和构建项目，将 `Debug` 改为 `Release` 可以构建 release 版本。如果安装了 CMake 还没支持的较新版本 VS，需要先手动进入 VS 2017 或 2019 的 Developer Command Prompt，再执行上面的命令。
+上面两条命令分别生成 build 目录和构建项目，将 `Debug` 改为 `Release` 可以构建 release 版本。如果安装了 CMake 还没支持的较新版本 VS，需要先手动进入 VS 2019 的 Developer Command Prompt，再执行上面的命令。
 
 如果你使用 VS Code，可以直接运行 task；如果使用 VS，可以直接选择菜单 CMake - 全部生成。
 
@@ -164,7 +173,7 @@ git submodule update
 
 ### 安装依赖
 
-如果需要安装依赖，可以直接使用 vcpkg，通过 `--triplet x86-windows-static-custom` 指定 triplet，或者使用 SDK 提供的包装脚本（参数和 vcpkg 相同），例如：
+如果需要安装依赖，可以直接使用 vcpkg（注意，前提是前面的准备步骤中安装了完整的 vcpkg，而不是预编译依赖），通过 `--triplet x86-windows-static-custom` 指定 triplet，或者使用 SDK 提供的包装脚本（参数和 vcpkg 相同），例如：
 
 ```ps1
 .\scripts\vcpkg.ps1 install curl