Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Developer #2734

Merged
merged 9 commits into from
Nov 14, 2022
Merged

Developer #2734

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
9 commits
Select commit Hold shift + click to select a range
a2db818
Update readme.md
JeffreySu Nov 14, 2022
c7c1136
Update readme.md
JeffreySu Nov 14, 2022
235e2e9
Update readme.md
JeffreySu Nov 14, 2022
d95b512
Update readme.md
JeffreySu Nov 14, 2022
c8712a1
Update readme.md
JeffreySu Nov 14, 2022
e4acfe5
Update readme.md
JeffreySu Nov 14, 2022
ee8c476
Update readme.md
JeffreySu Nov 14, 2022
a281090
Update readme.md
JeffreySu Nov 14, 2022
cf7244f
Update readme.md
JeffreySu Nov 14, 2022
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 4 additions & 3 deletions Samples/All/Senparc.Weixin.Sample.CommonService/readme.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,7 @@

| 文件名 | 说明
|--------|-------
| Senparc.Weixin.MP.Sample.CommonService.csproj | .NET 4.5 项目
| Senparc.Weixin.MP.CoreSample.CommonService.csproj | .NET Core 2.2 项目
| Senparc.Weixin.NetCore3Sample.CommonService.csproj | .NET Core 3.0 项目
| Senparc.Weixin.MP.Sample.CommonService.csproj | .NET 4.6.2 项目
| Senparc.Weixin.NetCore3Sample.CommonService.csproj | .NET Core 3.0 项目
| Senparc.Weixin.Net6Sample.CommonService.csproj | .NET 6.0 项目
| Senparc.Weixin.Net7Sample.CommonService.csproj | .NET 7.0 项目
2 changes: 1 addition & 1 deletion Samples/All/net45-mvc/readme.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,4 +14,4 @@

## .NET Core 及所有版本 Demo

返回上一级后见目录：[Senparc.Weixin.Sample.Net6.sln](../net6-mvc/) (.NET 6 版本，加载完整源码，推荐)。
返回上一级后见目录：[Senparc.Weixin.Sample.Net7.sln](../net7-mvc/) (.NET 7 版本，加载完整源码，推荐)、[Senparc.Weixin.Sample.Net6.sln](../net6-mvc/) (.NET 6 版本，加载完整源码)。
5 changes: 5 additions & 0 deletions Samples/All/net6-mvc/readme.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,11 @@
> 提示：由于源码中采用了条件编译，因此默认情况下，需要开发环境同时安装 `.NET Framework 4.6.2`、'.NET 6.0' 才能编译成功！<br>
> 如果您只希望编译 .NET Core 3.1，请将各个 .csproj 文件中的编译版本条件做对应的修改。


## 使用 .NET 7.0 Demo

返回上一级后见：[net7-mvc/Senparc.Weixin.Sample.Net7](../net7-mvc)。

## 使用 .NET Framework 4.5 Demo

返回上一级后见：[net45-mvc/Senparc.Weixin.MP.Sample](../net45-mvc)。
Expand Down
12 changes: 8 additions & 4 deletions Samples/All/net7-mvc/readme.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,16 +1,20 @@
# Senparc.Weixin.Sample.Net6 项目说明
# Senparc.Weixin.Sample.Net7 项目说明

> 推荐您使用当前 Sample（[在线示例](https://sdk.weixin.senparc.com/)）。<br>
> 如果您使用的是 Visual Studio，
请升级到 VS 2022（或将来更新版本），并安装 [.NET 6.0 SDK](https://docs.microsoft.com/zh-cn/aspnet/core/getting-started/?view=aspnetcore-6.0&WT.mc_id=DT-MVP-5002965&tabs=windows)。
请升级到 VS 2022（或将来更新版本），并安装 [.NET 7.0 SDK](https://docs.microsoft.com/zh-cn/aspnet/core/getting-started/?view=aspnetcore-7.0&WT.mc_id=DT-MVP-5002965&tabs=windows)。

当前 Sample 提供了 .NET 6.0 的 Mvc 项目示例，可以直接进行部署测试（高级功能测试需要修改配置文件，如修改 appId 等）。
当前 Sample 提供了 .NET 7.0 的 Mvc 项目示例，可以直接进行部署测试（高级功能测试需要修改配置文件，如修改 appId 等）。

当前 Sample 也可用于调试 Senparc.Weixin SDK，支持 .NET 4.6.2+、.NET Standard 2.1+、.NET 6.0 的不同版本库编译，并可在 Release 编译条件下生成 nuget 包。

> 提示：由于源码中采用了条件编译，因此默认情况下，需要开发环境同时安装 `.NET Framework 4.6.2`、'.NET 6.0' 才能编译成功！<br>
> 提示：由于 `/src` 目录下的源码中采用了条件编译，因此默认情况下，需要开发环境同时安装 `.NET Framework 4.6.2`、`.NET 6.0`、`.NET 7.0`才能编译成功！<br>
> 如果您只希望编译 .NET Core 3.1，请将各个 .csproj 文件中的编译版本条件做对应的修改。

## 使用 .NET 6.0 Demo

返回上一级后见：[net6-mvc/Senparc.Weixin.Sample.Net6](../net6-mvc)。

## 使用 .NET Framework 4.5 Demo

返回上一级后见：[net45-mvc/Senparc.Weixin.MP.Sample](../net45-mvc)。
Expand Down
5 changes: 4 additions & 1 deletion Samples/All/readme.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,10 +6,13 @@

| 文件夹 | 说明 |
|--------|--------|
| net7-mvc | 【推荐】.NET 7.0 示例，可用于直接部署（由于 .NET 7.0 刚发布不久，2023 年 2 月之前暂不建议用于生产环境！）
| net6-mvc | 【推荐】.NET 6.0 示例，可用于直接部署
| console | 命令行注册过程演示 Demo（接口调可参考 Web 项目）
| net45-mvc | 【停止更新】ASP.NET 4.5 MVC 示例，可用于直接部署，此项目中包含了 CommonServices 项目，供其他各 Sample 公用
| Senparc.Weixin.Sample.CommonService | 所有 Sample 中共享的公共代码库（仅为 Sample 服务，和 SDK 源码无关）
| Senparc.Weixin.Sample.Shared | 所有 Sample 中共享的 wwwroot 等静态文件资源（仅为 Sample 服务，和 SDK 源码无关）


> 注意： net45-mvc Sample 自 2022 年 5 月 4 日起，升级为 .NET Framework 4.6.2，并将一直支持到微软官方停止对该版本的支持，其后升级到 .NET Framework 4.8。为了方便交流，暂时保留 `net45` 这个名字，用以代表 .NET Framework Sample。

Expand All @@ -19,7 +22,7 @@

## 帮你选择

> 如果你希望学习并使用最新的 .NET 6.0 框架，并且已经安装了 VS2022（v16.9 以上），并且希望调试 .NET 6.0 及以上版本，那么请打开：net6-mvc/Senparc.Weixin.Sample.Net6.sln 解决方案
> 如果你希望学习并使用最新的 .NET 6.0（或7.0） 框架，并且已经安装了 VS2022（v16.9 以上），并且希望调试 .NET 6.0 及以上版本，那么请打开：net6-mvc/Senparc.Weixin.Sample.Net6.sln （或 net7-mvc/Senparc.Weixin.Sample.Net7.sln）解决方案

> 如果你希望将 Senparc.Weixin SDK 用于命令行或桌面应用，那么请打开：console/Senparc.Weixin.MP.Sample.Consoles.vs2019.sln 解决方案

Expand Down
19 changes: 11 additions & 8 deletions readme.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -195,7 +195,7 @@ app.UseMessageHandlerForMp("/WeixinAsync",
#### 图例
| ![.NET 4.6][net46Y] | ![.NET Standard 2.x][core20Y] | ![.NET Core][netcore] | ![.NET 5.0 / 6.0][net6]
|--|--|--|--|
| .NET Framework 4.6.2 | .NET Standard 2.0 / 2.1 | .NET Core 2.x / 3.x | .NET 5.0 / .NET 6.0
| .NET Framework 4.6.2 | .NET Standard 2.0 / 2.1 | .NET Core 2.x / 3.x | .NET 5.0 / .NET 6.0 / .NET 7.0

> 提示：<br>
> 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)。<br>
Expand Down Expand Up @@ -275,7 +275,7 @@ app.UseMessageHandlerForMp("/WeixinAsync",
* 已经支持分布式缓存及缓存策略扩展（默认支持：本地缓存、Redis、Memcached，可自由扩展），开发过程无需关心所使用缓存的类型，可在配置文件或运行过程中自由切换。

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

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

Expand Down Expand Up @@ -319,9 +319,10 @@ Senparc.Weixin SDK 所有的模块的用法都保持了高度的一致，包括
|[All](/Samples/All/) | 包含微信公众号、小程序、微信支付、企业微信等所有功能的混合场景演示，<br>推荐用于集成多个平台的项目，或许要进行深度开发的场景参考（进阶） |
| ┣ [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 | <strong>源码<strong>
| ┣ [All/net6-mvc](/Samples/All/net6-mvc) |可以直接发布使用的 Demo（.NET 6.0），兼容 .NET 5.0 和 .NET Core | <strong>源码<strong>
| ┗ [All/net7-mvc](/Samples/All/net7-mvc) |可以直接发布使用的 Demo（.NET 7.0），兼容 .NET 5.0、6.0 和 .NET Core | <strong>源码<strong>

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


<!-- ## 私人定制你的微信项目 Sample
Expand All @@ -341,7 +342,7 @@ Web 版：<a href="https://www.cnblogs.com/szw/p/WeChatSampleBuilder-V2.html#Web
## 资源

1. 官网地址：https://weixin.senparc.com/
2. 在线 Demo 地址：https://sdk.weixin.senparc.com/
2. 在线 Demo 地址（.NET 7.0，向下兼容 .NET 6.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
Expand Down Expand Up @@ -554,8 +555,10 @@ namespace Senparc.Weixin.MP.Sample.CustomerMessageHandler

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

## 使用Nuget安装到项目中

Expand All @@ -569,7 +572,7 @@ namespace Senparc.Weixin.MP.Sample.CustomerMessageHandler

### 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.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 也都是开通的。
在 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 也都是开通的。


<!--
Expand Down