友盟分享小结 - iOS

Posted survivors

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了友盟分享小结 - iOS相关的知识,希望对你有一定的参考价值。

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

 

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

技术分享图片

技术分享图片

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

#import "AppDelegate.h"
// Share
#import "AppDelegate+UMShare.h"
#import <UMCommon/UMCommon.h>
#import <UMCommonLog/UMCommonLogHeaders.h>

 

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

技术分享图片

技术分享图片

 

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

#import "AppDelegate.h"
#import <UMShare/UMShare.h>
 
@interface AppDelegate (UMShare)
 
/**
 共享平台配置
 */
- (void)configUSharePlatforms;
 
/**
 共享平台设置
 */
- (void)confitUShareSettings;
 
/**
 调用友盟相关方法
 
 @param controller 当前视图控件
 */
- (void)getUMShareRelevantMethodsWithCurrentViewController:(UIViewController *)controller;
 
@end

步骤二:

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    // Override point for customization after application launch.
    
    // Share
    [self registerShare];
    // Root ViewController
    [self setRootViewController];
    
    // CoreData
    [[CoreDataManager sharedCoreDataManager] managedObjectContext];
    
    return YES;
}
 
/**
 注册分享 - 初始化
 */
- (void)registerShare {
    // UMConfigure 通用设置,请参考SDKs集成做统一初始化。
    // 以下仅列出U-Share初始化部分
    [self configUSharePlatforms];
    [self confitUShareSettings];
    // Log
    [UMCommonLogManager setUpUMCommonLogManager];
    [UMConfigure setLogEnabled:YES];
    [UMConfigure initWithAppkey:USHARE_APPKEY channel:@"App Store"];
}

 

二.实现类中(.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)
 
/**
 共享平台配置
 */
- (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 *********
Error:%@", error);
        }
        else {
            NSLog(@"************UMShare************
Response 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的主要内容,如果未能解决你的问题,请参考以下文章

iOS开发——iOS10升级极光推送SDK友盟分享SDK

iOS 友盟分享

如何使用友盟 Cocos2d-x 分享组件实现 Android/iOS 分享功能

IOS 集成友盟分享

友盟分享适配iOS9

iOS 第三方分享Twitter授权的错误解决(友盟分享)