美文网首页我爱编程
对友盟分享(Umeng-Share)的功能封装

对友盟分享(Umeng-Share)的功能封装

作者: 小饼干是只松鼠 | 来源:发表于2018-04-17 10:01 被阅读372次

    对友盟分享(Umeng-Share)的功能封装


    引言

    本文档针对友盟分享(6.9.0)进行了功能封装,完成的对于 文字图片网页 分享功能封装,如有其它封装要求请根据本文档的封装思路和友盟分享 api再进行功能封装。
    😝话不多言,看看代码吧。

    封装主要完成几部

    • Cocoapods 集成友盟分享 SDK
    • 配置SSO白名单
    • 配置URL Scheme
    • AppDelegate+UMeng
    • UmengEnclosed
    App + Umeng.png

    Cocoapods 集成、白名单、URL Scheme

    这部分太啰嗦,也没有必要,需要的直接去官方文档查阅 U-Share集成文档

    AppDelegate+UMeng

    这里是对 AppDelegate 做了一个 Category 分类处理,在 AppDelegate 中好区别去其他第三方平台 SDK 注册和配置来调用U-Share SDK 的调用。
    这部分就不多说了,大家都懂,直接上代码。

    1. AppDelegate+UMeng.h

      #import "AppDelegate.h"
      
      @interface AppDelegate (UMeng)
      // 友盟系统配置和注册
      - (BOOL)umengapplication:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions;
      // 设置系统回调
      // 支持所有iOS系统
      - (BOOL)umengapplication:(UIApplication *)application openURL:(NSURL *)url sourceApplication:(NSString *)sourceApplication annotation:(id)annotation;
          
      // 仅支持iOS9以上系统,iOS8及以下系统不会回调
      - (BOOL)umengapplication:(UIApplication *)app openURL:(NSURL *)url options:(NSDictionary<UIApplicationOpenURLOptionsKey, id> *)options;
          
      // 2.支持目前所有iOS系统
      - (BOOL)umengapplication:(UIApplication *)application handleOpenURL:(NSURL *)url;
      @end
      
    2. AppDelegate+UMeng.m
      此部分代码过多只展示部分逻辑,有需要请到 GDMiao/UmengEnclosed 下载查看。

      a. // 友盟系统配置和注册

      // 友盟系统配置和注册
      - (BOOL)umengapplication:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
      {
          // UMConfigure 通用设置,请参考SDKs集成做统一初始化。
          [UMConfigure initWithAppkey:@"你的UMAPPKey" channel:@"App Store"];
          [UMConfigure setLogEnabled:YES];
          // U-Share 平台设置
          [self configUSharePlatforms]; // 配置参考官方文档
          [self confitUShareSettings];  // 配置参考官方文档
          return YES; 
      }
      

      b. 系统回调

      // 1.支持所有iOS系统
      - (BOOL)umengapplication:(UIApplication *)application openURL:(NSURL *)url sourceApplication:(NSString *)sourceApplication annotation:(id)annotation
      {
          //6.3的新的API调用,是为了兼容国外平台(例如:新版facebookSDK,VK等)的调用[如果用6.2的api调用会没有回调],对国内平台没有影响
          BOOL result = [[UMSocialManager defaultManager] handleOpenURL:url sourceApplication:sourceApplication annotation:annotation];
          if (!result) {
              // 其他如支付等SDK的回调
          }
          return result;
      }
      
      // 2.仅支持iOS9以上系统,iOS8及以下系统不会回调
      - (BOOL)umengapplication:(UIApplication *)app openURL:(NSURL *)url options:(NSDictionary<UIApplicationOpenURLOptionsKey, id> *)options
      {
          //6.3的新的API调用,是为了兼容国外平台(例如:新版facebookSDK,VK等)的调用[如果用6.2的api调用会没有回调],对国内平台没有影响
          BOOL result = [[UMSocialManager defaultManager]  handleOpenURL:url options:options];
          if (!result) {
              // 其他如支付等SDK的回调
          }
          return result;
      }
      
      // 3.支持目前所有iOS系统
      - (BOOL)umengapplication:(UIApplication *)application handleOpenURL:(NSURL *)url
      {
           BOOL result = [[UMSocialManager defaultManager] handleOpenURL:url];
           if (!result) {
              // 其他如支付等SDK的回调
           }
           return result;
      }
      

    UmengEnclosed

    这部分是对友盟分享的关键封装,定制了 文本字、图片、网页 三种分享,分钟分享有固定的参数形式。

    1. UmengEnclosed.h

      #pragma mark -- 定制Text类型分享面板预定义平台
      /**
      文本分享
       @param vc         分享方法调用的 Controller
       @param socialType 分享平台选择
       @param sharetype  分享类型选择
       @param data       分享类型固定参数 data = @"text"
       */
      - (void)customTextShareWithVC:(id)vc SocialType:(SocialType)socialType shareType:(ShareType)sharetype textData:(id)data;
      
      #pragma mark -- 定制Image类型分享面板预定义平台
      /**
       图片分享
       @param vc         分享方法调用的 Controller
       @param socialType 分享平台选择
       @param sharetype  分享类型选择
       @param data       分享类型固定参数 {"thumb":"thumbImgurl","original":@"originalImgurl"}
       */
      - (void)customImageShareWithVC:(id)vc SocialType:(SocialType)socialType shareType:(ShareType)sharetype imgUrlData:(id)data;
      
      #pragma mark -- 定制Web类型分享面板预定义平台
      /**
       网页分享
       @param vc         分享方法调用的 Controller
       @param socialType 分享平台选择
       @param sharetype  分享类型选择
       @param data       分享类型固定参数 {"title":"","descr":"","weburl":@""}
       */
      - (void)customWebShareWithVC:(id)vc SocialType:(SocialType)socialType shareType:(ShareType)sharetype webData:(id)data;
      
    2. UmengEnclosed.m

      a. 此部分根据 SocialType 定制分享面板,根据ShareType定制分享方法,data 根骨分享方法配置参数。

      #pragma mark -- 定制自己的分享面板预定义平台
      /**
       配置分享面板 和 分享类型
       @param vc         分享方法调用的 Controller
       @param socialType 分享平台选择
       @param sharetype  分享类型选择
       @param data       分享类型参数
       */
      - (void)shareMenuViewWithVC:(id)vc SocialType:(SocialType)socialType ShareType:(ShareType)sharetype date:(id)data
      {
          _vc = vc;
          if (socialType == SType_sina_wx_qq) {
              [UMSocialUIManager setPreDefinePlatforms:@[@(UMSocialPlatformType_Sina),@(UMSocialPlatformType_WechatSession),@(UMSocialPlatformType_WechatTimeLine),@(UMSocialPlatformType_QQ),@(UMSocialPlatformType_Qzone)]];
          
          } else {
              //[UMSocialUIManager setPreDefinePlatforms:@[@(UMSocialPlatformType_Sina),@(UMSocialPlatformType_QQ),@(UMSocialPlatformType_WechatSession)]];
          }
          __weak typeof(self) weakself = self;
          
          [UMSocialUIManager showShareMenuViewInWindowWithPlatformSelectionBlock:^(UMSocialPlatformType platformType, NSDictionary *userInfo) {
              // 根据获取的platformType确定所选平台进行下一步操作
              __strong typeof(self) strongself = weakself;
      
              switch (sharetype) {
                  case ShareText:
                      [strongself shareTextToPlatformType:platformType date:data]; // 根据友盟文档定制方法
                      break;
                  case SharePictures:
                      [strongself shareImageToPlatformType:platformType date:data];
                      break;
                  case SharePicturesAndText_sina:
                      
                      break;
                  case ShareWebPages:
                      [strongself shareWebPageToPlatformType:platformType date:data];
                      break;
                  case ShareMusic:
                      
                      break;
                  case ShareVideo:
                      
                      break;
                  case ShareWeChatExpression:
                      
                      break;
                  case ShareWeChatPrograms:
                      
                      break;
                  default:
                      break;
              }
          }];
      }
      

      b. 分享文本

      // 分享文本
      - (void)shareTextToPlatformType:(UMSocialPlatformType)platformType date:(id)data
      {
          NSString *text = data;
          //创建分享消息对象
          UMSocialMessageObject *messageObject = [UMSocialMessageObject messageObject];
          //设置文本
          messageObject.text = text;
          //调用分享接口
          [[UMSocialManager defaultManager] shareToPlatform:platformType messageObject:messageObject currentViewController:self.vc completion:^(id data, NSError *error) {
              if (error) {
                  NSLog(@"************Share fail with error %@*********",error);
              }else{
                  NSLog(@"response data is %@",data);
              }
          }];
      }
      

      c.调用文本分享定制方法

      /**
       文本分享
       @param vc         分享方法调用的 Controller
       @param socialType 分享平台选择
       @param sharetype  分享类型选择
       @param data       分享类型固定参数 data = @"text"
       */
      - (void)customTextShareWithVC:(id)vc SocialType:(SocialType)socialType shareType:(ShareType)sharetype textData:(id)data
      {
          [self shareMenuViewWithVC:vc SocialType:socialType ShareType:sharetype date:data];
      }
      

      d.不一一举例详情请参考 GDMiao/UmengEnclosed 下载查看。

    具体调用

    #import "UmengEnclosed.h"
    
    - (IBAction)umengSharedAciton:(id)sender {
      UmengEnclosed *umeng = [UmengEnclosed sharedUmengEnclosed];
      [umeng customTextShareWithVC:self SocialType:SType_sina_wx_qq shareType:ShareText textData:@"OK"];
    }
    
    

    结语

    本次封装只定制我我方 APP 的对应分享的部分功能,如有需要请更加文档自行定制。
    如果您能读到点这里我非常感谢。

    相关文章

      网友评论

        本文标题:对友盟分享(Umeng-Share)的功能封装

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