集成指南

集成指南

  • 本文档介绍 Android Studio 开发环境下基于 Maven 方式集成的步骤。
  • 本文档适用 SDK 版本:1.0.0.0 及以后
  • 本文默认读者已经具有基础的 Android 知识,以及项目工程结构如下:

    Getui_SDK_Demo_AS_official/
        |- app/ (项目主模块)
        |    |- libs/ (第三方库)
        |    |- src/ (代码目录)
        |    |- build.gradle (模块级 gradle 文件)
        |- gradle/
        |- build.gradle (顶层 gradle 文件)
        |- settings.gradle
        | ......
    

    注:其中 “......” 表示省略其他与本教程无关的内容,以下 “......” 表示相同意义,不再重复说明。

重点提示

注意:

需要集成com.getui:gtc:3.2.13.0及以上版本。

1. 创建个推应用

请参考 创建应用 获取相应的AppID信息。该信息在之后的步骤配置中将会使用。

2. Maven 集成

2.1 配置 Maven 库地址

在项目根目录 build.gradle 文件的 allprojects.repositories 块中,添加个推 maven 库地址 maven { url "https://mvn.getui.com/nexus/content/repositories/releases/"},如下所示:

buildscript {
    repositories {
        mavenCentral()
        google()
    }
    dependencies {
        ......
    }
}

allprojects {
    repositories {
        mavenCentral()
        google()
        maven {
            url "https://mvn.getui.com/nexus/content/repositories/releases/"
        }
    }
}

2.2 配置依赖

  1. 配置 SDK 依赖及应用参数:在 app/build.gradle 文件的 dependencies 块中引用个推 SDK 依赖 implementation 'com.getui:gtsdk:${version}',此处的 ${version} 为对应的 SDK 版本号,并在android.defaultConfig 下添加 manifestPlaceholders,配置个推相关的应用参数, 如下所示:

       ......
    
       android {
           defaultConfig {
               manifestPlaceholders = [
                   GETUI_APPID       : "your appid",
               ]        
           }
         ......
       }
    
       dependencies {
           implementation 'com.getui:oneid:1.0.0.0'  //OneID SDK
           implementation 'com.getui:gtc:3.2.13.0'  //个推核心组件
       }  
    

2.3 其他说明(重要)

AndroidManifest文件添加标签,适配 android11及以上

  • queries标签对gradle版本有要求,建议升级到4.0.1及以上。或使用3.3.3 、3.4.3 、 3.5.4 、 3.6.4版本
</manifest>

//......
 <queries>
        <intent>
            <action android:name="com.getui.sdk.action" />
        </intent>
    </queries>
//......

</manifest>

3. 编写集成代码

初始化 SDK

  1. 初始化 SDK,接收OneID

    • 建议您在Application或首页的OnCreate方法中,初始化OneID,接收初始化结果。请参考下列代码实现初始化方法:

      OneIDManager.getInstance().initialize(getApplicationContext(), new OneCallback() {
              @Override
              public void onSuccess(OneResponse response) {
                 //初始化成功,获取唯一id回调结果
                 Log.d("OneId", "oneId = " + response.getOneAID());
      
              }
      
              @Override
              public void onFailure(Throwable t) {
                 //初始化失败,错误信息回调
                Log.d("OneID", "错误信息 = " + t.toString());
              }
          });
      

更多API接口详情见API文档

文档中心搜索

技术
咨询

微信扫一扫

随时联系技术支持

在线
咨询