公司项目需要对接微信分享,本来之前准备对接友盟分享的,但友盟的分享实际参数太多,而我又只需要对接一个微信分享,于是便是选择总结对接官方的
顺便把微信SDK的APPID申请的流程也一起记录了
步骤
1.注册获得APPID
前往微信公众平台,使用企业认证的开发者账号进行登录,提交应用包名和签名指纹文件,可以生成一个appId,有了此appId账号才能有侯勋的操作
通过输入命令可查看签名文件的md5等信息:
keytool -list -v -keystore qj_test.keystore
注意:上述输完命令后需要输入密码,密码不会显示出来,密码正确则会出现下面的相关md5等信息了
微信平台比较坑的就是,它要求输入不要带:
号,且还要小写的md5数值,我们稍微处理一下:我比较懒,就写了几行代码处理了,代码如下:
//改为你的md5即可
String md5 = "73:95:50:FB:F9:A9:A6:A3:F2:74:E0:25:64:EB:E7:48";
String result = md5.replaceAll(":", "").toLowerCase();
System.out.println(result);
输出结果复制一下,就得到了符合规范的md5了
2.添加依赖
implementation 'com.tencent.mm.opensdk:wechat-sdk-android:6.8.0'
官方文档提供的写法是不固定版本号的,我这里觉得还是固定版本号比较好,需要依赖中央仓库即可
3.初始化启动分享
// APP_ID 替换为你的应用从官方网站申请到的合法appID
private static final String APP_ID = "wx88888888";
// IWXAPI 是第三方 app 和微信通信的 openApi 接口
private IWXAPI api;
private void regToWx(Context context) {
// 通过 WXAPIFactory 工厂,获取 IWXAPI 的实例
api = WXAPIFactory.createWXAPI(context, APP_ID, true);
// 将应用的 appId 注册到微信
api.registerApp(APP_ID);
//建议动态监听微信启动广播进行注册到微信
context.registerReceiver(new BroadcastReceiver() {
@Override
public void onReceive(Context context, Intent intent) {
// 将该 app 注册到微信
api.registerApp(APP_ID);
}
}, new IntentFilter(ConstantsAPI.ACTION_REFRESH_WXAPP));
}
之后在分享的Activity或Application中进行初始化,调用regToWx()
,如
regToWx(MainActivity.this)
PS: 这里可以看下下面提到的工具类封装
4.使用微信分享
经过上面的步骤,我们已经能够使用微信分享了,使用IWXAPI那个对象即可,具体可以查看文档WXMediaMessage (微信媒体消息内容)说明 | 微信开放文档
api.sendReq(req);
不过需要注意一下Android11的适配,需要在AndroidManifest.xml
声明
<queries>
<!-- 指定微信包名-->
<package android:name="com.tencent.mm" />
</queries>
这里我是封装了一个工具类,源码在下一章节,主要封装了分享文本,图片,视频和网页链接,至于分享小程序和分享音乐文件没有需求,就暂时没有对接,各位可以参考的完善即可
这里顺便补充一下,由于我自己个人没法成功申请到微信应用平台的APPID,于是我就是使用了另外项目的的APPID来进行测试
测试的发现,只要你使用同个签名文件,同时,把build.gradle里面的applicationId改成填写的包名,微信分享就是能够正常的使用
举个例子,我们有一个应用包名为com.starsone.test
的应用已经申请到了APPID
这个时候,我们另外个项目,包名与其不同,但我们想要测试一下分享功能,可以进行以下的操作:
修改app模块里的build.gradle,将applicationId改为com.starsone.test
包名,并使用相同的签名文件打包即可使用同个APPID测试分享功能了,如下图所示:
这里如果使用分享视频或分享网页链接,在微信中会以消息卡片的形式展示,如下图所示:
5.添加回调
如果项目中需要对分享成功或失败进行监听,来进行进一步的逻辑处理,可以按照微信官方的文档添加一个WxEntryActivity实现
由于我开发的项目暂时无需,所以没怎么研究,这里稍微简单的补充一下:
我们需要创建一个WXEntryActivity
作为回调的接收,WXEntryActivity
没有页面,主要实现微信的回调接口IWXAPIEventHandler
即可,代码如下:
public class WXEntryActivity extends Activity implements IWXAPIEventHandler {
@Override
public void onReq(BaseReq baseReq) {
}
@Override
public void onResp(BaseResp baseResp) {
}
}
<activity
android:name=".wxapi.WXEntryActivity"
android:exported="true"
android:launchMode="singleTask"
android:taskAffinity="com.tyky.share"
android:theme="@android:style/Theme.Translucent.NoTitleBar"/>
这里,注意,Activity是要处于你当前包名下的wxapi文件夹,如我自己的例子,当前包名是com.tyky.share
,也是我在新建一层wxapi包名,并将Activity放在里面,如下图所示
这里由于我没有用到,所以就没有在方法里补充对应的逻辑了
逻辑解释如下:
通过
api.sendReq(req)
分享内容,发送的请求会将回调一次onReq()
方法,之后微信分享完成(成功或取消)之后,会将响应结果将回调到onResp()
方法
工具类封装
工具类用到了以下两个依赖,记得先导入
implementation 'org.apache.commons:commons-lang3:3.9'
/