开发IOS SDK注意事项
2016-07-12 12:02
441 查看
注意事项一:所有类名都应该加前缀
说明:没有前缀的类名有冲突的风险。Bad Case:微信分享的 SDK,文件名:
WXApiObject.h,代码如下,其中
BaseReq类和
BaseResp类都没有加前缀。
@interface BaseReq : NSObject /** 请求类型 */ @property (nonatomic, assign) int type; /** 由用户微信号和 AppID 组成的唯一标识,发送请求时第三方程序必须填写,用于校验微信用户是否换号登录 */ @property (nonatomic, retain) NSString* openID; @end #pragma mark - BaseResp /*! @brief 该类为微信终端 SDK 所有响应类的基类 * */ @interface BaseResp : NSObject /** 错误码 */ @property (nonatomic, assign) int errCode; /** 错误提示字符串 */ @property (nonatomic, retain) NSString *errStr; /** 响应类型 */ @property (nonatomic, assign) int type; @end |
注意事项二:所有 category 方法加前缀
说明:category 方法如果不加前缀,有冲突的风险。Bad Case:腾讯分享的 SDK,它为 NSArray 增加了一个 JSONArray 的 category,造成我们本身的同名 category 被覆盖。另外他们为 NSArray 增加的其它 category 和著名的 Cordova 开源库冲突,造成 Cordova 无法使用。
注意事项三:不要将第三方库打包进 SDK
说明:尽量不要将第三方库打包进 SDK,如果要打包,最好也要将该第三方库重命名,以避免冲突。Bad Case:小米的推送 SDK,直接在 SDK 静态库里面编进去一个第三方依赖库,而且这个库还是 ASIHttpRequest。ASIHttp 当前已经处于无人维护状态,很多 Bug 都是大家自己在修复(例如网易就自己维护了一个 ASIHttpRequest 的分支)。在 SDK 中依赖这种库还是比较麻烦的。
注意事项四:做基本的检查和测试
说明:SDK 对外公布前应该进行基本的编译检查,不应该有编译器警告存在。Bad Case:腾讯分享的 SDK。它的
CGIParamsWrap.o和
TencentOAuth.o文件里面的方法名冲突了,如下所示:
ld: warning: instance method ‘deleteAPIRequestBySeq:’ in category from /Users/tangqiao/work/iphone/solar-ios/lib_common/TencentOpenApi/TencentOpenAPI.framework/TencentOpenAPI(CGIParamsWrap.o) overrides method from class in /Users/tangqiao/work/iphone/solar-ios/lib_common/TencentOpenApi/TencentOpenAPI.framework/TencentOpenAPI(TencentOAuth.o)
注意事项五:文档完整并且正确
说明:这就不用解释了吧?Bad Case: 微信官方的微信支付的示例代码,里面有各种错误,代码都无法编译成功。如下所示的是其中一个错误:
于是还有人专门帮微信另外制作了一个非官方的说明文档,地址在这里:https://github.com/gbammc/WechatPayDemo
注意事项六:支持最新的 CPU 版本
说明:去年苹果的一次 Bug,造成上传应用必须支持 arm64 的 CPU 版本,结果众多应用因为依赖的 SDK 不支持 arm64 而无法更新。当然,这次 Bug 出来之后,各 SDK 厂商都紧急做了更新。但是我觉得这种事情如果要做得专业,就应该一开始就紧跟技术更新,及时更新,而不是被迫更新。相关文章推荐
- Xcode 和 SDK各个版本的下载地址
- iOS 微信支付
- 【ios 汇总 - 操作文件常用方法】 (NSFileManager NSFileHandle NSData)
- 【ios 汇总 - UI 视图布局 】
- 【ios 汇总 你可能不知道的调试技巧】
- Use GraceNote SDK in iOS(二)获取音乐的完整信息
- Delphi调用IOS三方SDK(OC的静态库文件)
- 集成第三方推送最佳实践
- 开发者所需要知道的 iOS 10 SDK 新特性
- 社群公会GangSDK:程序员入行AI领域需要哪些技能?
- IOS开发之制作静态库
- 我最近的四场关于Delphi开发APP的直播
- Android开发集成百度翻译SDK
- iOS SDK 中unrecognized selector sent to instance错误
- 云巴 2016 年更新合集——SDK 篇
- iOS中全局悬浮按钮,类似IPhone中的AssistiveTouch
- iOS 宏(define)与常量(const)的正确使用
- 正则表达式在ios中应用
- iOS实现透明度渐变和颜色渐变的view
- iOS判断第三方SDK是否含有广告位