友盟分享小结 - 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的主要内容,如果未能解决你的问题,请参考以下文章