集成 Linkus Android SDK

本文介绍如何通过手动导入 Linkus SDK AAR 文件的方式,将 Linkus SDK 与 Android 项目进行集成。

使用要求及前提条件

使用要求
确保你的开发环境满足以下要求:
开发环境 版本要求
Java Java 11
Android 5.0 及以上
Android Studio Arctic Fox 及以上
Gradle & Gradle 插件
  • Gradle:6.5
  • Android Gradle Plugin:4.1.1
注: 如使用其它版本的 Gradle 及 Gradle 插件,可能需要额外的调试才能保证 Linkus SDK 的正常运行。
前提条件
你已 启用 Linkus SDK 并绑定推送证书

Demo & 源码

在正式集成之前,我们推荐你体验 Linkus Android SDK 的 Demo 并查阅项目源码,以了解 Linkus Android SDK 的整体运行框架及流程。

更多信息,前往 Linkus Android SDK 的 GitHub 仓库

操作步骤

  1. 前往 Linkus SDK 的 GitHub 仓库,下载最新版本的 linkus-sdk-x.x.x.aar 文件。
    注: x.x.x 代表 Linkus SDK 的版本号,请参见 Linkus Android SDK 更新记录 查看最新的版本号。
  2. linkus-sdk-x.x.x.aar 文件复制到 Android 项目的 app > libs 目录中。
  3. 在项目中引入 Linkus SDK 的 AAR 文件。
    注:
    • 开发环境版本不同,引入 AAR 文件的方式会存在差异。你可根据实际的开发环境选择对应的引入方式。
    • 如果你的工程文件采用的是 Kotlin 语法 (文件拓展名为 .kts),你需要将以下代码转换为 Kotlin 语法。
    1. 在项目的根目录下,打开 build.gradle 文件,并在 allprojects > repositories 下添加以下代码。
      flatDir {
          dirs 'app/libs'
      }

    2. app 目录下,打开 build.gradle 文件,并在 dependencies 下添加以下代码。
      implementation(name: 'linkus-sdk-x.x.x', ext: 'aar')
      注: linkus-sdk-x.x.x 表示 Linkus SDK 的 AAR 文件的文件名 (不包括扩展名)。
  4. 同步项目。

执行结果

你已成功将 Linkus SDK 与你的 Android 应用进行集成,可 初始化 Linkus Android SDK
注: AAR 文件中已包含混淆文件,你无需进行额外的设置以防止代码混淆。