除普通安装方式外,目前还支持Gradle(Android Studio)插件打包方法、Eclipse插件打包方式、Ant插件打包方式和Maven插件打包方式,下面对各安装方式进行详细说明。
Gradle(Android Studio)插件
选择“Gradle(Android Studio)”,点击<下载配置文件(版本)>按钮下载最新版本的配置文件。解压下载的安装包后开始安装,详细说明如下。
引入Cloudwise的Gradle插件
打开工程的的根目录下的build.gradle(Project)文件,如下图所示。
在buildscript模块内添加如下代码:
repositories { jcenter() } classpath 'com.cloudwise.mobile.android.plugins:cloudwise-gradle-plugin:1.5.1'
打开build.gradle(Module:app)文件,添加以下代码,从而使用cloudwise提供的gradle插件功能:
apply plugin: 'cloudwise'
引入cloudwise的SDK实现库
在build.gradle(Module:app)文件中,添加以下代码,从而下载cloudwise提供的SDK实现库:
compile 'com.cloudwise.mobile.android.distribute:cloudwise-mobile-distribute:1.5.1'
添加工程文件
将安装包中的cloudwise-mobile.xml文件添加到工程的assets目录下,如下图所示。
注意:App工程中没有assets目录时,首先在src/main目录下新建一个目录并命名为assets,然后再将文件拖拽到该目录下即可。
添加App Key、设置渠道号、设置网络权限、设置混淆、集成NDK、集成libcurl.so库等后续配置请参考“配置App工程 — 在Android中配置”中的相关内容。
Eclipse插件
选择“Eclipse”,点击<下载Smart SDK for Android(版本)>按钮下载最新版本的Smart SDK(Eclipse版)安装包。解压下载的安装包后开始安装,详细说明如下。
查看Eclipse版本号
Cloudwise Eclipse插件支持Eclipse 3.8及以上版本,请于安装前确认使用的Eclipse版本号。
Mac系统下的查看方法:选择Eclipse菜单,点击进入“About Eclipse”。
Windows & Linux系统下的查看方法:选择Help菜单,点击进入“About Eclipse”或者是“About ADT”。
在顶部的红色区域未见详细版本号时,点击进入“Eclipse Plugin”,选中“Eclipse Platform”即可查看版本号。
安装Eclipse插件
在集成开发环境中打开Eclipse,执行以下操作:
1、选择Help菜单,点击进入“Install New Software...”。
2、点击Work with项右侧的<Add…>按钮,打开“Add Repository“对话框添加 Cloudwise Eclipse 插件。
3、设置插件的名称(比如Cloudwise),点击<Archive...>按钮选择安装包中对应的插件包。
Eclipse 4.4及之后版本使用:Eclipse_plugin_above4.4.zip。
Eclipse 4.4及之前版本使用:Eclipse_plugin_below4.4.zip。
4、在Work with项下方列表中选中上一步添加的资料库,点击<Select All>按钮可选中所有插件。、
5、点击<Next>按钮进入下一步。
注意:为了提高安装速度,请不要勾选“Contact all update sites during install to find required software”。
6、 查看插件描述并点击<Next>按钮进入下一步。
7、 查看许可协议,选择“I accept the terms of the license agreement”,点击<Finish>按钮进入下一步。
8、 选择信任插件的签名证书,点击<OK>按钮确认。
9、 点击<Yes>按钮重启Eclipse完成插件安装。
配置App工程
插件安装完成后,在需要监控的Android工程中点击右键,选择“Install Cloudwise”。
Eclipse会自动添加“cloudwise-mobile-distribute.1.5.1.jar”包到libs目录下,“cloudwise-mobile.xml”到assets目录下。
同时在Console界面中会显示是否安装成功的提示信息,如下图所示。
添加App Key、设置渠道号、设置网络权限、设置混淆、集成NDK、集成libcurl.so库等后续配置请参考“配置App工程 — 在Eclipse中配置”中的相关内容。
Ant插件
选择“Ant”,点击<下载Smart SDK for Android(版本)>按钮下载最新版本的Smart SDK(Ant版)安装包。解压下载的安装包后开始安装,详细说明如下。
添加jar文件到工程
将安装包中的cloudwise-mobile-distribute-1.5.1.jar文件添加到工程的libs目录中,如果项目中没有libs目录,请创建一个新的libs目录。
设置ANT_OPTS环境变量
拷贝cloudwise-mobile-obfus-1.5.1.jar文件到某个目录下或者直接在解压目录下,如:e:\cloudwise-mobile-obfus-1.5.1.jar(Windows系统)或/Users/cloudwise/cloudwise-mobile-obfus-1.5.1. jar(Mac或Linux系统)。
不同系统中设置ANT_OPTS环境变量的方法如下:
Windows系统:
set ANT_OPTS="-javaagent:e:\cloudwise-mobile-obfus-1.5.1.jar"
Mac/Linux系统:
export ANT_OPTS="-javaagent:/Users/cloudwise/cloudwise-mobile-obfus-1.5.1.jar"
注意:
Mac或Linux系统下,cloudwise-mobile-obfus-版本号.jar的路径最好放在/Users/xxx/目录下。如果放在系统目录下,由于权限原因可能会导致一些难以预估的问题。
请勿将该环境变量ANT_OPTS永久设置到用户或系统环境变量里,否则会影响其他不需要进行嵌码的Android项目。建议在单次编译的命令行状态下临时设置该环境变量,或单独在需要嵌码项目的批处理编译脚本中设置该环境变量。
配置App工程
后续需要将安装包中的cloudwise-mobile.xml文件添加到工程的assets目录下,同时需要添加App Key、设置渠道号、设置网络权限、设置混淆、集成NDK、集成libcurl.so库等,详细说明请参考“配置App工程”中的相关内容。
Maven插件
选择“Maven”,点击<下载Smart SDK for Android(版本)>按钮下载最新版本的Smart SDK(Maven版)安装包。解压下载的安装包后开始安装,详细说明如下。
设置环境变量
设置环境变量JDK_TOOLS,变量值设置为:jdk目录下\lib\tools.jar的绝对路径。
安装插件
在配置App工程时,请将示例中的CLOUDWISE_MAVEN_PATH改为下载Smart SDK解压后的路径,如:e:\cloudwise-mobile-obfus-1.5.1.jar(Windows系统)或/Users/cloudwise/cloudwise-mobile-obfus-1.5.1.jar(Mac或Linux系统)。
注册cloudwise-mobile-distribute.jar包为本地maven库
mvn install:install-file -DgroupId=com.cloudwise.mobile -DartifactId=cloudwise-mobile-distribute -Dversion=1.5.1 -Dpackaging=jar -Dfile=CLOUDWISE_MAVEN_PATH\cloudwise-mobile-distribute.jar
注册cloudwise-mobile-obfus.jar包为本地maven库
mvn install:install-file -DgroupId=com.cloudwise.mobile -DartifactId=cloudwise-mobile-obfus -Dversion=1.5.1 -Dpackaging=jar -Dfile=CLOUDWISE_MAVEN_PATH\cloudwise-mobile-obfus.jar
注册 cloudwise-maven-plugin.jar和cloudwise-maven-plugin.pom
mvn install:install-file -DgroupId=com.cloudwise.mobile -DartifactId=cloudwise-maven-plugin -Dversion=1.5.1 -Dpackaging=jar -Dfile=CLOUDWISE_MAVEN_PATH\cloudwise-maven-plugin.jar -DpomFile=CLOUDWISE_MAVEN_PATH\cloudwise-maven-plugin.pom
注意:
"-Dfile="后面不要加空格,否则运行Maven时会报错。
Mac或Linux系统下,cloudwise-mobile-obfus-版本号.jar的路径最好放在/Users/xxx/目录下。如果放在系统目录下,由于权限原因可能导致一些难以预估的问题。
配置本地pom.xml 文件
在pom.xml文件中,添加以下命令到<dependencies/>中,添加刚注册的cloudwise-mobile-distribute依赖包。
<dependency> <groupId>com.cloudwise.mobile</groupId> <artifactId>cloudwise-mobile-distribute</artifactId> <version>1.5.1</version> </dependency>
同时,在pom.xml的最后添加以下命令:
<plugin> <groupId>com.cloudwise.mobile</groupId> <artifactId>cloudwise-maven-plugin</artifactId> <version>1.5.1</version> <executions> <execution> <goals> <goal>instrument</goal> </goals> </execution> </executions> </plugin>
配置App工程
后续需要将安装包中的cloudwise-mobile.xml文件添加到工程的assets目录下,同时需要添加App Key、设置渠道号、设置网络权限、设置混淆、集成NDK、集成libcurl.so库等,详细说明请参考“配置App工程”中的相关内容。