Android Studio External Tools: 自

一. 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语言头文件

项目结构如下:

62D40C52-A66F-4163-A356-E20199140613.png

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 -> 点击"加号"添加一个扩展工具 -> 填写工具信息
如下图所示:

76B3A0B5-32E5-4480-89C0-8790C84C31EC.png

b. 怎么使用?

操作步骤: 在native方法所在的类上右键 -> My Tools -> 点击javah (generate c header file), 如下图:

javah扩展工具的使用步骤.png

这时会在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 注意, 最后面是类的全名称
这样会在命令行输出下面的信息:

"javap -c 类名"的输出信息.png
如果单纯是想看方法的签名, 用-s操作会更加清晰, 即:
javap -s com.stone.jni_demo.network.ApiTools
输出如下:
"javap -s 类名"的输出信息.png

0x02. javap扩展工具查看字节码信息

a. 操作和javap扩展工具一样, 只是信息界面填写的信息不一样, 下面是javap扩展工具的信息界面填写的信息:

javap扩展工具的信息填写界面.png

b. 如何使用?

操作步骤: 在字节码文件上右键 -> "My Tools" ->点击"disassembling (javap -c)"
如下图所示:

javap扩展工具的使用步骤.png

注意: 不能操作classpath下的字节码文件 (猜测是权限问题, 但是我把字节码文件权限改成777以及给父目录添加了读写权限还是操作不能执行成功, 具体原因不明, 知道的童鞋给要告诉我哦, 非常感谢!)

如果操作classpath(<MODULE_PATH>/build/intermediates/classes/debug)下的字节码会出现下面的错误提示:

操作classpath下的字节码文件出现的错误提示.png

下面的非常重要

**因此, 需要把字节码文件从classpath目录下copy出来, 我是copy到module的根目录下了, 即app目录下, 如下图所示: **

将字节码文件从classpath中拷贝到module根目录下.png

这时候你在copy出来的字节码文件上右键操作即可成功, 输出如下:

使用javap扩展工具查看字节码信息.png

四. 打debug/release包

下面这两个 (当然你还可以定制跟多的扩展工具) 扩展工具主要是为了减少输入而已, 因为本人喜欢用命令行编译或安装, 如: ./gradlew :app:assembleDebug, ./gradlew :myAndroidLibrary:assemRelease, ./gradlew :app:installDebug , ....

一般编译debug/release包的时候会在项目根目录下执行:
./gradlew :someApplicationModule:assembleDebug, ./gradlew :someApplicationModule:assembleRelease
下面的两个扩展工具就是根据这个思路来配置的啦 ...

0x01. 打debug包

a. 操作步骤跟之前的扩展工具一样, 下面看看扩展工具的信息填写界面:

assembleDebug扩展工具.png

b. 如何使用?

操作步骤: 在android application module或者android library module上右键 -> My Tools -> 点击assembleDebug (注意啦, java module是没有assembleDebug和assembleRelease task的)
如下图所示:

assembleDebug扩展工具的使用步骤.png

0x02. 打release包

打release包的模式跟打debug包一样, 只要把扩展工具信息页中的debug字样替换成release即可, 下面标出了要替换的地方:

assembleRelease扩展工具的信息填写页面.png

前面有个地方忘记说明了, 扩展工具信息填写页面的$SomeVariable$,其实是AS定义的一些宏, 每个宏都有说明, 可以自己查看啰:

插入宏变量.png

Android Studio的External Tools功能真心强大, 更多工具等待你去定制哟, 赶紧用起来吧 - -

本文只针对 mac os 系统, 其他操作系统请自行变通 .

References:
https://www.jetbrains.com/help/idea/2017.1/external-tools.html