版本记录
| 版本号 | 时间 |
|---|---|
| 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模块之进阶说明之分享到第三方平台（二）
6. 友盟集成（六） —— UShare模块之进阶说明之分享面板UI（三）
自定义平台
1. 自定义的平台类型的选取
U-Share SDK已经为用户提供了主流的预定义平台，对这些平台已经做了优化和封装，比如：新浪，微信，QQ等。
详细的平台类型可以查看UMSocialPlatformType的枚举类型，方便用户直接导入后使用。
用户自定义平台类型取值范围在UMSocialPlatformType_UserDefine_Begin到UMSocialPlatformType_UserDefine_End之间，不包括边界。
例如：用户自定义平台的取值为: UMSocialPlatformType_UserDefine_Begin+1
2. 平台基类UMSocialHandler的功能介绍
UMSocialHandler是实现每个平台的基础类，其功能如下:
- 实现了最基础的平台协议
UMSocialPlatformProvider
请查看
UMSocialPlatformProvider的协议内容
- 检查平台的前缀
查找URLScheme前缀的功能
-(BOOL)searchForURLSchemeWithPrefix:(NSString *)prefix;
- 缓存对应的
appkey,appSecret,redirectURL
-(void)setAppId:(NSString *)appID appSecret:(NSString *)secret url:(NSString *)url;
- 保存用户的授权信息。
-(void)saveuid:(NSString *)uid openid:(NSString *)openid accesstoken:(NSString *)token refreshtoken:(NSString *)retoken expiration:(id )expiration;
- 增加了平台的配置项用来限制分享内容(对超过的文本截断和超大图片的裁剪)
请查看
UMSocialHandlerConfig的class
3. 创建自定义平台的类
用户需要继承UShareSDK的基类UMSocialHandler ,该基类提供了基础框架功能，方便用户使用其功能。
用户自定义的类以UMSocialTemplateHandler为例子给用户示例：
用户继承UMSocialHandler类后，需要实现最基本的三个基础函数，
- 单例的类函数，函数名如下:
+ (UMSocialTemplateHandler *)defaultManager; - 重载load方法。
- 当前平台对应的平台类型。
单例类的函数名必须要defaultManager，此规则必须注意
代码如下:
+(void)load
{
[super load];
}
+(NSArray*) socialPlatformTypes
{
return @[@(UMSocialPlatformType_UserDefine_Begin+1)];
}
+ (UMSocialTemplateHandler *)defaultManager
{
static UMSocialTemplateHandler *instance = nil;
static dispatch_once_t onceToken;
dispatch_once(&onceToken, ^{
if (!instance) {
instance = [[self alloc] init];
}
});
return instance;
}
这些方法调用都是固定的，用户可以自行拷贝代码，替换成自己的类名(UMSocialTemplateHandler)和平台类型(UMSocialPlatformType_UserDefine_Begin+1)
4. 实现自定义平台类的协议
接下来需要实现UMSocialPlatformProvider 定义的协议在UMSocialTemplateHandler类中重写协议如下:
- 初始化sdk的
appKey，appSecret，redirectURL。
-(void)umSocial_setAppKey:(NSString*)appKey
withAppSecret:(NSString *)appSecret
withRedirectURL:(NSString *)redirectURL
- 删除缓存授权数据。
- (void)umSocial_clearCacheData
- 授权
-(void)umSocial_AuthorizeWithUserInfo:(NSDictionary *)userInfo
withViewController:(UIViewController*)viewController
withCompletionHandler:(UMSocialRequestCompletionHandler)completionHandler
- 取消授权
-(void)umSocial_cancelAuthWithCompletionHandler:(UMSocialRequestCompletionHandler)completionHandler
- 分享
-(void)umSocial_ShareWithObject:(UMSocialMessageObject *)messageObject withCompletionHandler:(UMSocialRequestCompletionHandler)completionHandler
- 获得用户信息
-(void)umSocial_RequestForUserProfileWithCompletionHandler:(UMSocialRequestCompletionHandler)completionHandler
- 获得从sso或者web端回调到本app的回调
-(BOOL)umSocial_handleOpenURL:(NSURL *)url
- 返回平台的版本
-(NSString *)umSocial_PlatformSDKVersion
- 当前平台app是否安装
-(BOOL)umSocial_isInstall
- 当前平台是否可以分享
-(BOOL)umSocial_isSupport
- 检查urlschema
-(BOOL)checkUrlSchema
5. 自定义平台的代码模板
只要按照上面的文档给出的步凑来实现就可以实现该用户自定义的平台类，UShare给出了用户自定义的类的模板类:
UMSocialTemplateHandler.h,
UMSocialTemplateHandler.m,
用户可以下载模板文件修改成自己的类名和平台类型，在对应的函数调用处实现自己的方法。 至此用户自定义的平台类已经实现完毕。
后记
本篇主要介绍了UShare模块之进阶说明之自定义平台，感兴趣的给个赞或者关注~~~~
