极光画像 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.** { *; }

此代码块在浮窗中显示