1. SDK基础概念
做后端开发这些年，我和SDK打过无数次交道。
说实话，很多人把SDK想得太神秘了。
它就是个工具包，说白了——就是让你少写点重复代码。
1.1 什么是SDK
SDK全称 Software Development Kit，软件开发工具包。
我习惯把它理解成「乐高积木盒」。
盒子里有各种现成的零件，你拿来拼一拼，就能搭出想要的功能。
SDK 核心价值：把复杂的技术封装成简单的接口，让开发者聚焦业务逻辑。
举个例子。我在做支付系统改造时，接入微信支付SDK。
我不需要理解微信的加密协议、签名算法、回调机制。
只需要调几个方法，传几个参数，支付功能就跑起来了。
你想想看，如果每个SDK都要从头造轮子，那项目周期至少翻三倍。
1.2 SDK与API的关系
很多新人搞不清SDK和API的区别。
我初入行时也犯过这个糊涂。
其实关系很简单——API是接口，SDK是工具包。
| 对比维度 | API | SDK |
|---|---|---|
| 本质 | 一组接口规范 | 一个完整工具包 |
| 形态 | HTTP端点 / RPC方法 | 代码库 + 文档 + 示例 |
| 使用方式 | 发送请求 / 调用接口 | 引入依赖 / 调用方法 |
| 复杂度 | 通常较低 | 通常较高 |
| 关系 | SDK 内部封装了 API | API 是 SDK 的核心 |
我的经验：SDK是API的高级封装。API告诉你「能做什么」，SDK告诉你「怎么方便地做」。
1.3 SDK的典型构成
一个标准SDK长什么样？
我拆解过的项目里，基本都包含这几块：
- 核心库：封装了业务逻辑的代码集，通常是 jar、dll、so 格式
- API文档：告诉你怎么用这些代码，包括参数说明、返回值、异常码
- 示例代码：快速上手用的Demo，我一般先跑示例再读文档
- 配置文件：环境配置、密钥、连接参数等
- 依赖清单：SDK本身依赖哪些外部包，避免版本冲突
- 测试工具：模拟请求、调试日志、Mock服务
来看一个典型的Java SDK调用示例：
// 引入SDK依赖
// Maven: com.example:auth-sdk:1.2.0
// 初始化SDK客户端
AuthClient client = AuthClient.builder()
.appKey("your_app_key")
.appSecret("your_app_secret")
.endpoint("https://api.example.com")
.build();
// 调用SDK方法
AuthResult result = client.verifyToken("user__12345");
if (result.isSuccess()) {
System.out.println("用户: " + result.getUserId());
System.out.println("角色: " + result.getRole());
} else {
System.out.println("验证失败: " + result.getErrorCode());
}避坑指南：我曾经接手过一个项目，团队直接把SDK源码全部改了一遍。结果依赖升级时，所有代码都要重新适配。嗯，千万别这么干。SDK是黑盒，能不改就别改。
我们来总结一下SDK的典型架构。我画了一张图帮你建立整体认知：
这张图展示了SDK的三层结构。你仔细看：
左侧API层定义「能做什么」，中间实现层负责「怎么做」，右侧文档工具告诉你「怎么上手」。
三者缺一不可。
1.4 为什么RBAC适配要从SDK入手
你可能会问，改造RBAC权限模型，和SDK有什么关系？
我直接说结论：
SDK是权限管控的第一道关卡。所有外部请求进入系统，首先经过SDK层。
如果在SDK层就把RBAC权限校验做好了，后续所有业务模块都可以复用这套逻辑。
关键思路：改造SDK的认证鉴权模块，把原有的用户-角色-权限映射关系，替换为RBAC模型。这样一次改造，全局生效。
举个例子。我负责过一个多系统集成项目，每个子系统都有自己的权限校验。后来统一抽到SDK层，所有系统直接调SDK的checkPermission方法。嗯，那感觉真清爽。
这就是我们的课程核心——通过改造SDK接入层，实现RBAC权限模型的统一适配。