Android Jack Server Build

从Android M(6.0)之后，Android 源码build 引入了jack 官方文档

Jack工具的主要优势
• 完全开放源码
源码均在AOSP中，合作伙伴可贡献源码
• 加快编译源码
Jack 提供特殊的配置，减少编译时间：pre-dexing, 增量编译和Jack编译服务器.
• 支持代码压缩，混淆，重打包和multidex
不在使用额外单独的包，例如ProGuard。

1

The .jack library format
Jack 有单独的文件格式.jack, 它包含有预编译的dex代码，允许快速编译（pre-dex）

2

Jack Intermediate Library Linker (Jill)
Jill 工具能够将jar包转换成jack格式，转换过程如下

3

使用Jack 编译Android
当你编译Android时，你不需要修改任何内容。 Jack是Andriod M的默认编译工具。只需使用标准的makefile命令执行即可。
当第一次执行jack时，它会在你的机器上启动一个jack编译服务：
这个服务大大提高了编译速度，因为它避免了启动一个新的JVM，加载Jack代码，初始化Jack和每次编译都要预制JIT，即使在很小的编译过程中，它也很好的节省了时间（例如，在incremental模式）
这个服务也是一个控制Jack并行编译的短期解决方案。它可以限制编译的并行数据量，这样也可以避免内存硬盘溢出问题
当一段时间没有编译活动，Jack 服务会自动关闭，默认它在本地使用了两个TCP端口，且不对外公开。它也提供了很多参数来配置Jack服务，例如并行数量，timeout时间，端口等等。只修改$HOME/.jack 文件即可。
$HOME/.jack 文件
$HOME/.jack 文件包含了Jack服务的设置变量
以下是现在可用的变量说明：

SERVER=true 启用Jack server
SERVER_PORT_SERVICE=8072 编译服务TCP端口.
SERVER_PORT_ADMIN=8073 管理服务TCP端口
SERVER_COUNT=1 目前没用
SERVER_NB_COMPILE=4 最大编译并行数
SERVER_TIMEOUT=60 空闲时间分钟数据，无编译时间超出该时间，将自动关闭服务
SERVER_LOG=${SERVER_LOG:=$SERVER_DIR/jack-$SERVER_PORT_SERVICE.log} 服务器日志存放目录，可被环境变量替换
JACK_VM_COMMAND=${JACK_VM_COMMAND:=java} 默认启动JVM的命令，可被环境变量替换

Jack 问题
1. 你的电脑没有响应或者编译过程出现内存溢出
你可以减少SERVER_NB_COMPILE数量，来减少编译占用内存。
2. Cannot launch background server
很有可能时TCP端口被占用，试着修改SERVER_PORT_SERVICE和SERVER_PORT_ADMIN参数
Jack 限制
• Jack server 默认是单用户的，所以只能同时被一个用户使用。如果需要多个用户同时使用，请每个人都使用不同的端口。也可以通过设置SERVER=false 禁用Jack Server
• CTS 编译会变慢.
• 二进制码有关的工具将不支持, 例如 JaCoCo.
使用Jack特性
Jack支持JDK1.7，并且整合了一下特性
Predexing
当生成Jack包时，dex包将会被生成，并存储到Jack包中，这个过程就是pre-dex，在编译过程中，Jack会为每一个包使用pre-dex.
所有的包都将pre-dexed

4

这里记录一下jack 编译的时会遇到一些问题

1、Android source code compile error: “Try increasing heap size with java option '-Xmx'”
如果出现了这个问题，就是需要分配更多的内存：

export JACK_SERVER_VM_ARGUMENTS="-Dfile.encoding=UTF-8 -XX:+TieredCompilation -Xmx4g"
./prebuilts/sdk/tools/jack-admin kill-server
./prebuilts/sdk/tools/jack-admin start-server

2、Communication error with Jack server (60), try 'jack-diagnose' or see Jack server log
Failed to authenticate Jack server certificate. Try 'jack-diagnose'
Failed to authenticate Jack server certificate. Try 'jack-diagnose

同时修改 $HOME/.jack-settings和$HOME/.jack-server/config.properties中的端口号（比如都改为8086/8087），可支持多用户同时编译
1). $HOME/.jack-settings：

# Server settings
SERVER_HOST=127.0.0.1
SERVER_PORT_SERVICE=8076               // 比如都改为8086/8087
SERVER_PORT_ADMIN=8077                   // 比如都改为8086/8087

# Internal, do not touch
SETTING_VERSION=4

2). $HOME/.jack-server/config.properties：

#Fri Jan 19 10:21:41 CST 2018
jack.server.max-jars-size=104857600
jack.server.max-service=4
jack.server.service.port=8076                           //  都改为8086/8087 和上面settings的值一样
jack.server.max-service.by-mem=1\=2147483648\:2\=3221225472\:3\=4294967296
jack.server.admin.port=8077                            //  都改为8086/8087 和上面settings的
jack.server.config.version=2
jack.server.time-out=7200

3). 注意修改的时候不要改到权限，把文件$HOME/.jack-server/config.properties的权限由rwx改为rw。
3、Jack Server 卸载重装
一般如果还有问题的话卸载重装后配置下就可以解决问题
1). 进入源码相应目录 prebuilts/sdk/tools
./jack-admin kill-server
./jack-admin uninstall-server
2). 需要手动kill
ps ax | grep jack // 查看jack-server 进程
kill 9 XXXX // kill jack-server进程
rm -rf ~/.jack* // 删除home目录下的jack文件
3).
./jack-admin install-server jack-launcher.jar jack-server-4.8.ALPHA.jar
或者直接在源码目下source luanch make会重新自动生成，然后在配置下第二问题情况下端口号就可以了
4、关闭jack编译
参考文章 Android O上如何关闭jack