友盟分享小结

因之前都写在了 AppDelegate 类中,看起来过于臃肿,此次基于友盟分享重新进行了一次优化,此次分享内容基于已经成功集成 SDK 后 code 层级部分.
注:此次分享基于 SDK 6.9.3,若版本相差较大,仅供参考.
友盟分享官方文档: https://developer.umeng.com/docs/66632/detail/66825

Github: https://github.com/survivorsfyh/YHSampleCode/tree/master/UMShare

首先,为分享单独创建了一个类,为了可以更加清晰的划分其内容部分.

注:创建该子类后,切记将其头文件引入到 AppDelegate 类中.

#import "AppDelegate.h"

// Share

#import "AppDelegate+UMShare.h"

其次,校验项目工程中是否配置正确相关参数.

再其次,便是具体 code 相关内容,将申请的相关 key 预先设置成宏准备好,方便使用和变更时进行调用和更改.
一.声明类中(.h)
1.将初始化的相关接口配置优先声明准备好,并在 AppDelegate 类中调用.
2.将调用分享的具体执行方法接口预留好,在需要调用的地方调用该方法.
步骤一:

#import "AppDelegate.h"

#import <UMShare/UMShare.h>

@interface AppDelegate (UMShare)

/**

 UMShare 注册

 @param launchOptions 应用程序

 */

- (void)registerUMShare:(NSDictionary *)launchOptions;

/**

 调用友盟相关方法

 @param controller 当前视图控件

 */

- (void)getUMShareRelevantMethodsWithCurrentViewController:(UIViewController *)controller;

/**

 调用友盟相关方法(带参)

 @param controller  当前视图控件

 @param data        参数(shareType:分享类型(默认:base,若需要自定义则将 base 变更为其它) & descr:备注说明文字 & webpageUrl:跳转链接地址)

 */

- (void)getUMShareRelevantMethodsWithCurrentViewController:(UIViewController *)controller AndParameter:(NSMutableDictionary *)data;

@end

步骤二:

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {

    // Override point for customization after application launch.

    // Share

    [self registerUMShare:launchOptions];

    // Root ViewController

    [self setRootViewController];

    // CoreData

    [[CoreDataManager sharedCoreDataManager] managedObjectContext];

    return YES;

}

二.实现类中(.m)
1.引入所需的头文件
2.实现声明类中接口
3.实现具体方法和代理事件

#import "AppDelegate+UMShare.h"

#import <UMShare/UMShare.h>

#import <UMCommon/UMCommon.h>

#import <UMCommonLog/UMCommonLogHeaders.h>

#import <UShareUI/UShareUI.h>

@implementation AppDelegate (UMShare)

/**

 UMShare 注册

 @param launchOptions 应用程序

 */

- (void)registerUMShare:(NSDictionary *)launchOptions {

    // UMConfigure 通用设置，请参考SDKs集成做统一初始化。

    // 以下仅列出U-Share初始化部分

    [self configUSharePlatforms];

    [self confitUShareSettings];

    BOOL isSetLog;

#ifdef DEBUG

    isSetLog = 0;

#else

    isSetLog = 1;

#endif

    // Log

    [UMCommonLogManager setUpUMCommonLogManager];

    [UMConfigure setLogEnabled:isSetLog];

    [UMConfigure initWithAppkey:UMSHARE_APPKEY channel:@"App Store"];

}

/**

 共享平台配置

 */

- (void)configUSharePlatforms {

    /*

     设置微信的 appKey 和 appSecret

     AppID:     xxxxxx

     AppSecret: xxxxxx

    申请相关参数的 URL:https://open.weixin.qq.com/

    腾讯相关 URL:https://open.tencent.com

     */

    [[UMSocialManager defaultManager] setPlaform:UMSocialPlatformType_WechatSession

                                          appKey:@"您项目申请的 key 值"

                                       appSecret:@"您项目申请的 Secret 值"

                                     redirectURL:@"您的官网门户链接即可"];

    /*

     设置分享到 QQ 互联的 appID

     U-Share SDK为了兼容大部分平台命名，统一用appKey和appSecret进行参数设置，而QQ平台仅需将appID作为U-Share的appKey参数传进即可。

     */

    [[UMSocialManager defaultManager] setPlaform:UMSocialPlatformType_QQ

                                          appKey:@"您项目申请的 key 值"  /*设置QQ平台的appID*/

                                       appSecret:@"您项目申请的 Secret 值"    /*QQ平台为appKey*/

                                     redirectURL:@"您的官网门户链接即可"];// aC5dY6D15Uz5wCv9

    /*

     * 移除相应平台的分享，如微信收藏

     */

//    [[UMSocialManager defaultManager] removePlatformProviderWithPlatformTypes:@[@(UMSocialPlatformType_WechatFavorite)]];

}

/**

 共享平台设置

 */

- (void)confitUShareSettings {

    [UMSocialGlobal shareInstance].isClearCacheWhenGetUserInfo = YES;

    /*

     * 打开图片水印

     */

//    [UMSocialGlobal shareInstance].isUsingWaterMark = YES;

    /*

     * 关闭强制验证https，可允许http图片分享，但需要在info.plist设置安全域名

     <key>NSAppTransportSecurity</key>

     <dict>

     <key>NSAllowsArbitraryLoads</key>

     <true/>

     </dict>

     */

//    [UMSocialGlobal shareInstance].isUsingHttpsWhenShareContent = NO;

}

/**

 调用友盟相关方法

 @param controller 当前视图控件

 */

- (void)getUMShareRelevantMethodsWithCurrentViewController:(UIViewController *)controller {

    // 设置预定义平台(即:需要分享至哪些平台就将其枚举值中的参数添加进数组中)

    NSArray *sharePlatforms = @[@(UMSocialPlatformType_WechatSession),

                                @(UMSocialPlatformType_WechatTimeLine),

                                @(UMSocialPlatformType_QQ)];

    [UMSocialUIManager setPreDefinePlatforms:sharePlatforms];

    kWeakSelf(self);

    // 显示分享面板

    [UMSocialUIManager showShareMenuViewInWindowWithPlatformSelectionBlock:^(UMSocialPlatformType platformType, NSDictionary *userInfo) {

        [weakself shareWebPageToPlatformType:platformType AndCurrentViewController:controller];

//        [weakself checkUserInfoForPlatform:platformType AndCurrentViewController:controller];

    }];

}

/**

 校验用户信息平台

 @param platformType 平台类型

 */

- (void)checkUserInfoForPlatform:(UMSocialPlatformType)platformType AndCurrentViewController:(UIViewController *)controller {

    kWeakSelf(self);

    [[UMSocialManager defaultManager] getUserInfoWithPlatform:platformType currentViewController:nil completion:^(id result, NSError *error) {

        // 当前设备 App 安装检测    [kApplication openURL:[NSURL URLWithString:@"weixin://"]] && [kApplication openURL:[NSURL URLWithString:@"mqq://"]]

        if ([kApplication openURL:[NSURL URLWithString:@"mqq://"]] && [kApplication openURL:[NSURL URLWithString:@"weixin://"]]) {// WeChat    @"weixin://"

            [weakself shareWebPageToPlatformType:platformType AndCurrentViewController:controller];

        }

        else {

            UIAlertView *alert = [[UIAlertView alloc] initWithTitle:@"提示"

                                                            message:@"当前设备未安装该程序"

                                                           delegate:nil

                                                  cancelButtonTitle:@"确定"

                                                  otherButtonTitles:nil, nil];

            [alert show];

            return;

        }

    }];

}

/**

 分享内容设置(网页)

注:此处包含多种分享种类样式的,具体根据需求选择具体方法;

方法实现大同小异,传递所需的参数和数据即可;

具体详见友盟接口中所对应的方法;

此 demo 是以分享网页链接为例,简单的图文介绍,点击后跳转进入预先设置好的 URL 链接.

 @param platformType 平台类型(网页)

 */

- (void)shareWebPageToPlatformType:(UMSocialPlatformType)platformType AndCurrentViewController:(UIViewController *)controller {

    // 创建分享消息对象

    UMSocialMessageObject *messageObj = [UMSocialMessageObject messageObject];

    // 创建网页内容对象

//    NSString *thumURL = @"http://xxx.png";// 注:URL 链接地址必须为 https,具体详见 confitUShareSettings 方法中注释掉的 code 部分

    NSDictionary *infoPlist = [[NSBundle mainBundle] infoDictionary];

    NSString *icon = [[infoPlist valueForKeyPath:@"CFBundleIcons.CFBundlePrimaryIcon.CFBundleIconFiles"] lastObject];

    UIImage *thumImg = [UIImage imageNamed:icon];

    UMShareWebpageObject *shareObj = [UMShareWebpageObject shareObjectWithTitle:@"分享标题" descr:@"分享内容描述" thumImage:thumImg];// 此处 thumImage 字段以当前 App 图标为例,若更换其它图片方法如此,支持 UIImage 或者 NSData 类型或者 image_url.

    // 设置网页地址

    shareObj.webpageUrl = @"http://xxxxxx";// 点击后欲跳转的 URL 链接地址

    // 分享消息对象设置分享内容对象

    messageObj.shareObject = shareObj;

    // 调用分享接口

    kWeakSelf(self);

    [[UMSocialManager defaultManager] shareToPlatform:platformType messageObject:messageObj currentViewController:controller completion:^(id result, NSError *error) {

        if (error) {

            NSLog(@"************Share fail with error *********\nError:%@", error);

        }

        else {

            NSLog(@"************UMShare************\nResponse data is:%@", result);

        }

        // Callback

        [weakself callbackAlterStateWithError:error];

    }];

}

/**

 分享内容设置(网页)

注:此处包含多种分享种类样式的,具体根据需求选择具体方法;

方法实现大同小异,传递所需的参数和数据即可;

具体详见友盟接口中所对应的方法;

此 demo 是以分享网页链接为例,简单的图文介绍,点击后跳转进入预先设置好的 URL 链接.

 @param platformType 平台类型(网页)

 @param controller 当前控件视图

 @param dataSource 分享数据

 */

- (void)shareWebPageToPlatformType:(UMSocialPlatformType)platformType AndCurrentViewController:(UIViewController *)controller AndShareInfoData:(NSMutableDictionary *)dataSource {

    /** 分享类型(base 则分享默认内容)*/

    NSString *shareType = [NSString stringWithFormat:@"%@", [dataSource objectForKey:@"shareType"]];

    NSDictionary *infoPlist = [[NSBundle mainBundle] infoDictionary];

    NSString *icon = [[infoPlist valueForKeyPath:@"CFBundleIcons.CFBundlePrimaryIcon.CFBundleIconFiles"] lastObject];

    NSString *strTitle = @"分享标题";

    NSString *strDescr = @"分享内容描述";

    NSString *strWebpageUrl = @"分享链接地址";// 即:点击分享详情后跳转至相对应的 URL 链接地址

    if ([shareType isEqualToString:@"custom"]) {// 分享类型:自定义

        strTitle = [NSString stringWithFormat:@"%@", [dataSource objectForKey:@"title"]];

        strDescr = [NSString stringWithFormat:@"%@", [dataSource objectForKey:@"descr"]];

        strWebpageUrl = [NSString stringWithFormat:@"%@", [dataSource objectForKey:@"webpageUrl"]];

        icon = [NSString stringWithFormat:@"%@", [dataSource objectForKey:@"imgUrl"]];// 注:该字段必须为 https,详见 confitUShareSettings 方法

        if (kStringIsEmpty(icon)) {

            icon = [[infoPlist valueForKeyPath:@"CFBundleIcons.CFBundlePrimaryIcon.CFBundleIconFiles"] lastObject];

        }

    }

    // 创建分享消息对象

    UMSocialMessageObject *messageObj = [UMSocialMessageObject messageObject];

    // 创建网页内容对象

    UIImage *thumImg = [UIImage imageNamed:icon];

    UMShareWebpageObject *shareObj = [UMShareWebpageObject shareObjectWithTitle:strTitle

                                                                          descr:strDescr

                                                                      thumImage:thumImg];

    // 设置网页地址

    shareObj.webpageUrl = strWebpageUrl;

    // 分享消息对象设置分享内容对象

    messageObj.shareObject = shareObj;

    // 调用分享接口

    kWeakSelf(self);

    [[UMSocialManager defaultManager] shareToPlatform:platformType messageObject:messageObj currentViewController:controller completion:^(id result, NSError *error) {

        if (error) {

            NSLog(@"************Share fail with error *********\nError:%@", error);

        }

        else {

            NSLog(@"************UMShare************\nResponse data is:%@", result);

        }

        // Callback

        [weakself callbackAlterStateWithError:error];

    }];

}

/**

 回调分享状态

 @param error 异常

 */

- (void)callbackAlterStateWithError:(NSError *)error {

    NSString *callback = nil;

    if (error) {

        NSString *strError = [self callbackErrorWithErrorCode:error.code];

        if (kStringIsEmpty(strError)) {

            callback = @"分享失败";

        }

        else {

            callback = strError;

        }

    }

    else {

        callback = @"分享成功";

    }

    // Show

    UIAlertView *alert = [[UIAlertView alloc] initWithTitle:@"欢迎使用【xxx App 名称】"

                                                    message:callback

                                                   delegate:nil

                                          cancelButtonTitle:@"确定"

                                          otherButtonTitles: nil, nil];

    [alert show];

}

/**

 回调异常提示

 http://dev.umeng.com/wsq/android/errorcode

 @param code    异常代码

 @return        异常提示

 */

- (NSString *)callbackErrorWithErrorCode:(NSInteger)code {

    NSString *result = nil;

    if (code == 10002) {

        result = @"用户不存在";

    }

    else if (code == 10003) {

        result = @"用户未登录";

    }

    else if (code == 10004) {

        result = @"用户没有执行操作的权限";

    }

    else if (code == 10005) {

        result = @"用户的id无效";

    }

    else if (code == 10006) {

        result = @"用户已经被创建";

    }

    else if (code == 10007) {

        result = @"已经关注过该用户";

    }

    else if (code == 10008) {

        result = @"注册时用户信息不完整";

    }

    else if (code == 10009) {

        result = @"用户不能关注自己";

    }

    else if (code == 10010) {

        result = @"用户名长度超出范围，用户名为2~20个字符";

    }

    else if (code == 10011) {

        result = @"用户不可用";

    }

    else if (code == 10012) {

        result = @"用户名存在敏感词";

    }

    else if (code == 10013) {

        result = @"用户已经存在";

    }

    else if (code == 10014) {

        result = @"用户自定义字段从长度超出范围";

    }

    else if (code == 10015) {

        result = @"该操作一次只能被一个用户操作";

    }

    else if (code == 10016) {

        result = @"用户名存在非法字符";

    }

    else if (code == 10017) {

        result = @"用户设备在黑名单中";

    }

    else if (code == 10018) {

        result = @"该用户收藏 feed 数量最多50条";

    }

    else if (code == 10019) {

        result = @"该 feed 已经被收藏";

    }

    else if (code == 10020) {

        result = @"该 feed 还未被收藏";

    }

    else {

        result = @"";

    }

    return result;

}

/*

 case UMSocialPlatformErrorType_Unknow:

 result = @"未知错误";

 break;

 case UMSocialPlatformErrorType_NotSupport:

 result = @"不支持（url scheme 没配置，或者没有配置-ObjC， 或则SDK版本不支持或则客户端版本不支持";

 break;

 case UMSocialPlatformErrorType_AuthorizeFailed:

 result = @"授权失败";

 break;

 case UMSocialPlatformErrorType_ShareFailed:

 result = @"分享失败";

 break;

 case UMSocialPlatformErrorType_RequestForUserProfileFailed:

 result = @"请求用户信息失败";

 break;

 case UMSocialPlatformErrorType_ShareDataNil:

 result = @"分享内容为空";

 break;

 case UMSocialPlatformErrorType_ShareDataTypeIllegal:

 result = @"分享内容不支持";

 break;

 case UMSocialPlatformErrorType_CheckUrlSchemaFail:

 result = @"schemaurl fail";

 break;

 case UMSocialPlatformErrorType_NotInstall:

 result = @"应用未安装";

 break;

 case UMSocialPlatformErrorType_Cancel:

 result = @"您已取消分享";

 break;

 case UMSocialPlatformErrorType_NotNetWork:

 result = @"网络异常";

 break;

 case UMSocialPlatformErrorType_SourceError:

 result = @"第三方错误";

 break;

 case UMSocialPlatformErrorType_ProtocolNotOverride:

 result = @"对应的    UMSocialPlatformProvider的方法没有实现";

 break;

 default:

 */

#pragma mark - Callback

// 兼容所有 iOS 设备

- (BOOL)application:(UIApplication *)application openURL:(NSURL *)url sourceApplication:(NSString *)sourceApplication annotation:(id)annotation {

    //注：该方法为建议使用的系统openURL回调，且 新浪 平台仅支持以上回调。还有以下两种回调方式，如果开发者选取以下回调，也请补充相应的函数调用。

    //6.3的新的API调用，是为了兼容国外平台(例如:新版facebookSDK,VK等)的调用[如果用6.2的api调用会没有回调],对国内平台没有影响

    BOOL result = [[UMSocialManager defaultManager] handleOpenURL:url

                                                sourceApplication:sourceApplication

                                                       annotation:annotation];

    if (!result) {

        // 其他如支付等SDK的回调

    }

    return result;

}

//仅支持iOS9以上系统，iOS8及以下系统不会回调

- (BOOL)application:(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;

}

- (BOOL)application:(UIApplication *)app handleOpenURL:(nonnull NSURL *)url {

    BOOL result = [[UMSocialManager defaultManager] handleOpenURL:url];

    if (!result) {

        // 其他如支付等SDK的回调

    }

    return result;

}

@end

最后,分享相关方法实现完毕后,便到了最终调用如上方法实现具体需求功能的时刻,定位到所需分享的代码块部分,调用之前预先预留好的接口方法即可.

#pragma mark - 缩写

#define kApplication        [UIApplication sharedApplication]

#define kKeyWindow          [UIApplication sharedApplication].keyWindow

#define kAppDelegate        ((AppDelegate*)[UIApplication sharedApplication].delegate)

#define kUserDefaults       [NSUserDefaults standardUserDefaults]

#define kNotificationCenter [NSNotificationCenter defaultCenter]

[kAppDelegate getUMShareRelevantMethodsWithCurrentViewController:self];

以上便是此次分享的全部内容,较为简易的分享小结,具体还以实际需求为准,可以自行 diy 调整,希望对大家有所帮助,也希望大神多多指点共进步!

巴特西

友盟分享小结 - iOS

最新文章

热门文章