<转> 写iOS SDK注意事项

最新推荐文章于 2022-07-14 18:12:35 发布

weixin_30472035

最新推荐文章于 2022-07-14 18:12:35 发布

阅读量190

点赞数

CC 4.0 BY-SA版权

文章标签：移动开发嵌入式

原文链接：http://www.cnblogs.com/yeast/p/4346445.html

本文总结了在开发SDK过程中常见的六个问题，包括类名和category方法的前缀问题、第三方库的打包方式、基本的检查和测试、文档的完整性与正确性、支持最新的CPU版本等，旨在帮助开发者避免常见错误。

我发现即使是像腾讯、小米这样的大厂提供的 SDK，在质量和规范上也有很多问题，而且包括我以及我身边的很多朋友都被恶心到了，所以我就把这些注意事项总结出来，希望大家不要犯同样的错误。

注意事项一：所有类名都应该加前缀

说明：没有前缀的类名有冲突的风险。

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)