美文网首页实用AndroidAndroid开发
Android集成微信分享功能(有这一篇就够了)

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

作者: 不略 | 来源:发表于2022-04-14 10:51 被阅读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,
    最好自己写个压缩的方法。

    相关文章

      网友评论

        本文标题:Android集成微信分享功能(有这一篇就够了)

        本文链接:https://www.haomeiwen.com/subject/jfltertx.html