快速集成：Gradle / Maven 配置与手动集成步骤

集成 SDK 这事儿，说难不难，说简单吧……我见过太多人卡在第一步。配置文件写错一个版本号，或者漏了远程仓库地址，然后花半天怀疑人生。

咱们直接来干货。

3.1 Gradle 集成（Android）

如果你用的是 Android Studio，Gradle 是首选。我个人习惯在公司内部仓库里统一管理依赖版本，这样团队不会出现“我本地能编译，你拉下来就报错”的诡异情况。

步骤一：在项目级 build.gradle（或 settings.gradle）添加仓库

// 项目级 build.gradle
allprojects {
    repositories {
        google()
        mavenCentral()
        // 如果使用私有仓库
        maven { url 'https://your-private-repo.com/releases' }
    }
}

以前有个同事，忘了在 settings.gradle 里加仓库，编译时一直报 404。我帮他看 log，说“你看看仓库地址对不对”，他还硬说配对了。最后发现是 gradle 版本升级后仓库声明位置变了。嗯，细节里藏魔鬼。

步骤二：在模块级 build.gradle 添加依赖

dependencies {
    implementation 'com.privacy.sdk:privacy-share:2.1.0'
    // 如果 SDK 依赖其他库，看情况 exclude 或强制版本
    implementation ('com.privacy.sdk:privacy-share:2.1.0') {
        exclude group: 'com.squareup.okhttp3', module: 'okhttp'
    }
}

3.2 Maven 集成（Java / Spring Boot）

Java 后端项目用 Maven 居多。配置方式和 Gradle 大同小异，但写配置的人容易手滑——比如多写了 scope 或者忘了 classifier。

步骤一：在 pom.xml 添加仓库

<repositories>
    <repository>
        <id>maven-central</id>
        <url>https://repo1.maven.org/maven2</url>
    </repository>
    <repository>
        <id>private-repo</id>
        <url>https://your-private-repo.com/releases</url>
    </repository>
</repositories>

步骤二：在 pom.xml 添加依赖

<dependency>
    <groupId>com.privacy.sdk</groupId>
    <artifactId>privacy-share</artifactId>
    <version>2.1.0</version>
    <!-- 注意：如果 SDK 包含 native 库，可能需要分类器 -->
    <!-- <classifier>linux-x86_64</classifier> -->
</dependency>

3.3 手动集成步骤（无包管理工具时）

有些安全等级高的项目不允许连远程仓库，只能用离线包。说白了就是“人肉拷贝”。

1. 获取 SDK 包： 从咱们官方渠道下载 privacy-share-release.aar（Android）或 privacy-share-2.1.0.jar（Java）。
2. 放入 libs 目录： Android 放在 app/libs，Java 放在项目的 lib/ 下。
3. Gradle 手动引用： 在模块级 build.gradle 加一行：implementation files('libs/privacy-share-release.aar')。
4. Maven 手动引用： 在你的 pom.xml 里用 <systemPath> 指向本地 jar 路径。
5. 依赖项补齐： SDK 用到了 gson、okhttp、protobuf 等。如果你没引入这些，编译器会抛出 ClassNotFoundException。我建议用打包工具（如 shadow 或 proguard）把依赖打进去，或者手动引入。

3.4 快速验证是否集成成功

集成完别急着写业务代码。写个最简单的初始化调用，看控制台有没有报错。

// Android
PrivacySDK.init(context, "your_app_id", new SDKCallback() {
    @Override
    public void onSuccess() {
        Log.d("SDK", "init ok");
    }
    @Override
    public void onError(int code, String msg) {
        Log.e("SDK", "init failed: " + code + " " + msg);
    }
});

// Java
PrivacySDK.init("your_app_id", new SDKCallback() {
    @Override
    public void onSuccess() { System.out.println("init ok"); }
    @Override
    public void onError(int code, String msg) { System.err.println("init failed: " + msg); }
});

如果回调了 onError，别慌。通常是网络不通、证书不对、AppId 输错了。检查这三样，八成能好。

3.5 快速集成流程总览

下面这张图可以帮你快速定位自己卡在哪一步。你想想看——集成流程其实就三个环节：加仓库 → 加依赖 → 调初始化。大部分问题出在细节上。

3.6 常见集成故障速查表