友盟分享小结 - iOS
因之前都写在了 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 调整,希望对大家有所帮助,也希望大神多多指点共进步!
