SDK集成

一、开发运行环境

AndroidStudio --- 推荐使用v2.0及以上的版本

Android Plugin --- v2.2.3以上版本

classpath 'com.android.tools.build:gradle:2.2.3'

Gradle Version --- v2.14+

distributionUrl=https\://services.gradle.org/distributions/gradle-2.14.1-all.zip

二、SDK集成

步骤1. 创建产品

在 AppCooking运营后台创建产品后取得 Token、 API Secret、 URL Scheme 信息。

[注意] 为了更好地分析和处理数据，Android与iOS仍属于不同平台的两个应用，无法共同使用同一个token，需要分别创建产品。

步骤2. 引入SDK

1) 下载AppCooking SDK。

SDK载点 : http://download.appcook.in/Android/Latest/AppCooking_Android.zip

2) 把解压缩文件中的aar包放到Androidstudio中的libs文件夹下。

3) 在項目的主build.gradle中的repositories添加以下代码

allprojects {
    repositories {
        jcenter()
        flatDir{
            dirs 'libs'
        }
    }
}

4) 在app的build.gradle中的dependencies添加以下代码

compile(name:'AppCooking',ext:'aar')

步骤3. 设置AndroidManifest.xml

1) 声明使用权限

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

<!-- optional -->
<uses-permission android:name="android.permission.READ_PHONE_STATE"/>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
<uses-permission android:name="android.permission.BLUETOOTH"/> 
<uses-permission android:name="android.permission.WAKE_LOCK"/>

// 备注：建议测试的设备可以主动将WAKE_LOCK(屏幕常亮)权限开启，避免在与后台连接设置事件或实验时灭屏，导致连线中断。

2) 设置scheme : 在程序的MainAcitivity中添加<intent-filter>

將<product_scheme>替换为您的产品scheme(在产品设置页面中的URL Scheme栏位取得)。

<intent-filter>
<action android:name="android.intent.action.VIEW"/>
<category android:name="android.intent.category.DEFAULT"/>
<category android:name="android.intent.category.BROWSABLE"/>
<data android:scheme="<product_scheme>"/>
</intent-filter>

3) 添加receiver

<receiver android:name="com.appcooking.android.acmetrics.InstallReferrerReceiver" android:exported="true">
<intent-filter>
<action android:name="com.android.vending.INSTALL_REFERRER"/>
</intent-filter>
</receiver>

步骤4. SDK初始化 :设置产品token、api secret。

将<product_token_>、<_product_api_secret>替换为您的产品token与api secret(在产品设置页面中取得)。

AppCookAPI.getInstance(getApplicationContext(), "<product_token>", "<product_api_secret>");

注：SDK初始化只需要在应用的Application中的onCreate（）方法中调用。

步骤5. (Optional) 混淆配置

APP如果需要混淆代码：需要在APP目录下的proguard-rules.pro文件下添加以下代码

-keep class com.appcooking.android.** { *; }

Android SDK集成