实用AndroidAndroid开发

Android集成微信分享功能(有这一篇就够了)

2022-04-14  本文已影响0人  不略

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

准备工作

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,这两步缺一不可,而且名字也要一模一样,不要问我为什么,微信规定的。

![E91FVVD`0O]IF@_9GAQY@8.png

这个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,
最好自己写个压缩的方法。

上一篇下一篇

猜你喜欢

热点阅读