Android微信分享功能集成开发指南（这一篇就够了）

前言

本文介绍的只是微信开发中的一个功能，分享。看到网上很多关于微信分享的博客、帖子，说实话，没几篇写的全的，很多都是复制粘贴，介绍的也不全，缺少代码的分析，关键性的代码总是漏一句两句，看着就很难受。所以，在这里我打算写一篇关于微信分享的博客，总结一下知识点，贴上详细的代码。学微信分享，这一篇就够了。

准备工作

1.微信开放平台申请应用，分享需要用到appId，这里注意了，申请时用到的是MD5值，而不是SHA1值（这里我就弄错过，导致分享一直都是失败，返回的状态码为-6）。不知道怎么在AS中得到签名信息的同学也不要紧，微信开放平台上有一个apk专门可以用来获取签名，这里附上链接点击前往。
2.在自定义的Application中的onCreate方法中，注册一下app，代码如下：

// 三个参数分别是上下文、应用的appId、是否检查签名（默认为false）
IWXAPI mWxApi = WXAPIFactory.createWXAPI(this, "你的appId", true);
// 注册
mWxApi.registerApp("你的appId");

3.微信分享是肯定需要请求网络的，所以要在manifests文件中允许网络权限：

<uses-permission android:name="android.permission.INTERNET"/>

4.在app模块的build.gradle文件中，添加如下依赖：

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

或者

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

这两个依赖乍一看是一样的，区别在于，第一个是with，第二个是without。其中，第一个依赖包含统计功能。说实话，我也没用过它的统计功能，但是我一般都是依赖第一个，说不定什么时候就需要用到了呢。依赖好后，同步一下。

开始使用

微信分享，可以是纯文本类型、图片类型、音乐类型、视频类型、网页类型、小程序类型。这么多类型如何实现，微信开放平台上有完整的代码实现，只是少了一个参数，看过的同学就知道啦，老样子，还是附上链接点击前往。我的项目中用到的是网页类型，所以我下面贴出的也是分享网页类型的代码，如果需要用到别的类型的，去我上面的链接里看一下就清晰了，其实代码本质都是一样的，只是个别参数变了一下。我把请求的代码写到了一个工具类里，方便调用，下面附上代码：

public class WxShareUtils {
/**
     * 分享网页类型至微信
     *
     * @param context 上下文
     * @param appId   微信的appId
     * @param webUrl  网页的url
     * @param title   网页标题
     * @param content 网页描述
     * @param bitmap  位图
     */
    public static void shareWeb(Context context, String appId, String webUrl, String title, String content, Bitmap bitmap) {
        // 通过appId得到IWXAPI这个对象
        IWXAPI wxapi = WXAPIFactory.createWXAPI(context, appId);
        // 检查手机或者模拟器是否安装了微信
        if (!wxapi.isWXAppInstalled()) {
            ToastUtil.makeText("您还没有安装微信");
            return;
        }

        // 初始化一个WXWebpageObject对象
        WXWebpageObject webpageObject = new WXWebpageObject();
        // 填写网页的url
        webpageObject.webpageUrl = webUrl;

        // 用WXWebpageObject对象初始化一个WXMediaMessage对象
        WXMediaMessage msg = new WXMediaMessage(webpageObject);
        // 填写网页标题、描述、位图
        msg.title = title;
        msg.description = content;
        // 如果没有位图，可以传null，会显示默认的图片
        msg.setThumbImage(bitmap);

        // 构造一个Req
        SendMessageToWX.Req req = new SendMessageToWX.Req();
        // transaction用于唯一标识一个请求（可自定义）
        req.transaction = "webpage";
        // 上文的WXMediaMessage对象
        req.message = msg;
        // SendMessageToWX.Req.WXSceneSession是分享到好友会话
        // SendMessageToWX.Req.WXSceneTimeline是分享到朋友圈
        req.scene = SendMessageToWX.Req.WXSceneSession;

        // 向微信发送请求
        wxapi.sendReq(req);
    }
}

工具类写好了，最后只要在你需要的地方调用就行了。这里补充一下，得到本地的bitmap很简单，只要通过工厂类就能实现，如果是网络图片呢？不知道的继续往下看，我这里使用了Glide这个控件。这个控件有多NB，不需要我在这里展开说明了吧。Glide有个方法可以直接异步获取网络图片的位图（我这里使用的是4.0.0版本，别的版本大家可以去Github查看，看有没有变化），老样子，贴上代码：

Glide.with(this).asBitmap().load("图片url").into(new SimpleTarget<Bitmap>() {
            /**
             * 成功的回调
             */
            @Override
            public void onResourceReady(Bitmap bitmap, Transition<? super Bitmap> transition) {
                // 下面这句代码是一个过度dialog，因为是获取网络图片，需要等待时间
                mDialog.dismiss();
                // 调用方法
                WxShareUtils.shareWeb(this, "你的appId",
                        "网页url", "网页标题", "网页描述",
                         bitmap);
            }

            /**
             * 失败的回调
             */
            @Override
            public void onLoadFailed(@Nullable Drawable errorDrawable) {
                super.onLoadFailed(errorDrawable);
                mDialog.dismiss();

                WxShareUtils.shareWeb(this, "你的appId",
                        "网页url", "网页标题", "网页描述",
                         null);
            }
});

这里还是需要补充一下，图片大小超过32KB（我记得没错应该是这个值），会导致分享界面调不起来，这里就需要压缩一下图片了，压缩图片的代码大家去网上找一下吧，以前我写过，但是暂时找不到了，怕网上随便找的有问题，误导大家，大家就辛苦一下自己找找吧，还是有很多的，基本没啥大问题。

收尾工作

在app模块包的根目录下新建一个wxapi的包，在这个包下面新建一个WXEntryActivity，这两步缺一不可，而且名字也要一模一样，不要问我为什么，微信规定的。

这个WXEntryActivity就是个普通的Activity，先贴上布局，其实就是一个最简单的空布局：

<?xml version="1.0" encoding="utf-8"?>
<android.support.constraint.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

</android.support.constraint.ConstraintLayout>

下面就是这个Activity的代码：

public class WXEntryActivity extends AppCompatActivity implements IWXAPIEventHandler {

    private IWXAPI wxapi;

    @Override
    protected void onNewIntent(Intent intent) {
        super.onNewIntent(intent);
        setIntent(intent);
        wxapi.handleIntent(intent, this);
    }

    @Override
    protected void onCreate(@Nullable Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_wxentry);

        wxapi = WXAPIFactory.createWXAPI(this, "你的appId");
        wxapi.handleIntent(getIntent(), this);
    }

    /**
     * 微信发送请求到第三方应用时，会回调到该方法
     */
    @Override
    public void onReq(BaseReq baseReq) {
        // 这里不作深究
    }

    /**
     * 第三方应用发送到微信的请求处理后的响应结果，会回调到该方法
     * app发送消息给微信，处理返回消息的回调
     */
    @Override
    public void onResp(BaseResp baseResp) {
        switch (baseResp.errCode) {
            // 正确返回
            case BaseResp.ErrCode.ERR_OK:
                switch (baseResp.getType()) {
                    // ConstantsAPI.COMMAND_SENDMESSAGE_TO_WX是微信分享，api自带
                    case ConstantsAPI.COMMAND_SENDMESSAGE_TO_WX:
                        // 只是做了简单的finish操作
                        finish();
                        break;
                    default:
                        break;
                }
                break;
            default:
                // 错误返回
                switch (baseResp.getType()) {
                    // 微信分享
                    case ConstantsAPI.COMMAND_SENDMESSAGE_TO_WX:
                        Log.i("WXEntryActivity" , ">>>errCode = " + baseResp.errCode);
                        finish();
                        break;
                    default:
                        break;
                }
                break;
        }
    }
}

这样还没完，最后需要在manifests文件中申明这个Activity，代码如下（复制粘贴的话，把代码中的注释去掉就可以了）：

<activity
    // 下面三行代码必须要有
    android:name=".wxapi.WXEntryActivity"
    android:exported="true"
    android:launchMode="singleTop"
    // 下面两行代码可有可无
    android:screenOrientation="portrait"
    // 指定一个主题，这里是无标题、半透明的主题
    android:theme="@style/NoTitleTranslucent80Theme"/>

下面是指定主题的代码，写在style.xml文件里（windowAnimationStyle可以不添加，这里只是一个动画）：

<style name="NoTitleTranslucent80Theme" parent="BaseAppTheme">
    <item name="android:windowNoTitle">true</item>
    <item name="android:windowBackground">#80000000</item>
    <item name="android:windowIsTranslucent">true</item>
    <item name="android:windowAnimationStyle">@style/AlphaAnim</item>
</style>

下面是动画的style（代码中两个item从上至下分别是进入动画、退出动画）：

<style name="AlphaAnim" parent="android:Animation">
    <item name="@android:windowEnterAnimation">@anim/bottom_in</item>
    <item name="@android:windowExitAnimation">@anim/bottom_out</item>
</style>

bottom_in 的代码如下：

<?xml version="1.0" encoding="utf-8"?>
<set xmlns:android="http://schemas.android.com/apk/res/android">
    <translate
        android:duration="300"
        android:fromXDelta="0"
        android:fromYDelta="100%"
        android:toXDelta="0"
        android:toYDelta="0" />
</set>

bottom_out 的代码如下：

<?xml version="1.0" encoding="utf-8"?>
<set xmlns:android="http://schemas.android.com/apk/res/android">
    <translate
        android:duration="300"
        android:fromXDelta="0"
        android:fromYDelta="0"
        android:toXDelta="0"
        android:toYDelta="100%" />
</set>

至此，一个完整的微信分享功能就实现了。

总结

只要按照上面的步骤一步步来，基本就能实现微信分享功能了。其中，要注意一点，
分享的图片大小不能大于32KB，
分享的图片大小不能大于32KB，
分享的图片大小不能大于32KB，
最好自己写个压缩的方法。