Android应用接入微信分享，以及遇到的坑

- 日理万妓 2022-02-22 15:38 1473阅读 0赞

本文转载自lc\_miao的博客：[https://blog.csdn.net/lc\_miao/article/details/79855687][https_blog.csdn.net_lc_miao_article_details_79855687]

**目录**

一、申请应用

二、配置微信分享的SDK

三、微信分享示例

四、微信分享的结果回调

五、微信分享的踩坑总结

--------------------

## 一、申请应用 ##

--------------------

1、首先到[ \[ 微信开放平台官网\] ][_ _]申请注册帐号，这些流程就忽略了到官网一看自然就知道怎么走，感觉在这里没有必要说很多。  
2、申请一个移动应用，填写完成你的应用信息。其他的没啥，最主要的是要填对你的签名和包名，否则SDK调不起来。包名大家都懂，主要是这个签名的过程需要提醒一下：  
1）签名全部是小写，没有大写。  
2）签名填的是MD5，不是SHA1更不是SHA256，有的同学不小心就搞错了  
这里获取应用签名的方法有二。

第一个方法：先假设我们的应用已经有签名文件了（这里就不讲解生成签名文件的过程了，Android Studio提供的生成签名文件的方法已经很简单了，这里不赘述）。在命令行输入以下命令：

keytool -list -v -keystore 目标签名文件路径

然后输入一下签名文件的密码后就出来很多签名文件的信息：

![70][]

注意是复制出里面的指纹证书下的MD5那一串。  
然后自己手动把大写字母改成小写字母，并且把冒号都去掉。这样子就得到了签名。

第二个方法：简单粗暴，微信开放平台提供给我们一个签名获取的工具，[点击这里跳转][Link 1]

![70 1][] 然后把apk安装到手机后，正确输入你的应用包名后就获取到了一串签名：

![70 2][]

把这串签名填写到你申请的应用配置里面。

搞定，等待微信审核。  
审核完成后得到AppID 和 AppSecret 。注意这两个，等下要用到。

# 二、配置微信分享的SDK #

--------------------

可以直接到官网下载jar包或者配置依赖：

dependencies {
        compile 'com.tencent.mm.opensdk:wechat-sdk-android-with-mta:+'
    }

或者

dependencies {
        compile 'com.tencent.mm.opensdk:wechat-sdk-android-without-mta:+'
    }

（其中，前者包含统计功能）

然后我们添加如下权限：

<uses-permission android:name="android.permission.INTERNET"/>
    
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
    
    <uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/>
    
    <uses-permission android:name="android.permission.READ_PHONE_STATE"/>
    
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>

# 三、微信分享示例 #

--------------------

1、首先我们需要像微信注册我们申请的应用，在前面我们申请的应用审核完后的APP\_ID 和APP\_SECRET 就填写在这里：

private static final String APP_ID = "123456"; 
    private static final String APP_SECRET = "123456";
    private IWXAPI api;  
    //向微信注册app
    public void register(Context context) {   
    	if(api==null){
    	    api = WXAPIFactory.createWXAPI(context, APP_ID, true);  
    	    api.registerApp(APP_ID);        
        }
    }

这部分代码没有限制性需要在哪里执行，你可以放在Application的onCreate，也可以在Activity，笔者推荐放在你要做分享的Activity里。

接下来就是编写分享的代码了。微信分享有文字、图片、链接、音乐、视频这几种方式，分享的途径有分享到好友、分享到朋友圈。  
由于不同分享方式的原理相同，这里我们就拿分享网页链接的例子来说  
以下是分享网页链接的代码:

WXWebpageObject webpage = new WXWebpageObject();
            webpage.webpageUrl = "网页链接";
            final WXMediaMessage msg = new WXMediaMessage(webpage);
            msg.title = "网页标题";
            msg.description = "网页内容";
            
            Bitmap thumb = BitmapFactory.decodeResource(mContext.getResources(), R.drawable.xxx);
            if(thumb != null) {
                Bitmap mBp = Bitmap.createScaledBitmap(thumb, 120, 120, true);
                thumb.recycle();
                msg.thumbData = bmpToByteArray(thumb,true);
            }
           SendMessageToWX.Req req = new SendMessageToWX.Req();    //创建一个请求对象
        req.message = msg; 
        //req.scene = SendMessageToWX.Req.WXSceneTimeline;    //设置发送到朋友圈
        req.scene = SendMessageToWX.Req.WXSceneSession;   //设置发送给朋友
        req.transaction = "设置一个tag";  //用于在回调中区分是哪个分享请求
        boolean successed = api.sendReq(req);   //如果调用成功微信,会返回true

好了，正常的话到这一步我们已经能够调起微信对好友分享网页链接了。  
而往往事与愿违，现实和理想差距太大。有很多同学到这一部却碰到很多问题，比如：

1、调不起来，微信一点反应都没有；  
2、能分享给好友、但是显示不了网页链接的图片；  
3、能分享给好友，自己能看到网页链接的图片，但是朋友看不到。

问题的答案如下：  
第一个问题：调不起来，微信一点反应都没有  
首先你得保证填写的包名和签名是一定正确的，签名你如果不确定是否正确的话就最好用官方的签名获取apk来校验一下。  
其次，你得确保有没有注册了?我们在代码的第一步写的：  
WXAPIFactory.createWXAPI(context, APP\_ID, true);  
如果都确保是没问题的，那么就要从图标入手了，这是微信文档的一个大坑

我们在分享链接的时候填写图片，这个bitmap不能超过32kb  
事实证明如果传给微信的bitmap太大的话，则微信会无任何反应，Log也看不出什么出错。  
所以有了这一步：

Bitmap mBp = Bitmap.createScaledBitmap(thumb, 120, 120, true);

或者把你的图切小一点。也许就能调起来了。  
第二个问题：能分享给好友、但是显示不了网页链接的图片  
这个问题其实也是跟bitmap的大小有关，跟问题一差不多。所以建议两个方法，要么把图片切小一点。要么代码控制图片的大小，使之在正常的范围内。

第三个问题：能分享给好友，自己能看到网页链接的图片，但是朋友看不到  
前面两个问题其实还好，至少稍微百度一下就能解决。而第三个问题着实坑爹。好友看不到你的网页图片，会让你误以为是问题二导致的，结果一顿修改都解决不了问题。  
而其实，这个是跟微信的一个敏感词检测系统，如果你的网页分享内容里面包含了“红包”、“领取”等等之类的词语，极有可能造成问题三的产生，而微信目前没有公布哪些敏感词不通过，所以出现这个问题的话你一定要注意修改你的标题和内容了，只能把表达方式换一个，再试一下。

## 四、微信分享的结果回调 ##

--------------------

说了这么多，想必你已经能调起微信进行分享了吧。我们还没说到微信的回调，其实微信的回调说起来也是比较坑的，如果没接触过的话，这个回调也能耗了你不少时间。  
微信的回调有四大坑，这里通过踩坑的方式来完成示例：

1、新建WXEntryActivity（坑一：新建的WXEntryActivity类包名路径不对）  
长话短说，这里千言万语融成一句话：一定要在建立一个 包名.wxapi.WXEntryActivity  
比如你的包名是：com.example.demo。那么你就得配置一个com.example.demo.wxapi.WXEntryActivity  
千万要注意，不要随便乱放这个Activity，也不能改名，就叫WXEntryActivity。包名跟你申请应用的时候填写的包名一致。

2、向AndroidManifest.xml注册WXEntryActivity（坑二：没有配置android:exported=“true”）

注意看清楚没？多配置了一个 android:exported=“true”，这个属性代表着运行被外界程序所启动这个Activity，微信对于我们的app来说就是外部程序了，要回调我们的Activity，没有这个万万不行。千万要注意

3、实现IWXAPIEventHandler接口，注册API（坑三：没有在onCreate里注册API）  
这个接口有两个方法：

@Override
        public void onReq(BaseReq baseReq) {
            
        }
    
        @Override
        public void onResp(BaseResp baseResp) {
    
        }

分别是我们做出的请求和请求的结果回调。我们的业务逻辑便是从onResp方法里写的  
然后一定要 千万要 万万要注册api、八成没有接收到回调的同学们就是没有这一步：

@Override
        protected void onCreate(Bundle savedInstanceState) {
            super.onCreate(savedInstanceState);
            //注册API 没有这个不会执行onResp
            api = WXAPIFactory.createWXAPI(this, WXModel.APP_ID);
            api.handleIntent(getIntent(), this);
            LogUtils.i(TAG, " handleIntent:" + api.handleIntent(getIntent(), this));
        }

4、在onResp方法里编写分享后的回调处理逻辑（坑四：回调处理逻辑搞错）  
其实到这一步回调就可以完成了。剩下的是我们的回调回来页面后的业务逻辑，从onResp来处理。  
在这里特别注意提醒同学们，由于微信的登录和分享都是一样放在这个WXEntryActivity里面，所以在onResp方法里面我们必须做出区分，通过baseReq.getType()可以得到回调的类型，在ConstantsAPI接口里面定义了微信回调的很多类型，需要我们自己来区分

![70 3][]

然后通过状态码：resp.errCode 来得知分享的结果（成功、失败、取消等等），正常成功的话是resp.errCode==BaseResp.ErrCode.ERR\_OK，取消分享是BaseResp.ErrCode.ERR\_USER\_CANCEL。

好了，到这一步的时候我们就绕过这么多个坑，基本做对的话就能成功分享链接出去并且回调分享结果。

最后，由于微信的回调机制，我们没办法做出其他处理，一定只能通过在固定的包名路径下新建这个类来完成回调，如果你实在不想微信显示这个页面的话，那么也可以通过广播、或者EventBus来吧结果回调出去，然后结束页面。这样子注册了广播接收或者EventBus的Actibity就能接收到回调的结果：

@Override
        public void onResp(BaseResp baseResp) {
            if (baseResp.getType() == ConstantsAPI.COMMAND_SENDMESSAGE_TO_WX) {
                Intent intent = new Intent("SHARE_WX_ACTION");
                intent.putExtra("errCode", baseResp.errCode);
                sendBroadcast(intent);
                finish();
            }
        }

## 五、微信分享的踩坑总结  ##

--------------------

到这里，微信分享的过程就结束了，你学会了吗？  
由于坑比较多，在最后我们再总结下微信分享都有哪些需要注意的地方：

1、配置签名的坑  
解决：一定要MD5、小写、不要带冒号，最好用官方给的签名获取工具。  
2、没有注册API  
解决：API是运行重复注册的，并且也不是耗时任务，所以不妨放在Activity的onCreate下面，记得写这个。  
3、分享的图标  
解决：分享的图标大小不能超过32K，要是jpg格式。  
3、分享图标自己能看到，好友看不到  
解决：修改分享的标题和内容，不要触及微信的敏感词检测系统，多试几下。  
4、没有回调  
解决：一定要注意WXEntryActivity的包名路径是否正确，已经配置export=true  
5、确定了问题4后还是调不起来  
你确定有在WXEntryActivity的onCreate里面注册API并且调用 api.handleIntent(getIntent(), this);？ 估计你没有吧？  
6、回调到其他页面  
解决：没办法直接回调到其他页面，但可以通过广播、EventBus等通知的实现来通知其他页面刷新，同时结束WXEntryActivity的页面。

[https_blog.csdn.net_lc_miao_article_details_79855687]: https://blog.csdn.net/lc_miao/article/details/79855687
[_ _]: https://open.weixin.qq.com/
[70]: /images/20220222/43f6f97dfe1047288a4418acdbf2b234.png
[Link 1]: https://open.weixin.qq.com/cgi-bin/showdocument?action=dir_list&t=resource/res_list&verify=1&id=open1419319167&token=&lang=zh_CN
[70 1]: /images/20220222/36d54d16dbd5449bab8a85c6bedcdfff.png
[70 2]: /images/20220222/97c9767c258643ebbb306dc91c8294ed.png
[70 3]: /images/20220222/623bc353199b42eb9f627dd8d6226387.png