有盟分享SDK集成

一、前言
关于友盟SDK以前在Android开发的过程之中就用到过,也是非常常见的第三方SDK,比如友盟分享在很多的应用中都可以用到,也是非常不错的分享SDK,所以今天抽出时间来总结下关于Android客户端集成友盟分享SDK的一二三,总体来说友盟分享SDK有以下特点:快速具备多平台分享、第三方登录功能,SDK包最小,集成成本最低,平台覆盖最全,助力产品开发与推广。
1、U-Share SDK6.0 核心平台包大小节约70%,SDK架构也全面重构了
2、覆盖国内外近30家社交平台,支持文本、图片、音乐、视频、链接等多种内容类型的分享,并提供了主流游戏平台的SDK。
国内平台:微信、朋友圈、QQ、Qzone、新浪微博、腾讯微博、人人、豆瓣、易信、短信、邮件等。
国外平台:Facebook、Twitter、Instagram、Google+、LINE、WhatsApp、Pinterest、Evernote、
Pocket、LinkedIn、KakaoTalk等。
3、集成成本低、速度快,规避平台差异性,统一封装极简接口,多个平台一次搞定。
4、提供了标准的分享编辑页、分享平台菜单模板,当然我们也可以微调甚至完全自由定制。
5、借助友盟+ 大数据优势,我们提供业界最权威的用户画像、分享回流等实时的数据分析

二、准备
1、注册:地址:https://passport.umeng.com/signup?lang=zh_CN

微信图片_20180515182038.png

2、注册好之后会跳转到如下界面,点击立即使用,当然有很多种类SDK可供选择,如有盟统计,友盟分享等:
微信图片_20180515182406.png

3、申请APP企业认证
微信图片_20180515183140.png

4、阅读友盟分享集成文档:https://developer.umeng.com/docs/66632/detail/66639
5、创建应用生成Android 唯一Appkey:
微信图片_20180515190106.png

三、集成:
集成分为两种方式:
1、自动集成不多讲:目前只支持微信,QQ,新浪三个平台
2、手动集成:
1)、下载最新SDK

2)、导入jar和res:将main文件夹以及platform(选择你想使用的平台即可)文件下,对应的资源文件和jar放入你的工程
2.png

3)、添加回掉Activity
微信:在包名目录下创建wxapi文件夹,新建一个名为WXEntryActivity的activity继承WXCallbackActivity。
支付宝:与微信相似,支付宝需要在包名目录下创建apshare文件夹,然后建立一个ShareEntryActivity的类,继承ShareCallbackActivity。
钉钉:与微信相似,钉钉需要在包名目录下创建ddshare文件夹,然后建立一个DDShareActivity的类,DingCallBack。
QQ与新浪:QQ与新浪不需要添加Activity,但需要在使用QQ分享或者授权的Activity中,onActivityResult不可在Fragment当中实现:
        @Override
         protected void onActivityResult(int requestCode, int resultCode, Intent data) {
               super.onActivityResult(requestCode, resultCode, data);
               UMShareAPI.get(this).onActivityResult(requestCode, resultCode, data);
         }

配置Android Manifest XML
sdk中需要的Activity

  //新浪
  <activity
        android:name="com.umeng.socialize.media.WBShareCallBackActivity"
        android:configChanges="keyboardHidden|orientation"
        android:theme="@android:style/Theme.Translucent.NoTitleBar"
        android:exported="false"
        android:screenOrientation="portrait" >
  </activity>
  <activity android:name="com.sina.weibo.sdk.web.WeiboSdkWebActivity"
          android:configChanges="keyboardHidden|orientation"
          android:exported="false"
          android:windowSoftInputMode="adjustResize">
  </activity>
  <activity
        android:theme="@android:style/Theme.Translucent.NoTitleBar.Fullscreen"
        android:launchMode="singleTask"
        android:name="com.sina.weibo.sdk.share.WbShareTransActivity">
        <intent-filter>
            <action android:name="com.sina.weibo.sdk.action.ACTION_SDK_REQ_ACTIVITY" />
            <category android:name="android.intent.category.DEFAULT" />
        </intent-filter>
    </activity>

     //微信
     <activity
        android:name=".wxapi.WXEntryActivity"
        android:configChanges="keyboardHidden|orientation|screenSize"
        android:exported="true"
        android:theme="@android:style/Theme.Translucent.NoTitleBar" />
      
      //支付宝
      <activity
        android:name=".apshare.ShareEntryActivity"
        android:configChanges="keyboardHidden|orientation|screenSize"
        android:exported="true"
        android:screenOrientation="portrait"
        android:theme="@android:style/Theme.Translucent.NoTitleBar" />

      //钉钉
      <activity
        android:name=".ddshare.DingCallBack"
        android:configChanges="keyboardHidden|orientation|screenSize"
        android:exported="true"
        android:screenOrientation="portrait"
        android:theme="@android:style/Theme.Translucent.NoTitleBar" />

        //qq(请注意将我们的qq appkey替换成您自己的qq appkey)
        <activity
          android:name="com.tencent.tauth.AuthActivity"
          android:launchMode="singleTask"
          android:noHistory="true" >
         <intent-filter>
             <action android:name="android.intent.action.VIEW" />
             <category android:name="android.intent.category.DEFAULT" />
             <category android:name="android.intent.category.BROWSABLE" />
             <data android:scheme="tencent100424468" />
         </intent-filter>
         </activity>
         <activity
               android:name="com.tencent.connect.common.AssistActivity"
              android:theme="@android:style/Theme.Translucent.NoTitleBar"
               android:configChanges="orientation|keyboardHidden|screenSize"/>

        //分享编辑页(只有豆瓣,人人,腾讯微博,领英,twitter需要)
          <activity
               android:name="com.umeng.socialize.editorpage.ShareActivity"
               android:theme="@android:style/Theme.NoTitleBar"
               android:excludeFromRecents="true"/>

4)、权限添加

             <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
             <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
             <uses-permission android:name="android.permission.INTERNET" />
             //如果需要使用QQ纯图分享或避免其它平台纯图分享的时候图片不被压缩,可以增加以下权限
             <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>   
             <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>

Android6.0以上设备动态权限请求

            if(Build.VERSION.SDK_INT>=23){
              String[] mPermissionList = new String[]{Manifest.permission.WRITE_EXTERNAL_STORAGE,Manifest.permission.ACCESS_FINE_LOCATION,Manifest.permission.CALL_PHONE,Manifest.permission.READ_LOGS,Manifest.permission.READ_PHONE_STATE, Manifest.permission.READ_EXTERNAL_STORAGE,Manifest.permission.SET_DEBUG_APP,Manifest.permission.SYSTEM_ALERT_WINDOW,Manifest.permission.GET_ACCOUNTS,Manifest.permission.WRITE_APN_SETTINGS};
              ActivityCompat.requestPermissions(this,mPermissionList,123);
          }

          @Override
          public void onRequestPermissionsResult(int requestCode,
                String permissions[], int[] grantResults) {
          }

5)、初始化配置

     @Override
     public void onCreate() {
          super.onCreate();   
          UMConfigure.init(this,"5a12384aa40fa3551f0001d1","umeng",
          UMConfigure.DEVICE_TYPE_PHONE,"");
          //设置友盟的Log开启
         UMConfigure.setLogEnabled(true);
         //设置友盟的Log加密
         UMConfigure.setEncryptEnabled(true);
     }

6)、Application中设置各各平台appkey:appkey需要去微信等各平台申请

     PlatformConfig.setWeixin("wxdc1e388c3822c80b", "3baf1193c85774b3fd9d18447d76cab0");
    //豆瓣RENREN平台目前只能在服务器端配置
    PlatformConfig.setSinaWeibo("3921700954", "04b48b094faeb16683c32669824ebdad","http://sns.whalecloud.com");
    PlatformConfig.setYixin("yxc0614e80c9304c11b0391514d09f13bf");
    PlatformConfig.setQQZone("100424468", "c7394704798a158208a74ab60104f0ba");
    PlatformConfig.setTwitter("3aIN7fuF685MuZ7jtXkQxalyi", "MK6FEYG63eWcpDFgRYw4w9puJhzDl0tyuqWjZ3M7XJuuG7mMbO");
    PlatformConfig.setAlipay("2015111700822536");
    PlatformConfig.setLaiwang("laiwangd497e70d4", "d497e70d4c3e4efeab1381476bac4c5e");
    PlatformConfig.setPinterest("1439206");
    PlatformConfig.setKakao("e4f60e065048eb031e235c806b31c70f");
    PlatformConfig.setDing("dingoalmlnohc0wggfedpk");
    PlatformConfig.setVKontakte("5764965","5My6SNliAaLxEm3Lyd9J");
    PlatformConfig.setDropbox("oz8v5apet3arcdy","h7p2pjbzkkxt02a");
    PlatformConfig.setYnote("9c82bf470cba7bd2f1819b0ee26f86c6ce670e9b");

7)、签名配置:不添加签名部分平台可能不可用

8)、代码混淆:https://developer.umeng.com/docs/66632/detail/66639#h2-u521Du59CBu5316u8BBEu7F6E9

三、分享

    1、带面板
          new ShareAction(MainActivity.this).withText("hello")                    
           .setDisplayList(SHARE_MEDIA.SINA,SHARE_MEDIA.QQ,SHARE_MEDIA.WEIXIN)
          .setCallback(umShareListener).open();
    2、不带面板
         new ShareAction(MainActivity.this)
        .setPlatform(SHARE_MEDIA.QQ)//传入平台
        .withText("hello")//分享内容
       .setCallback(umShareListener)//回调监听器
       .share();
  
        private UMShareListener shareListener = new UMShareListener() {
    /**
     * @descrption 分享开始的回调
     * @param platform 平台类型
     */
    @Override
    public void onStart(SHARE_MEDIA platform) {

    }

    /**
     * @descrption 分享成功的回调
     * @param platform 平台类型
     */
    @Override
    public void onResult(SHARE_MEDIA platform) {
        Toast.makeText(ShareDetailActivity.this,"成功                                        了",Toast.LENGTH_LONG).show();
    }

    /**
     * @descrption 分享失败的回调
     * @param platform 平台类型
     * @param t 错误原因
     */
    @Override
    public void onError(SHARE_MEDIA platform, Throwable t) {
        Toast.makeText(ShareDetailActivity.this,"失                                            败"+t.getMessage(),Toast.LENGTH_LONG).show();
    }

    /**
     * @descrption 分享取消的回调
     * @param platform 平台类型
     */
    @Override
    public void onCancel(SHARE_MEDIA platform) {
        Toast.makeText(ShareDetailActivity.this,"取消                                          了",Toast.LENGTH_LONG).show();

    }
};

 3、分享的消息类型
      1)、文本
          new ShareAction(ShareActivity.this).withText("hello").withMedia(image).share();
      2)、图片
         种类:
         UMImage image = new UMImage(ShareActivity.this, "imageurl");//网络图片
         UMImage image = new UMImage(ShareActivity.this, file);//本地文件
         UMImage image = new UMImage(ShareActivity.this, R.drawable.xxx);//资源文件
         UMImage image = new UMImage(ShareActivity.this, bitmap);//bitmap文件
         UMImage image = new UMImage(ShareActivity.this, byte[]);//字节流

        推荐使用网络图片和资源文件的方式,平台兼容性更高。对于部分平台,分享的图片需要设置缩略图,缩略图的设置规则为:
       用户设置的图片大小最好不要超过250k,缩略图不要超过18k,如果超过太多(最好不要分享1M以上的图片,压缩效率会很低),图片会被压缩。用户可以设置压缩的方式:

      UMImage thumb =  new UMImage(this, R.drawable.thumb);
      image.setThumb(thumb);
      image.compressStyle = UMImage.CompressStyle.SCALE;//大小压缩,默认为大小压
      缩,适合普通很大的图
      image.compressStyle = UMImage.CompressStyle.QUALITY;//质量压缩,适合长图的分
      享压缩格式设置
      image.compressFormat = Bitmap.CompressFormat.PNG;//用户分享透明背景的图片可以
      设置这种方式,但是qq好友,微信朋友圈,不支持透明背景图片,会变成黑色
      newShareAction(ShareDetailActivity.this)
                    .withMedias(imagelocal,imagelocal,imagelocall)
                    .setPlatform(share_media)
                    .withText("hello")
                    .setCallback(shareListener).share();

        3、链接
             UMWeb  web = new UMWeb(Defaultcontent.url);
             web.setTitle("This is music title");//标题
             web.setThumb(thumb);  //缩略图
             web.setDescription("my description");//描述
             new ShareAction(ShareActivity.this)
               .withMedia(web)
               .share();

          4、视频
           UMVideo video = new UMVideo(videourl);
           video.setTitle("This is music title");//视频的标题
           video.setThumb("http://www.umeng.com/images/pic/social/chart_1.png");//视频的缩略图
          video.setDescription("my description");//视频的描述
          new ShareAction(ShareActivity.this).withText("hello").withMedia(video).share();

        5、音乐
             UMusic music = new UMusic(musicurl);//音乐的播放链接
             music.setTitle("This is music title");//音乐的标题
             music.setThumb("http://www.umeng.com/images/pic/social/chart_1.png");//音乐的缩
             略图
             music.setDescription("my description");//音乐的描述
             music.setmTargetUrl(Defaultcontent.url);//音乐的跳转链接
             new ShareAction(ShareActivity.this).withMedia(music).share();
             特别说明:播放链接是指在微信qq分享音乐,是可以在当前聊天界面播放的,要求这个musicurl(播放链接)必须要以.mp3等音乐格式结尾,跳转链接是指点击linkcard之后进行跳转的链接。

           6、GIF
           UMEmoji emoji = new 
           UMEmoji(this,
           "http://img5.imgtn.bdimg.com/it/u=2749190246,3857616763&fm=21&gp=0.jpg");
          emoji.setThumb(new UMImage(this, R.drawable.thumb));
          new ShareAction(ShareActivity.this)
         .withMedia(emoji).share();

         7、微信小程序
               UMMin umMin = new UMMin(Defaultcontent.url);
               //兼容低版本的网页链接
               umMin.setThumb(imagelocal);
                // 小程序消息封面图片
               umMin.setTitle(Defaultcontent.title);
               // 小程序消息title
               umMin.setDescription(Defaultcontent.text);
               // 小程序消息描述
               umMin.setPath("pages/page10007/xxxxxx");
               //小程序页面路径
               umMin.setUserName("gh_xxxxxxxxxxxx");
               // 小程序原始id,在微信平台查询
               new ShareAction(ShareDetailActivity.this)
                .withMedia(umMin)
                .setPlatform(share_media)
                .setCallback(shareListener).share();

四、第三方登入
1、第三方登录包含两种使用场景:
获取用户资料的授权接口,使用该接口可以获取该三方平台返回的所有资料(包括姓名,性别,头像等)目前支持第三方登录的平台包括:
国内平台(微信、新浪微博、QQ、豆瓣、人人)
国外平台(Facebook、Twitter、linkedIn、kakao、VKontakte、Dropbox)
这里推荐直接使用第一种方式实现,因为本质上三方登录最终都需要拉取三方平台的用户资料,从这点来说,直接调用SDK和通过后台服务器请求,安全性是一样的

2、获取用户资料

    mShareAPI.getPlatformInfo(UserinfoActivity.this, SHARE_MEDIA.SINA, umAuthListener);
  UMAuthListener authListener = new UMAuthListener() {
        /**
         * @desc 授权开始的回调
         * @param platform 平台名称
         */
       @Override
       public void onStart(SHARE_MEDIA platform) {

       }

       /**
     * @desc 授权成功的回调
     * @param platform 平台名称
     * @param action 行为序号,开发者用不上
     * @param data 用户资料返回
     */
    @Override
    public void onComplete(SHARE_MEDIA platform, int action, Map<String, String> data) {

        Toast.makeText(mContext, "成功了", Toast.LENGTH_LONG).show();

   }

    /**
     * @desc 授权失败的回调
     * @param platform 平台名称
     * @param action 行为序号,开发者用不上
     * @param t 错误原因
     */
    @Override
   public void onError(SHARE_MEDIA platform, int action, Throwable t) {

       Toast.makeText(mContext, "失败:" + t.getMessage(),                                     Toast.LENGTH_LONG).show();
    }

    /**
     * @desc 授权取消的回调
     * @param platform 平台名称
     * @param action 行为序号,开发者用不上
     */
    @Override
    public void onCancel(SHARE_MEDIA platform, int action) {
        Toast.makeText(mContext, "取消了", Toast.LENGTH_LONG).show();
    }
};

3、删除授权

  UMShareAPI.get(mContext).deleteOauth(Activity, Platform, authListener);
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 205,033评论 6 478
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 87,725评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 151,473评论 0 338
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,846评论 1 277
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,848评论 5 368
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,691评论 1 282
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,053评论 3 399
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,700评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 42,856评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,676评论 2 323
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,787评论 1 333
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,430评论 4 321
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,034评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,990评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,218评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,174评论 2 352
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,526评论 2 343

推荐阅读更多精彩内容