转载

十项经典的技巧构建完美SDK

网+线下沙龙 | 移动APP模式创新：给你一个做APP的理由>>

过去十年以来，SDK的使用已经成为开发生命周期中的重要组成部分。事实上，其在产品中的应用与集成已经非常普遍。甚至对开发者而言，了解框架知识的重要性已经高于学习算法本身。

十项经典的技巧构建完美SDK

而在今天的文章中，我们将了解十项技巧，希望它们能帮助各位打造出完美的SDK：

0. 了解现有成果

在动手之前，我们首先需要了解竞争对手或者其它企业是否已经完成了各位预期的SDK方案。这类方案可以作为很好的参考点，大家不妨从中选取精华、摒弃糟粕。

1. 简单性

简单的代码能够确保成果的易用性。具体来讲，代码的交互方式越少越好，例如只提供一个接口类; 减少方法签名，例如只保留少数输入参数等等。除了初始化之外，一且SDK的使用方式都应尽可能保持简单。要实现这一目标，大家可以提供默认配置及默认实现类，同时允许高级用户对其加以修改。隐藏一切用户不需要使用的类与方法，即只在用户需要时才开放类/方法，否则仅在本地或私有范围内使用。部分IDE能够帮助大家自动实现代码检测与冗余部分清除。说明文档：让文档尽可能易于理解，即提供充分的解释表述但又要注意别啰里啰嗦。另外，内嵌代码示例也是很好的提示方式。

2. 保证易于上手

即保证用户能够在5分钟以内学会使用代码。这一点非常重要，特别是考虑到有时候用户会评估我们的产品——如果无法轻松上手，他们很可能直接选择放弃。

3. 保持简短

这部分要求对说明文档特别重要，但有时也会体现在用户与SDK代码的交互流程当中。要在说明文档中实现简短效果，大家应当提供代码示例、使用自解释方法名称并提供默认配置。

4. 整合

我们必须记住，用户的开发环境往往多种多样。举例来说，如果我们在编写一套Android库，则需要充分考虑要素整合：如果用户使用Android Studio与gradle，则须提供aar artifact并将其发布至远程库; 如果用户使用Eclipse，则需要提供变更AndroidManifest.xml所必需的jar文件以及SDK独立eclipse项目。当然，这部分工作无法一蹴而就，大家可以在项目推进当中听取意见并逐步纳入更多整合元素。