版本记录
| 版本号 | 时间 |
|---|---|
| V1.0 | 2018.04.05 |
前言
相信很多人用过友盟，包括友盟的第三方登录、分享以及统计。这里我们就分几个模块进行详细的说明 —— 移动统计
（U - App）、网站统计（U - Web）、消息推送（U - Push）、社会化分享（U - Share）、游戏统计（U - Game）、互联网运营数据服务（Dplus）- 多维度、一站式、精细化数据管理服务。感兴趣的可以看上面几篇。
1. 友盟集成（一） —— UShare模块之快速集成（一）
2. 友盟集成（二） —— UShare模块之快速集成（二）
3. 友盟集成（三） —— UShare模块之第三方登录（一）
4. 友盟集成（四） —— UShare模块之进阶说明之第三方平台SDK说明（一）
5. 友盟集成（五） —— UShare模块之进阶说明之分享到第三方平台（二）
分享面板UI
1. 分享面板注意事项
由于 1. 创建Xcode项目会默认添加Main.storyboard作为Main Interface(General - Deployment Info)，也就是项目的主Window。 2. 如果没使用Main.storyboard而又另外在AppDelegate中创建了UIWindow对象，如
self.window = [[UIWindow alloc] initWithFrame:[UIScreen mainScreen].bounds]
如果项目中同时出现Main Interface以及代码创建UIWindow会导致分享面板无法正常弹出，解决方法是移除其一即可。
2. 调用分享面板
#import <UShareUI/UShareUI.h>
//显示分享面板
[UMSocialUIManager showShareMenuViewInWindowWithPlatformSelectionBlock:^(UMSocialPlatformType platformType, NSDictionary *userInfo) {
// 根据获取的platformType确定所选平台进行下一步操作
}];
使用
presentViewController或其他无法显示分享面板的情况参考设置分享面板代理一节修改父窗口回调为self.view或其他指定视图。
3. 设置分享面板代理
代理协议如下
@protocol UMSocialShareMenuViewDelegate <NSObject>
@optional
/**
* 分享面板显示的回调
*/
- (void)UMSocialShareMenuViewDidAppear;
/**
* 分享面板的消失的回调
*/
- (void)UMSocialShareMenuViewDidDisappear;
/**
* 返回分享面板的父窗口,用于嵌入在父窗口上显示
*
* @param defaultSuperView 默认加载的父窗口
*
* @return 返回实际的父窗口
* @note 返回的view应该是全屏的view，方便分享面板来布局。
* @note 如果用户要替换成自己的ParentView，需要保证该view能覆盖到navigationbar和statusbar
* @note 当前分享面板已经是在window上,如果需要切换就重写此协议，如果不需要改变父窗口则不需要重写此协议
*/
- (UIView*)UMSocialParentView:(UIView*)defaultSuperView;
@end
可以更改分享面板的父窗口（示例）
/* 上下文 */
// self继承自UIViewController
[UMSocialUIManager setShareMenuViewDelegate:self];
/* 上下文 */
//不需要改变父窗口则不需要重写此协议
- (UIView*)UMSocialParentView:(UIView*)defaultSuperView
{
return defaultSuperView;
}
4. 自定义分享面板预定义平台（顺序）
Objective-C
#import <UShareUI/UShareUI.h>
[UMSocialUIManager setPreDefinePlatforms:@[@(UMSocialPlatformType_Sina),@(UMSocialPlatformType_QQ),@(UMSocialPlatformType_WechatSession)]];
[UMSocialUIManager showShareMenuViewInWindowWithPlatformSelectionBlock:^(UMSocialPlatformType platformType, NSDictionary *userInfo) {
// 根据获取的platformType确定所选平台进行下一步操作
}];
swift
//调用setPreDefinePlatforms的示例
UMSocialUIManager.setPreDefinePlatforms([NSNumber(integerLiteral:UMSocialPlatformType.wechatSession.rawValue),NSNumber(integerLiteral:UMSocialPlatformType.QQ.rawValue),NSNumber(integerLiteral:UMSocialPlatformType.sina.rawValue)])
- 此函数需要在
showShareMenuViewInWindowWithPlatformSelectionBlock之前调用 - 传入的平台必须是合法并且是core模块已经检测到的已经存在的平台，不然会被过滤掉(此条款是上线appStore审核的条件，开发者必须注意)
5. 自定义分享面板样式
用户可以根据需求来自定义分享面板，分享面板分有四个主体控件：
-
UMSocialShareTitleView title控件 -
UMSocialSharePageScrollView分页控件 -
UMSocialSharePageControl PageControl控件 -
UMSocialShareCancelControl CancelControl控件
每个控件对应相应的配置类，方便用户通过配置参数来调整控件的外观。 每个控件的配置类如下:
UMSocialShareTitleView --> UMSocialShareTitleViewConfig
UMSocialSharePageScrollView --> UMSocialSharePageScrollViewConfig
UMSocialSharePageControl --> UMSocialSharePageControlConfig
UMSocialShareCancelControl --> UMSocialShareCancelControlConfig
UMSocialShareTitleViewConfig 的参数如下:
BOOL isShow;//是否显示
NSString* shareTitleViewTitleString;//标题的文字
UIFont* shareTitleViewFont;//字体
UIColor* shareTitleViewTitleColor;//文字颜色
UIColor* shareTitleViewBackgroundColor;//背景颜色
CGFloat shareTitleViewPaddingTop;//title的内边距top
CGFloat shareTitleViewPaddingBottom;//title的内边距Bottom
UMSocialSharePageScrollViewConfig 的参数如下:
CGFloat shareScrollViewPageMaxItemWidth; //每页Items的最大宽度
CGFloat shareScrollViewPageMaxItemHeight; //每页Items的最大高度
UMSocialPlatformItemViewBackgroudType shareScrollViewPageItemStyleType;//每个Item的背景类型
CGFloat shareScrollViewPageMaxRowCountForPortraitAndBottom; //每页显示最大的行(在底部显示手机处于肖像模式)
CGFloat shareScrollViewPageMaxColumnCountForPortraitAndBottom; //每页显示最大的列(在底部显示手机处于肖像模式)
....
UMSocialSharePageControlConfig 的参数如下:
BOOL isShow;//是否显示
UIColor* sharePageControlPageIndicatorTintColor;//指示器颜色
UIColor* sharePageControlCurrentPageIndicatorTintColor;//当前的页的颜色
BOOL sharePageControlHidesForSinglePage;//为一页是会隐藏
UIColor* sharePageControlBackgroundColor;//背景色
UMSocialShareCancelControlConfig的参数如下:
BOOL isShow;//是否显示
NSString* shareCancelControlText;//相对父view的左边距
UIColor* shareCancelControlTextColor;//文字颜色
UIFont* shareCancelControlTextFont;//文字字体
UIColor* shareCancelControlBackgroundColor;//背景颜色;
示例代码如下： 要修改当前分享面板为:无titleview，面板显示再中间，肖像模式下的2行3列，风景模式2行6列，没有取消控件。
//配置上面需求的参数
[UMSocialShareUIConfig shareInstance].shareTitleViewConfig.isShow = NO;
[UMSocialShareUIConfig shareInstance].sharePageGroupViewConfig.sharePageGroupViewPostionType = UMSocialSharePageGroupViewPositionType_Middle;
[UMSocialShareUIConfig shareInstance].sharePageScrollViewConfig.shareScrollViewPageMaxRowCountForPortraitAndMid = 2;
[UMSocialShareUIConfig shareInstance].sharePageScrollViewConfig.shareScrollViewPageMaxColumnCountForPortraitAndMid = 3;
[UMSocialShareUIConfig shareInstance].sharePageScrollViewConfig.shareScrollViewPageMaxRowCountForLandscapeAndMid = 2;
[UMSocialShareUIConfig shareInstance].sharePageScrollViewConfig.shareScrollViewPageMaxColumnCountForLandscapeAndMid = 6;
[UMSocialShareUIConfig shareInstance].shareCancelControlConfig.isShow = NO;
//调用分享面板
[UMSocialUIManager showShareMenuViewInWindowWithPlatformSelectionBlock:^(UMSocialPlatformType platformType, NSDictionary *userInfo) {
// 根据获取的platformType确定所选平台进行下一步操作
}];
示例代码：
要修改当前分享面板为:分享面板的滑动的区域的背景色为红色，每页的背景色为黄色，去掉毛玻璃效果。
//配置上面需求的参数
//shareScrollView背景色为红色
[UMSocialShareUIConfig shareInstance].sharePageScrollViewConfig.shareScrollViewBackgroundColor = [UIColor redColor];
//每页的背景颜色为黄色
[UMSocialShareUIConfig shareInstance].sharePageScrollViewConfig.shareScrollViewPageBGColor = [UIColor yellowColor];
//去掉毛玻璃效果
[UMSocialShareUIConfig shareInstance].shareContainerConfig.isShareContainerHaveGradient = NO;
//调用分享面板
[UMSocialUIManager showShareMenuViewInWindowWithPlatformSelectionBlock:^(UMSocialPlatformType platformType, NSDictionary *userInfo) {
// 根据获取的platformType确定所选平台进行下一步操作
}];
分享面板已适配iOS和iPad，用户可以在此基础上微调一些参数来定制特有风格的分享面板。
每个对应的控件都可以独立设置，并且用户可自定义不同风格的控件外观。
6. 自定义分享面板中的icon与事件
分享面板可支持加入其他功能的图标，可处理自定义逻辑。
如在分享面板后面加一个“copy”功能。（注意每个在分享面板上显示的icon对应一个平台以UMSocialPlatformType类型作为标记） 假定“copy”功能需要设置一个UMSocialPlatformType类型为:UMSocialPlatformType_UserDefine_Begin+2
代码如下：
//加入copy的操作
//@see http://dev.umeng.com/social/ios/进阶文档#6
[UMSocialUIManager addCustomPlatformWithoutFilted:UMSocialPlatformType_UserDefine_Begin+2
withPlatformIcon:[UIImage imageNamed:@"auth_icon"]
withPlatformName:@"copy"];
[UMSocialShareUIConfig shareInstance].sharePageGroupViewConfig.sharePageGroupViewPostionType = UMSocialSharePageGroupViewPositionType_Bottom;
[UMSocialShareUIConfig shareInstance].sharePageScrollViewConfig.shareScrollViewPageItemStyleType = UMSocialPlatformItemViewBackgroudType_None;
[UMSocialUIManager showShareMenuViewInWindowWithPlatformSelectionBlock:^(UMSocialPlatformType platformType, NSDictionary *userInfo) {
//在回调里面获得点击的
if (platformType == UMSocialPlatformType_UserDefine_Begin+2) {
NSLog(@"do your operation for copy");
}
else{
[self runShareWithType:platformType];
}
}];
用户设置图标时，需要和保持预定于的图标大小一样，以保持样式统一。
后记
本篇主要介绍了UShare模块之进阶说明之分享面板UI，感兴趣的给个赞或者关注~~~
