极光画像 Android SDK 集成指南
最近更新:2022-11-22

极光画像 Android SDK 集成指南

使用提示

本文是极光画像 Android SDK 标准的集成指南文档。

本地工程配置

  • 解压压缩包,
    • 将libs下的所有文件复制到工程的libs下面.
      • jcore 和 JPortrait 两个 jar 文件。
      • 所有 CPU 平台的 so 文件。
    • 将res下的所有文件复制到工程的res下面
      • anim、drawable、drawable-xxhdpi 分别对应复制工程相应文件夹
    • 将assets下的所有文件复制到工程的assets下面

手动集成步骤

  • 解压缩 JPortrait-android-x.x.x.zip 集成压缩包。

  • 复制 libs/xxx 到工程 libs/xxx 目录下。

  • 复制 res/xxx 到工程 res/xxx 对应的目录下。

  • 复制 assets/xxx 到工程 assets/xxx 对应的目录下。

  • 复制 libs/(cpu-type)/xxx.so 到你的工程中存放对应cpu类型的目录下。

说明 1:使用android studio的开发者,如果使用jniLibs文件夹导入so文件,则仅需将所有cpu类型的文件夹拷进去;如果将so文件添加在module的libs文件夹下,注意在module的gradle配置中添加一下配置:

android { ...... sourceSets { main { jniLibs.srcDirs = ['libs'] ...... } ...... } ...... } dependencies { implementation fileTree(include: ['*.jar'], dir: 'libs') ...... }
              android {
        ......
        sourceSets {
            main {
                jniLibs.srcDirs = ['libs']
                ......
            }
            ......
        }
        ......
    }

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

        
此代码块在浮窗中显示

说明 2:如果你的应用所选的targetSdkVersion >=28,设备在Android P 上是默认限制使用http请求的。如果需要支持https,开发者需要做如下配置:

a、在res文件夹下创建一个xml文件夹,然后创建一个network_security_config.xml文件,文件内容如下: b、在AndroidManifest.xml文件下的application标签增加以下属性:
          a、在res文件夹下创建一个xml文件夹,然后创建一个network_security_config.xml文件,文件内容如下:

    <?xml version="1.0" encoding="utf-8"?>
    <network-security-config>
        <base-config cleartextTrafficPermitted="true">
            <trust-anchors>
                <certificates src="system" />
            </trust-anchors>
        </base-config>
    </network-security-config>
b、在AndroidManifest.xml文件下的application标签增加以下属性:

<application
...
 android:networkSecurityConfig="@xml/network_security_config"
...
    />

        
此代码块在浮窗中显示

配置 AndroidManifest

AndroidManifest 示例

          <?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="您应用的包名"
    android:versionCode="100"
    android:versionName="1.0.0"
    >
    <uses-sdk android:minSdkVersion="9" android:targetSdkVersion="23" />


    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />


    <!-- 可选 -->
    <!-- Optional. Required for location feature -->
    <!-- 为了提高sdk识别唯一用户的能力,用于画像分析,建议集成以下权限(可选)-->
    <uses-permission android:name="android.permission.READ_PHONE_STATE" />
    <uses-permission android:name="android.permission.QUERY_ALL_PACKAGES" />
    <uses-permission android:name="android.permission.GET_TASKS" />
    <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />

    <!-- 位置信息数据用于画像分析,您可选择集成以下权限(可选)-->
    <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
    <uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" />

    <!-- 扩展备用权限(可选)-->
    <permission android:name="${applicationId}.permission.JOPERATE_MESSAGE" android:protectionLevel="signature"/>
    <uses-permission android:name="${applicationId}.permission.JOPERATE_MESSAGE" />
    <!-- 可选 -->

    <application
        android:icon="@drawable/ic_launcher"
        android:label="@string/app_name"
        android:name="Your Application Name">

        <!-- Required -->
        <meta-data android:name="JPUSH_APPKEY" android:value="您应用的Appkey"/>
        <meta-data android:name="JPUSH_CHANNEL" android:value="developer-default"/>

    </application>
</manifest>

        
此代码块在浮窗中显示

混淆配置

  • 请下载 4.x 及以上版本的 proguard.jar, 并替换你 Android SDK "tools\proguard\lib\proguard.jar"
  • 请在工程的混淆文件中添加以下配置:
-dontoptimize -dontpreverify -dontwarn cn.jiguang.** -keep class cn.jiguang.** { *; }
              -dontoptimize
    -dontpreverify
    -dontwarn cn.jiguang.**
    -keep class cn.jiguang.** { *; }


        
此代码块在浮窗中显示
文档内容是否对您有帮助?

Copyright 2011-2022, jiguang.cn, All Rights Reserved. 粤ICP备12056275号-13 深圳市和讯华谷信息技术有限公司

在文档中心打开