跳转至

Android_Apk_Signing

本章节中将介绍如何对 APK 进行系统签名。

获取APK签名密钥

从百度网盘中获取密钥。

Tip

可从主板平台源码路径获取密钥，或从对应主板平台的网盘中获取。

A133 Android SDK 源码密钥路径：

(SDK)$ ls android/build/target/product/security/
platform.pk8 platform.x509.pem

H618/RK3576 Android SDK 源码密钥路径：

(SDK)$ ls build/target/product/security/
platform.pk8 platform.x509.pem

RK3562/RK3568/RK3588 Android SDK 源码密钥路径：

(SDK)$ ls device/rockchip/common/security/
 platform.pk8     platform.x509.pem

获取 keytool-importkeypair 工具

从百度网盘中获取keytool-importkeypair工具。

制作平台密钥库JKS

1. 存放系统签名文件和 keytool-importkeypair 到同一级目录下。

mkdir sign_key/
ls sign_key/
platform.pk8    platform.x509.pem   keytool-importkeypair

2. 使用 keytool 生成 jks 文件。

keytool-importkeypair 用法：

keytool-importkeypair: Missing option, exiting...
usage: keytool-importkeypair [-k keystore] [-p storepass]
-pk8 pk8 -cert cert -alias key_alias

This script is used to import a key/certificate pair
into a Java keystore.

If a keystore is not specified then the key pair is imported into
~/.keystore in the user's home directory.

The passphrase can also be read from stdin.

操作示例：

./keytool-importkeypair -k ./platform.jks -p android -pk8 platform.pk8 -cert platform.x509.pem -alias android

Note

-k ./platform.jks ：指定生成 jks 文件名为 platform.jks
-p android ： 指定密码为 android
-pk8 platform.pk8 ：指定 pk8 文件路径
-cert platform.x509.pem ：指定 pem 文件路径
-alias android 指定别名为： android

对APK进行系统签名

Android Studio 方式

1. Build -> Generate Signed App 选择生成带签名的APK。

image-20250603141117161

2. 选择生成APK（App Bundle 生成的是 aab 文件）。

image-20250603141754390

3. 选择系统 jks，输入对应的别名和密码。

image-20250603142034270

apksigner 方式

apksigner 用法：

USAGE: apksigner <command> [options]
       apksigner --version
       apksigner --help

EXAMPLE:
       apksigner sign --ks release.jks app.apk
       apksigner verify --verbose app.apk

apksigner is a tool for signing Android APK files and for checking whether
signatures of APK files will verify on Android devices.

        COMMANDS
rotate                Add a new signing certificate to the SigningCertificateLineage

sign                  Sign the provided APK

verify                Check whether the provided APK is expected to verify on
                      Android

lineage               Modify the capabilities of one or more signers in an existing
                      SigningCertificateLineage

version               Show this tool's version number and exit

help                  Show this usage page and exit

操作示例：

apksigner sign --ks platform.jks --ks-key-alias android --out app-signed.apk app-debug.apk

Note

--ks platform.jks ：指定 jks 文件路径。
--ks-key-alias android ：与 jks 中的别名一致。
--out app-signed.apk ：指定签名后apk的命名。
app-debug.apk ：指定需要签名的apk路径。

java 方式

在源码中进行重签（确保已经编译过源码）。

1. 配置 Android java 环境。

H618 平台：

source build/envsetup.sh
source device/softwinner/.BoardConfig.mk
lunch apollo_p2-userdebug

A133 平台：

source build/envsetup.sh
lunch ceres_c3-userdebug

RK3562 / RK3568 / RK3576 / RK3588 平台：

./build.sh lunch 
source device/rockchip/.BoardConfig.mk
source build/envsetup.sh 
lunch $TARGET_PRODUCT-$BUILD_VARIANT

2. 利用 java 进行签名。

Tip

不同平台根据实际签名文件路径，替换 platform.pk8 platform.x509.pem 路径。

$ java -Xmx2048m -Djava.library.path="out/host/linux-x86/lib64" \
-jar out/host/linux-x86/framework/signapk.jar  --disable-v2 \
-w device/rockchip/common/security/platform.x509.pem \
device/rockchip/common/security/platform.pk8 \
old.apk new.apk

Note

java：启动 Java 虚拟机（JVM）的命令。
-Xmx2048m：设置 JVM 最大堆内存为 2048MB（2GB），避免签名过程中因内存不足报错。
-Djava.library.path="out/host/linux-x86/lib64"：指定 Java native 库（C/C++ 编写的库）的搜索路径，这里指向 Android 编译输出的主机端（Linux x86 架构）库目录，确保签名工具能加载依赖的原生库。
-jar out/host/linux-x86/framework/signapk.jar：指定执行 signapk.jar 这个工具（Android 源码中用于 APK 签名的官方工具，位于编译输出的主机端框架目录）。
--disable-v2：禁用 APK 签名方案 V2（仅使用 V1 签名）。
V1 是基于 JAR 的传统签名（生成 META-INF 目录下的签名文件），兼容性好但安全性较低；
V2 是 Android 7.0+ 引入的整体 APK 签名，安全性更高。
禁用 V2 通常是为了兼容旧系统或特定场景（如某些定制系统对 V2 签名支持不完善）
-w platform.x509.pem：指定 公钥证书文件（platform.x509.pem），-w 表示验证证书链的完整性。
platform.pk8：指定 私钥文件（platform.pk8），与上述公钥证书配对，用于实际签署 APK。
old.apk：待签名的原始 APK 文件（可以是未签名、预签名或其他签名的 APK）。
new.apk：签名后生成的新 APK 文件（保存路径和文件名，将覆盖原文件同名文件）。

Android.mk 方式

添加 platform 配置：

LOCAL_CERTIFICATE := platform

操作示例：

LOCAL_PATH := $(call my-dir)
include $(CLEAR_VARS)
LOCAL_MODULE := Test
LOCAL_MODULE_CLASS := APPS
LOCAL_MODULE_TAGS := optional
LOCAL_BUILT_MODULE_STEM := package.apk
LOCAL_MODULE_SUFFIX := $(COMMON_ANDROID_PACKAGE_SUFFIX)
LOCAL_CERTIFICATE := platform
LOCAL_SRC_FILES := Test.apk
include $(BUILD_PREBUILT)

查看APK签名信息

apksigner verify -v --print-certs test.apk