WeChatSampleBuilder V2.0 使用教程（網頁版+桌面版）

2020 年 5 月 2 日
筆記
.NET Core, Asp.Net, ASP.NET MVC, c#, SampleBuilder, 原創, 微信

　　為了方便開發者可以快速搭建一個最小化所需模塊的 Senparc.Weixin SDK Sample 項目，我們於 2018 年 11 月發佈了首個 WeChatSampleBuilder 的版本，受到了廣大開發者的歡迎。

　　隨着時間的推移，我們的 Sample 功能不斷完善，同時微軟對 .NET 版本的路線也原來越清晰，當然也有越來越多的開發者反饋 WeChatSampleBuilder 會拋許多的異常警告，原因是本地網絡無法打開 github 特定的站點，以獲取最新的版本號。

　　為了優化上述的問題，並且推動新 .NET 版本的普及，我們對老版本進行了比較徹底的重構，發佈了 WeChatSampleBuilder V2.0（dll 版本v0.2.0）。

What’s new?

支持網頁版，基於全新的 SenparcCoreFramework（SCF）模塊（XSCF）開發，可以在 SCF 框架上隨時升級到最新版，無需再下載桌面軟件！Nuget 地址：//www.nuget.org/packages/Senparc.Xscf.WeChatSampleBuilder。
基於 XSCF 模塊，反向重用到 WinForm 項目中，保持核心邏輯的完全一致。
WinForm 版本升級到 .NET Core 3.1，這意味着您必須安裝 .NET Core 3.1 及以上版本才能打開桌面引用，.NET 4.5 的 WinForm 版本將不再更新。
不再需要本地網絡訪問 github 等境外站點，版本信息載入速度提升 200 倍以上。

如何使用網頁版 WeChatSampleBuilder？

　　第一步：安裝 SCF 框架

　　參考《安裝教程》完成 SCF 基礎框架搭建（無需編寫任何代碼，全自動執行）。

　　第二步：安裝 WeChatSampleBuilder Nuget 包

　　選擇 Senparc.Web 項目，或會被此項目引用（最終發佈）的項目，如下圖中【MyExtensionCode】項目，鼠標點擊右鍵，打開【管理 Nuget 程序包…】，搜索【WeChatSampleBuilder】，並點擊【安裝】：

　　第三步：安裝並啟用 XSCF 包

　　編譯打開 SCF 後台，進入左側菜單【擴展模塊】>【模塊管理】頁面，選擇新出現的【WeChatSampleBuilder】包，點擊右側【安裝】按鈕，自動完成安裝。

　　點擊【開啟】按鈕。

　　第四步：下載 Senparc.Weixin SDK 源碼

　　從 Senparc.Weixin SDK 源碼項目中下載的最新源碼，然後解壓後的根目錄物理路徑，如 F:\WeChatSampleBuilder-Code\WeiXinMPSDK

　　源碼可以通過另外一個功能【下載官方 Senparc.Weixin 源碼】引導下載，或者手動下載：

Github：//github.com/JeffreySu/WeiXinMPSDK
Gitee（碼雲）：//gitee.com/JeffreySu/WeiXinMPSDK
注意：目前更新最快的是 GitHub，Gitee（碼雲）在國內下載速度更快，但是不能確定是最新代碼，下載前請注意核對最新 GitHub 上的版本。

　　第五步：進行生成 Sample 操作

　　點擊上一步開啟模塊後，頁面中【生成 Sample】功能左側的【執行】按鈕，彈出生成參數選擇列表：

　　在【源碼物理路徑】中，填寫解壓了完整源碼的路徑，如上述「F:\WeChatSampleBuilder-Code\WeiXinMPSDK」；

　　在【使用模塊】中選擇您需要生成的對應模塊；

　　在【引用方式】中提供了兩種選擇：「使用 Nuget 包」和「附帶源碼」，如果您是測試功能，或者希望構建一個基礎測試項目，持續更新，建議使用前者（推薦），如果您希望查看並調試 SDK 的源碼，則選擇後者；

　　工具提供了兩個「完成後操作」，分別是「完成後自動打開 Sample 解決方案」，以及「完成後自動打開 Sample 所在文件夾」，前者需要當前電腦安裝了 Visual Studio 或 Visual Studio Code，在生成完成後將直接打開解決方案 sln 文件，後者將自動打開新生成項目的目錄。建議都開啟。

　　例如，我希望生成微信公眾號、小程序，同時帶微信支付，以及使用 Redis 緩存策略，則可以這樣選擇：