下载源码

本文示例的termux-x11仓库提交后为05bebd4(2024-4-9)

git clone https://github.com/termux/termux-x11

安装编译环境

特别强调，操作系统硬件平台必须为x86_64，否则，编译可能报错，如：在arm64 CPU环境下，提示“build-tools/34.0.0/aidl: 6: Syntax error: Unterminated quoted string”等错误

以ubuntu-22.04为例。

下载java sdk

至少需要jdk 17版本，否则编译出错

sudo apt install openjdk-17-jdk

下载交叉编译环境

首先，在Download Android Studio官网上下载命令行工具，本案例采用linux版本（commandlinetools-linux-11076708_latest.zip），将其解压至编译系统中，解压后目录名为cmdline-tools

unzip commandlinetools-linux-11076708_latest.zip

其次，通过sdkmanager下载android SDK，Android NDK，以及build-tools

mkdir -p //tmp/Android/Sdk/
cmdline-tools/bin/sdkmanager --sdk_root=/tmp/Android/Sdk "platforms;android-34"
cmdline-tools/bin/sdkmanager --sdk_root=/tmp/Android/Sdk "ndk;26.3.11579264"
cmdline-tools/bin/sdkmanager --sdk_root=/tmp/Android/Sdk "build-tools;34.0.0"

交叉编译

首先，修改配置文件，主要是termux-x11/app/build.gradle文件，只编译arm64-v8a版本，ndk指定为26版本，默认使用的sdk为android-14.

diff --git a/app/build.gradle b/app/build.gradle
index 5f70921..72e5275 100644
--- a/app/build.gradle
+++ b/app/build.gradle
@@ -23,7 +23,7 @@ android {
         enable true
         reset()

-        include "x86", "x86_64", "armeabi-v7a", "arm64-v8a"
+        include "arm64-v8a"
         universalApk true
     }

@@ -42,6 +42,7 @@ android {
             optimizeCode true
         }
     }
+    ndkVersion '26.3.11579264'
 }

 dependencies {

其次，准备好gradle源，修改termux-x1/gradle/wrapper/gradle-wrapper.properties文件配置

--- a/gradle/wrapper/gradle-wrapper.properties
+++ b/gradle/wrapper/gradle-wrapper.properties
@@ -1,7 +1,7 @@
 distributionBase=GRADLE_USER_HOME
 distributionPath=wrapper/dists
 distributionSha256Sum=194717442575a6f96e1c1befa2c30e9a4fc90f701d7aee33eb879b79e7ff05c0
-distributionUrl=https\://services.gradle.org/distributions/gradle-8.7-all.zip
+distributionUrl=https\://mirrors.cloud.tencent.com/gradle/gradle-8.7-all.zip
 networkTimeout=10000
 validateDistributionUrl=true
 zipStoreBase=GRADLE_USER_HOME

再次，设置ANDROID_HOME环境变量

export ANDROID_HOME=/tmp/Android/Sdk

最后，交叉编译，编译debug版本，若要编译release版本，将目标改为assembleRelease。

cd termux-x11/
./gradlew assembleDebug

编译后生成了两个主要apk文件

./shell-loader/build/outputs/apk/debug/shell-loader-debug.apk
./app/build/outputs/apk/debug/app-arm64-v8a-debug.apk

数字签名

shell-loader在debug版本中未签名，无法直接安装，由于shell-loader使用了android:sharedUserId="android.uid.system"，需要使用Android系统的证书和密钥（platform.pk8和platform.x509.pem）签名。Android SDK Build Tools提供了apksigner签名工具。

密钥证书：在Android系统工程”build/target/product/security”目录下，密钥文件platform.pk8，证书文件platform.x509.pem
签名工具：在Android Studio下载的build-tools目录下，/tmp/Android/Sdk/build-tools/34.0.0/apksigner

apksigner sign --key platform.pk8 -cert platform.x509.pem shell-loader/build/outputs/apk/debug/shell-loader-debug.apk
adb install shell-loader/build/outputs/apk/debug/shell-loader-debug.apk

由于shell-loader未定义为Android的application，因此无法在Android中启动。

4.1.3 termux-x11编译