跳到主要内容

SDK 集成

概述​

只需集成一次 Combo SDK，应用即可获得账号登录、内购、数据分析、错误追踪等能力，实现在中国各大应用商店的发行上架。

本文档介绍如何快速接入 Combo SDK。

系统要求​

  • Android SDK 仅支持 Android 6.0 (API level 23) 及以上版本
  • 仅支持 arm64
  • 支持 Java 17 及以下版本（推荐 Java 17）

SDK UI 主题配置​

接入前需要确定并配置 SDK 的 UI 主题，详情见 SDK UI 主题配置。

获取 Combo SDK​

Android 产物将发布至 世游 Maven 仓库。

CLI 工具会自动将 Android SDK 产物集成到你的项目中。

更多细节参见 集成 Combo SDK。

集成 Combo SDK​

1. 开始集成​

使用 Combo CLI setup 会自动生成 ComboSDK.json 以及所需的 Maven 依赖。

CLI 工具会把以下文件导入 Android 工程：

文件说明
ComboSDK.jsonSDK 构建期参数。
ComboSDK.gradle包含默认配置与构建脚本。
ComboSDKSigning.gradle应用签名配置。
ComboSDKDeps.gradleSDK 相关依赖声明，确保所有必需模块都引入项目。
ComboSDKRepo.gradle依赖仓库 URL 声明。 注意：若 settings.gradle 启用了 dependencyResolutionManagement（Android Gradle Plugin 7.0+ 引入），仓库声明应放入该模块以统一管理。

2. 代码混淆配置​

目前 SDK 内部集成了大量第三方库，不支持开启代码混淆。示例如下：

Show Code 
android{
    // ... 其他配置 ...
    buildTypes {
        debug {
            // 关闭 debug 的代码混淆
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
        }
        release {
            // 关闭 release 的代码混淆
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
        }
    }

    // 推荐的附加配置
    lintOptions {
        checkReleaseBuilds false
        abortOnError false
    }
}

工程配置完成后，继续阅读 应用生命周期与初始化。

最后于 更新