readme.en.md · steven_yin_js/WeiXinMPSDK

Senparc.Weixin —— WeChat .NET SDK 
=================

[![Build status](https://mysenparc.visualstudio.com/Senparc%20SDK/_apis/build/status/Weixin%20SDK/Senparc.Weixin%20Dev-%E5%86%85%E9%83%A8-%E8%87%AA%E5%8A%A8-.Net6)](https://mysenparc.visualstudio.com/Senparc%20SDK/_build/latest?definitionId=36)
[![NuGet](https://img.shields.io/nuget/dt/Senparc.Weixin.svg)](https://www.nuget.org/packages/Senparc.Weixin)
[![GitHub commit activity the past week, 4 weeks, year](https://img.shields.io/github/commit-activity/4w/JeffreySu/WeiXinMPSDK.svg)](https://github.com/JeffreySu/WeiXinMPSDK/commits/master)
![Static Badge](https://img.shields.io/badge/.NET-8.0-blue)
[![Senparc.Weixin.All](https://img.shields.io/nuget/vpre/Senparc.Weixin.All?label=Senparc.Weixin.All)](https://www.nuget.org/packages/Senparc.Weixin.All/)
[![license](https://img.shields.io/github/license/JeffreySu/WeiXinMPSDK.svg)](http://www.apache.org/licenses/LICENSE-2.0)

[![Senparc.Weixin](https://img.shields.io/nuget/vpre/Senparc.Weixin?label=Senparc.Weixin)](https://www.nuget.org/packages/Senparc.Weixin/)
[![Senparc.Weixin.MP](https://img.shields.io/nuget/vpre/Senparc.Weixin.MP?label=Senparc.Weixin.MP)](https://www.nuget.org/packages/Senparc.Weixin.MP/)
[![Senparc.Weixin.MP.Middleware](https://img.shields.io/nuget/vpre/Senparc.Weixin.MP.Middleware?label=Senparc.Weixin.MP.Middleware)](https://www.nuget.org/packages/Senparc.Weixin.MP.Middleware/)
[![Senparc.Weixin.MP.Mvc](https://img.shields.io/nuget/vpre/Senparc.Weixin.MP.Mvc?label=Senparc.Weixin.MP.Mvc)](https://www.nuget.org/packages/Senparc.Weixin.MP.Mvc/)
[![Senparc.Weixin.WxOpen](https://img.shields.io/nuget/vpre/Senparc.Weixin.WxOpen?label=Senparc.Weixin.WxOpen)](https://www.nuget.org/packages/Senparc.Weixin.WxOpen/)
[![Senparc.Weixin.WxOpen.Middleware](https://img.shields.io/nuget/vpre/Senparc.Weixin.WxOpen.Middleware?label=Senparc.Weixin.WxOpen.Middleware)](https://www.nuget.org/packages/Senparc.Weixin.WxOpen.Middleware/)
[![Senparc.Weixin.Work](https://img.shields.io/nuget/vpre/Senparc.Weixin.Work?label=Senparc.Weixin.Work)](https://www.nuget.org/packages/Senparc.Weixin.Work/)
[![Senparc.Weixin.Work.Middleware](https://img.shields.io/nuget/vpre/Senparc.Weixin.Work.Middleware?label=Senparc.Weixin.Work.Middleware)](https://www.nuget.org/packages/Senparc.Weixin.Work.Middleware/)
[![Senparc.Weixin.TenPay](https://img.shields.io/nuget/vpre/Senparc.Weixin.TenPay?label=Senparc.Weixin.TenPay)](https://www.nuget.org/packages/Senparc.Weixin.TenPay/)
[![Senparc.Weixin.TenPayV3](https://img.shields.io/nuget/vpre/Senparc.Weixin.TenPayV3?label=Senparc.Weixin.TenPayV3)](https://www.nuget.org/packages/Senparc.Weixin.TenPayV3/)
[![Senparc.Weixin.Open](https://img.shields.io/nuget/vpre/Senparc.Weixin.Open?label=Senparc.Weixin.Open)](https://www.nuget.org/packages/Senparc.Weixin.Open/)
[![Senparc.Weixin.AspNet](https://img.shields.io/nuget/vpre/Senparc.Weixin.AspNet?label=Senparc.Weixin.AspNet)](https://www.nuget.org/packages/Senparc.Weixin.AspNet/)
[![Senparc.Weixin.Cache.Redis](https://img.shields.io/nuget/vpre/Senparc.Weixin.Cache.Redis?label=Senparc.Weixin.Cache.Redis)](https://www.nuget.org/packages/Senparc.Weixin.Cache.Redis/)
[![Senparc.Weixin.Cache.CsRedis](https://img.shields.io/nuget/vpre/Senparc.Weixin.Cache.CsRedis?label=Senparc.Weixin.Cache.CsRedis)](https://www.nuget.org/packages/Senparc.Weixin.Cache.CsRedis/)
[![Senparc.Weixin.Cache.Memcached](https://img.shields.io/nuget/vpre/Senparc.Weixin.Cache.Memcached?label=Senparc.Weixin.Cache.Memcached)](https://www.nuget.org/packages/Senparc.Weixin.Cache.Memcached/)
[![Senparc.WebSocket](https://img.shields.io/nuget/vpre/Senparc.WebSocket?label=Senparc.WebSocket)](https://www.nuget.org/packages/Senparc.WebSocket/)

[[中文]](readme.md)

With Senparc.Weixin, you can easily and quickly develop applications for the Wechat platform, including Wechat Official Accounts, Mini Programs, Mini Games, Enterprise Accounts, Open Platforms, Wechat Pay, JS-SDK, Wechat Hardware/Bluetooth, and more. The demo of this project is also suitable for beginners to learn .NET programming.  
  
Currently, Senparc.Weixin supports almost all Wechat platform modules and interfaces, and supports multiple frameworks such as .NET 3.5 / 4.0 / 4.5 / .NET Standard 2.x / .NET Core 2.x / .NET Core 3.x / .NET 6.0 / .NET 7.0 / .NET 8.0. It is compatible with all environments including MVC, Razor, WebApi, Console (command line), desktop applications (.exe), Blazor, MAUI, and background services, and is completely decoupled from external frameworks.  
  
Senparc.Weixin SDK is currently the most widely used Wechat .NET SDK and one of the most popular .NET open source projects in China.  
  
Since its inception in 2013, we have been continuously updating the project and sharing the complete source code and design ideas without reservation, hoping that more people can benefit from it, understand and spread the spirit of open source, and help the open source cause in China! We are grateful to all the friends who have helped us along the way!  
  
If you like this project and want us to continue improving it, please give us a ★Star :)  
  
## 🔔 Announcement

> 🔥 AI chatbot wechat integration Sample is online! [click here to view](/Samples%20with%20AI) 
> 📺 <img src="https://github.com/JeffreySu/WeiXinMPSDK/assets/2281927/743f3019-c96b-4b61-acdb-d1834947d5d0" width="400" /> 
At the 2024 Microsoft MVP Global Summit, I had the privilege of interviewing Scott Hanselman and discussed a range of topics related to AI. We will continue our conversation on April 13, 2024, during the "Senparc 3.14 Technology Open Day" event, where we will delve deeper into the impact of AI and Agents on the future of the software industry and open-source software. Everyone is welcome to follow along! [Watch the video](https://github.com/JeffreySu/WeiXinMPSDK/wiki/%E5%BE%AE%E8%BD%AF-MVP-%E5%85%A8%E7%90%83%E5%B3%B0%E4%BC%9A%E9%87%87%E8%AE%BF-Scott-Hanselman) 
> ⚡ Sample now supports .NET 8.0 (backward compatible), [click here to view](/Samples/All/net8-mvc)! 
> 🔒 [Wechat Pay V3 module (V1.0)](https://github.com/JeffreySu/WeiXinMPSDK/tree/master/src/Senparc.Weixin.TenPay/Senparc.Weixin.TenPayV3) is now online! [Nuget](https://www.nuget.org/packages/Senparc.Weixin.TenPayV3) 
> 🎠 Fully support automatic segmentation and sending of long text messages, more: [《Auto Reply Long Text Messages to Adapt to AIGC Applications》](https://www.cnblogs.com/szw/p/weixin-large-text-response.html) 
 
 
 
 
## 🌟 Start: Separate documentation for each module + Sample code examples 
 
Module | Link 
----|---- 
Official Account | https://sdk.weixin.senparc.com/Docs/MP/ 
Mini Program | https://sdk.weixin.senparc.com/Docs/WxOpen/ 
Enterprise Wechat | https://sdk.weixin.senparc.com/Docs/Work/ 
Wechat Pay V3 (recommended) | https://sdk.weixin.senparc.com/Docs/TenPayV3/ 
Wechat Pay V2 (not recommended) | https://sdk.weixin.senparc.com/Docs/TenPayV2/ 
 
> Note: 
> 1. The above module examples include both documentation and runnable code templates (just need to configure Wechat parameters without modifying any code). 
> 2. The configuration, registration, and interface calling methods in the examples are consistent. Once you learn how to develop one module, you can apply the same knowledge to other modules. The Hello World example below uses Official Account as an example, but it can be extended to other modules as well. 
> 3. More complete development documentation is provided in the [/docs](/docs/) directory for advanced development, [click here to view](/docs/). 
 
## 🚀 Hello World: Start your Wechat development journey with 3 lines of code! 
 
> Note: 
> 1. The following source code is located in the [`/Samples/MP/`](/Samples/MP/) folder, using Wechat Official Account as an example. Once you learn how to develop for Official Account, you can apply the same knowledge to other modules (Mini Program, Enterprise Wechat, Wechat Pay, etc.). 
> 2. To view other module or integration examples, you can check the independent samples in the [`/Samples/`](/Samples/) folder or the integration samples in the [`/Samples/All/`](/Samples/All/) folder (for advanced users). 
> 3. For different WeChat platforms, the Senparc.Weixin SDK has decoupled and independently released each module. To simplify referencing, you can directly reference [Senparc.Weixin.All](https://www.nuget.org/packages/Senparc.Weixin.All), which will automatically reference all modules.
 
 
### Startup code (just 2 lines of code): 
1. Add configuration above `builder.Build()` in Program.cs: 
``` C# 
builder.Services.AddSenparcWeixinServices(builder.Configuration); 
``` 
> Corresponds to ConfigureServices() method in Startup.cs. 
 
2. Enable configuration below `builder.Build()` in Program.cs: 
``` C# 
var registerService = app.UseSenparcWeixin(app.Environment, null, null, register => { }, 
 (register, weixinSetting) => 
{ 
 // Register Official Account information (can be executed multiple times to register multiple Official Accounts) 
 register.RegisterMpAccount(weixinSetting, "Senparc Network Assistant Official Account"); 
}); 
``` 
> Corresponds to Configure() method in Startup.cs. 
 
### Call advanced interfaces (just 1 line of code): 
You can call interfaces (using Customer Service interface as an example) at any position in the program: 
``` C# 
await CustomApi.SendTextAsync("AppId", "OpenId", "Hello World!"); 
``` 
> Tips: 
> 1. Senparc.Weixin SDK automatically manages the AccessToken throughout its life cycle, so during development, you only need to provide the AppId without worrying about AccessToken expiration, etc. 
> 2. Registration information such as AppId can be automatically obtained from `Senparc.Weixin.Config.SenparcWeixinSetting`, and the relevant parameters are configured in `appsettings.json`. 
> 3. The above method also supports synchronous calls: Senparc.Weixin.MP.AdvancedAPIs.CustomApi.SendText(). 
> 4. All interface namespaces are defined according to the official API path rules, and the parameter naming is kept as consistent as possible with the documentation (especially the return parameters), making it easier for developers to quickly locate and test, and reduce the likelihood of bugs. 
 
With the above code, you can call interfaces for all Wechat modules! Continue reading for more skills. 
 
### How to use the messaging capability of Official Accounts? 
Official Accounts provide a messaging window by default, which can send different types of messages and interact with programs using text, images, voice, etc. 
 
The following example also applies to the messaging of Enterprise Wechat and Mini Program Customer Service, just two steps! 
 
#### Step 1: Create a custom MessageHandler to control message processing logic: 
 
<details> 
<summary>CustomMessageHandler.cs</summary> 
 
 
``` C# 
using Senparc.NeuChar.Entities; 
using Senparc.Weixin.MP.Entities; 
using Senparc.Weixin.MP.Entities.Request; 
using Senparc.Weixin.MP.MessageContexts; 
using Senparc.Weixin.MP.MessageHandlers; 
 
namespace Senparc.Weixin.Sample.MP 
{ 
 /// <summary> 
 /// Custom MessageHandler 
 /// Inherits from MessageHandler and overrides the corresponding request handling methods 
 /// </summary> 
 public partial class CustomMessageHandler : MessageHandler<DefaultMpMessageContext> 
 { 
 public CustomMessageHandler(Stream inputStream, PostModel postModel, int maxRecordCount = 0, 
 bool onlyAllowEncryptMessage = false, IServiceProvider serviceProvider = null) 
 : base(inputStream, postModel, maxRecordCount, onlyAllowEncryptMessage, null, serviceProvider) 
 { 
 } 
 
 /// <summary> 
 /// Default message for all unhandled types 
 /// </summary> 
 /// <returns></returns> 
 public override IResponseMessageBase DefaultResponseMessage(IRequestMessageBase requestMessage) 
 { 
 //ResponseMessageText can also be News or other types 
 var responseMessage = this.CreateResponseMessage<ResponseMessageText>(); 
 responseMessage.Content = $"You sent a message, but the program did not specify a processing procedure"; 
 return responseMessage; 
 } 
 
 public override Task<IResponseMessageBase> OnImageRequestAsync(RequestMessageImage requestMessage) 
 { 
 //Handle image requests... 
 } 
 
 public override Task<IResponseMessageBase> OnLocationRequestAsync(RequestMessageLocation requestMessage) 
 { 
 //Handle location requests... 
 } 
 } 
} 
``` 
</details> 
 
 
#### Step 2: Request the CustomMessageHandler: 
 
We provide two ways to request the CustomMessageHandler: `Middleware` (recommended) and `Controller (or WebApi)`. You can choose either one. Taking Middleware as an example, after enabling the configuration in Program.cs, add the following code to register the MessageHandler: 
``` C# 
app.UseMessageHandlerForMp("/WeixinAsync", 
 (stream, postModel, maxRecordCount, serviceProvider) 
 => new CustomMessageHandler(stream, postModel, maxRecordCount, false, serviceProvider), 
 options 
 => 
 { 
 options.AccountSettingFunc = context => Senparc.Weixin.Config.SenparcWeixinSetting; 
 }); 
``` 
 
At this point, you can use [https://YourDomain/WeixinAsync](https://sdk.weixin.senparc.com/WeixinAsync) to configure in the Wechat Official Account backend [Settings and Development]>[Basic Configuration]>Server Address (URL), and the corresponding Token is set in [appsettings.json](/Samples/MP/Senparc.Weixin.Sample.MP/appsettings.json#L36) (also applicable to Enterprise Wechat and Mini Program, please refer to the corresponding [Sample](/Samples/)). 
 
In addition, you can also use the `Controller (or WebApi)` method to have more precise control over the entire message processing process (or use it in .NET Framework), [click here to view](https://github.com/JeffreySu/WeiXinMPSDK/wiki/%E5%A6%82%E4%BD%95%E4%BD%BF%E7%94%A8MessageHandler%E7%AE%80%E5%8C%96%E6%B6%88%E6%81%AF%E5%A4%84%E7%90%86%E6%B5%81%E7%A8%8B). 
 
Now you have mastered the basic skills required to develop for Wechat platforms. Keep reading for more resources: 
 
<img src="https://sdk.weixin.senparc.com/images/SenparcRobotsnapshoot.jpg" width="300" align="right"> 
 
## 📇 More Indexes 
 
* [🏹 Libraries for each module](#-libraries-for-each-module) 
* [💾 Source code project folder description (under src folder)](#-source-code-project-folder-description-under-src-folder) 
* [🖥️ Samples folder description (under Samples folder)](#%EF%B8%8F-samples-folder-description-under-samples-folder) 
* [🎨 Resources](#-resources) 
* [📖 Senparc Official Book Tutorial](#-senparc-official-book-tutorial) 
* [🖥️ Senparc Official Video Tutorial](#-senparc-official-video-tutorial) 
* [🧪 Follow the test account (SenparcRobot)](#-follow-the-test-account-senparcrobot-to-experience-the-features) 
* [✋ Contribute to the code](#-contribute-to-the-code) 
* [👩‍🏫 How to develop using .NET Core](#-how-to-develop-using-net-core) 
* [↕️ Install via Nuget](#-install-via-nuget) 
* [🏬 How to deploy](#-how-to-deploy) 
* [🍴 Description of important branches](#-description-of-important-branches) 
* [🍟 Thanks to contributors](#-thanks-to-contributors) 
* [💰 Donate](#-donate) 
* [⭐ Star Count](#-star-count) 
* [📎 License](#-license) 
 
This repository contains the source code for multiple versions including .NET Framework/.NET Standard 2.0+/.NET Core 3.1/.NET 6/.NET 7/.NET 8: 
 
* Use Visual Studio 2022 to open the demo (supports all versions): .NET 8.0 - [Senparc.Weixin.Sample.Net7.sln](https://github.com/JeffreySu/WeiXinMPSDK/tree/Developer/Samples/All/net8-mvc) (includes recommended source code references) 
* Use Visual Studio 2019 or higher to open the .NET Framework demo: [Senparc.Weixin.MP.Sample.Net45.sln](https://github.com/JeffreySu/WeiXinMPSDK/tree/Developer/Samples/All/net45-mvc/) (does not include source code, only references the libraries) 
* Use Visual Studio 2019 or higher to open the command line Console demo (.NET Core): [Senparc.Weixin.MP.Sample.Consoles.vs2019.sln](https://github.com/JeffreySu/WeiXinMPSDK/tree/Developer/Samples/All/console)

#### Legend 
| ![.NET 4.6][net46Y] | ![.NET Standard 2.x][core20Y] | ![.NET 5.0 / 6.0 / 7.0 / 8.0][net8] 
|--|--|--| 
| .NET Framework 4.6.2+ | .NET Standard 2.0 / 2.1 | .NET 8.0, backward compatible with .NET 5.0-7.0 
 
> Tip: 
> 1. Starting from May 1, 2019, .NET Framework 3.5 and 4.0 will no longer receive updates. The last stable version of .NET Framework 3.5 + 4.0 can be found [here](https://github.com/JeffreySu/WeiXinMPSDK/releases/tag/v16.6.15). 
> 2. Starting from April 3, 2022, .NET Framework 4.5 has been upgraded to 4.6.2. The last stable version of .NET Framework 4.5 can be found [here](https://github.com/JeffreySu/WeiXinMPSDK/releases/tag/v16.17.9). 
> 3. If you are still using .NET Framework, it is recommended to upgrade your application to .NET Framework 4.8+ by January 12, 2027, as official support for .NET Framework 4.6.2 will end by then ([source](https://learn.microsoft.com/en-us/lifecycle/products/microsoft-net-framework)). 
> 4. Use the 'Senparc.Weixin.All' integration library to automatically reference all libraries at once.

[1.1]: https://img.shields.io/nuget/v/Senparc.Weixin.svg?style=flat
[1.2]: https://www.nuget.org/packages/Senparc.Weixin
[2.1]: https://img.shields.io/nuget/v/Senparc.Weixin.MP.svg?style=flat
[2.2]: https://www.nuget.org/packages/Senparc.Weixin.MP
[3.1]: https://img.shields.io/nuget/v/Senparc.Weixin.MP.MVC.svg?style=flat
[3.2]: https://www.nuget.org/packages/Senparc.Weixin.MP.MVC
[4.1]: https://img.shields.io/nuget/v/Senparc.Weixin.QY.svg?style=flat
[4.2]: https://www.nuget.org/packages/Senparc.Weixin.QY 
[5.1]: https://img.shields.io/nuget/v/Senparc.Weixin.Work.svg?style=flat
[5.2]: https://www.nuget.org/packages/Senparc.Weixin.Work
[6.1]: https://img.shields.io/nuget/v/Senparc.Weixin.Open.svg?style=flat
[6.2]: https://www.nuget.org/packages/Senparc.Weixin.Open
[7.1]: https://img.shields.io/nuget/v/Senparc.Weixin.Cache.Redis.svg?style=flat
[7.2]: https://www.nuget.org/packages/Senparc.Weixin.Cache.Redis
[8.1]: https://img.shields.io/nuget/v/Senparc.Weixin.Cache.Memcached.svg?style=flat
[8.2]: https://www.nuget.org/packages/Senparc.Weixin.Cache.Memcached
[9.1]: https://img.shields.io/nuget/v/Senparc.Weixin.WxOpen.svg?style=flat
[9.2]: https://www.nuget.org/packages/Senparc.Weixin.WxOpen
[10.1]: https://img.shields.io/nuget/v/Senparc.WebSocket.svg?style=flat
[10.2]: https://www.nuget.org/packages/Senparc.WebSocket
[11.1]: https://img.shields.io/nuget/v/Senparc.Weixin.MP.CoreMVC.svg?style=flat
[11.2]: https://www.nuget.org/packages/Senparc.Weixin.MP.CoreMVC
[12.1]: https://img.shields.io/nuget/v/Senparc.Weixin.TenPay.svg?style=flat
[12.2]: https://www.nuget.org/packages/Senparc.Weixin.TenPay
[13.1]: https://img.shields.io/nuget/v/Senparc.Weixin.TenPayV3.svg?style=flat
[13.2]: https://www.nuget.org/packages/Senparc.Weixin.TenPayV3

[net46Y]: https://img.shields.io/badge/.NET%20Framework%204.6+-Y-brightgreen.svg
[net46N]: https://img.shields.io/badge/.NET%20Framework%204.6+-N-lightgrey.svg
[net46N-]: https://img.shields.io/badge/.NET%20Framework%204.6+----lightgrey.svg
[core20Y]: https://img.shields.io/badge/.NET%20Standard2.x-Y-brightgreen.svg
[net8]: https://img.shields.io/badge/.NET%208.0-Y-brightgreen.svg

[nuget-img-base]: https://img.shields.io/nuget/dt/Senparc.Weixin.svg
[nuget-url-base]: https://www.nuget.org/packages/Senparc.Weixin
[nuget-img-mp]: https://img.shields.io/nuget/dt/Senparc.Weixin.MP.svg
[nuget-url-mp]: https://www.nuget.org/packages/Senparc.Weixin.MP
[nuget-img-mvc]: https://img.shields.io/nuget/dt/Senparc.Weixin.MP.Mvc.svg
[nuget-url-mvc]: https://www.nuget.org/packages/Senparc.Weixin.MP.Mvc
[nuget-img-tenpay]: https://img.shields.io/nuget/dt/Senparc.Weixin.TenPay.svg
[nuget-url-tenpay]: https://www.nuget.org/packages/Senparc.Weixin.TenPay
[nuget-img-tenpayv3]: https://img.shields.io/nuget/dt/Senparc.Weixin.TenPayV3.svg
[nuget-url-tenpayv3]: https://www.nuget.org/packages/Senparc.Weixin.TenPayV3
[nuget-img-qy]: https://img.shields.io/nuget/dt/Senparc.Weixin.QY.svg
[nuget-url-qy]: https://www.nuget.org/packages/Senparc.Weixin.QY
[nuget-img-work]: https://img.shields.io/nuget/dt/Senparc.Weixin.Work.svg
[nuget-url-work]: https://www.nuget.org/packages/Senparc.Weixin.Work
[nuget-img-open]: https://img.shields.io/nuget/dt/Senparc.Weixin.Open.svg
[nuget-url-open]: https://www.nuget.org/packages/Senparc.Weixin.Open
[nuget-img-redis]: https://img.shields.io/nuget/dt/Senparc.Weixin.Cache.Redis.svg
[nuget-url-redis]: https://www.nuget.org/packages/Senparc.Weixin.Cache.Redis
[nuget-img-mc]: https://img.shields.io/nuget/dt/Senparc.Weixin.Cache.Memcached.svg
[nuget-url-mc]: https://www.nuget.org/packages/Senparc.Weixin.Cache.Memcached
[nuget-img-wxopen]: https://img.shields.io/nuget/dt/Senparc.Weixin.WxOpen.svg
[nuget-url-wxopen]: https://www.nuget.org/packages/Senparc.Weixin.WxOpen
[nuget-img-ws]: https://img.shields.io/nuget/dt/Senparc.WebSocket.svg
[nuget-url-ws]: https://www.nuget.org/packages/Senparc.WebSocket

## Feature Support 
 
* Most of the WeChat 8.x APIs are supported, including WeChat Pay, custom menu/personalized menu, template message interface, material upload interface, mass message interface, customer service interface, payment interface, WeChat store interface, card interface, invoice interface, etc. 
* Support for WeChat Official Accounts, Mini Programs, Enterprise Accounts, Open Platforms, WeChat Pay, and other modules. 
* Support for user session context (solving the problem of using Session to process user information on the server). 
* Full support for the latest APIs of WeChat Official Accounts, Mini Programs, Enterprise Accounts (WeChat Work), WeChat Pay V2/V3, and Open Platforms. 
* Support for distributed caching and caching strategy extension (default support: local cache, Redis, Memcached, can be freely extended), no need to worry about the type of cache used during development, can be freely switched in the configuration file or during runtime. 
 
> 1. The official APIs are perfectly integrated, and all upgrades will try to ensure backward compatibility unless otherwise specified. So you can safely use or directly upgrade (overwrite) the latest DLLs. It is recommended to use [NuGet](https://www.nuget.org/) for updates. 
> 2. You can also modify and compile the code yourself. Open the [Senparc.Weixin.Sample.Net8.sln](/Samples/All/net8-mvc/) solution to see all the source code. When the compilation mode is `Release`, a local NuGet package will be automatically generated (default generated in the `/src/BuildOutPut/` folder). 
 
## 💾 Explanation of Source Code Project Folders (under the src folder) 
 
<details> 
<summary>Expand</summary> 
 
 
| Folder | Description | 
|--------|--------| 
|[Senparc.WebSocket](src/Senparc.WebSocket/)|WebSocket module| 
|[Senparc.Weixin.Cache](src/Senparc.Weixin.Cache)							|Senparc.Weixin.Cache.Memcached.dll, Senparc.Weixin.Cache.Redis.dll, and other distributed cache extension solutions| 
|[Senparc.Weixin.AspNet](src/Senparc.Weixin.AspNet)							|Senparc.Weixin.AspNet.dll, a class library specifically for web support| 
|[Senparc.Weixin.MP.MvcExtension](src/Senparc.Weixin.MP.MvcExtension)		|Senparc.Weixin.MP.MvcExtension.dll source code, an extension package for MVC projects | 
|[Senparc.Weixin.MP](src/Senparc.Weixin.MP)									|Senparc.Weixin.MP.dll WeChat Official Account SDK source code| 
|[Senparc.Weixin.MP.Middleware](src/Senparc.Weixin.MP.Middleware) |Senparc.Weixin.MP.Middleware.dll WeChat Official Account message middleware source code| 
|[Senparc.Weixin.Open](src/Senparc.Weixin.Open)								|Senparc.Weixin.Open.dll Third-party Open Platform SDK source code| 
|[Senparc.Weixin.TenPay](src/Senparc.Weixin.TenPay)							|Senparc.Weixin.TenPay.dll & Senparc.Weixin.TenPayV3.dll source code for WeChat Pay [V2](https://github.com/JeffreySu/WeiXinMPSDK/tree/Developer/src/Senparc.Weixin.TenPay/Senparc.Weixin.TenPay) and [V3](https://github.com/JeffreySu/WeiXinMPSDK/tree/Developer/src/Senparc.Weixin.TenPay/Senparc.Weixin.TenPayV3)| 
|[Senparc.Weixin.Work](src/Senparc.Weixin.Work)								|Senparc.Weixin.Work.dll Enterprise WeChat SDK source code| 
|[Senparc.Weixin.Work.Middleware](src/Senparc.Weixin.Work.Middleware) |Senparc.Weixin.Work.Middleware.dll Enterprise WeChat message middleware source code| 
|[Senparc.Weixin.WxOpen](src/Senparc.Weixin.WxOpen)							|Senparc.Weixin.WxOpen.dll WeChat Mini Program SDK source code, including Mini Games| 
|[Senparc.Weixin.WxOpen.Middleware](src/Senparc.Weixin.WxOpen.Middleware) |Senparc.Weixin.WxOpen.Middleware.dll WeChat Mini Program message middleware source code, including Mini Games| 
|[Senparc.Weixin](src/Senparc.Weixin)										|Source code for all Senparc.Weixin.[x].dll basic libraries| 
</details> 
 
[Enter Folder](/src/) 
 
## 🖥️ Explanation of Samples Folder (under the Samples folder) 
 
The usage of all modules in the Senparc.Weixin SDK is highly consistent, including the configuration process, AccessToken management, message processing, service messages, API calls, etc. You only need to refer to the usage of any module (it is recommended to start with `Official Accounts` or `Mini Programs`), and you can apply the same principles to other modules. 
 
From the following samples, you can learn about the configuration and usage of each independent module. Just open the `.sln` solution file in the corresponding folder to view the source code and run it to see the documentation. The `All` folder contains more comprehensive and advanced feature demonstrations. 
 
| Folder | Description | SDK Reference Method | 
|--------|--------|----| 
|[MP](/Samples/MP/) | Official Accounts | NuGet Package 
|[TenPayV2](/Samples/TenPayV2/) | WeChat Pay V1 and V2 | NuGet Package 
|[TenPayV3](/Samples/TenPayV3/) | WeChat Pay V3 (TenPay APIv3) | NuGet Package 
|[Work](/Samples/Work/) | Enterprise Accounts | NuGet Package 
|[WxOpen](/Samples/WxOpen/) | Mini Programs | NuGet Package 
|[Shared](/Samples/Shared) | Shared files required by all samples 
|[All](/Samples/All/) | A mixed scenario demonstration that includes all functions of WeChat Official Accounts, Mini Programs, WeChat Pay, Enterprise Accounts, etc., recommended for projects that integrate multiple platforms or require deep development (advanced) | 
| ┣ [All/console](/Samples/All/console)			|Command Line Console Demo (.NET Core)| NuGet Package 
| ┣ [All/net45-mvc](/Samples/All/net45-mvc)						|Demo that can be directly published and used (.NET Framework 4.5 + ASP.NET MVC)| NuGet Package 
| ┗ [All/net8-mvc](/Samples/All/net8-mvc)			|Demo that can be directly published and used (.NET 8.0), compatible with .NET 5.0, 6.0, 7.0, and .NET Core | Source Code 
 
[Enter Samples Folder](/Samples/) 
 
 
 
 
 
 
 
## 🎨 Resources 
 
1. Official website: https://weixin.senparc.com/ 
2. Online demo (for .NET 8.0, backward compatible with .NET 6.0, 7.0, and .NET Core): https://sdk.weixin.senparc.com/ 
3. WeChat development tutorials: https://www.cnblogs.com/szw/p/weixin-course-index.html 
4. WeChat technical community: https://weixin.senparc.com/QA 
5. Custom menu online editor: https://sdk.weixin.senparc.com/Menu 
6. Online message testing tool: https://sdk.weixin.senparc.com/SimulateTool 
7. Cache testing tool: https://sdk.weixin.senparc.com/Cache/Test 
8. chm help document download: https://sdk.weixin.senparc.com/Document 
9. Source code and latest updates: https://github.com/JeffreySu/WeiXinMPSDK 
10. WeChat development resource collection: https://github.com/JeffreySu/WeixinResource 
11. Auxiliary system for reading "In-depth Analysis of WeChat Development": https://book.weixin.senparc.com 
12. Purchase "In-depth Analysis of WeChat Development": [https://item.jd.com/12220004.html](https://book.weixin.senparc.com/book/link?code=github-homepage-resource) 
13. "Rapid Development of WeChat Official Accounts and Mini Programs" video tutorial: [https://github.com/JeffreySu/WechatVideoCourse](https://github.com/JeffreySu/WechatVideoCourse) 
 
* Technical communication QQ groups: 
 
>Group 1 (Official Accounts): 300313885 
>Group 14 (Video Course Students): 588231256 
>Group 10 (Distributed Cache): 246860933 
>Group 12 (Mini Programs): 108830388 
>Group 16 (Open Platform): 860626938 
>*`The following groups are full:`* 
>`Group 2: 293958349 (Full), Group 3: 342319110 (Full)` 
>`Group 4: 372212092 (Full), Group 5: 377815480 (Full), Group 6: 425898825 (Full)` 
>`Group 7: 482942254 (Full), Group 8: 106230270 (Full), Group 9: 539061281 (Full)` 
>`Group 11: 553198593 (Full), Group 13: 183424136 (Open Platform, Full), Group 15: 289181996 (Full)` 
 
* Business contact QQ: 498977166 
 
 
 
If this project is helpful to you, we welcome any form of donation or participation in code updates and feedback. Thank you! 
 
Donation: [Enter](http://sdk.weixin.senparc.com#donate)

## 📖 Senparc Official Book Tutorial 
 
<img src="https://sdk.weixin.senparc.com/images/book-cover-front-small-3d.png" width="400" align="right"> 
 
> The Wechat development book, titled "In-Depth Analysis of Wechat Development: Efficient Development Secrets for Official Accounts and Mini Programs," completed by Jeffrey Su and the Senparc team after 2 years of effort, has been published. The book comes with an auxiliary reading system: [BookHelper](http://book.weixin.senparc.com). 
> Welcome to purchase the genuine book: [【Buy Genuine】](https://book.weixin.senparc.com/book/link?code=github-homepage) 
> The code snapshot of the book's publication version is in the branch [BookVersion1](https://github.com/JeffreySu/WeiXinMPSDK/tree/BookVersion1). 
 
 
## 💻 Senparc Official Video Tutorial 
 
> In order to help everyone understand Wechat development details more intuitively and learn Wechat development and various tricks in .NET development process, we have established the "Senparc Classroom" group and launched Wechat development video courses, which cover the following two parts: 
> 1. Wechat development basic skills 
> 2. Case study of official accounts and mini programs 
> 
> The total course duration is 60 lessons, with additional episodes. 
> Currently, the videos are available on NetEase Cloud Classroom, with well-produced content and abundant materials. The course has been selected as an "A" level course. [【Watch Videos】](https://book.weixin.senparc.com/book/videolinknetease?code=github-homepage), [【View Course Code and Slides】](https://github.com/JeffreySu/WechatVideoCourse). 
 
 
## 🧪 Follow the test account to experience the functions (SenparcRobot): 
 
|Senparc Network Assistant Official Account|Senparc Network Assistant Mini Program|BookHelper| 
|--|--|--| 
| <img src="https://sdk.weixin.senparc.com/Images/qrcode.jpg" width="258" /> | <img src="https://sdk.weixin.senparc.com/Images/SenparcRobot_MiniProgram.jpg" width="258" /> | <img src="https://sdk.weixin.senparc.com/Images/qrcode-bookhelper.jpg" width="258" /> | 
 
 
## ✋ Contribute Code 
 
> If you need to use or modify the source code of this project, it is recommended to Fork first. You are also welcome to submit a Pull Request for the general version you modified. 
 
1. Fork 
2. Create your feature branch (`git checkout -b my-new-feature`) 
3. Commit your changes (`git commit -am 'Added some feature'`) 
4. Push to the remote `git` repository (`git push origin my-new-feature`) 
5. Go to the `my-new-feature` branch of your `git` remote repository on the github website and submit a Pull Request 
(Submit to the `Developer` branch instead of the `master` branch directly) 
 
 
 
 
## 👩‍🏫 How to develop with .NET Core 
 
> The current branch includes the full version of .NET Framework 4.6.2+ and .NET 6.0/7.0/8.0 code (snapshot of versions that are no longer updated can be found in [release](https://github.com/JeffreySu/WeiXinMPSDK/releases)). 
> The Demo for .NET Framework is located in the `/src/Samples/All/net45-mvc` directory, and 
> 【Recommended】The Demo for .NET 8.0 (compatible with .NET 5.0, 6.0, 7.0, and .NET Core 3.1 and lower versions) is located in the `/Samples/All/net8-mvc` directory. 
> Note: In the above Samples, the `net8-mvc` Sample directly references the source code of each module, and can generate a Senaprc.Weixin SDK library compatible with different versions after being compiled with `Release`.
 
## ↕️ Install via Nuget to the project 
 
The Nuget installation methods for each module: [Installing the SDK into the project using Nuget](https://github.com/JeffreySu/WeiXinMPSDK/wiki/Installing-the-SDK-into-the-project-using-Nuget) 
 
## 🏬 Deployment guide 
 
### 1) Deploy to Azure App Service 
 
[App Service](https://docs.microsoft.com/zh-cn/azure/app-service/azure-web-sites-web-hosting-plans-in-depth-overview) is a Web service launched by Microsoft Azure, which has good support for .NET. The deployment steps are detailed in: [Deploy the Wechat site to Azure](https://github.com/JeffreySu/WeiXinMPSDK/wiki/Deploy-the-Wechat-site-to-Azure). 
 
### 2) Deploy to any server via FTP 
 
Install an FTP service (FileZilla Server is recommended) on the Web server, and directly upload the compiled code from the local machine (the corresponding code in the [Samples](https://github.com/JeffreySu/WeiXinMPSDK/tree/master/Samples) is [Senparc.Weixin.Sample.Net8](https://github.com/JeffreySu/WeiXinMPSDK/tree/Developer/Samples/All/net8-mvc). After compilation, you can use it directly without modifying the code. If you use Azure App Service or other cloud services, FTP is usually enabled as well. 
 
 
 
 
## 🍴 Important Branches 
 
|  Branch   |     Description         
|-----------|--------------- 
| master   | The main branch for official releases. This branch is usually more stable and can be used in production environments. 
| Developer | 1. The development branch. This branch is usually the Beta version, and new versions are developed in this branch before being pushed to the master branch. If you want to get a sneak peek of new features, you can use this branch. 2. This branch is compatible with .NET 4.5 / .NET Core / .NET Core 2.0 versions at the same time. It is recommended to submit Pull Requests for code to this branch instead of the master branch. 
| BookVersion1 | This branch is a code snapshot of the book [In-Depth Analysis of Wechat Development: Efficient Development Secrets for Official Accounts and Mini Programs](https://book.weixin.senparc.com/book/link?code=github-homepage2) publication. 
| DotNET-Core_MySQL | This branch is a demonstration branch for integrating [Pomelo.EntityFrameworkCore.MySql](https://github.com/PomeloFoundation/Pomelo.EntityFrameworkCore.MySql) framework in .NET Core environment. 
| NET4.0     | Branch that only supports .NET 4.0. This branch was stopped updating in 2017. The latest code for .NET 4.0 is synchronized with the master / Developer branch. 
| NET3.5     | Branch that only supports .NET 3.5. This branch was stopped updating in 2015. The latest code for .NET 3.5 is synchronized with the master / Developer branch. 
| Developer-Senparc.SDK | This branch is only used for internal testing of the Senparc team and can be ignored. 
 
 
## 🍟 Thanks To Contributors 
 
Thanks to the developers who contributed to this project. You have not only improved this project, but also made a contribution to the Chinese open source community. Thank you! The list can be found [here](https://github.com/JeffreySu/WeiXinMPSDK/blob/master/Contributors.md).

<a href="https://github.com/JeffreySu/WeiXinMPSDK/graphs/contributors">
 <img src="https://contrib.rocks/image?repo=JeffreySu/WeiXinMPSDK&max=200" />
</a>
 
## 💰 Donations 
 
If this project is useful to you, we welcome any form of donation, including participating in project code updates or providing feedback. Thank you! 
 
Donate: 
 
[![donate](http://sdk.weixin.senparc.com/Images/T1nAXdXb0jXXXXXXXX_s.png)](http://sdk.weixin.senparc.com#donate)

## ⭐ Star Quantity Statistics

[![starcharts stargazers over time](https://starchart.cc/JeffreySu/WeiXinMPSDK.svg)](https://starchart.cc/JeffreySu/WeiXinMPSDK)

## 📎 License

Apache License Version 2.0

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file 
except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the 
License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, 
either express or implied. See the License for the specific language governing permissions 
and limitations under the License.
```
Detail: https://github.com/JeffreySu/WeiXinMPSDK/blob/master/license.md

steven_yin_js/WeiXinMPSDK

简介

发行版

贡献者

近期动态

steven_yin_js/WeiXinMPSDK .gitee-modal { width: 500px !important; }

简介

发行版

贡献者

近期动态

搜索帮助

steven_yin_js/WeiXinMPSDK