如何通过终端创建签名APK？适配CI/CD与Firebase部署

未签名的Release APK无法通过Android系统的安装校验，这就是你遇到“invalid package”错误的核心原因。以下是完整的解决方案：

1. 生成签名密钥库（Keystore） #

如果还没有签名密钥，通过终端执行以下命令生成：

keytool -genkey -v -keystore my-release-key.jks -keyalg RSA -keysize 2048 -validity 10000 -alias my-alias

按提示依次输入密钥库密码、密钥密码、个人信息等，完成后当前目录会生成my-release-key.jks文件——务必妥善保存该文件和所有密码，丢失后无法发布应用更新。

2. 配置项目签名信息 #

• 在项目根目录的gradle.properties中添加密钥配置（替换为你的实际信息）：

MYAPP_RELEASE_STORE_FILE=my-release-key.jks
MYAPP_RELEASE_STORE_PASSWORD=你的密钥库密码
MYAPP_RELEASE_KEY_ALIAS=my-alias
MYAPP_RELEASE_KEY_PASSWORD=你的密钥密码

• 打开app/build.gradle文件，在android块内配置签名规则并关联到Release构建：

android {
    ...
    signingConfigs {
        release {
            storeFile file(MYAPP_RELEASE_STORE_FILE)
            storePassword MYAPP_RELEASE_STORE_PASSWORD
            keyAlias MYAPP_RELEASE_KEY_ALIAS
            keyPassword MYAPP_RELEASE_KEY_PASSWORD
        }
    }
    buildTypes {
        release {
            ...
            signingConfig signingConfigs.release // 将签名绑定到Release构建
        }
    }
}

保存后执行./gradlew clean清理旧构建缓存。

3. 终端生成签名Release APK #

执行以下命令生成可正常安装的签名APK：

./gradlew assembleRelease

生成的APK位于app/build/outputs/apk/release/目录下，文件名通常为app-release.apk。

4. 对接Firebase分发 #

• 确保项目已接入Firebase：若未接入，在Firebase控制台创建项目并添加Android应用，下载google-services.json放入app/目录，同时在build.gradle中添加Firebase依赖。
• 进入Firebase控制台的App Distribution模块，点击「上传APK」，选择刚才生成的app-release.apk。
• 配置测试群体、发布说明后即可完成分发，测试人员可通过通知或链接下载安装。

校验签名有效性 #

如果仍有安装问题，可通过以下命令验证APK签名是否有效：

apksigner verify --verbose app/build/outputs/apk/release/app-release.apk

输出中出现Verified using v1 scheme (JAR signing): true和Verified using v2 scheme (APK Signature Scheme v2): true，则说明签名正常。

内容的提问来源于stack exchange，提问作者rasim altuntaş