一. Android Studio External Tools
AS扩展工具, 可以让我们自定义一些命令行工具. 比如说: 自动生成JNI头文件, 反编译Java字节码文件(查看某个类的方法签名), 打debug/release包等等.
下面就来看看如何利用Android Studio External Tools机制类实现这些功能.
二. JNI开发中生成c头文件
在JNI开发中我们的Java Native方法都会对应到c语言中的Native方法. 一般我们先在Java中先声明native方法, 然后在用javah来生成头文件. 不过javah这个命令使用起来特别不方便, 应为需要输入文件路径(或者类名). 这时我们可以使用Android Studio External Tools来扩展一个图形工具, 来简化繁杂的命令输入:
0x01. 用javah命令生成C语言头文件
项目结构如下:
a. 在Java文件中编写native方法, 如下:
public final class ApiTools {
static {
//加载本地库文件 (省略前缀lib和后缀.so)
System.loadLibrary("mynative"); //加载libmynative.so文件
}
private ApiTools() {
//no instance
}
/**
* 请求一个API
* @param apiString API地址
* @param callback 回调对象
* @param <T> api请求的数据类型
*/
public static <T> void request(String apiString, Callback<T> callback) {
request(apiString, getSignString(), callback);
}
private static <T> void request(String apiString, String signString, Callback<T> callback) {
// TODO: 17/4/17 require implemnt
}
// 本地方法 (对应到C/C++中的本地方法)
private static native String getSignString();
}
b. 切换到源文件根目录下: cd app/src/main/java
c. 生成C语言头文件: javah -d jni -jni com.stone.jni_demo.network.ApiTools
0x002. javah扩展工具生成C语言头文件
a. 操作步骤:
Perferences -> External Tools -> 点击"加号"添加一个扩展工具 -> 填写工具信息
如下图所示:
b. 怎么使用?
操作步骤: 在native方法所在的类上右键 -> My Tools -> 点击javah (generate c header file), 如下图:
这时会在main目录下面生成jni目录且在此目录下生成C头文件.
三. 反编译Java字节码文件(查看方法签名)
在JNI开发中很多地方需要知道某个方法的签名, 一般会使用javap命令来查看某个类中的方法签名. 和javah命令一样, javap使用起来也比较繁琐, 我们也扩展一个工具来简化它:
0x01. javap命令行反编译字节码文件
a. 进入到classpath目录下:
命令: cd app/build/intermediates/classes/debug
b. 反编译字节码文件(<PROJECT>/app/app/build/intermediates/classes/debug/com/stone/jni_demo/network/ApiTools.class):
命令: javap -c com.stone.jni_demo.network.ApiTools 注意, 最后面是类的全名称
这样会在命令行输出下面的信息:
如果单纯是想看方法的签名, 用
-s操作会更加清晰, 即:javap -s com.stone.jni_demo.network.ApiTools输出如下:
0x02. javap扩展工具查看字节码信息
a. 操作和javap扩展工具一样, 只是信息界面填写的信息不一样, 下面是javap扩展工具的信息界面填写的信息:
b. 如何使用?
操作步骤: 在字节码文件上右键 -> "My Tools" ->点击"disassembling (javap -c)"
如下图所示:
注意: 不能操作classpath下的字节码文件 (猜测是权限问题, 但是我把字节码文件权限改成777以及给父目录添加了读写权限还是操作不能执行成功, 具体原因不明, 知道的童鞋给要告诉我哦, 非常感谢!)
如果操作classpath(<MODULE_PATH>/build/intermediates/classes/debug)下的字节码会出现下面的错误提示:
下面的非常重要
**因此, 需要把字节码文件从classpath目录下copy出来, 我是copy到module的根目录下了, 即app目录下, 如下图所示: **
这时候你在copy出来的字节码文件上右键操作即可成功, 输出如下:
四. 打debug/release包
下面这两个 (当然你还可以定制跟多的扩展工具) 扩展工具主要是为了减少输入而已, 因为本人喜欢用命令行编译或安装, 如: ./gradlew :app:assembleDebug, ./gradlew :myAndroidLibrary:assemRelease, ./gradlew :app:installDebug , ....
一般编译debug/release包的时候会在项目根目录下执行:
./gradlew :someApplicationModule:assembleDebug, ./gradlew :someApplicationModule:assembleRelease
下面的两个扩展工具就是根据这个思路来配置的啦 ...
0x01. 打debug包
a. 操作步骤跟之前的扩展工具一样, 下面看看扩展工具的信息填写界面:
b. 如何使用?
操作步骤: 在android application module或者android library module上右键 -> My Tools -> 点击assembleDebug (注意啦, java module是没有assembleDebug和assembleRelease task的)
如下图所示:
0x02. 打release包
打release包的模式跟打debug包一样, 只要把扩展工具信息页中的debug字样替换成release即可, 下面标出了要替换的地方:
前面有个地方忘记说明了, 扩展工具信息填写页面的$SomeVariable$,其实是AS定义的一些宏, 每个宏都有说明, 可以自己查看啰:
Android Studio的External Tools功能真心强大, 更多工具等待你去定制哟, 赶紧用起来吧 - -
本文只针对 mac os 系统, 其他操作系统请自行变通 .
References:
https://www.jetbrains.com/help/idea/2017.1/external-tools.html
