Android APK 平台签名获取

19 阅读1分钟

由于我们自定义的桌面应用程序是支持 soong 和 AS 双编的,使用 Android Studio 打包的 APK 安装失败,报错如下:

Performing Streamed Install adb: failed to install ./app/build/outputs/apk/debug/app-debug.apk: Failure [INSTALL_FAILED_UPDATE_INCOMPATIBLE: Existing package com.tlrobot.home signatures do not match newer version; ignoring!]

这意味着镜像内置编译的包与 Android Studio 编译的包签名不一致,从而导致无法安装。内置的系统应用在 android.bp 中使用的是平台签名,而 AS 中的 gradle 未声明签名(默认使用 .android 的 debug 签名)。我们该如何解决这个问题呢?

有两种解决方式:

  1. apk 编译完成后,对其文件二次重签。
  2. 直接将 platform 签名集成至包中,并放置到系统应用目录中,跟随 gradle 一起打包编译(该方式需格外注意平台签名的安全性,切勿泄露)。

系统源码里平台签名材料就在这:

/mnt/aosp32/TaishanPi-3-Android14/build/target/product/security/
├── platform.pk8        # 私钥 (PKCS8 DER)
├── platform.x509.pem   # 证书
└── platform.pem        # 私钥+证书合一的 PEM(可直用)

把 platform key 转成 JKS,配进 Gradle

由于源码树中不包含 keytool-importkeypair 工具脚本,直接用 openssl + keytool 手动转:

cd build/target/product/security/

# ① pk8(DER) → PEM 私钥
openssl pkcs8 -in platform.pk8 -inform DER -nocrypt -out platform.pk8.pem

# ② 打成 PKCS12(设一个你自己记住的密码,示例用 android)
openssl pkcs12 -export \
  -in platform.x509.pem \
  -inkey platform.pk8.pem \
  -name platform \
  -passout pass:android \
  -out platform.p12

# ③ 再转成 JKS 给 Gradle 用
keytool -importkeystore \
  -srckeystore platform.p12 -srcstoretype PKCS12 -srcstorepass android \
  -destkeystore platform.jks -deststoretype JKS -deststorepass android \
  -alias platform

在 Gradle 里配置签名

在 app/build.gradle(或 build.gradle.kts)里加:

android {
    signingConfigs {
        platform {
            storeFile file("platform.jks")
            storePassword "android"
            keyAlias "platform"
            keyPassword "android"
        }
    }
    buildTypes {
        debug {
            signingConfig signingConfigs.platform
        }
    }
}

这样 AS 每次 Run/Debug 出来的 APK 就和镜像里的 tlrobothome 同一签名,可以直接覆盖安装,也保留系统权限。