第2章：集成准备——获取SDK、环境要求、系统版本兼容性

集成SDK这事儿，看着简单，但往往翻车就翻在第一步。我见过不少团队在调试阶段排查半天，最后发现是SDK版本不对或者环境没配好。这章咱们就把准备工作捋清楚，省得后面走弯路。

2.1 获取SDK的正确姿势

隐私共享SDK的获取途径其实很明确，但有几个细节我得提醒你注意。

获取方式	适用场景	注意事项
官方Maven仓库	Android项目标准集成	确认仓库地址配置正确
私有NPM源	React Native / Flutter	需要先申请access
压缩包直接导入	离线环境、定制化需求	记得校验文件MD5
Git子模块	内部团队统一管理	注意.gitignore配置

以Android为例，配置起来很简单：

// build.gradle 的 allprojects 区块
allprojects {
    repositories {
        google()
        mavenCentral()
        // 隐私共享SDK的私有仓库
        maven { url 'https://private.depend.com/privacyshare' }
    }
}

// app/build.gradle 的 dependencies 区块
dependencies {
    implementation 'com.privacy.share:core:2.1.0'
    implementation 'com.privacy.share:crypto:2.1.0'
}

2.2 环境要求——别让环境坑了你

集成之前，先检查你的开发环境。说白了，很多编译错误都是环境不达标导致的。

2.2.1 基础开发环境

• JDK：11及以上版本（推荐17），我建议用OpenJDK长期支持版
• Android SDK：API Level 26+ 编译版本，build-tools 30.0.3+
• Gradle：7.0+，如果你还在用6.x系列，最好升一下
• NDK：21.0+（如果涉及native层加密）

2.2.2 依赖库版本

隐私共享SDK依赖一些基础库，版本不能乱选：

依赖库	最低版本	推荐版本	说明
AndroidX Core	1.6.0	1.9.0+	底层兼容性依赖
Kotlin Stdlib	1.5.0	1.7.0+	部分API基于Kotlin协程
OkHttp	4.9.0	4.10.0+	网络通信基础
Gson / Moshi	2.8.6	2.9.1+	数据序列化

2.3 系统版本兼容性

这块是坑最多的地方。你想想看，Android碎片化这么严重，iOS也在不断迭代，兼容性工作不做扎实，后面测试阶段有你受的。

2.3.1 Android系统支持

• 最低支持：Android 6.0 (API 23) —— 覆盖了99%以上的活跃设备
• 目标版本：Android 13 (API 33)，不过最新的SDK已经适配了Android 14
• 特别说明：Android 10+对隐私权限收得很严，SDK内部做了自适应处理

2.3.2 iOS系统支持

• 最低支持：iOS 12.0（因为隐私计算用到的一些底层API从iOS 12才开始稳定）
• 目标版本：iOS 16.0+，建议用Xcode 14.0+编译
• 注意：iOS 14+新增了App Tracking Transparency框架，SDK默认遵循用户授权

2.3.3 跨平台兼容点

嗯，这里要说一个实战中很容易忽略的问题。隐私共享SDK在某些国产ROM上可能有特殊表现。我记得之前有个项目在小米MIUI上启动闪退，定位了半天才发现是MIUI的隐私保护机制拦截了SDK的初始化请求。解决方案是让SDK增加了一个“兼容模式”初始化参数。

2.4 知识体系总览

这一节的内容比较零散，我画了一张图帮你梳理整个准备工作的结构，方便你对照检查。

2.5 快速验证清单

最后，给你一份我平时用的验证清单。每次集成新版本SDK，我都会过一遍这个列表，基本没出过大问题。

1. 版本一致性检查：所有SDK模块版本号统一，依赖库版本符合最低要求
2. 编译环境验证：使用 gradle dependencies 查看依赖树，确认无冲突
3. 系统版本测试：在最低版本设备（Android 6.0 / iOS 12.0）上跑通初始化流程
4. 权限声明检查：确认AndroidManifest.xml 或 Info.plist 中的隐私权限声明正确
5. 签名校验：特别是压缩包导入方式，一定要核对官方提供的MD5值