背景
MAUI的出现,赋予了广大Net开发者开发多平台应用的能力,MAUI 是Xamarin.Forms演变而来,但是相比Xamarin性能更好,可扩展性更强,结构更简单。但是MAUI对于平台相关的实现并不完整。所以MASA团队开展了一个实验性项目,意在对微软MAUI的补充和扩展
项目地址https://github.com/BlazorComp...
每个功能都有单独的demo演示项目,考虑到app安装文件体积(虽然MAUI已经集成裁剪功能,但是该功能对于代码本身有影响),届时每一个功能都会以单独的nuget包的形式提供,方便测试,现在项目才刚刚开始,但是相信很快就会有可以交付的内容啦。
前言
本系列文章面向移动开发小白,从零开始进行平台相关功能开发,演示如何参考平台的官方文档使用MAUI技术来开发相应功能。
介绍
App开发中难免不了要对接第三方平台,这些平台官网也提供了SDK供开发者使用。
对于Android和iOS平台而言,只需要下载官方的SDK,按照官方说明文档进行集成就可以轻松实现了。
但是对于MAUI来说,并没有官方的SDK,这个时候就需要我们绑定适用于.NET MAUI 的本机库。
本文主要介绍在MAUI中如何完成iOS绑定库,相比较Android绑定,iOS绑定会麻烦些,接下里让我们一步步在MAUI中实现iOS微信SDK的绑定。
*以下过程,均在macOS上操作
前置环境准备
- Xcode 13.4.1
- Visual Studio for mac 2022
- 安装Sharpie, Shapie 是一个非常好用的转换工具,它支持在 macOS 下对 Objective-C 的库的转换。通过 Sharpie 可以对库文件给出的头文件进行转换完成 C# 的绑定。
通过 Sharpie 工具生成 C# 调用的接口
下载微信iOS SDK,打开后里面有libWeChatSDK.a的静态库和三个头文件(.h)
我们需要将这几个.h文件转换为C#文件,这时候就需要用到Objective Sharpie工具
sharpie bind -output=WeChatSDK.IOS -namespace=WeChatSDK.IOS -sdk=iphoneos15.5 -scope [绝对路径]/OpenSDK1.9.6 [绝对路径]/OpenSDK1.9.6/*.h
这里需要注意指定-scope。
-scope如果没有参数,Objective Sharpie 将尝试为导入的任何 iOS SDK 标头生成绑定,例如#import
转换成功后,会在你指定的文件夹生成ApiDefinitions.cs和StructsAndEnums.cs,StructsAndEnums.cs 对应的是一些常量和枚举类型, ApiDefinitions.cs 对应的是一些接口和方法。
创建 MAUI 的 iOS 绑定项目
通过命令行创建MAUI的iOS绑定库
dotnet new iosbinding -o WeChatSDK.IOS
将生成的ApiDefinitions.cs和StructsAndEnums.cs替换掉项目对应内的文件并对.csproj调整
生成一下,发现报错了
看了文档之后,了解到Verify标注只是让我们确认转换是否正常,删除掉即可。删除verify后得到以下界面
这里忘记了添加对静态库libWeChatSDK.a文件的引用,添加下并根据微信文档对.csproj调整
Static
True
CFNetwork CoreTelephony Security SystemConfiguration
-ObjC -all_load -lstdc++ -lsqlite3.0 -lz
生成后发现还有报错
删除AutoGeneratedName,删除后显示生成成功
绑定成功后如何确定程序已经运行?让我们接着往下看
测试绑定库
创建一个MAUI Blazor 项目并给项目添加绑定库的引用
测试一下微信分享(这里只是演示 appid和Universal Links要换成你自己的)
WXApi.RegisterApp("wxd930ea5d5a258f4f","https://help.wechat.com/sdksample/");
SendMessageToWXReq req = new SendMessageToWXReq();
req.Text = "Hello,MASA!";
req.BText = true;
req.Scene = 1;
WXApi.SendReq(req,null);
根据微信文档,在Info.plist中增加对应配置
最后来看一下真机效果
踩坑记录
- 本人一开始用的Xcode 14,发现在Xcode14中无法真机调试,给官方提了issues,当时Xcode 14 对MAUI还没有很好的支持,根据官方的意见退回到了Xcode 13.4.1。
- 使用Sharpie要指定-scope,做MAUI的iOS微信SDK绑定前看了一些Xamarin ios绑定的文章,里面用Sharpie都没有指定scope,照着指令敲转换生成的入口文件带大量无法编译的错误,到不了Verify那一步,看了官网文档后才了解到需要指定scope。
- MAUI引用做好的iOS绑定库,发现代码智能感知失效了,但是可以成功构建项目,目前要解决绑定库智能感知的问题,我的做法是直接引用生成的程序集。
如果你对我们的开源项目感兴趣,无论是代码贡献、使用、提 Issue,欢迎联系我们
- WeChat:MasaStackTechOps
- QQ:7424099