readme.md · 与猪共舞/WeiXinMPSDK

Senparc.Weixin —— 微信 .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/)

[[English Version]](readme.en.md)

使用 Senparc.Weixin，您可以方便快速地开发微信全平台的应用（包括微信公众号、小程序、小游戏、企业号、开放平台、微信支付、JS-SDK、微信硬件/蓝牙，等等）。本项目的 Demo 同样适合初学者进行 .NET 编程学习。

目前 Senparc.Weixin 已经支持几乎所有微信平台模块和接口，并同时支持 
[.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](https://github.com/JeffreySu/WeiXinMPSDK/tree/Developer) 等多种框架，同时兼容所有 MVC、Razor、WebApi、Console（命令行）、桌面应用（.exe）、Blazor、MAUI、后台服务等环境，和外部框架完全解耦。

Senparc.Weixin SDK 是目前使用率最高的微信 .NET SDK，也是国内最受欢迎的 .NET 开源项目之一。

自 2013 年起立项 10 年多来，我们一直保持着项目的持续更新，并将完整的源代码以及设计思想毫无保留地分享给大家，希望有更多的人可以从中受益，理解并传播开源的精神，一同助力中国开源事业！感恩一路上给我们提供帮助的朋友们！

如果你喜欢并希望我们继续优化这个项目，请给我们一个 ★Star ：)

## 🔔 公告

> 🔥 AI 聊天机器人微信集成 Sample 已上线！[查看](/Samples%20with%20AI) 
> 📺 <img src="https://github.com/JeffreySu/WeiXinMPSDK/assets/2281927/743f3019-c96b-4b61-acdb-d1834947d5d0" width="400" /> 
在 2024 微软 MVP 全球峰会上有幸采访到 Scott Hanselman，并交流了一部分有关 AI 的话题，我们将会在 2024 年 4 月 13 日的“盛派 3.14 技术开放日”活动上再次进行对话，深入交流关于 AI 和 Agent 对未来软件行业以及开源软件的影响，欢迎大家关注！[查看视频](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 已支持 .NET 8.0（向下兼容），[点击这里查看](/Samples/All/net8-mvc)！ 
> 🔒 [微信支付 V3 模块（V1.0）](https://github.com/JeffreySu/WeiXinMPSDK/tree/master/src/Senparc.Weixin.TenPay/Senparc.Weixin.TenPayV3)已上线！[Nuget](https://www.nuget.org/packages/Senparc.Weixin.TenPayV3) 
> 🎠 全面支持长文本自动分片发送，更多：[《顺应 AIGC 应用，自动“续航”回复超长文本消息》](https://www.cnblogs.com/szw/p/weixin-large-text-response.html)

## 🌟 Start：分模块独立说明文档 + Sample 代码示例

模块 | 地址
----|----
公众号 | https://sdk.weixin.senparc.com/Docs/MP/
小程序 | https://sdk.weixin.senparc.com/Docs/WxOpen/
企业微信 | https://sdk.weixin.senparc.com/Docs/Work/
微信支付 V3（推荐） | https://sdk.weixin.senparc.com/Docs/TenPayV3/
微信支付 V2（不推荐） | https://sdk.weixin.senparc.com/Docs/TenPayV2/

> 说明： 
> 1、上述分模块示例中，同时包含了文档及可以立即运行的代码模板（只需要配置微信参数，无需修改任何代码）。
> 1、示例中的配置、注册、接口调用方法均一致，只要学会其中一个模块开发，就可以举一反三。以下的 Hello World 示例也以公众号为例，可以延伸到所有其他模块。 
> 2、[/docs](/docs/) 目录中提供了更完整的开发说明文档，供进阶开发使用，[点击查看](/docs/)。 
> 3、对应于微信不同平台，Senparc.Weixin SDK 已经将各模块解耦并独立发布，为了简化引用，您也可以直接引用 [Senparc.Weixin.All](https://www.nuget.org/packages/Senparc.Weixin.All)，自动引用所有模块。
	
## 🚀 Hello World ：用 3 句代码开启你的微信开发之旅！

> 说明： 
> 1、下述源码位于 [`/Samples/MP/`](/Samples/MP/) 文件夹，以微信公众号为例。学会公众号就可以举一反三使用其他模块，基本用法一致（小程序、企业微信、微信支付等）。 
> 2、如需查看其他模块或集成示例，可以查看位于 [`/Samples/`](/Samples/) 文件夹下的其他独立 Sample，或 [`/Samples/All/`](/Samples/All/) 文件夹下的集成 Sample（进阶）。

### 启动代码（只需 2 句代码）：
1、 在 Program.cs 的 builder.Build() 上方添加配置：
``` C#
builder.Services.AddSenparcWeixinServices(builder.Configuration);
```
> 对应于 Startup.cs 的 ConfigureServices() 方法内。

2、 在 Program.cs 的 builder.Build() 下方启用配置：
``` C#
var registerService = app.UseSenparcWeixin(app.Environment, null, null, register => { },
 (register, weixinSetting) =>
{
 //注册公众号信息（可以执行多次，注册多个公众号）
 register.RegisterMpAccount(weixinSetting, "【盛派网络小助手】公众号");
});
```
> 对应于 Startup.cs 的 Configure() 方法内。

### 调用高级接口（只需 1 句代码）：
可在程序任意位置调用接口（以客服接口为例）：
``` C#
await CustomApi.SendTextAsync("AppId", "OpenId", "Hello World!");
```
> 提示： 
> 1. Senparc.Weixin SDK 将全生命周期自动托管 AccessToken，因此开发过程只需提供 AppId，无需操心 AccessToken 过期等问题。 
> 2. AppId 等注册信息可从 `Senparc.Weixin.Config.SenparcWeixinSetting` 中自动获取，相关参数在 `appsettings.json` 中配置。
> 3. 以上方法也支持同步方法：Senparc.Weixin.MP.AdvancedAPIs.CustomApi.SendText() 。
> 4. 所有接口命名空间均参照官方 API 路径规则定义，且参数命名方式尽量与文档保持一致（特别是返回参数），以方便开发者在源码中快速查找定位、提升测试效率、降低 bug 发生的可能性。

至此，您已经可以举一反三调用所有微信模块的接口啦！更多技能请继续往下看。

### 如何使用公众号消息对话能力？
公众号默认提供了对话窗口，可以发送文字、图片、语音等不同类型的信息和程序互动。

以下示例同样适用于企业微信和小程序客服消息的对话，只需两步！

#### 第一步：创建自定义 MessageHandler 负责控制消息处理逻辑：

<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>
 /// 自定义MessageHandler
 /// 把MessageHandler作为基类，重写对应请求的处理方法
 /// </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>
 /// 所有未处理类型的默认消息
 /// </summary>
 /// <returns></returns>
 public override IResponseMessageBase DefaultResponseMessage(IRequestMessageBase requestMessage)
 {
 //ResponseMessageText也可以是News等其他类型
 var responseMessage = this.CreateResponseMessage<ResponseMessageText>();
 responseMessage.Content = $"你发送了一条消息，但程序没有指定处理过程";
 return responseMessage;
 }

public override Task<IResponseMessageBase> OnImageRequestAsync(RequestMessageImage requestMessage)
 {
 //处理图片请求...
 }

public override Task<IResponseMessageBase> OnLocationRequestAsync(RequestMessageLocation requestMessage)
 {
 //处理地理位置请求...
 }
 }
}
```
</details>

#### 第二步：请求 CustomMessageHandler：

我们提供了 `中间件`（推荐）和 `Controller（或WebApi）` 两种方式请求 CustomMessageHandler，您可以任选其一。以中间件为例，在 Program.cs 中启用配置后添加代码，注册 MessageHandler：
``` C#
app.UseMessageHandlerForMp("/WeixinAsync",
    (stream, postModel, maxRecordCount, serviceProvider)
        => new CustomMessageHandler(stream, postModel, maxRecordCount, false, serviceProvider),
    options 
        =>
    {
        options.AccountSettingFunc = context => Senparc.Weixin.Config.SenparcWeixinSetting;
    });
```

此时，您已经可以使用 [https://YourDomain/WeixinAsync](https://sdk.weixin.senparc.com/WeixinAsync) 在微信公众号后台【设置与开发】>【基本配置】> 服务器地址(URL) 中进行配置，对应 Token 在 [appsettings.json](/Samples/MP/Senparc.Weixin.Sample.MP/appsettings.json#L36) 中设置（同样适用于企业微信和小程序，请参考对应 [Sample](/Samples/)）。

此外，您还可以使用 `Controller（或 WebApi）` 方式可以对整个消息处理步骤进行更加细致的控制（或在 .NET Framework 中使用），[点击这里查看](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)。

至此，您已经掌握了开发微信各平台所需要的基本技能，更多资源请继续往下看：

## 📇 更多介绍索引

* [🏹 各模块类库](#-各模块类库)
* [💾 源码项目文件夹说明（src文件夹下）](#-源码项目文件夹说明src文件夹下)
* [🖥️ Samples 文件夹说明（Samples文件夹下）](#%EF%B8%8F-samples-文件夹说明samples文件夹下)
* [🎨 资源](#-资源)
* [📖 Senparc 官方图书教程](#-senparc-官方图书教程)
* [🖥️ Senparc 官方视频教程](#-senparc-官方视频教程)
* [🧪 关注测试账号（SenparcRobot）](#-关注测试账号体验功能senparcrobot)
* [✋ 贡献代码](#-贡献代码)
* [👩‍🏫 如何使用 .NET Core 开发](#-如何使用-net-core-开发)
* [↕️ 使用 Nuget 安装到项目中](#-使用-nuget安装到项目中)
* [🏬 如何部署](#-如何部署)
* [🍴 各重要分支说明](#-各重要分支说明)
* [🍟 感谢贡献者](#-感谢贡献者)
* [💰 捐助](#-捐助)
* [⭐ Star 数量统计](#-star-数量统计)
* [📎 License](#-license)

本库包含了 .NET Framework/.NET Standard 2.0+/.NET Core 3.1/.NET 6/.NET 7/.NET 8 等多个版本的源代码（核心逻辑完全一致）：

* 使用 Visual Studio 2022 打开 Demo（支持所有版本）：.NET 8.0 - [Senparc.Weixin.Sample.Net8.sln](https://github.com/JeffreySu/WeiXinMPSDK/tree/Developer/Samples/All/net8-mvc)（包含源码引用推荐）
* 使用 Visual Studio 2019 或更高版本打开 .NET Framework Demo：[Senparc.Weixin.MP.Sample.Net45.sln](https://github.com/JeffreySu/WeiXinMPSDK/tree/Developer/Samples/All/net45-mvc/)（不包含源码，仅引用类库）
* 使用 Visual Studio 2019 或更高版本打开命令行 Console Demo（.NET Core）：[Senparc.Weixin.MP.Sample.Consoles.vs2019.sln](https://github.com/JeffreySu/WeiXinMPSDK/tree/Developer/Samples/All/console)

## 🏹 各模块类库

| # | 模块功能 | DLL | Nuget | 支持 .NET 版本 
|---|----------------------------------------------------|-------------------------------------------------|---------------------------------------|--------------------------------------
| 1| 基础库 |Senparc.Weixin.dll | [![Senparc.Weixin][1.1]][1.2] [![Senparc.Weixin][nuget-img-base]][nuget-url-base] | ![.NET 4.5][net46Y] ![.NET Standard 2.0/2.1][core20Y] ![.NET 5.0 / 6.0 / 7.0 / 8.0][net8] 
| 2| 微信公众号 / JSSDK / 摇周边 等等 |Senparc.Weixin.MP.dll | [![MP][2.1]][2.2] [![MP][nuget-img-mp]][nuget-url-mp] | ![.NET 4.5][net46Y] ![.NET Standard 2.0/2.1][core20Y] ![.NET 5.0 / 6.0 / 7.0 / 8.0][net8] 
| 3| [微信小程序 （支持小游戏） （独立项目）](https://github.com/JeffreySu/WxOpen) |Senparc.Weixin.WxOpen.dll | [![WxOpen][9.1]][9.2] [![WxOpen][nuget-img-wxopen]][nuget-url-wxopen] | ![.NET 4.5][net46Y] ![.NET Standard 2.0/2.1][core20Y] ![.NET 5.0 / 6.0 / 7.0 / 8.0][net8] 
| 4| 微信支付 |Senparc.Weixin.TenPay.dll | [![TenPay][12.1]][12.2] [![TenPay][nuget-img-tenpay]][nuget-url-tenpay] | ![.NET 4.5][net46Y] ![.NET Standard 2.0/2.1][core20Y] ![.NET 5.0 / 6.0 / 7.0 / 8.0][net8] 
| 5| 微信支付 V3 |Senparc.Weixin.TenPayV3.dll | [![TenPayV3][13.1]][13.2] [![TenPay][nuget-img-tenpayv3]][nuget-url-tenpayv3] | ![.NET 4.5][net46N] ![.NET Standard 2.0/2.1][core20Y] ![.NET 5.0 / 6.0 / 7.0 / 8.0][net8] 
| 6| ASP.NET MVC 扩展 |Senparc.Weixin.MP.MVC.dll         | [![MP.MVC][3.1]][3.2] [![Mvc][nuget-img-mvc]][nuget-url-mvc] | ![.NET 4.5][net46Y] ![.NET Standard 2.0/2.1][core20Y] ![.NET 5.0 / 6.0 / 7.0 / 8.0][net8] 
| 7| 微信企业号 |Senparc.Weixin.QY.dll | [![QY][4.1]][4.2] [![QY][nuget-img-qy]][nuget-url-qy] | ![.NET 4.5][net46Y] ![.NET Standard 2.0/2.1][core20Y] ![.NET 5.0 / 6.0 / 7.0 / 8.0][net8] 
| 9| 企业微信 |Senparc.Weixin.Work.dll | [![Work][5.1]][5.2] [![Work][nuget-img-work]][nuget-url-work] | ![.NET 4.5][net46Y] ![.NET Standard 2.0/2.1][core20Y] ![.NET 5.0 / 6.0 / 7.0 / 8.0][net8] 
| 9| 微信开放平台 |Senparc.Weixin.Open.dll | [![Open][6.1]][6.2] [![Open][nuget-img-open]][nuget-url-open]| ![.NET 4.5][net46Y] ![.NET Standard 2.0/2.1][core20Y] ![.NET 5.0 / 6.0 / 7.0 / 8.0][net8] 
| 10| Redis 分布式缓存 |Senparc.Weixin.Cache. Redis.dll | [![Cache.Redis][7.1]][7.2] [![Redis][nuget-img-redis]][nuget-url-redis] | ![.NET 4.5][net46Y] ![.NET Standard 2.0/2.1][core20Y] ![.NET 5.0 / 6.0 / 7.0 / 8.0][net8] 
| 11| Memcached 分布式缓存 |Senparc.Weixin.Cache. Memcached.dll | [![Cache.Memcached][8.1]][8.2] [![MC][nuget-img-mc]][nuget-url-mc] | ![.NET 4.5][net46Y] ![.NET Standard 2.0/2.1][core20Y] ![.NET 5.0 / 6.0 / 7.0 / 8.0][net8] 
| 12| [WebSocket （独立项目）](https://github.com/JeffreySu/Senparc.WebSocket)   |Senparc.WebSocket.dll | [![Senparc.WebSocket][10.1]][10.2] [![WebSocket][nuget-img-ws]][nuget-url-ws] | ![.NET 4.5][net46Y] ![.NET Standard 2.0/2.1][core20Y] ![.NET 5.0 / 6.0 / 7.0 / 8.0][net8] 
| 13| All In One 集成库 |Senparc.Weixin.All.dll | [![Senparc.Weixin.All][14.1]][14.2] [![Senparc.Weixin.All][nuget-img-base]][nuget-url-base] | ![.NET 4.5][net46N] ![.NET Standard 2.0/2.1][core20Y] ![.NET 5.0 / 6.0 / 7.0 / 8.0][net8]

> 提示： 
> 1. 自 2019 年 5 月 1 日起，.NET Framework 3.5 及 4.0 停止更新，最后一个 .NET Framework 3.5 + 4.0 稳定版[点击这里](https://github.com/JeffreySu/WeiXinMPSDK/releases/tag/v16.6.15)。 
> 2. 自 2022 年 4 月 3 日起，.NET Framework 4.5 升级为 4.6.2，最后一个 .NET Framework 4.5 的稳定版[点击这里](https://github.com/JeffreySu/WeiXinMPSDK/releases/tag/v16.17.9)。 
> 3. 如果您还在使用 .NET Framework，建议您在 2027 年 1 月 12 日之间，将 .NET Framework 应用升级至 .NET Framework 4.8+，彼时官方将停止对 .NET Framework 4.6.2 的支持（[查看](https://learn.microsoft.com/en-us/lifecycle/products/microsoft-net-framework)）。 
> 4. 使用 `Senparc.Weixin.All` 集成库可一次性自动引用所有模块。
	
	
[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
[14.1]: https://img.shields.io/nuget/v/Senparc.Weixin.All.svg?style=flat
[14.2]: https://www.nuget.org/packages/Senparc.Weixin.All

[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

## 功能支持

* 已经支持大部分微信 8.x API，包括微信支付、自定义菜单/个性化菜单、模板信息接口、素材上传接口、群发接口、多客服接口、支付接口、微小店接口、卡券接口、发票接口等等。
* 已支持微信公众号、小程序、企业号、开放平台、微信支付等各个模块。
* 已经支持用户会话上下文（解决服务器无法使用 Session 处理用户信息的问题）。
* 已经全面支持微信公众号、小程序、企业号（企业微信）、微信支付V2/V3、开放平台的最新 API。
* 已经支持分布式缓存及缓存策略扩展（默认支持：本地缓存、Redis、Memcached，可自由扩展），开发过程无需关心所使用缓存的类型，可在配置文件或运行过程中自由切换。

> 1.目前官方的 API 都已完美集成，除非有特殊说明，所有升级都会尽量确保向下兼容，所以已经发布的版本请放心使用或直接升级（覆盖）最新的 dll，建议使用 [Nuget](https://www.nuget.org/) 进行更新。 
> 2. 您也可以自行修改并编译代码，打开 [Senparc.Weixin.Sample.Net6.sln](/Samples/All/net6-mvc/) 或 [Senparc.Weixin.Sample.Net8.sln](/Samples/All/net8-mvc/) 解决方案即可看到所有源码。当编译模式为 `Release` 时，将自动生成本地 Nuget 包（默认生成到 `/src/BuildOutPut/` 文件夹下）。

## 💾 源码项目文件夹说明（src文件夹下）

| 文件夹 | 说明 |
|--------|--------|
|[Senparc.WebSocket](src/Senparc.WebSocket/)|WebSocket 模块|
|[Senparc.Weixin.Cache](src/Senparc.Weixin.Cache)							|Senparc.Weixin.Cache.Memcached.dll 、 Senparc.Weixin.Cache.Redis.dll 等分布式缓存扩展方案|
|[Senparc.Weixin.AspNet](src/Senparc.Weixin.AspNet)							|Senparc.Weixin.AspNet.dll 专为 Web 提供支撑的类库|
|[Senparc.Weixin.MP.MvcExtension](src/Senparc.Weixin.MP.MvcExtension)		|Senparc.Weixin.MP.MvcExtension.dll源码，为 MVC 项目提供的扩展包 |
|[Senparc.Weixin.MP](src/Senparc.Weixin.MP)									|Senparc.Weixin.MP.dll 微信公众账号SDK源代码|
|[Senparc.Weixin.MP.Middleware](src/Senparc.Weixin.MP.Middleware) |Senparc.Weixin.MP.Middleware.dll 微信公众账号消息中间件源代码|
|[Senparc.Weixin.Open](src/Senparc.Weixin.Open)								|Senparc.Weixin.Open.dll 第三方开放平台SDK源代码|
|[Senparc.Weixin.TenPay](src/Senparc.Weixin.TenPay)							|Senparc.Weixin.TenPay.dll & Senparc.Weixin.TenPayV3.dll 包含微信支付 [V2](https://github.com/JeffreySu/WeiXinMPSDK/tree/Developer/src/Senparc.Weixin.TenPay/Senparc.Weixin.TenPay) 和 [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 企业微信SDK源代码|
|[Senparc.Weixin.Work.Middleware](src/Senparc.Weixin.Work.Middleware) |Senparc.Weixin.Work.Middleware.dll 企业微信消息中间件源代码|
|[Senparc.Weixin.WxOpen](src/Senparc.Weixin.WxOpen)							|Senparc.Weixin.WxOpen.dll 微信小程序SDK源代码，包括小游戏|
|[Senparc.Weixin.WxOpen.Middleware](src/Senparc.Weixin.WxOpen.Middleware) |Senparc.Weixin.WxOpen.Middleware.dll 微信小程序消息中间件源代码，包括小游戏|
|[Senparc.Weixin](src/Senparc.Weixin)										|所有Senparc.Weixin.[x].dll 基础类库源代码|
</details>

[进入文件夹](/src/)

## 🖥️ Samples 文件夹说明（Samples文件夹下）

Senparc.Weixin SDK 所有的模块的用法都保持了高度的一致，包括配置过程、AccessToken 管理、消息处理、服务消息、接口调用，等等。您只需参考任意一个模块的用法（推荐从`公众号`或`小程序`开始），就可以举一反三使用其他模块。

从以下 Sample 中您可以了解到每个独立模块的配置和使用方式，直接打开对应文件夹下的 `.sln` 解决方案即可查看对应源码，运行即可看到说明文档。其中 `All` 文件夹中包含了更多综合和进阶功能的演示。

| 文件夹 | 说明 | SDK 引用方式
|--------|--------|----|
|[MP](/Samples/MP/) | 公众号 | Nuget 包
|[TenPayV2](/Samples/TenPayV2/) | 微信支付 V1 和 V2 | Nuget 包
|[TenPayV3](/Samples/TenPayV3/) | 微信支付 V3（TenPay APIv3） | Nuget 包
|[Work](/Samples/Work/) | 企业微信 | Nuget 包
|[WxOpen](/Samples/WxOpen/) | 微信小程序 | Nuget 包
|[Shared](/Samples/Shared) | 所有 Sample 都需要用到的共享文件
|[All](/Samples/All/) | 包含微信公众号、小程序、微信支付、企业微信等所有功能的混合场景演示， 推荐用于集成多个平台的项目，或许要进行深度开发的场景参考（进阶） | 
| ┣ [All/console](/Samples/All/console)			|命令行 Console Demo（.NET Core）| Nuget 包
| ┣ [All/net45-mvc](/Samples/All/net45-mvc)						|可以直接发布使用的Demo（.NET Framework 4.5 + ASP.NET MVC）| Nuget 包
| ┣ [All/net6-mvc](/Samples/All/net6-mvc)			|可以直接发布使用的 Demo（.NET 6.0），兼容 .NET 5.0 和 .NET Core | 源码
| ┣ [All/net7-mvc](/Samples/All/net7-mvc)			|可以直接发布使用的 Demo（.NET 7.0），兼容 .NET 5.0、6.0 和 .NET Core | 源码
| ┗ [All/net8-mvc](/Samples/All/net8-mvc)			|可以直接发布使用的 Demo（.NET 8.0），兼容 .NET 5.0、6.0、7.0 和 .NET Core | 源码（最新）

[进入 Samples 文件夹](/Samples/)

<!-- ## 私人定制你的微信项目 Sample

Web 版：<a href="https://www.cnblogs.com/szw/p/WeChatSampleBuilder-V2.html#Web-WeChatSampleBuilder" target="_blank">查看教程</a>。

<!-- 
2. 桌面版：登录 <a href="https://weixin.senparc.com/User" target="_blank">https://weixin.senparc.com/User</a>下载 WeChatSampleBuilder 工具，并查看使用说明。

<img src="https://sdk.weixin.senparc.com/images/WeChatSampleBuilder-v0.2.0.png?t=1" width="700" alt="WeChatSampleBuilder" />
-->

## 🎨 资源

1. 官网地址：https://weixin.senparc.com/
2. 在线 Demo 地址（.NET 8.0，向下兼容 .NET 6.0、7.0 和 .NET Core）：https://sdk.weixin.senparc.com/
3. 微信开发系列教程：https://www.cnblogs.com/szw/p/weixin-course-index.html
4. 微信技术交流社区：https://weixin.senparc.com/QA
5. 自定义菜单在线编辑工具：https://sdk.weixin.senparc.com/Menu
6. 在线消息测试工具：https://sdk.weixin.senparc.com/SimulateTool
7. 缓存测试工具：https://sdk.weixin.senparc.com/Cache/Test
8. chm帮助文档下载：https://sdk.weixin.senparc.com/Document
9. 源代码及最新更新：https://github.com/JeffreySu/WeiXinMPSDK
10. 微信开发资源集合：https://github.com/JeffreySu/WeixinResource
11. 《微信开发深度解析》阅读辅助系统：https://book.weixin.senparc.com
12. 购买《微信开发深度解析》：[https://item.jd.com/12220004.html](https://book.weixin.senparc.com/book/link?code=github-homepage-resource)
13. 《微信公众号 + 小程序快速开发》视频教程：[https://github.com/JeffreySu/WechatVideoCourse](https://github.com/JeffreySu/WechatVideoCourse)

* 技术交流QQ群：

>1群（公众号）：300313885 
> 14群（视频课程学员群）：588231256 
> 10群（分布式缓存群）：246860933 
> 12群（微信小程序）：108830388 
> 16群（开放平台）：860626938 
> *`以下群已满：`* 
> `2群：293958349（已满），3群：342319110（已满）` 
> `4群：372212092（已满）， 5群：377815480（已满），6群：425898825（已满）` 
> `7群：482942254（已满），8群：106230270（已满），9群：539061281（已满）` 
> `11群：553198593（已满），13群：183424136（开放平台，已满），15群：289181996（已满）`

* 业务联系QQ：498977166

如果这个项目对您有用，我们欢迎各方任何形式的捐助，也包括参与到项目代码更新或意见反馈中来。谢谢！

资金捐助：[进入](http://sdk.weixin.senparc.com#donate)

## 📖 Senparc 官方图书教程

> 由 Jeffrey Su 和盛派团队耗时 2 年完成的微信开发图书已经出版，书名：《微信开发深度解析：公众号、小程序高效开发秘籍》，全书配套辅助阅读系统已经上线： [BookHelper](http://book.weixin.senparc.com)。 
> 欢迎购买正版图书：[【购买正版】](https://book.weixin.senparc.com/book/link?code=github-homepage) 
> 图书出版时的代码版本快照见分支 [BookVersion1](https://github.com/JeffreySu/WeiXinMPSDK/tree/BookVersion1)。

## 💻 Senparc 官方视频教程

> 为了帮助大家更直观地了解微信开发细节，同时结合《微信开发深度解析》图书进行学习，我们成立“盛派课堂”小组，开设了微信开发视频课程，帮助大家从多个维度学习微信开发以及 .NET 开发过程中的诸多技巧。 
> 视频包含两大部分： 
> 1. 微信开发基础技能 
> 2. 公众号及小程序案例实战 
> 
> 共计 60 课时，配有番外篇。 
> 目前视频已经在网易云课堂上线，课程制作精良、内容充实，被选为“A”级课程，[【观看视频】](https://book.weixin.senparc.com/book/videolinknetease?code=github-homepage)，[【查看课程代码及课件】](https://github.com/JeffreySu/WechatVideoCourse)。

## ✋ 贡献代码

> 如果需要使用或修改此项目的源代码，建议先Fork。也欢迎将您修改的通用版本Pull Request过来。

1. Fork
2. 创建您的特性分支 (`git checkout -b my-new-feature`)
3. 提交您的改动 (`git commit -am 'Added some feature'`)
4. 将您的修改记录提交到远程 `git` 仓库 (`git push origin my-new-feature`)
5. 然后到 github 网站的该 `git` 远程仓库的 `my-new-feature` 分支下发起 Pull Request
（请提交到 `Developer` 分支，不要直接提交到 `master` 分支）

<!--
### /Controllers/WeixinController.cs

下面的Token需要和微信公众平台后台设置的Token同步，如果经常更换建议写入Web.config等配置文件（实际使用过程中两列建议使用数字+英文大小写改写Token，Token一旦被破解，微信请求将很容易被伪造！）：
```C#
public readonly string Token = "weixin";
```
下面这个Action（Get）用于接收并返回微信后台Url的验证结果，无需改动。地址如：http://domain/Weixin 或 http://domain/Weixin/Index
```C#
/// <summary>
/// 微信后台验证地址（使用Get），微信后台的“接口配置信息”的Url填写如：http://weixin.senparc.com/weixin
/// </summary>
[HttpGet]
[ActionName("Index")]
public ActionResult Get(PostModel postModel, string echostr)
{
 if (CheckSignature.Check(postModel.Signature, postModel.Timestamp, postModel.Nonce, Token))
 {
 return Content(echostr); //返回随机字符串则表示验证通过
 }
 else
 {
 return Content("failed:" + postModel.Signature + "," 
 + MP.CheckSignature.GetSignature(postModel.Timestamp, postModel.Nonce, Token) + "。" +
 "如果你在浏览器中看到这句话，说明此地址可以被作为微信公众账号后台的Url，请注意保持Token一致。");
 }
}
```
上述方法中的PostModel是一个包括了了Signature、Timestamp、Nonce（由微信服务器通过请求时的Url参数传入），以及AppId、Token、EncodingAESKey等一系列内部敏感的信息（需要自行传入）的实体类，同时也会在后面用到。

下面这个Action（Post）用于接收来自微信服务器的Post请求（通常由用户发起），这里的if必不可少，之前的Get只提供微信后台保存Url时的验证，每次Post必须重新验证，否则很容易伪造请求。
```C#
/// <summary>
/// 用户发送消息后，微信平台自动Post一个请求到这里，并等待响应XML
/// </summary>
[HttpPost]
[ActionName("Index")]
public ActionResult Post(PostModel postModel)
{
 if (!CheckSignature.Check(postModel.Signature, postModel.Timestamp, postModel.Nonce, Token))
 {
 return Content("参数错误！");
 }
 ...
}
```

### 如何处理微信公众账号请求？

Senparc.Weixin.MP提供了2中处理请求的方式，[传统方法](https://github.com/JeffreySu/WeiXinMPSDK/wiki/处理微信信息的常规方法)及使用[MessageHandler](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)处理方法（推荐）。上面两个方法在wiki中已经有比较详细的说明，这里简单举例MessageHandler的处理方法。

MessageHandler的处理流程非常简单：
``` C#
[HttpPost]
[ActionName("Index")]
public ActionResult Post(PostModel postModel)
{
    if (!CheckSignature.Check(postModel.Signature, postModel.Timestamp, postModel.Nonce, Token))
    {
        return Content("参数错误！");
    }

postModel.Token = Token;
    postModel.EncodingAESKey = EncodingAESKey;//根据自己后台的设置保持一致
    postModel.AppId = AppId;//根据自己后台的设置保持一致

var messageHandler = new CustomMessageHandler(Request.InputStream, postModel);//接收消息（第一步）

messageHandler.Execute();//执行微信处理过程（第二步）

return new FixWeixinBugWeixinResult(messageHandler);//返回（第三步）
}
```
整个消息除了postModel的赋值以外，接收（第一步）、处理（第二步）、返回（第三步）分别只需要一行代码。

上述代码中的CustomMessageHandler是一个自定义的类，继承自Senparc.Weixin.MP.MessageHandler.cs。MessageHandler是一个抽象类，包含了执行各种不同请求类型的抽象方法（如文字，语音，位置、图片等等），我们只需要在自己创建的CustomMessageHandler中逐个实现这些方法就可以了。刚建好的CustomMessageHandler.cs如下：

```C#
using System;
using System.IO;
using Senparc.Weixin.MP.MessageHandlers;
using Senparc.Weixin.MP.Entities;

namespace Senparc.Weixin.MP.Sample.CustomerMessageHandler
{
 public class CustomMessageHandler : MessageHandler<MessageContext>
 {
 public public CustomMessageHandler(Stream inputStream, PostModel postModel, int maxRecordCount = 0)
 : base(inputStream, postModel, maxRecordCount)
 {

}

public override IResponseMessageBase DefaultResponseMessage(IRequestMessageBase requestMessage)
 {
 //ResponseMessageText也可以是News等其他类型
 var responseMessage = CreateResponseMessage<ResponseMessageText>();
 responseMessage.Content = "这条消息来自DefaultResponseMessage。";
 return responseMessage;
 }

public override IResponseMessageBase OnTextRequest(RequestMessageText requestMessage)
        {
            //...
        }

public override IResponseMessageBase OnVoiceRequest(RequestMessageVoice requestMessage)
        {
            //...
        }

//更多没有重写的OnXX方法，将默认返回DefaultResponseMessage中的结果。
        ....
    }
}
```

其中OnTextRequest、OnVoiceRequest等分别对应了接收文字、语音等不同的请求类型。

比如我们需要对文字类型请求做出回应，只需要完善OnTextRequest方法：
```C#
 public override IResponseMessageBase OnTextRequest(RequestMessageText requestMessage)
 {
 //TODO:这里的逻辑可以交给Service处理具体信息，参考OnLocationRequest方法或/Service/LocationSercice.cs
 var responseMessage = CreateResponseMessage<ResponseMessageText>();
 responseMessage.Content = string.Format("您刚才发送了文字信息：{0}", requestMessage.Content);
 return responseMessage;
 }
```
这样CustomMessageHandler在执行messageHandler.Execute()的时候，如果发现请求信息的类型是文本，会自动调用以上代码，并返回代码中的responseMessage作为返回信息。responseMessage可以是IResponseMessageBase接口下的任何类型（包括文字、新闻、多媒体等格式）。

从v0.4.0开始，MessageHandler增加了对用户会话上下文的支持，用于解决服务器上无法使用Session管理用户会话的缺陷。详见：[用户上下文WeixinContext和MessageContext](https://github.com/JeffreySu/WeiXinMPSDK/wiki/%E7%94%A8%E6%88%B7%E4%B8%8A%E4%B8%8B%E6%96%87WeixinContext%E5%92%8CMessageContext)

-->

## 👩‍🏫 如何使用 .NET Core 开发

> 当前分支包含了 .NET Framework 4.6.2+ 及 .NET 6.0/7.0/8.0 的全版本代码（已经不更新的版本请查看 [release](https://github.com/JeffreySu/WeiXinMPSDK/releases) 快照）。 
> 其中 .NET Framework 的 Demo 位于 `/src/Samples/All/net45-mvc` 目录下， 
> 【推荐】.NET 8.0（向下兼容 .NET 5.0、6.0、7.0 及 .NET Core 3.1 等更低版本） 的 Demo 位于 `/Samples/All/net8-mvc` 目录下。 
> 注意： 
> 1. 以上 Sample 中，`net8-mvc` 中的 Sample 直接引用了每个模块的源码，使用 `Release` 编译后可生成兼容不同版本的 Senaprc.Weixin SDK 库。 
> 2. 您也可以使用 .NET 6.0（向下兼容 .NET 5.0 及 .NET Core 3.1 等更低版本） 的 Demo 位于 `/Samples/All/net6-mvc` 目录下。

## ↕️ 使用Nuget安装到项目中

各个模块的 Nuget 安装方式：《[使用 Nuget 将 SDK 安装到项目中](https://github.com/JeffreySu/WeiXinMPSDK/wiki/%E4%BD%BF%E7%94%A8-Nuget-%E5%B0%86-SDK-%E5%AE%89%E8%A3%85%E5%88%B0%E9%A1%B9%E7%9B%AE%E4%B8%AD)》

## 🏬 如何部署

### 1) 部署到 Azure App Service

[App Service]( https://docs.microsoft.com/zh-cn/azure/app-service/azure-web-sites-web-hosting-plans-in-depth-overview ) 是 Microsoft Azure 推出的 Web 服务，对 .NET 有很好的支持。部署步骤详见：[《将微信站点部署到 Azure 中》](https://github.com/JeffreySu/WeiXinMPSDK/wiki/%E5%B0%86%E5%BE%AE%E4%BF%A1%E7%AB%99%E7%82%B9%E9%83%A8%E7%BD%B2%E5%88%B0-Azure-%E4%B8%AD)。

### 2) 部署到任意服务器的 FTP

在 Web 服务器上安装 FTP 服务（推荐 [FileZilla Server](https://filezilla-project.org/download.php?type=server)），直接使用 FTP 直接上传本地已经编译好的代码（本项项目 [Samples](https://github.com/JeffreySu/WeiXinMPSDK/tree/master/Samples) 中对应的是 [Senparc.Weixin.Sample.Net7](https://github.com/JeffreySu/WeiXinMPSDK/tree/Developer/Samples/net7-mvc)、[Senparc.Weixin.Sample.Net6](https://github.com/JeffreySu/WeiXinMPSDK/tree/Developer/Samples/net6-mvc) 或 [Senparc.Weixin.Sample.NetCore3](https://github.com/JeffreySu/WeiXinMPSDK/tree/Developer/Samples/netcore3.1-mvc)，编译后即可直接使用，无需修改代码）。如果使用 Azure App Service 或其他云服务，通常 FTP 也都是开通的。

<!--
已实现功能
-------------
* 微信公众号
> - [x] 接收/发送消息（事件）
> - [x] 自定义菜单 & 个性化菜单
> - [x] 消息管理
> - [x] OAuth授权
> - [x] JSSDK
> - [x] 微信支付
> - [x] 用户管理
> - [x] 素材管理
> - [x] 账号管理
> - [x] 带参数二维码
> - [x] 长链接转短链接接口
> - [x] 微信认证事件推送
> - [x] 数据统计
> - [x] 微信小店
> - [x] 微信卡券
> - [x] 卡券事件推送
> - [ ] 买单事件推送
> - [ ] 会员卡内容更新事件推送
> - [ ] 库存报警事件推送
> - [ ] 券点流水详情事件推送
> - [x] 微信门店
> - [x] 微信智能
> - [x] 微信设备功能
> - [x] 多客服功能
> - [x] 微信摇一摇周边
> - [x] 微信连WI-FI（未完整）
> - [x] 微信扫一扫（商家）
> - [ ] 扫一扫事件推送
> - [ ] 打开商品主页事件推送
> - [ ] 关注公众号事件推送
> - [ ] 进入公众号事件推送
> - [ ] 地理位置信息异步推送
> - [ ] 商品审核结果推送

* 微信开放平台
>   - [x] 网站应用
>   - [x] 公众号第三方平台

* 微信企业号
>	- [x] 管理通讯录
>	- [x] 管理素材文件
>	- [x] 管理企业号应用
>	- [x] 接收消息与事件
>	- [x] 发送消息
>	- [x] 自定义菜单
>	- [x] 身份验证接口
>	- [x] JSSDK
>	- [x] 第三方应用授权
>	    - [x] 第三方回调协议
>	        - [ ] 授权成功推送auth_code事件
>	        - [ ] 通讯录变更通知
> 	- [x] 企业号授权登陆
>	- [x] 企业号微信支付
>	- [x] 企业回话服务
>	    - [ ] 企业会话回调
>	- [x] 企业摇一摇周边
>	- [ ] 企业卡券服务
>	    - [ ] 卡券事件推送
>	- [x] 企业客服服务
>	    - [ ] 客服回复消息回调

* 缓存策略
>   - [x] 策略扩展接口
>   - [x] 本地缓存
>   - [x] Redis 扩展包
>   - [x] Memcached 扩展包

欢迎开发者对未完成或需要补充的模块进行 Pull Request！
-->

## 🍴 各重要分支说明

|  分支   |     说明         
|-----------|---------------
| master   | 正式发布的主分支，通常这个分支比较稳定，可以用于生产环境。
| Developer | 1、开发分支，此分支通常为 Beta 版本，新版本都会先在此分支中进行开发，最后推送稳定版到 master 分支，如果想对新功能先睹为快，可以使用此分支。 2、此分支同时兼容 .NET 4.5 / .NET Core / .NET Core 2.0 版本，建议 Pull Request 的代码都到这个分支下，而不是 master
| BookVersion1 | 此分支为[《微信开发深度解析：微信公众号、小程序高效开发秘籍》](https://book.weixin.senparc.com/book/link?code=github-homepage2)图书出版时对应代码快照。
| DotNET-Core_MySQL | 此分支为 .NET Core 环境下的 [Pomelo.EntityFrameworkCore.MySql](https://github.com/PomeloFoundation/Pomelo.EntityFrameworkCore.MySql) 框架集成演示分支。
| NET4.0     | 仅支持 .NET 4.0 的分支，此分支已于2017年停止更新。.NET 4.0 最新代码随 master / Developer 分支同步更新
| NET3.5     | 仅支持 .NET 3.5 的分支，此分支已于2015年停止更新。.NET 3.5 最新代码随 master / Developer 分支同步更新
| Developer-Senparc.SDK | 此分支仅用于 Senparc 团队内部测试，可忽略。

## 🍟 感谢贡献者

感谢为此项目做出贡献的开发者，你们不光完善了这个项目，也为中国开源事业出了一份力，感谢你们！名单[点击这里](https://github.com/JeffreySu/WeiXinMPSDK/blob/master/Contributors.md)查看。

## 💰 捐助

如果这个项目对您有用，我们欢迎各方任何形式的捐助，也包括参与到项目代码更新或意见反馈中来。谢谢！

资金捐助：

[![donate](http://sdk.weixin.senparc.com/Images/T1nAXdXb0jXXXXXXXX_s.png)](http://sdk.weixin.senparc.com#donate)

## ⭐ Star 数量统计

[![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

> 100% 开源，支持商用。

与猪共舞/WeiXinMPSDK

简介

发行版

贡献者

近期动态

与猪共舞/WeiXinMPSDK .gitee-modal { width: 500px !important; }

简介

发行版

贡献者

近期动态

搜索帮助

与猪共舞/WeiXinMPSDK