Guides

集成指南

SDK 支持多种集成方式，您可根据项目需求选择合适的方案。

版本与兼容性

• compdfkit-tools 版本需与 compdfkit、compdfkit-ui 保持一致。
• 请根据 SDK 发布说明选择合适的 minSdk / compileSdk / targetSdk 与 AGP 版本。
• 若开启 R8/ProGuard 混淆，请参考 SDK 随附的混淆配置。

Gradle 集成

1. 打开位于项目根目录中的 settings.gradle 文件，添加 mavenCentral 存储库：

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
+       mavenCentral()
    }
}

2. 在应用程序模块目录中打开 build.gradle 文件：

编辑并添加 ComPDFKit_Tools 模块依赖项：

def compdfVersion = "2.6.0" // 与 compdfkit / compdfkit-ui 版本保持一致

dependencies {
  implementation "com.compdf:compdfkit-tools:${compdfVersion}"
  // 或分别依赖核心与 UI 模块（版本需一致）：
  // implementation "com.compdf:compdfkit:${compdfVersion}"
  // implementation "com.compdf:compdfkit-ui:${compdfVersion}"
}

手动集成

1. 将 ComPDFKit-Tools.aar 复制到 app 模块的 libs 目录中。

2. 将以下代码添加到 app 目录下的 build.gradle 文件中：

dependencies {
  implementation fileTree(dir: 'libs', include: ['*.jar', '*.aar'])
}

请务必按照手动集成方式同时依赖 ComPDFKit.aar、ComPDFKit-UI.aar，确保正常运行。

源码集成

可通过 SDK 安装包或 GitHub 示例项目 获取 ComPDFKit_Tools 模块源码。

1. 下载或解压 SDK 源码。
2. 在 Android Studio 中通过 File → New → Import Module 导入模块。

3. 在 app/build.gradle 中添加：

dependencies {
    implementation project(path: ':ComPDFKit_Tools')
}

源码集成方式可让您直接修改 Tools 模块代码，实现更深度的定制。