/LDSDKManager_IOS

对应用中集成的第三方SDK（目前包括QQ,微信,易信,支付宝）进行集中管理，按照功能（目前包括第三方登录,分享,支付）开放给各个产品使用。通过接口的方式进行产品集成，方便对第三方SDK进行升级维护。

Primary LanguageObjective-CMIT LicenseMIT

LDSDKManager

===============

对应用中集成的第三方SDK（目前包括QQ,微信,易信,支付宝）进行集中管理，按照功能（目前包括第三方登录,分享,支付）开放给各个产品使用。通过接口的方式进行产品集成，方便对第三方SDK进行升级维护。

提供扩展SDK的方式，方便往组件中扩展集成更多的SDK；

如何集成LDSDKManager

采用Pod集成：在项目工程的Podfile文件中加载LDSDKManager库：

pod 'LDSDKManager' :git => 'https://github.com/Lede-Inc/LDSDKManager_IOS.git'

如何使用LDSDKManager

通过pod或者代码拷贝manager代码到工程之后，即可通过如下方式调用SDKManager管理的功能：

  1. 在应用的appdelegate的didFinishLaunchingWithOptions函数中配置SDK的初始化参数，格式示例：(运行Demo时需要填补对应SDK申请的key和secret，并在工程中配置从sdk应用回调的scheme)

     NSArray *regPlatformConfigList = @[
 @{
     LDSDKConfigAppIdKey:@"微信appid",
     LDSDKConfigAppSecretKey:@"微信appsecret",
     LDSDKConfigAppDescriptionKey:@"应用描述",
     LDSDKConfigAppPlatformTypeKey:@(LDSDKPlatformWeChat)
 },
 @{
     LDSDKConfigAppIdKey:@"QQ appid",
     LDSDKConfigAppSecretKey:@"qq appkey",
     LDSDKConfigAppPlatformTypeKey:@(LDSDKPlatformQQ)
 },
 @{
     LDSDKConfigAppIdKey:@"易信appid",
     LDSDKConfigAppSecretKey:@"易信appsecret",
     LDSDKConfigAppPlatformTypeKey:@(LDSDKPlatformYiXin)
 },
 @{
     LDSDKConfigAppSchemeKey:@"支付宝 appScheme",
     LDSDKConfigAppPlatformTypeKey:@(LDSDKPlatformAliPay)
 },
 ];
 [LDSDKManager registerWithPlatformConfigList:regPlatformConfigList];

    获取各项服务的方式： /*! * @brief 获取配置服务 */ + (id)getRegisterService:(LDSDKPlatformType)type;

     /*!
 *  @brief  获取登陆服务
 */
 + (id)getAuthService:(LDSDKPlatformType)type;

 /*!
 *  @brief  获取分享服务
 */
 + (id)getShareService:(LDSDKPlatformType)type;

 /*!
 *  @brief  获取支付服务
 */
 + (id)getPayService:(LDSDKPlatformType)type;

  2. 配置应用回调时，首先配置info.plist中的URL types，然后在appdelegate中添加代码：

     -(BOOL)application:(UIApplication *)application handleOpenURL:(NSURL *)url
 {
     return [LDSDKManager handleOpenURL:url];
 }
 
 -(BOOL)application:(UIApplication *)application openURL:(NSURL *)url sourceApplication:(NSString *)sourceApplication annotation:(id)annotation
 {
     return [LDSDKManager handleOpenURL:url];
 }

    我们同时提供独立的处理回调方法：

     [[LDSDKManager getRegisterService:(LDSDKPlatformType)type] handleResultUrl:(NSURL *)url];

 //对于支付宝，可以针对结果进行进一步的处理
 [[LDSDKManager getPayService:(LDSDKPlatformType)type] payProcessOrderWithPaymentResult:(NSURL *)url standbyCallback:(void (^)(NSDictionary *))callback];

  3. 需要登陆时，提供对应函数及回调：

     /*!
  *  @brief  第三方SDK登录回调
  *
  *  @param oauthInfo 登录口令信息
  *  @param userInfo  第三方用户基本信息
  *  @param error
  */
 typedef void(^LDSDKLoginCallback)(NSDictionary *oauthInfo, NSDictionary *userInfo, NSError *error);

 //判断该平台是否支持登陆
 [[LDSDKManager getAuthService:(LDSDKPlatformType)type] isLoginEnabledOnPlatform]；

 //登陆
 [[LDSDKManager getAuthService:(LDSDKPlatformType)type] loginToPlatformWithCallback:(LDSDKLoginCallback)callback];

  4. 需要分享时，提供对应函数及回调：

     /*!
  *  @brief  第三方SDK分享回调
  *
  *  @param success 是否分享成功
  *  @param error
  */
 typedef void(^LDSDKShareCallback)(BOOL success, NSError *error);

 /*!
 *  @brief  分享到指定平台
 *  @param content  分享内容
 *  @param shareModule 分享子平台，目前主要包括好友和朋友圈（空间）两部分
 *  @param complete  分享之后的回调
 */
 [[LDSDKManager getShareService:(LDSDKPlatformType)type] shareWithContent:(NSDictionary *)content
                                                                 shareModule:(NSUInteger)shareModule
                                                                  onComplete:(LDSDKShareCallback)complete];

 //分享内容字典的key
 FOUNDATION_EXTERN NSString *const LDSDKShareContentTitleKey;
 FOUNDATION_EXTERN NSString *const LDSDKShareContentDescriptionKey;
 FOUNDATION_EXTERN NSString *const LDSDKShareContentImageKey;
 FOUNDATION_EXTERN NSString *const LDSDKShareContentWapUrlKey;
 FOUNDATION_EXTERN NSString *const LDSDKShareContentTextKey;

  5. 需要支付时，提供对应函数：

     /*!
  *  @brief  第三方SDK支付回调
  *
  *  @param signString 签名字符串
  *  @param error
  */
 typedef void(^LDSDKPayCallback)(NSString *signString, NSError *error);

 /**
  *  支付
  *
  *  @param payType     支付类型，支付宝或微信
  *  @param orderString 签名后的订单信息字符串
  *  @param callback    回调
  */
 [[LDSDKManager getPayService:(LDSDKPlatformType)type] payOrder:(NSString *)orderString callback:(LDSDKPayCallback)callback;

LDSDKManager的框架层次

LDSDKManager目前有五个submodule，分别是CoreService，QQService，WechatService，YixinService，AlipayService。后边四个分别整合了QQSDK、微信SDK、易信SDK以及支付宝SDK，他们都依赖于CoreService。

整合的优点在于： 1. 开发者无需调用SDK头文件，方便SDK的升级； 2. 易拓展，可以通过增加模块使得开发者无需修改代码即可支持更多的第三方SDK。

如何新增一个第三方SDK

  1. 如果是已有的模块，导入子模块即可；

  2. 如果要导入新的SDK，实现步骤：

     SDKManager中LDSDKPlatformType添加相应type；
 建立新文件夹，导入SDK文件，编写代码实现[SDKServiceInterface文件夹](LDSDKManager/CoreService/SDKServiceInterface) 中的protocol;
 修改SDKServiceConfig.plist，添加新SDK支持的Service以及对应实现的文件名。

Author

张海洋, zhanghaiyang@corp.netease.com, 庞辉, huipang@corp.netease.com

License

LDSDKManager is available under the MIT license. See the LICENSE file for more info.