WeChatSampleBuilder V2.0 使用教程（网页版+桌面版）

　　为了方便开发者可以快速搭建一个最小化所需模块的 Senparc.Weixin SDK Sample 项目，我们于 2018 年 11 月发布了首个 WeChatSampleBuilder 的版本，受到了广大开发者的欢迎。

　　随着时间的推移，我们的 Sample 功能不断完善，同时微软对 .NET 版本的路线也原来越清晰，当然也有越来越多的开发者反馈 WeChatSampleBuilder 会抛许多的异常警告，原因是本地网络无法打开 github 特定的站点，以获取最新的版本号。

　　为了优化上述的问题，并且推动新 .NET 版本的普及，我们对老版本进行了比较彻底的重构，发布了 WeChatSampleBuilder V2.0（dll 版本v0.2.0），继续免费！

　　

What's new?

1. 支持网页版，基于全新的 SenparcCoreFramework（SCF） 模块（XSCF）开发，可以在 SCF 框架上随时升级到最新版，无需再下载桌面软件！Nuget 地址：https://www.nuget.org/packages/Senparc.Xscf.WeChatSampleBuilder。
2. 基于 XSCF 模块，反向重用到 WinForm 项目中，保持核心逻辑的完全一致。
3. WinForm 版本升级到 .NET Core 3.1，这意味着您必须安装 .NET Core 3.1 及以上版本才能打开桌面引用，.NET 4.5 的 WinForm 版本将不再更新。
4. 不再需要本地网络访问 github 等境外站点，版本信息载入速度提升 200 倍以上。

如何使用网页版 WeChatSampleBuilder？

 第一步：安装 SCF 框架

　　参考 《安装教程》 完成 SCF 基础框架搭建（无需编写任何代码，全自动执行）。

 第二步：安装 WeChatSampleBuilder Nuget 包

　　选择 Senparc.Web 项目，或会被此项目引用（最终发布）的项目，如下图中【MyExtensionCode】项目，鼠标点击右键，打开【管理 Nuget 程序包...】，搜索【WeChatSampleBuilder】，并点击【安装】：

 第三步：安装并启用 XSCF 包

　　编译打开 SCF 后台，进入左侧菜单【扩展模块】>【模块管理】页面，选择新出现的【WeChatSampleBuilder】包，点击右侧【安装】按钮，自动完成安装。

　　

 

  

 　　点击【开启】按钮。

 第四步：下载 Senparc.Weixin SDK 源码

　　从 Senparc.Weixin SDK 源码项目中下载的最新源码，然后解压后的根目录物理路径，如 F:WeChatSampleBuilder-CodeWeiXinMPSDK

　　源码可以通过另外一个功能【下载官方 Senparc.Weixin 源码】引导下载，或者手动下载：

• Github：https://github.com/JeffreySu/WeiXinMPSDK
• Gitee（码云）：https://gitee.com/JeffreySu/WeiXinMPSDK
  注意：目前更新最快的是 GitHub，Gitee（码云）在国内下载速度更快，但是不能确定是最新代码，下载前请注意核对最新 GitHub 上的版本。

 第五步：进行生成 Sample 操作

 　　点击上一步开启模块后，页面中【生成 Sample】功能左侧的【执行】按钮：

　　弹出生成参数选择列表：

  

　　在【源码物理路径】中，填写解压了完整源码的路径，如上述“F:WeChatSampleBuilder-CodeWeiXinMPSDK”；

　　在【使用模块】中选择您需要生成的对应模块；

　　在【引用方式】中提供了两种选择：“使用 Nuget 包”和“附带源码”，如果您是测试功能，或者希望构建一个基础测试项目，持续更新，建议使用前者（推荐），如果您希望查看并调试 SDK 的源码，则选择后者；

　　工具提供了两个“完成后操作”，分别是“完成后自动打开 Sample 解决方案”，以及“完成后自动打开 Sample 所在文件夹”，前者需要当前电脑安装了 Visual Studio 或 Visual Studio Code，在生成完成后将直接打开解决方案 sln 文件，后者将自动打开新生成项目的目录。建议都开启。

　　例如，我希望生成微信公众号、小程序，同时带微信支付，以及使用 Redis 缓存策略，则可以这样选择：

　　点击【运行】按钮，然后静静地等待即可。 

　　完成后，将收到成功提示：

　　结果中，提示了新 Sample 的输出目录、日志文件、Manifest 文件，以及 Sample 对应的 .sln 文件。

　　由于我同时选择了两个“完成后操作”，因此将自动打开文件夹：

 　　以及 VS 中的解决方案：

 　　直接 Ctrl+F5 运行解决方案：

　　此 Sample 的官方现在上版本（完整版）是：https://sdk.weixin.senparc.com/

　　提示：由于整个新 Sample 是基于官方完整的 Sample 基础上，根据开发者的选择进行自动删除和调整得到的，有些情况下因为文件编码、文件系统的原因，可能会有部分残余代码没有被自动处理从而影响编译，此时只要删除对应出错代码即可。

如何使用桌面版 WeChatSampleBuilder？

 第一步：下载桌面软件

　　注册并进入后台：https://weixin.senparc.com/User

 

 　　点击【点击下载】链接，下载并解压文件，解压密码可能会随时修改，以当前页面显示为准。

 第二步：运行软件

　　打开 WeChatSampleBuilder.exe 文件：

　　如遇杀毒软件、防火墙等提示，可以忽略，不包含任何木马或后门程序。

　　桌面版的应用提示都是英文的，其中，【Source Project Path】即源码根目录（对应 Web 版的【源码物理路径】），【Source Project Reference】即 SDK 的引用方式（对应 Web 版的【引用方式】）。

　　【Select Reference Modules】即需要生成的 Sample 所需要包含的模块。

　　Sample 和 .NET 的版本已经锁定，目前只提供 .NET Core 3.1（MVC） 的 Sample，生成后，您可以将其借鉴到其他 .NET Core 版本，如 .NET Core 2.2，无需修改代码。

 第三步：生成

　　配置选项，例如，下方配置仅生成适用于微信公众号的示例，并且只是用本地缓存，并且使用应用源码的方式：

 　　

　　进行设置后，点击【Build Sample】按钮，即可开始生成操作，耐心等待十几秒到几十秒。

　　生成成功界面：

　　点击【确定】，即可自动打开 .sln 解决方案以及生成目录，点击【取消】仅打开生成目录。

反馈

　　欢迎给我们反馈或意见建议，Email: zsu@senparc.com