美文网首页
当你写一个框架时, 需要注意:

当你写一个框架时, 需要注意:

作者: Stark_Dylan | 来源:发表于2016-03-22 15:47 被阅读231次
  • 首先,考虑你要提供给开发者什么帮助
  • 尽可能小的访问权限
public 必须要公开的方法
private 私有方法

而不是所有的方法全部public

  • 注意方法以及参数的命名
(返回值) 明确的方法名称, 驼峰, 首字母小写 (明确的参数描述)
// 正确
- (UIImage *) photoAt: (NSIndexPath *) photoPosition;
// 错误
- (UIImage *) photo: (NSIndexPath *) index;
  • 易懂的属性方法名称。
    假如你现在需要写一个展示昵称的属性,你会怎么写 ? displayName 还是 screenName ?

  • 尝试为每一个方法写详细的描述,以及需要注意的事项。 当然,如果代码的可读性很高可以忽略(但这几乎很难做到)。

 /*!
  * @see @param @discussion @author @abstract ....
  */
  • 主动边写测试环节。
@interface FrameWorkTest : XCTestCase
  • 注意命名冲突的问题,因为你的框架有可能跟别人的冲突。方案:添加前缀,就像jsq_这样。

  • 资源打包为Bundle

NSBundle * bundle = [NSBundle bundleForClass:[self class]];
[bundle pathForResource:@"logo" ofType:@"png"];
  • 使用Github、Gitcafe等作为项目的仓库托管。
  • 使用cocoapods、carthage、packageManager等为集成提供方便。
  • 版本管理,版本日志记录。
  • 注意版本兼容。
  • 注意你的框架最低支持的系统版本、对语言的支持。
  • 选择持续集成,Travis CI,Circle CI等。
  • 自动发布流程,之前我提到的Fastlane。

简单的说,包括:文档、注释、测试、代码质量、更新日志、issue、便捷使用。

阅读自: 喵神-如何打造一个让人愉悦的框架

copyRight@Dylan 2015-3-22

相关文章

  • 当你写一个框架时, 需要注意:

    首先,考虑你要提供给开发者什么帮助 尽可能小的访问权限 而不是所有的方法全部public 注意方法以及参数的命名 ...

  • 写框架需要的注意点

    转自:http://www.jianshu.com/p/aa3208a1cdd0首先要明确出于什么目的来写框架,这...

  • 94~建立框架

    搭建框架,尤其对于写作,框架就是聚焦。 一篇文章的,只写一个主题,在碎片化的阅读时代,我们需要去吸引读者的注意力。...

  • jquery DOM&事件

    1.说说库和框架的区别? 库:库里面有很多方法,当你需要时就可以到库里面拿去调用。 框架:就是一个模型,相当于一个...

  • 当你决定跑步时你需要注意什么

    记得我看到过这样一段话:读书,去别人的灵魂里偷窥。旅行,去陌生的环境里去感悟。电影,去荧屏里感受别人的生活历程。冥...

  • 当你需要帮助时

    当你需要帮助时,你会找谁;当你需要帮助时,谁会帮你;当你需要帮助时,如何求助?当你需要帮助时,会有怎样的期...

  • Python 中的 10 个常见安全漏洞,以及如何避免

    简评:编写安全代码很困难,当你学习一个编程语言、模块或框架时,你会学习其使用方法。 在考虑安全性时,你需要考虑如何...

  • Python 中的 10 个常见安全漏洞,以及如何避免(上)

    简评:编写安全代码很困难,当你学习一个编程语言、模块或框架时,你会学习其使用方法。 在考虑安全性时,你需要考虑如何...

  • 当你迷茫时,当你写不下去时......

    写作写久了,总会有迷茫的时期,总会有写不下去的时期,总会出现焦虑,不知所措时期。 深知这样下去不可以,越陷越深,越...

  • 86 写时注意

    动手去做,胜于一切完美 From嘉莉妹妹加叙加议,明快好读

网友评论

      本文标题:当你写一个框架时, 需要注意:

      本文链接:https://www.haomeiwen.com/subject/izhllttx.html