记在为Xamarin.Android项目接入Huawei HMS的检测更新接口时遇到的坑
事情是这样的,前期我将岁寒输入法上传到了华为应用市场,最近我进行版本更新时审核不过,原因如下:
审核要求我接入华为的检测更新接口,简单的说就是在用户进入应用时检测一下应用市场是否有更新的版本,如果有的话就提示用户。
接入一个接口而已,想来应该也不难,不料竟是一个大坑。
如果我所使用的是原生技术栈的话,确实是一件很简单的事情。这里是官方文档:联运应用开发文档。
官方认为的接入耗时大约也就半个小时,而在Xamarin.Android下我前后花了好几天,总工时至少在5个小时以上。原因是官方既没有给出Xamarin.Android下接入联运应用接口的帮助文档,也没有提供Xamarin.Android下接入联运应用接口所必须的依赖库。实际上,我所花费的大部分时间都用在了确认以上事实。
就没有帮助文档这一情况倒是好办。一般而言,仿照原生技术的代码改写一下就OK了。但问题卡在了依赖库上,接入联运应用接口要求添加com.huawei.hms:appservice
依赖。
但是我翻遍了华为的官方文档和Nuget官网,也没有找到与appservice
相关的依赖(也就是说华为官方没有提供Xamarin.Android相应的封装库),而我甚至连appservice
的arr或jar都找不到下载页面。
我倒是找到了游戏联运的需要的依赖库下载页面。
这个页面里的依赖除了gameservicesdk
之外,其它依赖与应用联运接入是一样的,但是gameservicesdk
是用于游戏应用的,而我岁寒输入法并不是游戏应用,使用这个依赖库可能导致审核还是过不了。
但我实在是找不着appservice
的下载链接怎么办呢?
最后我下载了官方提供的联运应用示例工程,并将工程里的appservice
版本更新到最新的版本后执行gradle的同步操作,然后前往gradle的本地仓库(在我的主机上路径是/Users/用户/.gradle/caches/modules-2/files-2.1
),终于拿到了appservice
的aar文件:
拿到这个aar文件之后,我就可以创建Xamarin.Android的绑定库了,这里过程略,具体参考微软的官方文档:Binding a Java Library
除了引用这个绑定库之外,项目还需要引用其它相关的依赖。其它的依赖库nuget上倒是大部分都有。
但还是差了一个apptouch没有找到。这个好办,也给它创建了一个绑定库就好了:
现在“龙珠”凑齐了,开始“许愿”吧。仿照原生技术文档,将其改写成Xamarin.Android的调用方式。 如果事情到这里就结束了,那我这篇文章岂不是太水了!肯定还有问题嘛。
改写代码后,代码出现了几处错误。 另一个是提示找不到ApkUpgradeInfo类:
另一个是提示找不到IAppUpdateClient下的CheckAppUpdate和ShowUpdateDialog方法:
我们先来看第一个问题,为什么会找不到ApkUpgradeInfo类? 根据华为官方文档,ApkUpgradeInfo类应该属于Huawei.Hms.update依赖库。
但是,这里我确实添加了对Huawei.Hms.update的引用。
为了确认ApkUpgradeInfo类是否属于Huawei.Hms.update库,我通过在华为开源到GitHub上的源代码项目找出Huawei.Hms.update的aar文件,并掏出了反编译查看工具-Java Decompiler(JD-GUI)。 利用JD-GUI,我在Huawei.Hms.update的aar文件中找到ApkUpgradeInfo类:
既然ApkUpgradeInfo类确实存在于Huawei.Hms.update库中,我也确实引用了Huawei.Hms.update库,那为什么在Xamarin.Android里还是看不见ApkUpgradeInfo类呢?看来应该是在生成绑定的过程中出了什么问题。 我们查看一下微软官方对绑定中可能导致类型丢失的解释
再看一眼ApkUpgradeInfo类的反编译结果,发现其继承自一个被混淆的类型b,符合微软官方文档中提到的最后一种情形:
看一下这个b类的情况:
所以,难道华为官方提供的Huawei.Hms.update库没有针对这个情况进行处理?为了验证这一点,我自行创建了一个Huawei.Hms.update的绑定库:
并根据微软官方文档,在这个绑定库的Metadata.xml文件中添加如下代码:
<attr path="/api/package[@name='com.huawei.updatesdk.a.b.c.c']/class[@name='b']" name="obfuscated">false</attr>
引用这个新的绑定库之后,找不到ApkUpgradeInfo类的提示消失了。看来华为官方确实没有对此情况进行处理,回头我就到Github上给他们了提交一个补丁,所以可能当你看到本文时,问题已经修复了。鉴于我没有时间等官方发布新版本,现在我需要用自己的绑定库替代官方的绑定库,因此要令自己的绑定库与官方的绑定库一致,才能与其它的官方的绑定库保持兼容。
查看nuget上Huawei.Hms.update的情况:
可知Huawei.Hms.update对另外三个库有依赖,因此这里需要把它们添加到我自己创建的绑定库的引用中:
此外还是关注版本的问题,这在下载aar文件的时候就要注意。
下面,我们来看看提示找不到IAppUpdateClient下的CheckAppUpdate和ShowUpdateDialog方法的问题。
先查看一下IAppUpdateClient在绑定库中的代码:
这里还是使用JD-GUI查看appservice的aar文件,找到与IAppUpdateClient对的接口类AppUpdateClient:
可以看到,在绑定过程中IAppUpdateClient丢失checkAppUpdate和showUpdateDialog方法。其中checkAppUpdate方法使用了CheckUpdateCallBack接口,而showUpdateDialog方法使用了ApkUpgradeInfo类型。而这两个类型都自来于Huawei.Hms.update库,符合微软官方文档提供的第一种情形。解决办法是在appservice绑定库工程中添加对Huawei.Hms.update绑定库的引用。
重新编译后,找不到IAppUpdateClient下的CheckAppUpdate和ShowUpdateDialog方法的提示消失。
最后处理一下主工程中检测接口所依赖的其它绑定库的引用。
至此,检测接口的接入完成,文章最后给出改写成Xamarin.Android形式的代码供大家参考:
public void checkUpdate() {
IAppUpdateClient client = JosApps.GetAppUpdateClient(this);
client.CheckAppUpdate(this, new HuaweiCheckUpdateCallBack(this));
}
using System;
using Android.Content;
using Android.Util;
using Com.Huawei.Hms.Jos;
using Com.Huawei.Updatesdk.Service.Appmgr.Bean;
using Com.Huawei.Updatesdk.Service.Otaupdate;
namespace MyNameSpace {
public class HuaweiCheckUpdateCallBack : Java.Lang.Object, ICheckUpdateCallBack {
private WeakReference<Context> mContextWeakReference;
private const string TAG = "HuaweiCheckUpdateCallBack";
public HuaweiCheckUpdateCallBack(Context context) {
mContextWeakReference = new WeakReference<Context>(context);
}
public void OnUpdateInfo(Intent intent) {
if (intent != null) {
// 更新状态信息
int status = intent.GetIntExtra(UpdateKey.Status, -99);
Log.Info(TAG, "check update status is:" + status);
// 返回错误码
int rtnCode = intent.GetIntExtra(UpdateKey.FailCode, -99);
// 返回失败信息
String rtnMessage = intent.GetStringExtra(UpdateKey.FailReason);
// 强制更新应用时,弹出对话框后用户是否点击“退出应用”按钮
bool isExit = intent.GetBooleanExtra(UpdateKey.MustUpdate, false);
Log.Info(TAG, "rtnCode = " + rtnCode + "rtnMessage = " + rtnMessage);
var info = intent.GetSerializableExtra(UpdateKey.Info);
// 如果info属于ApkUpgradeInfo类型,则拉起更新弹框
if (info is ApkUpgradeInfo) {
Context context;
if (!mContextWeakReference.TryGetTarget(out context)) return;
if (context != null) {
// showUpdateDialog接口中最后一个字段传入不同取值会带来不同的用户体验,具体请参考本文档的场景描述,此处以false为例
JosApps.GetAppUpdateClient(context).ShowUpdateDialog(context, (ApkUpgradeInfo)info, false);
}
Log.Info(TAG, "check update success and there is a new update");
}
Log.Info(TAG, "check update isExit=" + isExit);
if (isExit) {
// 是强制更新应用,用户在弹出的升级提示框中选择了“退出应用”,处理逻辑由您自行控制,这里只是个例子
//不强制更新,故什么也不做
}
}
}
public void OnMarketInstallInfo(Intent p0) {
}
public void OnMarketStoreError(int p0) {
}
public void OnUpdateStoreError(int p0) {
}
}
}
接入过程中的其它细节请参考华为官方文档。
感谢阅读,希望本文能对你有所帮助。
参考文档
- 原文作者:岁寒
- 原文链接:http://www.suihanime.com/post/Xamarin/%E8%AE%B0%E5%9C%A8%E4%B8%BAXamarin.Android%E9%A1%B9%E7%9B%AE%E6%8E%A5%E5%85%A5Huawei-HMS%E7%9A%84%E6%A3%80%E6%B5%8B%E6%9B%B4%E6%96%B0%E6%8E%A5%E5%8F%A3%E6%97%B6%E9%81%87%E5%88%B0%E7%9A%84%E5%9D%91/
- 版权声明:本作品采用知识共享署名-非商业性使用-禁止演绎 4.0 国际许可协议进行许可,非商业转载请注明出处(作者,原文链接),商业转载请联系作者获得授权。