轻量级开源小程序SDK发车啦
Magicodes.WxMiniProgram.Sdk
轻量级微信小程序SDK,支持.NET Framework以及.NET Core。目前已提供Abp模块的封装,支持开箱即用。
Nuget
新的包
主要功能
轻量级微信小程序SDK,以便于简单方便的实现小程序服务端API的调用。具体见单元测试。
RoadMap
- 完善接口
- 登录
- 用户信息
- 接口调用凭证
- 数据分析
- 客服消息
- 模板消息
- 统一服务消息
- 动态消息
- 插件管理
- 附近的小程序
- 小程序码
- 内容安全
- 广告
- 图像处理
- OCR
- 运维中心
- 搜索
- 生物认证
- 订阅消息
- AccessToken自动传参,无需显式指定
- 方法参数改成类参数,并且支持通过特性校验
更新历史
0.0.5
- 重构AccessToken管理
- 添加对分布式架构支持(使用分布式缓存)
- 重构Http请求模块,移除HttpClient
- 添加获取二维码接口(Create、Get、GetUnlimited),详见单元测试
开始使用
如果使用Abp相关模块,则使用起来比较简单,具体您可以参考相关单元测试的编写。主要有以下步骤:
- 引用对应的Abp的Nuget包
如果仅需某个支付,仅需引用该支付的包。下面以通联支付为例,我们需要在工程中引用此包:
- 添加模块依赖
在对应工程的Abp的模块(AbpModule)中,添加对“WxMiniProgramSdkModule”的依赖,如:
[DependsOn(typeof(WxMiniProgramSdkModule))]
- 直接使用
通过构造函数或者属性注入相关服务,即可直接使用。
如何配置?
对于ABP集成,则可以通过以下方式获取配置:
- 配置文件,如:
"App_MiniProgram": { "MiniProgramAppId": "wx25fa5d55ef27e086", "MiniProgramAppSecret": "ab02ac4499c9764108a78e19476d7101" }
以上为个人小程序号配置,仅用于测试,请勿乱搞!
- 配置管理器
需存储JSON对象,对应的key为“App_MiniProgram”。
对于非ABP集成,则需要自己实例化或注入配置类对象,可以参考单元测试的编写。
非ABP集成
请参考Abp相关模块的封装或者相关的单元测试代码,目前“Test”工程对应非ABP集成方式的使用,“Abp.Test”工程对应集成ABP之后的使用。
分布式缓存配置
为了支持分布式架构,已引入IDistributedCache来支持分布式缓存,在开发测试或单主机服务中,需使用以下代码进行注入:
services.AddDistributedMemoryCache();
如需使用Redis,请参考下面代码:
services.AddDistributedRedisCache(options => { options.Configuration = "localhost"; options.InstanceName = "SampleInstance"; });