Skip to content

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

License

Lede-Inc/LDSDKManager_IOS

Repository files navigation

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.

About

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

Resources

License

Stars

Watchers

Forks

Packages

No packages published