• 前言
    • 人生南北多歧路,君向潇湘我向秦

一、关于 jack-server

Jack (Java Android Compiler Kit)是 Android 的一个工具链,包含:

  • Jack:编译 Java 代码到 Dalvik 字节码
  • Jill:将 Java 库转换为 Jack 库格式
  • Jack server:一个常驻后台服务,用于缓存和加速编译过程

从 AOSP Android N(7.0) 首次引入,AOSP Android P(9.0) 正式弃用;

二、常见问题

日志文件目录: ~/.jack-server/logs

工具目录:$AOSP/prebuilts/sdk/tools/jack-admin

2.1、端口占用

Communication error with Jack server (58), try 'jack-diagnose' or see Jack server log
Failed to contact Jack server: Problem reading /home/user3/.jack-server/client.pem. Try 'jack-diagnose'

一般是编译突然中止(多用户编译占用端口导致),使用 netstat -ap | grep 8076 查看端口号是否占用;
若占用需修改 ~/.jack-server/config.properties 以及 ~/.jack-settings 默认内容如下:

cat ~/.jack-settings 

# Server settings
SERVER_HOST=localhost
SERVER_PORT_SERVICE=8076
SERVER_PORT_ADMIN=8077
# Internal, do not touch
SETTING_VERSION=4

cat ~/.jack-server/config.properties 

#Thu Oct 16 15:35:31 CST 2025
jack.server.idle=180
jack.server.max-service.by-mem=1\=2147483648\:2\=3221225472\:3\=4294967296
jack.server.shutdown=21600
jack.server.time-out=7200
jack.server.max-jars-size=104857600
jack.server.service.port=8076
jack.server.admin.port=8077
jack.server.config.version=4
jack.server.max-service=4
jack.server.deep-idle=900

重新配置用户端口(1024-49151) 部分特殊端口可能被应用占用,比如 3306、3389、8080、8888 等,建议使用 netstat -ap | grep [端口号] 查看端口号是否占用,例如修改

配置 端口号
SERVER_PORT_SERVICE 8066
jack.server.service.port
SERVER_PORT_ADMIN 8067
jack.server.admin.port
注意:两组值需相互一致

2.2、文件权限异常

17:23:05.497: SEVERE: com.android.jack.launcher.ServerLauncher: Server 1 Exception
com.android.jack.server.api.v01.ServerException: '.' has the following invalid permissions ---rwxrwx
    at com.android.jack.server.JackServerImpl.run(JackServerImpl.java:71)
    at com.android.jack.launcher.ServerLauncher$3.run(ServerLauncher.java:392)
    at java.lang.Thread.run(Thread.java:748)
Caused by: java.io.IOException: '.' has the following invalid permissions ---rwxrwx
    at com.android.jack.server.PosixFileAccess.checkAccessibleOnlyByOwner(PosixFileAccess.java:62)
    at com.android.jack.server.JackHttpServer.getCurrentUser(JackHttpServer.java:1232)
    at com.android.jack.server.JackHttpServer.<init>(JackHttpServer.java:525)
    at com.android.jack.server.JackServerImpl.run(JackServerImpl.java:66)
    ... 2 more

需要保证 ~/.jack-server/config.properties 以及 ~/.jack-settings 权限一致:

ls -la ~/.jack-server/

drwx------  4 xx xx    4096 Oct 16 17:03 .
drwxr-x--x 36 xx xx    4096 Oct 16 17:03 ..
-rw-------  1 xx xx    2076 Oct 16 15:35 client.jks
-rw-------  1 xx xx    2786 Oct 16 15:35 client.pem
-rw-------  1 xx xx     356 Oct 16 17:03 config.properties
drwxrwxr-x  2 xx xx    4096 Oct 16 15:35 jack
-rw-------  1 xx xx 5102506 Oct 16 15:35 launcher.jar
drwx------  2 xx xx    4096 Oct 16 17:02 logs
-rw-------  1 xx xx 5522186 Oct 16 15:35 server-1.jar
-rw-------  1 xx xx    2066 Oct 16 15:35 server.jks
-rw-------  1 xx xx    1042 Oct 16 15:35 server.pem

ls -la ~/.jack-settings

-rw------- 1 xx xx 132 Oct 16 17:03 /xx/xx/.jack-settings

# 权限修改: 

chmod 0600 ~/.jack-server/config.properties
chmod 0600 ~/.jack-settings

2.3、启用 TLSv1, TLSv1.1 功能

FAILED: setup-jack-server
/bin/bash -c "(prebuilts/sdk/tools/jack-admin install-server prebuilts/sdk/tools/jack-launcher.jar prebuilts/sdk/tools/jack-server-4.11.ALPHA.jar  2>&1 || (exit 0) ) && (JACK_SERVER_VM_ARGUMENTS=\"-Dfile.encoding=UTF-8 -XX:+TieredCompilation\" prebuilts/sdk/tools/jack-admin start-server 2>&1 || exit 0 ) && (prebuilts/sdk/tools/jack-admin update server prebuilts/sdk/tools/jack-server-4.11.ALPHA.jar 4.11.ALPHA 2>&1 || exit 0 ) && (prebuilts/sdk/tools/jack-admin update jack prebuilts/sdk/tools/jacks/jack-4.32.CANDIDATE.jar 4.32.CANDIDATE || exit 47 )"
Jack server already installed in "/home/user/.jack-server"
Communication error with Jack server (35), try 'jack-diagnose' or see Jack server log
SSL error when connecting to the Jack server. Try 'jack-diagnose'
SSL error when connecting to the Jack server. Try 'jack-diagnose'
[ 10% 541/4980] build out/target/product/rk3399_mid/obj/ETC/precompiled_sepolicy_intermediates/precompiled_sepolicy
ninja: build stopped: subcommand failed.
22:32:18 ninja failed with: exit status 1

查看 prebuilts/sdk/tools/jack-admin 启动命令对应 jdk

~/$AOSP/prebuilts/sdk/tools$ git diff jack-admin
diff --git a/tools/jack-admin b/tools/jack-admin
index f028d27..de737a2 100755
--- a/tools/jack-admin
+++ b/tools/jack-admin
@@ -484,7 +484,7 @@ case $COMMAND in
     if [ "$RUNNING" = 0 ]; then
       echo "Server is already running"
     else
-      JACK_SERVER_COMMAND="java -XX:MaxJavaStackTraceDepth=-1 -Djava.io.tmpdir=$TMPDIR $JACK_SERVER_VM_ARGUMENTS -cp $LAUNCHER_JAR $LAUNCHER_NAME"
+      JACK_SERVER_COMMAND="/usr/lib/jvm/jdk8u392-b08/bin/java -XX:MaxJavaStackTraceDepth=-1 -Djava.io.tmpdir=$TMPDIR $JACK_SERVER_VM_ARGUMENTS -cp $LAUNCHER_JAR $LAUNCHER_NAME"

比如这里是 /usr/lib/jvm/jdk8u392-b08/bin/java ,查询 grep -nr "TLSv1.1" /usr/lib/jvm/jdk8u392-b08/, 如果出现 TLSv1、TLSv1.1 (弱加密算法,存在漏洞) 被禁用,CP 特用的 jdk 进行配置;

2.4、常用命令

# 清除所有配置(可选)
rm -rf ~/.jack-server
rm -rf ~/.jack-settings
rm -rf ~/.jack

# 注意:如果是卸载服务、清除配置之后,第一点配置的端口就会默认为 8076
# 工具目录
cd AOSP/prebuilts/sdk/tools

# 强制结束服务
./jack-admin kill-server

# 启动服务
./jack-admin start-server

# 安装服务
./jack-admin install-server jack-launcher.jar jack-server-4.11.ALPHA.jar

# 卸载服务
./jack-admin uninstall-server

# 日志导出
./jack-admin dump-report

# 日志目录
ls ~/.jack-server/logs

三、总结

jack-server 是低版本编译才会有,高版本使用 Soong + R8 替代