Android SDK - Ant安装方法

1. 配置 ANT

  • 第一步:下载最新的 OneAPM Android SDK
  • 第二步:添加 oneapm-android-agent.jar 到工程 libs 目录中,如果项目中没有 libs 目录,请创建一个新的 libs 目录
  • 第三步:设置 ANT_OPTS 环境变量

Mac OS / Linux 环境

        export ANT_OPTS="-javaagent:/path/to/oneapm/class.rewriter.jar"

Windows 环境

  • 方法一:“在我的电脑右键->属性->高级系统设置->环境变量->添加环境变量”,如下图: 

    其中 “/path/to/oneapm/” 请用你实际存放 OneAPM 的 class.rewriter.jar 的路径替换。

    不要放在工程的libs目录中!

  • 方法二:在命令行中设置

    set ANT_OPTS="-javaagent:/path/to/oneapm/class.rewriter.jar"

注意:请勿将该环境变量 ANT_OPTS 永久设置到用户或系统环境变量里,否则会影响其他不需要进行嵌码的 Android 项目。建议在单次编译的命令行状态下临时设置该环境变量,或单独在需要嵌码项目的批处理编译脚本中设置该环境变量。

2. 设置 App 权限

构建完成后,请在待监测的 App 工程的 AndroidMainfest.xml 文件中增加以下的权限:

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

3. 配置 Agent

  • 第一步:在应用的主 Activity 的 class 中,添加

  • import com.blueware.agent.android.BlueWare;
  • 第二步:在 onCreate 方法中,添加

  • BlueWare.withApplicationToken("ApiKey").start(this.getApplication());

    注意:APIKey 由 oneapm 分发,每个应用对应一个唯一的 APIKey。

4. 生成 build.xml

  • 第一步:首先确保已经安装了 Ant 构建环境和 Android 开发环境;

  • 第二步:在待监测的 App 工程根目录下执行:
    android update project –p .

  • 第三步:生成 build.xml 文件。

注意:Android 命令在 Android SDK 目录的 tools 子目录下,需要您设置好 PATH 环境变量,才可直接使用 Android 命令行。

5. 编译安装

  • 第一步:设置混淆器

    如果 App 使用 ProGuard 工具来优化发布的 apk 包,为了保证 App 监测 SDK 可以正常使用,请在所属项目的 proguard.cfg 文件中加入以下的内容:

        -dontwarn org.apache.commons.**
        -keep class org.apache.http.impl.client.**
        -dontwarn org.apache.commons.**
        -keep class com.blueware.** { *; }
        -dontwarn com.blueware.**
        -keepattributes Exceptions, Signature, InnerClasses
    
  • 第二步:使用 Ant 重新编译并安装 App,在项目根目录下运行:

    ant clean release install
    

静候 5 分钟后,若无应用程序相关性能数据展现,或安装过程中出现问题:请联系 OneAPM 客服人员:

        技术咨询热线: 400-622-3101

        销售咨询热线: 400-659-1230

        OneAPM客服邮箱:support@oneapm.com

 

还有其他问题? 提交请求

您还可以采取以下方式解决问题: