為了方便開發者可以快速搭建一個最小化所需模塊的 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 地址:https://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:https://github.com/JeffreySu/WeiXinMPSDK
- Gitee(碼雲):https://gitee.com/JeffreySu/WeiXinMPSDK
注意:目前更新最快的是 GitHub,Gitee(碼雲)在國內下載速度更快,但是不能確定是最新代碼,下載前請注意核對最新 GitHub 上的版本。
第五步:進行生成 Sample 操作
點擊上一步開啟模塊后,頁面中【生成 Sample】功能左側的【執行】按鈕:
彈出生成參數選擇列表:
在【源碼物理路徑】中,填寫解壓了完整源碼的路徑,如上述“F:\WeChatSampleBuilder-Code\WeiXinMPSDK”;
在【使用模塊】中選擇您需要生成的對應模塊;
在【引用方式】中提供了兩種選擇:“使用 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