Android实现微信分享功能

龙旋

共 4760字,需浏览 10分钟

 ·

2021-11-08 11:42

准备打算写一个专题关于一些第三方的SDK的使用,主要是因为有些三方SDK在开发时会碰到一些问题,所以打算记录下。接入功能基本都是挺方便的,主要就是会碰上一些坑。每次遇到新的坑都会抽时间重新更新文章

这里就先说说微信分享的功能。


一、接入微信分享SDK

1、sdk下载地址
https://open.weixin.qq.com/cgi-bin/showdocument?action=dir_list&t=resource/res_list&verify=1&lang=zh_CN
里面有SDK的文件和接入指南(如果实在看不懂,可以下载Demo来看)


2、接入
(1)、在Gradle中引用或者导入jar包

(2)、配置manifest


android:name="你的包名.wxapi.WXEntryActivity" android:label="@string/app_name" android:theme="@android:style/Theme.Translucent.NoTitleBar" android:exported="true" android:taskAffinity="你的包名" android:launchMode="singleTask">


WXEntryActivity这个类是主要用来接收微信回调的,如果接过微信的东西一般就会比较熟悉,比如微信分享、微信支付等等,都会要求你的工程加入这个类。


(3)、初始化SDK

IWXAPI wxAPI = WXAPIFactory.createWXAPI(context, appId, true);wxAPI.registerApp(appId);


appId就是在微信后台申请参数的时候生成的一个参数。

注意一下,无论你看文档还是Demo,当前版本给出测试用的appId是wx88888888,设置这个值得话会跳界面,不过会无法分享,这个问题在下面会详细说。

(4)、跳转微信分享

应用向微信发送请求是使用sendReq方法
wxAPI.sendReq(req);


至于怎么配置分享的参数,文档里把每种类型都说得很请求,Demo也有写。



这里就举个最简单的例子,分享一条消息到微信,点开后是打开一个连接,看官网文档的说明
//初始化一个WXWebpageObject,填写urlWXWebpageObject webpage = new WXWebpageObject();webpage.webpageUrl ="网页url";
//用 WXWebpageObject 对象初始化一个 WXMediaMessage 对象WXMediaMessage msg = new WXMediaMessage(webpage);msg.title ="网页标题 ";msg.description ="网页描述";Bitmap thumbBmp = BitmapFactory.decodeResource(getResources(), R.drawable.send_music_thumb);msg.thumbData =Util.bmpToByteArray(thumbBmp, true);
//构造一个ReqSendMessageToWX.Req req = new SendMessageToWX.Req();req.transaction = buildTransaction("webpage");req.message =msg;req.scene =mTargetScene;req.userOpenId = getOpenId();
//调用api接口,发送数据到微信api.sendReq(req);


    private String buildTransaction(final String type) {        return (type == null) ? String.valueOf(System.currentTimeMillis()) : type + System.currentTimeMillis();    }


其实就直接抄这段就行了,不过设置图片应该是这样
req.setThumbImage(bitmap);


再看看这个req.scene属性
// 分享到微信 req.scene = SendMessageToWX.Req.WXSceneSession;
// 分享到朋友圈req.scene = SendMessageToWX.Req.WXSceneTimeline ;


分享后差不多就是这样一个效果



还要说一个问题是,按照文档和demo的做法是这个图片的设置都是设置bitmap,都是本地的,那如果是给一个网上图片的url怎么办,我不知道有没有办法能直接设置(QQ分享是可以的),目前我的做法是根据url下载图片成bitmap格式再设置,如果有人知道能直接设置图片url,劳烦在评论指导一下。


(5)、接收微信的回调

接收分享的回调我感觉就是坑最多的。按照文档的Demo的写法,要在WXEntryActivity写回调逻辑(这一块建议直接可以看Demo中的WXEntryActivity类),我这里就写一个简单的吧
public class WXEntryActivity extends Activity implements IWXAPIEventHandler{
@Override protected void onCreate(@Nullable Bundle savedInstanceState) { super.onCreate(savedInstanceState); IWXAPI wxAPI = 获取到你之前初始化的IWXAPI ; if (wxAPI != null){ wxAPI.handleIntent(getIntent(), this); }else{ // callback是个假设,你可以用自己的办法把数据给回调 callback.result("分享失败"); } }
@Override public void onReq(BaseReq baseReq) {
}
@Override public void onResp(BaseResp baseResp) { // 返回结果 if (baseResp != null){ if (baseResp.errCode == BaseResp.ErrCode.ERR_OK){ callback.result( "分享成功"); }else { callback.result("分享失败,错误码:"+baseResp.errCode); } }else { callback.result("分享失败"); } finish(); }
@Override protected void onNewIntent(Intent intent) { super.onNewIntent(intent); IWXAPI wxAPI = 获取到你之前初始化的IWXAPI ; if (wxAPI != null){ wxAPI.handleIntent(getIntent(), this); } }
}


具体的逻辑具体处理,不过不建议在这里处理复杂的逻辑,可以把分享的结果先返回去,再自己的类中再做处理。

还有就是要记得写finish,这是一个Activity,不写finish的话你就无法和你的Activity交互。

可以看出分享的操作还是很简单的,按照文档和Demo来做基本没问题,我也是随便讲讲,好吧,其实就是凑凑字数。


二、接入微信分享SDK碰到的坑

1、跳转弹出页面提示失败


一般来说是参数的问题,比如我上面说的appId,如果你用测试的那个appId来测试的话,在现版本是跳转不了的,官方也有说明。




所以最好是用正式的参数去测(卧槽,为是什么QQ分享都可以微信却不行)
还有如果包名和签名对不上你在微信后台申请时填的,也是无法跳转的。

2、无法获取到分享的回调

这是一个比较坑的问题了,好像挺早前就有了,简单来说,问题是:微信分享之后,选择留在微信,再返回应用,接收不到回调。

是的,无论是Android还是IOS都是这样,似乎是微信这样特意去设计的,因为QQ是可以的,QQ分享选择留在QQ,返回之后也是有回调的。

当前版本分享到朋友圈不会有这个选择,所以可以只对分享到微信做处理,那么官方没有处理的办法怎么办?我们只能自己写逻辑去处理了。


先测下一下各种情况下的生命周期情况(可能不同的版本流程不同)

(1)分享直接错误,没有跳转微信的情况:
send -> onPause -> WXEntryActivity -> onResume

(2)分享时弹出同一个页面提示分享错误:
send -> onPause -> (点击确认之后)onResume
是的,这种情况是不走WXEntryActivity 的

(3)分享跳转到微信,然后直接物理返回应用:
send -> onPause -> onStop -> 在微信返回 -> onStart -> WXEntryActivity  -> onResume
这种情况下微信给的回调是分享成功

(4)分享跳转到微信,然后切进程返回(只要是切进程返回都是这种情况):
send -> onPause -> onStop -> 在微信切进程 -> onStart -> onResume
可以看出这种情况也不会调用WXEntryActivity

(5)分享成功后选择返回应用:
send -> onPause -> onStop -> 分享成功后选返回应用 -> onStart -> WXEntryActivity  -> onResume

(6)分享成功后选择留在微信:
send -> onPause -> onStop -> 分享成功后选留在微信 -> onStart -> onResume -> onPause -> onStop -> 再手动返回应用 -> onStart  -> onResume
不知道为什么会调两次生命周期

(7)分享到朋友圈:
send -> onPause -> onStop -> 确认分享朋友圈  -> onStart -> onResume -> onPause -> WXEntryActivity -> onResume
不知道为什么这个生命周期也是很乱


可以看出如果要做的话,我们可以选择只要跳转到微信就分享成功,因为默认就算你跳到微信不分享,他们给的回调也是成功的回调。

从上面的所有情况的生命周期观察,我的做法是判断send方法之后有调用onStop 生命周期就表示跳转微信的情况。

我是自己定义一个状态state去判断分享的结果,onResume的时候返回分享的结果,send之前state为0,默认设置结果为分享失败,send+onStop 之后设置结果为分享成功,WXEntryActivity  之后再把结果覆盖之前的变量,然后onResume返回。



就算中间某步的方法没调用也没关系,最终都会有返回值,不过这样的做法也会有问题,如果onResume没调用,那就无法接收到回调了。


到这里就结束啦。
浏览 59
点赞
评论
收藏
分享

手机扫一扫分享

分享
举报
评论
图片
表情
推荐
点赞
评论
收藏
分享

手机扫一扫分享

分享
举报