详解-sdk解释和定义以及开发要点

爱被打了一巴掌 2022-04-04 14:22 1016阅读 0赞

### 详解-sdk解释和定义以及开发要点 ###

*  关于SDK的解释
 *   *  什么是SDK
     *  什么是\`Library\`
     *  什么是\`Framework\`
     *  什么是\`API\`
     *  四者之间的关联
 *  架构中的一些核心点.
 *   *  浅谈\`SDK\`实现目标
     *  简洁易用
     *  常见的\`SDK\`初始化如下:
     *  一个优良的API
     *   *  \`简单可靠\`
         *  稳定
         *  高效
     *  SDK整体架构设计
     *   *  模块化开发
         *  \`组件\`化开发
         *   *  \`组件\`的概念
             *  那为什么要组件化?
         *  \`插件化\`开发
         *   *  为什么需要插件化
             *  SDK初始化
             *  云更新控制
     *  安全
     *   *  SDK自身安全
         *  核心逻辑采用C/C++
         *  通讯加密
         *  设备安全
     *  减少传输数据大小
     *  选择支持最低系统版本
     *  权限管理
     *  日志服务
     *  深究\`API\`设计
     *   *  1.方法名能够表明其用途
         *  2.参数的合法性检验
         *  3.方法要明确其单一的功能
         *  4.方法异常问题
         *  5.方法权限控制
         *  6.避免过长参数
         *  7.谨慎使用方法重载
         *  8.谨慎使用变长参数
         *  9.避免方法直接返回NUll
         *  10.必要时进行保护性拷贝
     *  \`SDK\`开发流程
     *   *  \`SDK\`版本管理策略
         *   *  \`SDK\` 版本号命名及修改原则
             *   *  希腊字母版本号说明
                 *  版本号修改规则
         *  API版本管理
         *  接入文档和API文档版本管理
         *  集成\`Demo\`版本管理
     *  总结

> 拜读完作者的文章, 收益良多, 写的很详细透彻, 就是错边字稍微多了一点, 转载过来, 重新排版修复下, 希望能帮助更多的人  
> 文章转载自 [https://blog.csdn.net/dd864140130/article/details/53558011][https_blog.csdn.net_dd864140130_article_details_53558011]

# 关于SDK的解释 #

## 什么是SDK ##

在开始正文之前,首先来聊聊SDK是个啥玩意.

> `SDK`是Software Development Kit的缩写,译为”`软件开发工具包`”,通常是为辅助开发某类软件而编写的特定软件包,框架集合等,`SDK`一般包含相关`文档`,`范例`和`工具`.

`SDK`可以分为`系统SDK`和`应用SDK`.

*  `系统SDK`: 是为特定的软件包,软件框架,硬件平台,操作系统等简历应用时所使用的开发工具集合.
 *  `应用SDK`: 则是基于`系统SDK`开发的独立于具体业务而具有特定功能的集合.

> 比如在进行Android 应用开发时,我们使用Google提供的系统SDK(Android SDK),而我们经常使用的`友盟SDK`,`极光SDK`则是基于`系统SDK`开发的.

明确`SDK`的概念之后,再来聊一聊这三个概念:`Library`,`API`,`Framework`

## 什么是`Library` ##

`Library`即我们所说的库,通常是一组或者几组类的集合,通常是应用中某些功能的具体实现或者对系统已有功能的增强或补充.

> 对Android开发者而言,最常见的莫过于是Support Library,另外就是我们经常使用各种网络请求库(OkHttp,Volley),数据库操作,图片加载库(Glide,ImageLoader)等.

## 什么是`Framework` ##

`Framework`即我们所说的框架,通常是系统或者应用的骨架,很多时候,它表现为一组抽象的构建及构件实例间交互的方法.因此,可以认为,`Framework`规定了应用的体系结构,阐明了整体设计,写作构件之间的依赖关系以及控制流程.注意自处的`Framework`并不完全等同于你所熟知的Android Framework框架,可以认为Android Framework中体现了Framework的思想,并进行了实现.

## 什么是`API` ##

`API`是Application Programming Interface,又称为应用编程接口，是软件系统不同组成部分衔接的约定。更加通俗的说就`API`就是我们常见和编写的方法或函数.  
小结

## 四者之间的关联 ##

明确了上面提到的概念之后,现在就可以来描述这四者之间的关联:

*  `SDK`主要包含Framework,API及Library的三部分.
 *  `Framework`定义了SDK整体的可重用设计,规定了SDK各功能模块的职责以及依赖关系.
 *  `Library`: 主要为功能模块
 *  `API`: 模块之间的内部通信及SDK外部通信(SDK对外提供服务的接口)

另外完整的SDK还应该包含大量的示例和其他工具

>  *  比如在Android SDK的tools目录下提供了大量的辅助开发工具.  
>     对我们而言,大部分情况下是为某种具体的业务需求开发对应的SDK,以便作为第三正提供给其他需求方使用.
>  *  比如百度推送的SDK主要实现消息推送功能,需求方只需要集成百度推送的SDK便可以使自己应用具备推送功能.

到现在已经介绍了SDK的主要构成,接下来我们重点来介绍SDK的实现目标以及在SDK

# 架构中的一些核心点. #

## 浅谈`SDK`实现目标 ##

上面介绍了开发中常见的概念,现在来谈谈`SDK`的实现目标.  
任何应用都应具备:简洁易用,稳定,高效,轻量,`SDK`作为一种特定应用当然也不例外.

## 简洁易用 ##

按照`奥卡姆剃须刀`理论,一个好的产品对第三方使用者使用而言应该是简洁易用,不用修改太多或让使用者花费太长时间学习的.  
这对`SDK`同样适用

> `SDK`不应该对宿主应用有过多的代码侵入,也不应该有复杂频繁的接入工作.比如当开发者需要使用SDK的服务时,只需要在缘由的代码中新增一行即可.

## 常见的`SDK`初始化如下: ##

public class Ad{ 
    
        @TargetApi(9)
        public synchronized static void init(Context context, SdkParams params) { 
            //省略多行代码
        }
    }

当我们需要使用该`SDK`的服务时,通过一行代码便可启用`Ad.init(this,params)`  
要保证较少的代码侵入主要在对外提供服务时充分考虑到使用者的使用场景来设计出优良的API.一个优良的API在定义的时候应该满足绝大数开发者所预期的方式—语义上要求通俗易懂,使用上要求简单可靠.

## 一个优良的API ##

### `简单可靠` ###

*  在正常使用的情况下体现为`稳定可靠的执行`
 *  在异常情况下体现为`及时的告知使用者使用错误`
 *  遵循`一致的命名规则`,并使所有的`API`呈现出一致的风格

### 稳定 ###

> 站在SDK使用者角度来看,我们期望第三方的SDK服务应该是稳定高效的,体现在提供稳定可靠的服务,在不影响宿主稳定性的前提下足够的高效,这就要求我们SDK设计者在设计并实现SDK时要尽可能的做到以下几点:

1.  对外提供稳定的API.SDK的API一旦确定,如无非常严重情况不可更改.作为提供服务方,发生API变更所带来的变更成本非常大.
2.  对外提供稳定的业务.在稳定的API后,必须要有稳定的业务来支撑.  
    SDK运行时的稳定,作为服务提供方,我们必须确保SDK自身运行的稳定,并且保证接入方不会因为我们的SDK产生不稳定的情况.
3.  版本稳定更新.和面向普通用户的应用相比,SDK版本的迭代是非常缓慢的.并且需要尽可能的对开发者屏蔽迭代过程,以免给开发者带来不必要的适配开销.

### 高效 ###

无论是普通的应用开发还是SDK开发,都应该考虑到性能问题,SDK设计者应该着重考虑以下问题:

1.  更少的内存占用.在不使用多进程的情况下,SDK服务和宿主程序运行在同一进程中,这种情况下必须要求限制SDK内存的占用,不能因为我们SDK占用太多的内存资源,导致应用的存活时间变短.
2.  更少的内存抖动.在占用更少内存的前提下,SDK设计者必须刻意的减少反复GC造成的内存抖动问题.
3.  更少的电量消耗.尽管很多时候无法对电量消耗做一个很好的权衡,但是仍然有一些可以参考的做法,比如减少使用耗电模块的时间.比如在使用定位服务时,不要求非常高的精度下优先使用网络定位而不是GPS定位.
4.  更少的流量消耗.

## SDK整体架构设计 ##

`SDK`的架构实现决定了`SDK`后续的维护难度,因此有必要在此对`SDK`整体架构中的一些点做些简单的说明.

### 模块化开发 ###

根据`单一职责`将系统拆分为不同的小`模块`，每个`模块`保持相对独立。  
模块之间通过`协议`或`接口`通信，以减少相互之间的`依赖耦合`.模块内部按照设计的几大原则进行实现,以保证`模块`本身可以灵活实现

> 对于现代开发而言,模块化是常用的手段,从宏观角度来看,模块是系统最小的组成单元.

### `组件`化开发 ###

#### `组件`的概念 ####

`组件`开发同样是个老生常谈的概念,但从我个人的感受来说,`组件`是对逻辑的封装,并具备单个可移植性  
比如可以把日志记录做成一个`组件`,之后它可以被轻松在应用在不同的项目中.对于`android` 开发者而言,`Android` 提供的每个`UI 控件`同样也是`组件`,比如`Button`,`TextView`等.  
在明确了组件这一概念之后,`组件化`开发也就不难理解

> 所谓的组件化就是将整个项目划分成多个模块,几个模块或者单个模块作为一个组件,开发过程中我们可以对每个组件进行并行开发,最后发布时通过依赖将组件合并成完整的应用.

#### 那为什么要组件化? ####

随着`android`的逐渐成熟,现在的`app`业务越来越复杂,与此同时,`android`工程也变得日益庞大,代码行数十几万已经是常态,此时有几个问题便会凸显出来:

1.  工程任何一点改动都会造成整个工程的重新编译.记忆最深的就是早期在没有进行组件化的时候,庞大的工程动辄需要十几分钟的编译时间,一杯茶的时间就出来了,很多时候,不得不眼巴巴的等着,尽管现在可以使用facebook出品的buck以及来自阿里的feeline来加速编译过程,但仍然不够.
2.  整个工程中充斥的大量重复或者冗余的子模块,业务耦合度非常高,牵一发而动全身.这就造成了”老人不敢改,新人无法改”,因为谁也不能预知在做修改之后,会产生什么影响.
3.  协作开发基本上是不可能的,天知道彼此在做什么.代码合并的的时候更是令人痛苦.  
    不方便测试.高度耦合的业务和模块导致无法下手进行测试,只能草草了事.

通过引入组件化,上面遇到的问题便可迎刃而解.在`SDK`当中,根据实际情况对其进行`组件化`,比如我们将分享功能`组件化`,可以轻松的支持多种渠道的分享,在需要更新分享功能时,可以对其进行单独的编译和测试.

> 通过组件化,我们也可以轻松的实现`SDK`的定制功能,通过编写`编译脚本`,我们可以决定哪些组件被`依赖`,最终合并到完整的应用当中.  
> 比如友盟中的提供的可定制分享组件(如下图)的原理就是如此.  
> ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM0MjA4ODQ0_size_16_color_FFFFFF_t_70]

### `插件化`开发 ###

什么是插件化开发这里就不做介绍了,一方面`插件化`并不是个新概念,另外就是`插件化`到目前为止理论层次上已经非常成熟,不像15年开始研究的时候资料相对较少.

#### 为什么需要插件化 ####

1.  `SDK`不同于普通应用,不能频繁的进行更新,以免让开发者觉得SDK不稳定或者让开发者频繁的集成.
2.  `SDK`看起来变化较慢,实则变化频繁.就以以前做的广告SDK而言,有时候经常需要对某类机型进行数据采集或者及时更新反作弊模块,  
    在没有使用插件化之前,解决该问题是非常麻烦的.  
    利用插件化之后,解决该问题就变得非常容易:

我们将`SDK`整体划分为两部分:`宿主`和`插件`.

*  宿主: 只向开发者提供必要的服务接口,并提供了自定义插件加载器.
 *  插件: 功能的核心的逻辑  
    当需要采集数据的时候,只需要由开发人员开发好数据采集插件并下发到指定设备即可当需要修复SDK缺陷时,同样也只需要下发新的插件包即可

通过在SDK使用插件化方案,可以有效的对开发者屏蔽手动更新的过程.宿主相对稳定,一旦确定,一般不会变动,而后续的业务变化则只需要通过更新插件来支撑.

> 除了上面谈到的利用插件化解决`动态更新`之外,通过将整个工程分为`宿主`和`插件`可以实现`宿主`的并行开发和分开编译,并且能有效的解决方法数65535的限制.在没有使用插件化之前,我们整个项目是由很多`组件`通过`依赖`形成的庞大工程

#### SDK初始化 ####

和应用开发不同,很多情况下`SDK`没有自身的上下文Context必须要借助应用提供.

`SDK`初始化的常见做法:`Ad.init(Context context,AdParams params)`  
我们往往推荐开发者在应用`Application`组件中的`onCreate()`中去掉用该方法,这就意味着该初始化过程是同步的

假如`SDK`本身初始化时间较长,就会影响应用的启动速度  
通常将`SDK`服务进一步划分成`核心服务`和`辅助服务`,之后通过`并行初始化`和`延迟初始化`的手段来减少`SDK`初始化耗时.

曾经在我所负责的广告SDK中,有开发者反馈我们的SDK启动较慢  
通过对整个`SDK`启动流程进行分析后

*  将插件加载服务和云控服务`并行初始化`
 *  日志服务则采用延迟初始化,通过该手段有效的减少了初始化耗时

#### 云更新控制 ####

`云控服务`作为一种服务端控制客户端的手段在`SDK`中开发中非常重要,现在的`SDK`开发可以不支持`插件化`,但是必须要提供`云控服务`,以便让服务端能控制`SDK`  
比如在不需要进行数据采集的时候,可以通过`云控服务`关闭`SDK`采集功能,在需要的时候在将其打开.

对本身是基于插件化开发的`SDK`而言,`云控服务`更是不可或缺.  
从实现的角度而言,云控服务分为`服务端主动`和`客户端主动`

*  服务端主动是指服务端会将最新的云控开关的信息推送到`SDK`
 *  客户端主动则是SDK在进行操作之前会首先请求云控信息

> 对有推送开发经营的同学而言,这非常容易理解,就是像是为了实现消息推送功能,我们可以通过客户端轮训也可以通过服务端保持长连接进行消息推送一样.

## 安全 ##

### SDK自身安全 ###

为了区分接入者并提高`SDK`自身安全性,我们通常会为开发者分配`api key`和`api secret`  
`SDK`会读取开发者配置的`api key`和`api secret`,并用于随后的`网络通信`中.这是非常常见的做法,比如当你集成极光推送`SDK`的时候,它也许需要你提供`api key`和`api secret`,如果没有则需要到官网进行申请.

### 核心逻辑采用C/C++ ###

为了安全起见,`数据加密`类,`模块算法`类都都应该采用`NDK`开发,将其封装在`.so文件`当中.  
有很多开发者不明白为什么这样会增强`安全性`  
这里我们简单的做个说明

1.  `.so文件`是通过`c/c++`编译出的文件,相对于`java`的反编译文件来说,可读性更差
2.  大部分的`Android`开发者并不具备较深的`C/C++`能力,因此一定程度上增加了被破解的可能

### 通讯加密 ###

针对实际情况对通讯协议进行加密,具体是采用对称加密还是非对称加密,则需要根据实际情况做选择

> 尽可能使用https来代替http.

### 设备安全 ###

比如广告SDK中,有一些开发者会通过虚拟机来刷广告,因此有必要针对此情况做判断.一旦SDK检测出非法请求后可以采取两种方案

*  一种是SDK拒绝服务
 *  另外一种则是正常服务,SDK会将作弊信息上传至服务器,以便后端服务定向排除数据

## 减少传输数据大小 ##

在设计`SDK`和`服务端通讯`之间的`数据协议`时,需要根据实际情况考虑  
以下几条建议:

*  如果对传输的数据大小有要求,建议对数据进行压缩
 *  可以采用json/xml/Protobuf等协议,如果它们仍然不能满足则可以考虑自定义二进制协议.

## 选择支持最低系统版本 ##

作为`SDK`的设计者,面临一个很大的问题是我们不得不考虑开发者应用所支持的系统最小版本,但是在SDK发布之前,我们并不知道会什么样的开发者使用我们提供的服务,因此为了让`SDK`支持更广泛的设备,我们需要降低最低支持的系统版本.比如现在失眠上主流的系统版本是`Android 5.0`,那么对`SDK`而言,起码要支持到`Android 4.0`,甚至是`Android 2.3`.

*  降低最低支持版本看起来很容易,但是我们不得不做更多的工作来确保`SDK`能表现出一致的工作行为(通常,我们在`SDK`内部检测当前系统版本来确定哪些方法可以被调用).
 *  更残酷的真相是我们花费了很大的精力去支持2.3,但来自2.3系统版本的请求量却连1%都不到.

## 权限管理 ##

`Android`中任何开发都避不开权限申请.作为`SDK`的设计者,对于权限遵循”如无必要,无需增加”,换句话说就是用不到的权限,就不要加上去,这也是我们所谓的`最小权限原则`,该原则同样适用于普通应用开发.

在刚接触`SDK`开发时,某些早期功能需要某些权限,但是后期该功能被砍掉了,但是权限却忘记去掉,这就导致不必要权限仍然存在的情况.

> 另外过多的权限申请,会让开发者怀疑你的目的  
> 比如一个广告SDK的你申请照相机权限是想干嘛?  
> 恩,我怀疑你在偷拍我….好吧,这里我只是开个玩笑.  
> 另外,从`android 6.0以上`,`google`改变了权限申请的策略,因此需要单独对此做适配.

## 日志服务 ##

无论系统大小,日志服务是基本的服务.一个良好的日志服务能够帮助我们快速的发现问题,定位缺陷,从而获得问题的解决方案.  
`SDK`的日志服务和其他常见的日志服务并无太大的不同,但是要保证以下几点:

1.  日志服务能够记录有效的信息,在SDK要关键位置进行打点.
2.  日志服务上传日志信息到服务器时,要保证最大的可靠性,不能发生上传失败后抛弃日志的情况.
3.  日志服务不能影响对正常的操作流程有过多的性能影响.SDK产生的日志信息往往是非常多的,因此必须考虑日志IO操作所带来的开销.

## 深究`API`设计 ##

`API`的设计在任何开发中都是非常重要的,很多时候软件的质量好不好在`API`的设计可以得到体现  
在普通的应用开发中,`API`只会在应用开发人员间流通而不会暴露给非本应用开发的其他人员,但是`SDK`作为一种服务,需要向开发者暴露一部分`API`

*  通常我们将内部流通的`API`称之为`内部API`
 *  而开放给开发者的称之为`SDK API`.

> 两者使用场景虽然不同,但是都遵循着一些通用的设计规则

这里无法细说,只列出我认为需要重点关注的十条原则:

### 1.方法名能够表明其用途 ###

方法名是理解方法含义的第一渠道.一个好的方法名首先是能够向他人展示自身功能,这样做的好处就是能够减少不必要的沟通成本,对于开发者而言,还有什么比直接读代码更直观呢.

### 2.参数的合法性检验 ###

对参数进行合法性检验是非常重要的,请不要想当然的认为可以用运行时异常来代替.  
当合法性校验不通过时,针对方法权限不同分别对应不同不同的处理策略:

*  对于公开方法通过显示检查抛出异常的方式，并且使用`javadoc`的`@throw`来说明抛出异常的原因
 *  对于私有方法通过断言的方式来检查参数的合法  
    检查构造方法的参数的合法性，以使对象处在统一状态

> 需要注意,如果检查的代价太大，需要综合考量，比如如果接受的是一个很大的List，此时检查的代价可能很大

### 3.方法要明确其单一的功能 ###

一个方法应该具有单一的功能，尽可能做更少，但是更专的事情.这也是我们常说的`单一职责原则`  
一定要记住宁可提供`小而美`的方法也不要提供`大而全`的方法,经验证明`大而全`的方法往往发生变动,产生风险的可能性更高,因此不如提供更小的方法以便组合使用

### 4.方法异常问题 ###

对于需要暴露给开发者的方法要及时的抛出可查异常来帮助开发者在编译阶段发现问题

> 另外,对于运行时异常,SDK设计者必须保证该类异常不会导致宿主程序出问题并且需要告知开发者.

### 5.方法权限控制 ###

方法的权限也是需要着重考虑的,`SDK`设计者必须同时从安全和业务的角度考虑哪些方法是可公开的,哪些是不可公开以及哪些是静态的

### 6.避免过长参数 ###

过长的参数会造成记忆上困难,需要慎重对待.在无法避免过长参数的情况下,需要考虑其他的方法进行解决:

*  a. 通过使用Builder模式来实现
 *  b. 通过使用辅助类,通常采用静态内部类的方式,具体见静态内部类的使用
 *  c. 通过将多个参数封装成类对象
 *  d. 通过将参数拆解成多个方法的参数

### 7.谨慎使用方法重载 ###

重载不应该让使用者感到疑惑  
不应该出现这种情况:  
同样的参数,但是开发者不能明确哪个方法会被执行  
换言之就是不要产生歧义性.

另外需要注意,不要存在参数类型经过自动转换就可以运行在另外一个方法的情况

> 我曾经在`code review`中看到这样的代码:  
> `list`中的`remove(Object)`和`remove(int)`,请务必保证自己不会犯类似的错误.  
> 尽管在`java`当中能够使用重载,但是我不建议使用,尤其是不要重载变长参数,在需要重载的时候宁可使用不同方法名来代替也要好的多.关于这点`java`中提供的`ObjectOutputStream`类给我们做了很好的示范:它的`write`对于每个基本类型都有一个变形,比如写出字符,写出`boolean`等操作,我们发现设计者,并没有使用重载将其设计成`write(Long l)`,`write(Boolean b)`,而是将其设计为`writeLong(l)`,`writeBoolean()`

对于构造函数,则可以通过是用静态工厂的方式来代替重载.

`这里我其实是持不同的意见, 我觉得的方法重载是为了方便调用者(不用关心参数类型, 而只关心方法实现的效果), 但是一定要保证不要存在歧义(一种参数能对应两种方法)`

### 8.谨慎使用变长参数 ###

多数情况下不需要使用变长参数,一般方法的参数在5个以上的时候,才建议使用变长参数.  
在还有其他非变长参数的情况下,变长参数应放在形参列表的最后

### 9.避免方法直接返回NUll ###

对于需要返回数组或这集合的方法,不要返回`null`

> 比如我们去买糕点店买面包,面包没了是一种正常状态,就不应该返回`null`,而是返回长度为0的数组或集合.

### 10.必要时进行保护性拷贝 ###

当类接受来自客户端的对象或者需要向客户端返回对象,如果该类不能容忍进来的对象再发生变化,那么有必要对对象进行保护性拷贝

> 另外要注意参数的合法性检验发生在保护性拷贝之后

需要注意的是如果需要进行保护性拷贝的对象非常大,比如`list`集合中存在十多万个对象,需要权衡处理.  
这十一条原则是我在团队中推广并要求严格遵守的,下面,将对这十条原则分别进行说明.

## `SDK`开发流程 ##

关于`SDK`开发流程,我会从以下三个方面写:一时团队中如何协同开发,二是`SDK`的持续集成,三是`SDK`多仓库拆分和管理.  
这三方面会再另外的篇章中展现(具体什么时候写完目前还未确定)

### `SDK`版本管理策略 ###

#### `SDK` 版本号命名及修改原则 ####

`SDK`版本号命名和我们以往的命名规则并无太大不同,通由4部分组成,格式为:  
V主版本号子版本号阶段版本号\_日期版本号加希腊字母版本号  
比如`V1_1_2_161209_beta`

##### 希腊字母版本号说明 #####

*  Alpha版:内部测试版,此版本表示该软件在该阶段主要是以实现功能为主,Bug相对较多,需要继续修改,通常只在内部流通流通而不对外开放.
 *  Beta版:外部测试版,该版本相对Alpha已经有了很大的改进,不存在严重的Bug,但还是存在一些缺陷,需要进一步的测试以检查和消除Bug.
 *  RC版:该版本已经相当成熟,不存在导致错误的Bug.与正式版相差无几.
 *  Release版:该版本意味着”最终版本”,是最终交付用户或者公开发布的版本,也称为标准版.需要注意的是,该版本在发布的时候回以符合R来代替Release单词.

##### 版本号修改规则 #####

1.  主版本号变化:当功能模块有较大的变化或者整体架构发生变化
2.  子版本号变化:当功能有一定变化
3.  阶段版本号变化:一般是Bug修复或者较小的变动,根据反馈,需要经常发布修订版本.
4.  日期版本号(161209):用于记录修改项目的当前日期,每天对项目的修改都要更改日期版本号.
5.  希腊字母版本号:此版本号用于标注当前软件处于那个开发阶段,当软件进入到另一个阶段是需要修改.

### API版本管理 ###

和普通应用`API版本管理`不同,`SDK`设计者需要着重关注`SDK API`的管理.原则上`SDK API`一旦公开发布后其状态(签名和具体实现)应为不可变

对于特殊情况下API的变更,需要遵守`开闭原则`  
即一个`类`,`模块`,`方法`应该对扩展开发,对修改关闭.  
这就要求我们做到以下几点:

1.  在需要调整`SDK API`时,优先选择添加新方法,而不是在原方法上修改.对于实现相同功能的新方法,尽可能的要兼容原始方法.
2.  在需要废除某些方法时,需要在正式版发版前使用`@deprecated`标识,并给出替代方案和废弃的时间(通常是`SDK版本号`)

### 接入文档和API文档版本管理 ###

接入文档是用来告诉`SDK`使用者,如何使用`SDK`,使用的详细步骤和可能发生的问题,每个公司会有自己的一套规则,这个不需要做太多的解释.  
另外,接入文档通常分为两份:内部版和公开版.

*  内部版通常用于内部开发人员和测试人员,信息较为详细
 *  公开版则是面向开发者,相比内部版会省略的一些信息.  
    `API`文档其实就是对`SDK API`的更详细说明,类似`java`中的`api doc`,可以借助`jdk`的自带`javadoc`直接生成(当然在`android studio`也提供了便捷的生成方式)

> 无论是接入文档还是`api`说明文档,其变更一般发生在`SDK`版本发生变化时.当`SDK`发生变更时,文档必须随之更新,不能出现`SDK`更新后说明文档不与之匹配的情况.

### 集成`Demo`版本管理 ###

集成`Demo`通常是一个简单的`app`,用来展示如何快速的接入`SDK`.其版本变更策略和`SDK`版本的变化保持一致.

## 总结 ##

`SDK`开发中需要关注的点非常多,每个点都不能用三言两语完成的,后面会在此基础上慢慢的补充.

[https_blog.csdn.net_dd864140130_article_details_53558011]: https://blog.csdn.net/dd864140130/article/details/53558011
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM0MjA4ODQ0_size_16_color_FFFFFF_t_70]: /images/20220404/b33583ce59d64e4998df05a0ce908ab0.png