Firma y empaquetado
Antes conviene leer «Esquemas de firma v1, v2 y v3», «Alineación y zipalign»
1. Qué es y por qué existe
Firmar un APK es añadirle una marca hecha con una clave privada que solo tiene su autor.
Android la comprueba al instalar y, sobre todo, al actualizar: solo acepta una versión nueva si
viene firmada con la misma clave que la instalada, o con una que esa clave haya autorizado. La
clave se guarda en un fichero protegido con contraseña, el almacén de claves (keystore). Junto
a ella va un certificado: la parte pública de la clave, con el nombre de quien firma. Así decide el
sistema si una actualización viene de quien publicó la versión anterior, y así pueden dos
aplicaciones compartir permisos o identidad de usuario.
Android no instala un APK sin firma. Si no está firmado, o la firma está rota, el instalador lo
rechaza con un error genérico que no dice cuál de las dos cosas ha pasado. En el muestrario no
hemos encontrado ni una app sin firma. Por «sin firma» entendemos que no tiene ningún .SF con su
bloque PKCS#7 en META-INF/ ni ninguna firma v2, v3, v3.1 o v3.2 en el APK Signing Block.
Las herramientas que reconstruyen un APK no lo firman. apktool no firma, APKEditor tampoco (por
diseño) y zipalign destruye la firma que hubiera. Por eso todo APK modificado pasa por los
pasos de este documento antes de instalarse.
Aquí está solo el uso: qué herramienta, con qué opciones y en qué orden. El porqué (qué cubre cada
esquema, cómo está construido el APK Signing Block, para qué se alinea) está en el bloque
«Firma», y en particular en
«Alineación y zipalign».
2. El orden del pipeline, que no es negociable
Las apps con un protector comercial (PairIP, DexProtector, Bangcle y similares) se firman igual
que las demás: la mayoría lleva exactamente v2 y v3, como cualquier otra. Qué hace cada protector
cuando recibe un APK modificado y refirmado no se puede medir de forma estática, así que lo
dejamos fuera.
Nada toca el APK después de firmarlo. Cualquier cambio posterior invalida la firma, y por
eso se alinea antes. Alinear es colocar cada entrada sin comprimir del ZIP en un offset múltiplo
de un tamaño dado: 4 bytes para las entradas, 16 KiB para las .so. La documentación oficial de
zipalign lo dice claro: con apksigner, alinear antes de firmar. Solo con el jarsigner
antiguo, que no se recomienda, el orden es el contrario.
Desde build-tools 37.0.0, el paso 2 es además redundante: apksigner sign ya alinea al firmar.
Deja las entradas sin comprimir a 4 bytes y las .so a 16 KiB (--alignment-preserved false y
--lib-page-alignment 16384 por defecto). El paso 2 solo es imprescindible si firmas con otra
herramienta o con --alignment-preserved true. No estorba en ningún caso.
La prueba, con una pieza real del muestrario: tk.hack5.treblecheck (F-Droid, 1.411.896 B,
minSdkVersion 22, targetSdkVersion 33). Tiene cuatro .so sin comprimir, y sus datos empiezan
en offsets que, divididos entre 16.384, dejan restos de 4.096, 12.288, 0 y 4.096. Tres no están
alineadas, así que zipalign -c -P 16 -v 4 responde Verification FAILED (3 BAD). Con
build-tools 37.0.0, en octubre de 2026:
| Qué se hace | Resultado de zipalign -c -P 16 -v 4 |
|---|---|
Nada: el APK original |
Verification FAILED, 3 BAD |
apksigner sign sin zipalign previo |
Verification successful, código 0; las cuatro .so en múltiplo de 16.384 |
apksigner sign --alignment-preserved true |
Verification FAILED, código 1, los mismos 3 BAD |
Puedes repetir las tres filas con zipalign -c -P 16 -v 4, apksigner sign y
apksigner sign --alignment-preserved true sobre esa pieza.
Entonces, ¿para qué sirve el paso 2? Para lo que no venga ya alineado, que es poco fuera del
mercado chino. Entre las piezas con alguna .so sin comprimir, la gran mayoría ya las trae todas
a 16 KiB: el 96 % en F-Droid y el 85 % en el sorteo de Google Play. En el mercado chino, en
cambio, solo 3 de 21.
Hay una excepción conocida a «nada toca el APK después de firmarlo»: los bloques de canal que
añaden algunas tiendas se escriben dentro del APK Signing Block sin invalidar la firma
(«sección 8.1 · Lo que sí se puede añadir después de firmar»).
Esto no es teoría. Se puede comprobar, y la «sección 8 · Qué se rompe si se altera el orden» lo comprueba con salida real.
3. apksigner
La herramienta oficial de firma y verificación de las build-tools. La tenemos instalada, así que
todo lo de esta sección está ejecutado de verdad.
BT=~/Library/Android/sdk/build-tools/37.0.0
$BT/apksigner version
0.9
Cuatro comandos: sign, verify, rotate y lineage.
3.1 verify: leer una firma ajena
Es la orden más útil del documento, porque no requiere claves. La probamos sobre el APK de Maps
Go del muestrario (Google Play, versión 165.0, 2.098.452 B, minSdkVersion 29,
targetSdkVersion 36). Es un APK suelto de móvil:
BT=~/Library/Android/sdk/build-tools/37.0.0
$BT/apksigner verify --verbose --print-certs "com.google.android.apps.mapslite_165.0-165_minAPI29(nodpi)_apkmirror.com.apk"
Verifies
Verified using v1 scheme (JAR signing): false
Verified using v2 scheme (APK Signature Scheme v2): false
Verified using v3 scheme (APK Signature Scheme v3): true
Verified using v3.1 scheme (APK Signature Scheme v3.1): true
Verified using v3.2 scheme (APK Signature Scheme v3.2): false
Verified using v4 scheme (APK Signature Scheme v4): false
Verified for SourceStamp: true
Number of signers: 1
V3.1 Signer: (minSdkVersion=33, maxSdkVersion=2147483647) certificate DN: CN=Android, OU=Android, O=Google Inc., L=Mountain View, ST=California, C=US
V3.1 Signer: (minSdkVersion=33, maxSdkVersion=2147483647) certificate SHA-256 digest: 49262eb97ba0784b6e1a6b3fc80ad45637902229626e98292a359cf5b4d39f00
V3.1 Signer: (minSdkVersion=33, maxSdkVersion=2147483647) key algorithm: RSA
V3.1 Signer: (minSdkVersion=33, maxSdkVersion=2147483647) key size (bits): 4096
V3.0 Signer: (minSdkVersion=24, maxSdkVersion=32) certificate DN: CN=Android, OU=Android, O=Google Inc., L=Mountain View, ST=California, C=US
V3.0 Signer: (minSdkVersion=24, maxSdkVersion=32) certificate SHA-256 digest: 68f72b282eecefd55f660b88e9e29796d846295d2c2627e800c76e33137105eb
V3.0 Signer: (minSdkVersion=24, maxSdkVersion=32) key algorithm: RSA
V3.0 Signer: (minSdkVersion=24, maxSdkVersion=32) key size (bits): 2048
Source Stamp Signer: certificate DN: CN=Android, OU=Android, O=Google Inc., L=Mountain View, ST=California, C=US
Source Stamp Signer: certificate SHA-256 digest: 3257d599a49d2c961a471ca9843f59d341a405884583fc087df4237b733bbd6d
Source Stamp Signer: key algorithm: RSA
Source Stamp Signer: key size (bits): 4096
La salida está recortada: hemos quitado los digests SHA-1 y MD5, las huellas de clave pública, la
marca de tiempo del sello y la línea INFO: SourceStamp: No digests are available in the source stamp for signature scheme: 31. Ejecutado el 31 de octubre de 2026.
Este volcado enseña la firma moderna entera de un vistazo:
- v3.1 con segmentación por SDK. Hay dos firmantes distintos con rangos que no se solapan: la API 24 a 32 con una clave RSA de 2048 bits, y la API 33 en adelante (Android 13) con una de 4096. Es una rotación de clave: los dispositivos antiguos validan con la clave vieja y los nuevos con la nueva. Es casi exclusivo de las apps más instaladas de Google Play, donde lo lleva una de cada diez; en F-Droid e IzzyOnDroid no lo lleva ninguna. En total hay 68 apps con v3.1, casi todas con un linaje de 2 eslabones. En 1.092 de las 1.093 piezas con v3.1, el firmante v3 termina en la API 32, y la clave del firmante v3.1 suele ser RSA de 4096 bits.
- v1 y v2 salen
false, pero no por lo mismo. Ojo:apksigner verifyno dice qué firmas lleva elAPK, sino con cuál lo comprobaría cada versión de Android entre elminSdkVersiony la última. Si una firma más moderna ya sirve, la antigua no se mira y salefalse. Aquí, v1 no está. El bloque v2 sí está, pero no se ha consultado: la orden no lleva--min-sdk-version, así queapksignertoma elminSdkVersiondel manifiesto (29 en Maps Go) y comprueba de la API 29 en adelante. En ese rango un dispositivo verifica con el firmante v3.0 (API 29 a 32) o con el v3.1 (API 33 y siguientes), y cuando encuentra una firma v3 válida no mira la v2. Que un esquema salgafalseno significa que falte («Esquemas de firma → §9 · Por qué un APK moderno lleva v1+v2+v3 (y cuándo se puede omitir v1)»). Y aunque el firmante v3.0 declareminSdkVersion=24, v3 solo se verifica desde la API 28: para instalar en 24-27 hace falta v2. Se ve pidiendo ese rango,--min-sdk-version 24 --max-sdk-version 27: sale v2true, v3falsey el sellotrue. - Sello de origen (source stamp) presente. Identifica a la tienda que distribuyó la app, no
a su autor, y lleva su propio certificado, aparte del de la firma de distribución. En el
muestrario ese certificado es siempre el mismo, uno de Google (
3257d599…), en las 8.982 piezas que lo llevan. Es la marca de Google Play: lo llevan cuatro de cada cinco apps de las más instaladas y casi ninguna fuera de Play. Todas las piezas de una misma app comparten sello.
3.2 sign: firmar de verdad
Pipeline completo ejecutado el 31 de octubre de 2026 sobre org.fossify.math (F-Droid, versión
1.4.0; 7.047.681 B, minSdkVersion 26, targetSdkVersion 36, firmado solo con v2), con un
keystore creado con la orden de la «sección 4.1 · Crear un keystore PKCS#12». Es la calculadora de Fossify; el fichero es byte a
byte el que el muestrario anterior llamaba org.fossify.calculator_1.4.0.apk:
BT=~/Library/Android/sdk/build-tools/37.0.0
# demo-in.apk es una copia de fdroid/org.fossify.math_10.apk
$BT/zipalign -P 16 -f 4 demo-in.apk demo-aligned.apk
$BT/apksigner sign --ks demo.p12 --ks-type PKCS12 --ks-key-alias pruebas-demo \
--ks-pass pass:demopass --key-pass pass:demopass \
--min-sdk-version 24 --max-sdk-version 35 \
--v1-signing-enabled true --v2-signing-enabled true \
--v3-signing-enabled true --v4-signing-enabled true \
--out demo-signed.apk demo-aligned.apk
Sin salida y con código 0. Produce dos ficheros:
-rw-r--r-- 1 jj wheel 7176568 demo-signed.apk
-rw-r--r-- 1 jj wheel 62961 demo-signed.apk.idsig
demo-aligned.apk pesa 7.043.585 B, 4.096 menos que el original. El original ya traía su bloque
de firma v2, y zipalign lo descarta al reescribir el ZIP. Como el original no tenía v1, la
v1 de demo-signed.apk la añade apksigner por pedirle --v1-signing-enabled true: con
--min-sdk-version 24 no la pondría por su cuenta.
Con -p sale exactamente el mismo APK. Las cuatro .so van sin comprimir
(extractNativeLibs=false), y el APK de partida ya las traía alineadas a 16 KiB: empiezan en los
offsets 2.228.224, 2.244.608, 2.260.992 y 2.277.376, todos múltiplos de 16.384. zipalign las
deja donde estaban, con -p y con -P 16, y siguen ahí en demo-signed.apk. Si el APK las
trajera a 4 KiB, solo -P 16 las movería en demo-aligned.apk. Pero daría igual: el apksigner sign siguiente las dejaría a 16 KiB, porque realinea por defecto (--lib-page-alignment 16384 y
--alignment-preserved false). La «sección 2 · El orden del pipeline, que no es negociable» lo comprueba con una pieza real. El offset de los
datos de una entrada es el de su cabecera local más 30, más la longitud del nombre, más la del
campo extra; python3 -I scripts/muestrario/cifras/alineacion_y_16k_1.py --offsets <apk> lib/ lo
calcula.
El .idsig es la firma v4, y viaja al lado del APK, no dentro. Si lo pierdes, pierdes la
firma v4 y con ella la instalación incremental. Lo que se descarga no la incluye: no hay ni un
.idsig en las más de 15.000 piezas del muestrario, ni en sus .apkm, .xapk o carpetas de adb.
Las opciones que importan:
| Opción | Para qué |
|---|---|
--ks <fichero> |
El keystore |
--ks-key-alias <alias> |
Qué clave del keystore usar. Obligatorio si hay más de una |
--ks-pass <formato> |
Contraseña del keystore: pass:, env:, file:, stdin |
--key-pass <formato> |
Contraseña de la clave privada, si difiere |
--ks-type <tipo> |
PKCS12, JKS… |
--key / --cert |
Alternativa al keystore: clave PKCS#8 DER y certificado X.509 sueltos |
--min-sdk-version <n> |
Determina qué esquemas hacen falta. Ver «sección 3.3 · La sutileza de verify que engaña a todo el mundo» |
--max-sdk-version <n> |
Límite superior del rango a cubrir |
--v1-signing-enabled <bool> |
Firma JAR |
--v2-signing-enabled <bool> |
Esquema v2 |
--v3-signing-enabled <bool> |
Esquema v3 |
--v4-signing-enabled <true|false|only> |
Esquema v4; genera el .idsig. only produce solo el .idsig. Sin la opción se activa si el rango de SDK llega a la API 30, así que por defecto casi siempre sale un .idsig |
--rotation-min-sdk-version <n> |
Desde qué API se usa la clave rotada |
--next-signer |
Separa las opciones de un segundo firmante |
--alignment-preserved <bool> |
false por defecto: realinea las entradas stored, a 4 bytes y las .so a la página de la opción siguiente. true conserva la alineación de entrada |
--lib-page-alignment <bytes> |
Alineación de las .so sin comprimir. 16.384 por defecto |
--v1-signer-name <base> |
Nombre base de los ficheros de firma v1 |
--out <fichero> |
Salida. Sin él, firma en el sitio |
-v, --verbose |
Detalle |
Nunca --ks-pass pass:... fuera de una demostración. La contraseña queda en el historial
del shell y en la tabla de procesos. En cualquier uso real, env: o file:.
3.3 La sutileza de verify que engaña a todo el mundo
El APK recién firmado, verificado:
$BT/apksigner verify --verbose --min-sdk-version 24 demo-signed.apk
Verifies
Verified using v1 scheme (JAR signing): false
Verified using v2 scheme (APK Signature Scheme v2): true
Verified using v3 scheme (APK Signature Scheme v3): true
Verified using v3.1 scheme (APK Signature Scheme v3.1): false
Verified using v3.2 scheme (APK Signature Scheme v3.2): false
Verified using v4 scheme (APK Signature Scheme v4): false
Verified for SourceStamp: false
Number of signers: 1
Pedimos v1 y dice false. Pedimos v4 y dice false. ¿Ignoró los flags? No. Los dos
false tienen causas distintas y ninguna es un fallo.
v1: está, pero no se usa en ese rango de API. Los ficheros están físicamente dentro:
unzip -l demo-signed.apk | grep -E "META-INF/(MANIFEST\.MF|[A-Z0-9_-]+\.(SF|RSA))"
156212 01-01-1981 01:01 META-INF/PRUEBAS-.SF
1316 01-01-1981 01:01 META-INF/PRUEBAS-.RSA
156085 01-01-1981 01:01 META-INF/MANIFEST.MF
Y verificando en un rango de API donde v1 sí es necesaria:
$BT/apksigner verify --verbose --min-sdk-version 21 --max-sdk-version 23 demo-signed.apk
Verifies
Verified using v1 scheme (JAR signing): true
Verified using v2 scheme (APK Signature Scheme v2): false
Verified using v3 scheme (APK Signature Scheme v3): false
...
La regla:
apksigner verifyno responde «¿está presente este esquema?» sino «¿se usó este esquema para verificar en el rango de API que me has dado?». Con--min-sdk-version 24, Android prefiere v2/v3 y v1 ni se mira. Con 21-23, solo existe v1 y es la que se usa.
Quien lea esa salida como un inventario de esquemas presentes va a informar mal. Para saber qué
hay dentro, mira el ZIP y el APK Signing Block.
En el muestrario, apksigner verify da por buenas casi todas las piezas (código de salida 0).
Fuera de Google Play verifican todas, y dentro fallan muy pocas: 93 de 7.893 piezas de las más
instaladas y 34 de 1.272 del sorteo. Ninguna carece de firma. Las que no verifican son de dos
clases.
La primera es un caso real de la misma regla. Las 93 de las más instaladas, de 6 apps descargadas
de APKMirror, son splits sueltos que no declaran minSdkVersion y solo llevan v3. apksigner
supone entonces minSdkVersion 1 y exige la firma v1, que no hay. Responde DOES NOT VERIFY con
ERROR: Missing META-INF/MANIFEST.MF, aunque la firma v3 sea correcta. Casi todos son splits de
idioma. Ejemplo: el split split_lenssampledoc.apk de com.microsoft.office.officehubrow (versión
16.0.20611.20024, del .apkm de APKMirror). Para comprobar un split se le pasa un rango que su
base sí cumple, por ejemplo --min-sdk-version 33: con el minSdkVersion de su base (33 en 55 de
ellos, 30 en 38) verifican las 93, con v3. El mismo error sale en la «sección 8 · Qué se rompe si se altera el orden» por otra causa:
allí zipalign quita el bloque de firma.
La segunda clase son las 34 piezas del sorteo, de 9 apps, con el firmante
híbrido de v3.2: con Java 21 apksigner responde «ML-DSA KeyFactory not available». Con Java
25.0.5 verifican las 34 («sección 3.6 · Qué firman las apps reales»).
v4: hay que pasarle el .idsig explícitamente.
$BT/apksigner verify --verbose --min-sdk-version 24 \
--v4-signature-file demo-signed.apk.idsig demo-signed.apk
Verifies
Verified using v1 scheme (JAR signing): false
Verified using v2 scheme (APK Signature Scheme v2): true
Verified using v3 scheme (APK Signature Scheme v3): true
Verified using v3.1 scheme (APK Signature Scheme v3.1): false
Verified using v3.2 scheme (APK Signature Scheme v3.2): false
Verified using v4 scheme (APK Signature Scheme v4): true
Verified for SourceStamp: false
Number of signers: 1
Ahora sí. La firma v4 estaba correcta desde el principio; el verificador no la buscaba.
Opciones de verify:
| Opción | Efecto |
|---|---|
--print-certs |
Certificados: DN, digests SHA-256/SHA-1/MD5, algoritmo y tamaño de clave |
--print-certs-pem |
Además, el PEM por stdout |
--min-sdk-version / --max-sdk-version |
El rango a comprobar. Cambia el veredicto |
--v4-signature-file <fichero> |
El .idsig |
-v, --verbose |
Desglose por esquema |
-Werr |
Los avisos cuentan como error |
3.4 Por qué firmar solo en v1 hoy es no firmar
Firmando el mismo APK únicamente con v1:
$BT/apksigner sign --ks demo.p12 --ks-key-alias pruebas-demo \
--ks-pass pass:demopass --key-pass pass:demopass --min-sdk-version 21 \
--v1-signing-enabled true --v2-signing-enabled false \
--v3-signing-enabled false --v4-signing-enabled false \
--out demo-v1.apk demo-aligned.apk
$BT/apksigner verify --verbose demo-v1.apk
DOES NOT VERIFY
ERROR: Target SDK version 36 requires a minimum of signature scheme v2; the APK is not signed with this or a later signature scheme
WARNING: META-INF/com/android/build/gradle/app-metadata.properties not protected by signature. Unauthorized modifications to this JAR entry will not be detected. Delete or move the entry outside of META-INF/.
WARNING: META-INF/version-control-info.textproto not protected by signature. Unauthorized modifications to this JAR entry will not be detected. Delete or move the entry outside of META-INF/.
Es el mismo DOES NOT VERIFY de siempre, ejecutado el 31 de octubre de 2026 sobre
org.fossify.math. Tras el error salen 104 avisos de entradas de META-INF/ que la firma no
protege; aquí te enseñamos los dos primeros.
La aplicación declara targetSdkVersion 36, y con ese target Android exige v2 como mínimo.
La firma v1 es válida criptográficamente y aun así el APK no se instala.
Esta salida demuestra un dato de la «sección 4.3 de
Comparativa y selección · Cuántas están vivas»: cuatro de las trece herramientas de
manipulación de APK que desglosa firman solo en v1, y sus APK no se instalan en
Android 11 o superior con targetSdk moderno. La herramienta parece funcionar hasta el último paso.
Los WARNING son la otra lección de v1: la firma JAR no cubre las entradas de META-INF/, así
que cualquiera puede modificarlas sin invalidarla. Es la debilidad estructural que motivó v2.
Firmar solo con v1 se sigue viendo, sobre todo en F-Droid, donde lo hace un 8 % de las apps; en
Google Play es rarísimo. Ninguna de ellas declara un targetSdkVersion de 30 o más, que es justo
el caso en que Android exigiría v2. Ejemplo de app solo con v1: ru.zxalexis.ugaday (F-Droid). Y
al revés: la firma v1 sobra desde la API 24, porque Android 7.0 ya verifica v2, y aun así la sigue
llevando más de la mitad de las apps de F-Droid con minSdkVersion 24 o más.
3.5 rotate y lineage
Rotar la clave de firma sin perder la identidad de la aplicación. rotate construye el fichero
de lineage que acredita la sucesión; sin --in empieza un linaje nuevo, y con
--in lineage-anterior añade un eslabón a uno existente. Ejecutado el 25 de septiembre de 2026
con dos keystores creados con la orden de la «sección 4.1 · Crear un keystore PKCS#12»:
apksigner rotate --out lineage \
--old-signer --ks clave-vieja.p12 \
--new-signer --ks clave-nueva.p12
apksigner lineage --in lineage --print-certs
Signer #1 in lineage certificate DN: CN=Pruebas vieja, O=Ejemplo, C=ES
…
Has installed data capability: true
Has shared UID capability : true
Has permission capability : true
Has rollback capability : false
Has auth capability : true
Signer #2 in lineage certificate DN: CN=Pruebas nueva, O=Ejemplo, C=ES
…
La clave vieja conserva todas sus capacidades menos una, rollback, que viene desactivada.
Se activa con --set-rollback true detrás de --old-signer. Al firmar se aporta el linaje:
apksigner sign --ks clave-vieja.p12 \
--next-signer --ks clave-nueva.p12 \
--lineage lineage --rotation-min-sdk-version 28 --out rotada.apk app.apk
apksigner verify --print-certs rotada.apk solo enseña el firmante que vale desde la API 28, el
nuevo (V3.0 Signer: certificate DN: CN=Pruebas nueva…). El linaje que va dentro se lee con
apksigner lineage --in rotada.apk --print-certs, que devuelve los dos eslabones de arriba.
Qué firmante enseña no depende del minSdkVersion del APK, sino del rango que se verifica. Lo
repetimos el 18 de octubre de 2026 con tres APK mínimos de minSdkVersion 21, 24 y 28 firmados
igual. Sin rango, los tres enseñan solo el firmante v3 nuevo, porque el rango por defecto va del
minSdkVersion en adelante y siempre llega a la API 28. Con --min-sdk-version 24 --max-sdk-version 27, el de 24 verifica con v2 y enseña la clave vieja,
V2 Signer: certificate DN: CN=Pruebas vieja….
Lo que hace el instalador con eso, en un emulador Android 14 arm64-v8a, actualizando siempre el
mismo paquete:
| Instalado | Se instala encima | Resultado |
|---|---|---|
| Firmado con la vieja | Firmado solo con la nueva | INSTALL_FAILED_UPDATE_INCOMPATIBLE: Existing package … signatures do not match newer version; ignoring! |
| Firmado con la vieja | rotada.apk |
Success |
rotada.apk |
Firmado solo con la nueva | Success |
| El anterior | Firmado solo con la vieja | INSTALL_FAILED_UPDATE_INCOMPATIBLE, el mismo mensaje |
rotada.apk con --set-rollback true |
Firmado solo con la vieja | Success, y el paquete vuelve a la clave vieja |
Tras instalar rotada.apk, adb shell dumpsys package lo resume en una línea:
signatures=PackageSignatures{… signatures:[28c95b25], past signatures:[a66ae172 …, 28c95b25 …]}:
la clave actual y el linaje. Después del rollback, signatures:[a66ae172], past signatures:[]:
la clave vieja, y el linaje olvidado. Una vez instalada la rotación, volver atrás solo es
posible si se previó al rotar.
Un linaje desplegado en producción es el de Maps Go, el APK de la «sección 3.1 · verify: leer una firma ajena».
apksigner lineage --in <APK> --print-certs (31 de octubre de 2026) enseña tres eslabones, todos
con el nombre de Google. Sus certificados empiezan por 68f72b28… (el primero, el firmante v3.0 de
la «sección 3.1 · verify: leer una firma ajena»), 29bb45be… y 49262eb9… (el último, el firmante v3.1). Solo el segundo tiene
activada la capacidad rollback. En los tres están activas installed data, shared UID,
permission y auth. Es la misma disposición que en el base.apk de Google Keep, en su variante
para reloj (com.google.android.keep, versión 5.26.411.03.97; lo comprobamos el 27 de octubre de
2026: tres eslabones y rollback en el segundo).
En la práctica, el corte de la v3.1 es la API 33: así es en 1.092 de las 1.093 piezas que la
llevan. El 28 del ejemplo con --rotation-min-sdk-version 28 es solo el valor que elegimos para
la demostración. Hay también linajes dentro de la firma v3, sin bloque v3.1, pero salen de muy
pocas apps: una treintena en todo el muestrario.
El mecanismo y el formato del linaje están en «Firma v4 y verificación».
3.6 Qué firman las apps reales
Cada tienda tiene sus costumbres. Esta tabla da, por grupo de apps, qué porcentaje lleva cada
esquema. «Presente» quiere decir que su identificador está en el APK Signing Block (o, para v1,
que hay un .SF con su bloque PKCS#7 en META-INF/): es presencia en los bytes, no
verificación. Mira cada columna por separado.
| Esquema presente | F-Droid | IzzyOnDroid | Google Play, más instaladas | Google Play, sorteo | Mercado chino | Webs de autores |
|---|---|---|---|---|---|---|
| v1 | 77 % | 52 % | 37 % | 37 % | 94 de 100 | 7 de 7 |
| v2 | 91 % | 98 % | 98 % | 100 % | 99 de 100 | 7 de 7 |
| v3 | 64 % | 18 % | 90 % | 89 % | 37 de 100 | 2 de 7 |
| v3.1 | 0 % | 0 % | 10 % | 1 % | 1 de 100 | 1 de 7 |
| v3.2 | 0 % | 0 % | 0 % | 2 % | 0 de 100 | 0 de 7 |
La v2 está en casi todas. La v1 sigue en tres de cada cuatro apps de F-Droid, pero solo en una de
cada tres en Google Play. La v3.2 es la firma con clave poscuántica ML-DSA (un algoritmo resistente
a los ordenadores cuánticos): solo aparece en 9 de las 369 apps del sorteo de Google Play, y
apksigner con Java 21 no la verifica. Hace falta Java 25: con él verifican las 34 piezas de esas
9 apps. Un ejemplo con v1, v2, v3 y v3.2 es la carpeta de adb com.vexostudio.win786, pieza
base.apk. El de v2, v3 y v3.1 es Maps Go («sección 3.1 · verify: leer una firma ajena»).
Cada grupo tiene su combinación favorita: v1, v2 y v3 en F-Droid; solo v2 en IzzyOnDroid; v2 y v3 en Google Play; y v1 y v2 en el mercado chino.
Quién hace la firma v1 lo dice el campo Created-By del .SF. En F-Droid casi siempre es
apksigner (el 80 %). En IzzyOnDroid gana el Android Gradle Plugin (el complemento de Gradle que
compila las apps), y en las más instaladas de Google Play aparece SignApk en una de cada cinco.
El nombre del fichero .SF dice poco: en F-Droid, el 80 % son 8 cifras hexadecimales.
4. keytool
Viene con el JDK. Lo tenemos disponible (OpenJDK 21.0.10), así que esta sección también está ejecutada.
4.1 Crear un keystore PKCS#12
PKCS#12 es el formato actual; JKS es el heredado y Java avisa al usarlo.
keytool -genkeypair -v -keystore demo.p12 -storetype PKCS12 -alias pruebas-demo \
-keyalg RSA -keysize 2048 -validity 10000 \
-dname "CN=Ejemplo Demo, OU=Docs, O=Ejemplo, L=Madrid, C=ES" \
-storepass demopass -keypass demopass
Generando par de claves RSA de 2.048 bits para certificado autofirmado (SHA384withRSA) con una validez de 10.000 días
para: CN=Ejemplo Demo, OU=Docs, O=Ejemplo, L=Madrid, C=ES
[Almacenando demo.p12]
La salida sale en español porque el JDK respeta el locale del sistema. Si pensabas escribir un
script que analice esta salida: no lo hagas.
Sobre el SHA384withRSA: repetimos la orden el 31 de octubre de 2026 con Temurin 21.0.10+7
(openjdk version "21.0.10" 2026-01-20 LTS), la salida es la misma, y keytool -list -v da
Nombre del algoritmo de firma: SHA384withRSA. Es el valor por defecto que documenta el JDK 21 para
claves RSA de 624 a 7.680 bits; el JDK 17 elegía SHA256withRSA hasta 3.072. Si necesitas un
algoritmo concreto, lo fijas con -sigalg. En el muestrario, SHA384withRSA es minoritario (un
14 % de los certificados de F-Droid), y la mitad de las apps más instaladas de Google Play siguen
con SHA1withRSA.
-validity 10000 son unos 27 años, el mismo valor que usa F-Droid: todos sus certificados de
firma tienen exactamente 10.000 días. Google Play App Signing genera certificados de unos 30 años
(10.957 o 10.958 días). Google Play exige que el certificado siga siendo válido hasta el 22 de
octubre de 2033, y entre sus apps más instaladas del muestrario solo una caduca antes. En F-Droid e
IzzyOnDroid, que no tienen esa exigencia, son unas pocas más. Hay casos extremos: el certificado de
zatrit.skinbread (F-Droid) ya había caducado el 19 de octubre de 2026, el primer día de descarga.
4.2 Listar el keystore
keytool -list -v -keystore demo.p12 -storepass demopass
Tipo de Almacén de Claves: PKCS12
Proveedor de Almacén de Claves: SUN
Su almacén de claves contiene 1 entrada
Nombre de Alias: pruebas-demo
Fecha de Creación: 12 ago 2026
Tipo de Entrada: PrivateKeyEntry
Longitud de la Cadena de Certificado: 1
Certificado[1]:
Propietario: CN=Ejemplo Demo, OU=Docs, O=Ejemplo, L=Madrid, C=ES
Emisor: CN=Ejemplo Demo, OU=Docs, O=Ejemplo, L=Madrid, C=ES
Número de serie: e8251338a7c3fb45
Válido desde: Wed Aug 12 12:31:43 CEST 2026 hasta: Sun Dec 28 11:31:43 CET 2053
Huellas digitales del certificado:
SHA1: 8F:B6:F0:35:AA:FE:12:EE:E3:32:49:EC:6C:B2:BA:A4:2F:71:E1:5C
SHA256: FE:9D:A8:50:02:E2:8D:F0:C5:40:16:4B:22:64:88:70:E0:92:99:58:63:F3:1C:50:BB:FE:4C:8B:AA:D0:EF:CC
Nombre del algoritmo de firma: SHA384withRSA
Algoritmo de clave pública de asunto: Clave RSA de 2048 bits
Versión: 3
Propietario y Emisor coinciden: es autofirmado, que es lo normal para firmar aplicaciones
Android. En el muestrario lo son casi todos: las únicas excepciones son 20 de las 658 más
instaladas de Google Play, y no hemos medido quién las emitió. Ninguna app tiene más de un
firmante en algún esquema. El SHA-256
del certificado es la identidad de la aplicación a efectos de actualizaciones, y es el valor que
hay que registrar en las consolas de servicios de terceros.
4.3 Exportar el certificado
keytool -exportcert -keystore demo.p12 -alias pruebas-demo \
-storepass demopass -rfc -file pruebas-demo.pem
Sin -rfc sale en DER binario. El PEM es lo que piden las consolas de Firebase, Google Maps y
similares.
4.4 El debug keystore
Android Studio crea un keystore de depuración con valores conocidos y públicos:
| Elemento | Valor |
|---|---|
| Ruta (macOS y Linux) | ~/.android/debug.keystore |
| Ruta (Windows) | %USERPROFILE%\.android\debug.keystore |
| Contraseña del keystore | android |
| Alias | androiddebugkey |
| Contraseña de la clave | android |
keytool -list -v -alias androiddebugkey -keystore ~/.android/debug.keystore
La documentación de Google Play services confirma la ruta, la contraseña android y el alias
androiddebugkey; la de firma de aplicaciones solo dice que el IDE «sets the keystore and key
passwords», sin dar los valores. Los fija el código de AGP: DefaultSigningConfig.kt
declara DEFAULT_PASSWORD = "android" y DEFAULT_ALIAS = "AndroidDebugKey", su
DebugSigningConfig devuelve esa misma contraseña para el almacén y para la clave, y
createDefaultDebugStore() crea el keystore con esos valores (platform/tools/base,
etiqueta studio-2026.1.2). keytool lista el alias en minúsculas, androiddebugkey.
Por qué no vale para distribuir. La documentación oficial de firma de aplicaciones lo dice
directamente: el certificado de depuración lo generan las herramientas de compilación y es
inseguro por diseño. Por eso la mayoría de las tiendas, incluida Google Play, no aceptan
aplicaciones firmadas con él. El fondo del problema es que la contraseña es pública. La clave
se genera en cada máquina la primera vez que se compila, así que no es la misma en dos
ordenadores. Pero cualquiera que consiga ese debug.keystore (de un repositorio, de una imagen de
CI) puede firmar una actualización de la aplicación, justo lo que la firma debía impedir.
Sirve para desarrollo, para pruebas locales y para reinstalar sobre uno mismo. Nada más.
Aun así, en el muestrario hay unas pocas apps cuyo certificado lleva el nombre del de depuración
(CN=Android Debug, O=Android, C=US), casi todas de F-Droid. Ejemplos: com.icesu.kinnaid
(F-Droid) y, en Google Play, la única app, com.amanotes.beathopper (versión 8.18.1, pieza
base.apk). Todos esos certificados tienen 30
años de validez (10.950 días). Solo 2 de las 1.402 apps de IzzyOnDroid declaran además
android:debuggable=true. El nombre del certificado es solo una pista: cualquiera puede escribirlo
en un certificado propio, así que esta cuenta es un mínimo de apps firmadas con la clave de
depuración, no un máximo.
4.5 Los certificados de las apps publicadas
Qué claves usan las apps que ya están en las tiendas. La clave del firmante es la del primer certificado del primer firmante de v3 (si no hay v3, la de v2; si no, la de v1). La clase de nombre (Play App Signing, F-Droid, depuración) es una pista por el nombre del certificado, no una prueba.
En F-Droid e IzzyOnDroid lo habitual es una clave RSA de 2048 bits, en nueve de cada diez apps.
En Google Play cambia la cosa, y en dos direcciones. Entre las más instaladas, el 30 % sigue con
una clave de 1024 bits. Entre las del sorteo, dos de cada tres ya usan 4096, y la razón es Play App
Signing, que genera esa clave: el certificado con CN=Android, OU=Android, O=Google Inc. aparece
en esas mismas dos de cada tres. En el mercado chino, la mitad lleva una clave de 1024 bits, y una,
cn.ninegame.gamemanager (tienda 360), una de 512.
El algoritmo con que se firma el certificado también envejece. SHA1withRSA sigue en la mitad de
las más instaladas de Google Play y del mercado chino, y alguna de las más instaladas aún usa
MD5withRSA.
Lo que el muestrario no enseña es cómo funciona Play App Signing (clave de subida frente a clave de la app), solo el nombre del certificado. En estático no hay forma de saber si una app lo usó.
5. zipalign
Instalado, así que ejecutado.
Alinear al escribir, con las .so a 16 KiB, que es lo que exige Play (tabla de abajo):
BT=~/Library/Android/sdk/build-tools/37.0.0
$BT/zipalign -P 16 -f 4 entrada.apk salida.apk
Comprobar sin modificar, sobre Termux 0.119.0-beta.3 (com.termux, 114.920.926 B, 745 entradas,
minSdkVersion 24, targetSdkVersion 28):
MUESTRARIO=<carpeta del muestrario>
$BT/zipalign -c -v 4 $MUESTRARIO/fdroid/com.termux_1022.apk | head -8
Verifying alignment of …/fdroid/com.termux_1022.apk (4)...
87 META-INF/com/android/build/gradle/app-metadata.properties (OK - compressed)
179 classes.dex (OK - compressed)
1405330 classes2.dex (OK - compressed)
1405890 lib/arm64-v8a/liblocal-socket.so (OK - compressed)
1657504 lib/arm64-v8a/libtermux-bootstrap.so (OK - compressed)
30359505 lib/arm64-v8a/libtermux.so (OK - compressed)
30362967 lib/armeabi-v7a/liblocal-socket.so (OK - compressed)
(OK - compressed) significa que la entrada va comprimida y la alineación no le aplica: solo
importa para las entradas sin comprimir (stored), que son las que el sistema mapea en memoria.
Este APK comprime sus 12 .so. Eso solo ocurre con extractNativeLibs="true" o sin el atributo
(que entonces vale true), y Termux lo declara explícitamente. Si una .so va comprimida, Android
no puede leerla desde el APK y la extrae al instalar. En el muestrario hay al menos una pieza base
con las .so comprimidas y extractNativeLibs="false": el base.apk de com.venticake.retrica
(versión 9.5, del .apkm de APKMirror).
Comprobación de páginas de 16 KB, que es el requisito nuevo:
$BT/zipalign -c -P 16 4 $MUESTRARIO/fdroid/org.fossify.math_10.apk; echo "exit=$?"
exit=0
Ese exit=0 solo dice que las .so sin comprimir (aquí cuatro) empiezan en un múltiplo de 16 KiB
dentro del ZIP. Con tk.hack5.treblecheck, que tiene tres .so mal colocadas, sale exit=1.
Y un exit=0 puede ser vacuo: con VLC 3.7.2 (org.videolan.vlc) también sale exit=0, pero sus
4 .so van comprimidas y no hay nada que mirar. zipalign no lee el ELF: que los segmentos
PT_LOAD estén alineados a 16 KiB, la otra mitad del requisito, se comprueba aparte («sección 6.1
de Código nativo y ELF · Qué es el requisito»). Y las dos comprobaciones pueden
discrepar. Entre las piezas con .so de 64 bits en lib/arm64-v8a/ o lib/x86_64/, hay que
pasan zipalign -c -P 16 4 pero llevan un PT_LOAD por debajo de 16 KiB. En Google Play son
pocas (un 7 % de las más instaladas), en F-Droid casi una de cada cinco, y en el mercado chino tres
de cada cuatro.
Opciones:
| Opción | Efecto |
|---|---|
-c |
Solo comprueba, no modifica |
-f |
Sobrescribe la salida si existe |
-p |
Alinea los .so sin comprimir a páginas de 4 KiB. Obsoleto: usar -P 16 |
-P <kb> |
Alinea los .so a páginas de ese tamaño. Valores válidos: 4, 16, 64 |
-v |
Detalle entrada a entrada |
-z |
Recomprime con Zopfli |
| (alineación) | Argumento obligatorio. Siempre 4 |
Google Play exige páginas de 16 KB a las aplicaciones con targetSdk 35 o superior. Para las
nuevas y las actualizaciones rige desde el 1 de noviembre de 2025, según el blog de Android
Developers; la guía da ahora el 1 de febrero de 2027 para las actualizaciones. Por eso -P 16 deja
de ser opcional. Aunque se te olvide, apksigner sign realinea las .so a 16 KiB por defecto. El
porqué está en
«Alineación y zipalign» y en
«Código nativo y ELF».
«Cumple 16 KB» se puede medir de dos maneras, y no hay que mezclarlas. La guía de Android
pide que todos los segmentos PT_LOAD de las .so ELF de lib/arm64-v8a/ tengan p_align de
16.384 o más y, solo si el APK se carga sin extraer las .so (extractNativeLibs=false), que
también estén en múltiplo de 16.384 dentro del ZIP. El cargador de Android 17 en un
dispositivo de 16 KB no entra en modo de compatibilidad: es más estricto, porque mira también dónde
acaba el segmento PT_GNU_RELRO. Entre las apps con alguna .so ELF en lib/arm64-v8a/ y
targetSdk 35 o más:
Apps con targetSdk ≥ 35 |
Cumple la guía de Android | Cumple el cargador de Android 17 |
|---|---|---|
| F-Droid | 94 % | 92 % |
| IzzyOnDroid | 94 % | 92 % |
| Google Play, más instaladas | 92 % | 80 % |
| Google Play, sorteo | 93 % | 86 % |
| Mercado chino (16 apps) | 5 de 16 | 1 de 16 |
| Webs de autores (5 apps) | 5 de 5 | 5 de 5 |
Fíjate en la diferencia entre columnas en las más instaladas de Google Play: del 92 % al 80 %.
Son los ELF cuyo PT_GNU_RELRO acaba fuera de un múltiplo de 16.384. Con targetSdk menor de 35
la cosa cambia mucho: en F-Droid cumple la guía poco más de un tercio de las apps, y en Google
Play casi ninguna. Un ejemplo
con targetSdk 35 o más y .so es org.fcitx.fcitx5.android.plugin.sayura (F-Droid).
5.1 Alineación real en las apps publicadas
Casi todo lo que se descarga ya está bien alineado. Pasan zipalign -c 4 todas las apps de Google
Play y de las webs de autores, y fallan solo un puñado en F-Droid, IzzyOnDroid y el mercado chino.
El resources.arsc (la tabla de recursos compilada) va sin comprimir en prácticamente todas. Con
targetSdk 30 o más, lo lleva comprimido o sin alinear a 4 una sola app, de F-Droid:
dudeofx.eval, donde una entrada stored fuera de múltiplo de 4 hace fallar zipalign -c 4. Con
targetSdk menor de 30 hay unas pocas más. Solo contamos estos casos: no hemos comprobado qué hace
Android 11 con ellos.
En 16 KB, el framework con que está hecha la app importa poco entre las que tienen targetSdk 35
o más (con la definición de la guía de Android, «sección 5 · zipalign»). Entre las más instaladas de Google
Play cumplen casi todas las apps Flutter, Unity y React Native, y el 90 % de las que no usan
ninguno de los tres. El fallo se concentra en las apps con targetSdk menor de 35.
6. uber-apk-signer
| Dato | Valor |
|---|---|
| Repositorio | https://github.com/patrickfav/uber-apk-signer |
| Licencia | Apache-2.0 |
| Última versión | v1.3.0, publicada el 16 de febrero de 2023 |
| Último push | 30 de octubre de 2023 |
| Tracción | 2.703 ★ · 264 forks · 11 issues abiertas |
| Archivado | No |
Estado real: sin mantenimiento activo. A 31 de octubre de 2026 han pasado tres años y ocho meses sin release (la v1.3.0 es del 16 de febrero de 2023) y tres años sin commits (el último push es del 30 de octubre de 2023). Las estadísticas de la tabla las consultamos el 12 de agosto de 2026 vía la API de GitHub y no las hemos repetido. No está archivado, pero no se mueve.
Qué automatiza: encadena zipalign + apksigner + verificación en una sola invocación, sobre
uno o muchos APK, con el debug keystore por defecto si no le das otro.
java -jar uber-apk-signer.jar --apks /ruta/con/apks/
java -jar uber-apk-signer.jar -a app.apk --ks release.jks \
--ksAlias mialias --ksPass ... --ksKeyPass ...
La sintaxis procede de la descripción oficial del proyecto, consultada el 12 de agosto de 2026 (no la hemos ejecutado).
Cuándo compensa: cuando hay que firmar muchos APK de golpe, o cuando quieres una sola
orden en un script en lugar de tres. Es lo que usan APKLab y Apk Studio internamente, y por eso
la salida de APKLab reporta «sign success / zipalign verified / signature verified [v1, v2, v3]»
en un solo paso.
Cuándo no: en cualquier flujo nuevo. Es una capa de conveniencia sin mantenimiento sobre dos herramientas oficiales que sí lo tienen y que resuelven el problema en dos líneas. Además congela su propia idea de qué esquemas hay que aplicar, así que envejece como han envejecido las interfaces gráficas de «Comparativa y selección».
7. Instalar
ADB=~/Library/Android/sdk/platform-tools/adb
# Un APK único
$ADB install -r demo-signed.apk
# Un conjunto de splits, sin fusionarlos (carpeta de adb del muestrario)
$ADB install-multiple base.apk split_config.en.apk split_config.es.apk split_config.xxhdpi.apk
# Desde un APK Set, dejando que bundletool elija
java -jar bundletool.jar install-apks --apks=fixture.apks
Los nombres de las piezas del segundo ejemplo son los de una carpeta real de adb del muestrario,
la del paquete de.systembau.prourlaubapp: base.apk (1.066.846 B), split_config.en.apk
(37.273 B), split_config.es.apk (20.889 B) y split_config.xxhdpi.apk (87.148 B). Es
versionCode 400 (4.0.0), con v1, v2, v3 y v3.1, y sin split de ABI: las cuatro piezas llevan el
mismo certificado. Las tres órdenes las ejecutamos el 25 de septiembre de 2026 contra un emulador
Android 14 arm64-v8a, con otros splits generados a mano, y no las hemos repetido:
install -r demo-signed.apkrespondeSuccess. Comoapksignerdeja el.idsigjunto alAPK(«sección 3.2 · sign: firmar de verdad»),adblo encuentra y hace una instalación incremental: la salida empieza porServing...yPerforming Incremental Install. Con--no-incrementalse vePerforming Streamed Install. Instalar encima la calculadora original, firmada por Fossify, daINSTALL_FAILED_UPDATE_INCOMPATIBLE: Existing package org.fossify.math signatures do not match newer version; ignoring!.install-multiplerespondeSuccesscon un base y suconfig.esgenerados conaapt2 link --split. Los fallos de ese camino, con sus mensajes reales, están en la «sección 2.3 de Diagnóstico de fallos · Los cinco que hay que conocer al detalle».install-apks, sinadben elPATH, falla igual queget-device-spec:
[BT:1.18.3] Error: Unable to determine the location of ADB. Please set the --adb flag or define ANDROID_HOME or PATH environment variable.
Con --adb ~/Library/Android/sdk/platform-tools/adb responde
The APKs have been extracted in the directory: … y la aplicación queda instalada (es otra prueba,
del 25 de septiembre y con otros splits; el fixture.apks de la «sección 6.3 de Desempaquetado · build-apks» sale
sin firmar y ese no lo instalamos). En un
emulador con el idioma en inglés solo instala base: el split es del APK Set no se entrega.
Tres notas que ahorran tiempo:
install-multiplees la vía para splits sin fusionarlos. Todos losAPKdel conjunto deben compartirpackageNameyversionCodey estar firmados con la misma clave; si no, la instalación falla entera. Las apps partidas de Google Play del muestrario cumplen la regla sin excepciones, vengan en.apkm, en.xapko en carpeta de adb.installreemplaza siempre, con-ro sin él:pmacepta-ry lo ignora,-Res lo que desactiva el reemplazo, y reemplazar exige la misma firma que la versión instalada (PackageManagerShellCommand.java, líneas 3590-3594, fuente 15). UnAPKrefirmado con otra clave exige desinstalar primero.bundletool install-apkshaceget-device-spec,extract-apkseinstall-multipleen un paso.
Un targetSdkVersion antiguo no se instala. Desde Android 14, el instalador rechaza las
aplicaciones cuyo targetSdkVersion está por debajo de un mínimo —23 en Android 14— con
INSTALL_FAILED_DEPRECATED_SDK_VERSION: App package must target at least SDK version 23, but found …; las que ya estaban instaladas cuando el dispositivo se actualizó se conservan. Para
probar una así hay que pedirlo expresamente: adb install --bypass-low-target-sdk-block app.apk.
El mínimo de cada versión está en la «sección 2.4 de
Diagnóstico de fallos · Fallos de instalación», y el caso, reproducido con
la salida de los dos intentos, en la 2.5. Que Android 14 pida esa opción sale de la documentación
oficial (fuente 12); no lo hemos vuelto a comprobar, y el mínimo ha subido en versiones
posteriores sin que lo hayamos verificado.
En el muestrario son muy pocas las apps con un targetSdkVersion menor de 23 (el de la pieza base
o única; sin el atributo vale el minSdkVersion): una docena, casi todas de IzzyOnDroid. Con esos
APK, Android 14 pide la opción --bypass-low-target-sdk-block.
El catálogo de errores de instalación —INSTALL_PARSE_FAILED_NO_CERTIFICATES,
INSTALL_FAILED_UPDATE_INCOMPATIBLE, INSTALL_PARSE_FAILED_INCONSISTENT_CERTIFICATES— está en
«Diagnóstico de fallos».
7.1 Contenedores reales: .apkm, .xapk y carpetas de adb
Las apps de Google Play llegan al muestrario de tres maneras. Un .apkm es un ZIP de APKMirror
con varias piezas dentro. Un .xapk es otro ZIP, con el mismo propósito. Una carpeta de adb es un
directorio con un base.apk y varios split_config.*.apk, listo para adb install-multiple. Casi
todos traen varias piezas. Todas las piezas de una app tienen el mismo paquete, el mismo
versionCode y el mismo certificado, que es justo lo que adb install-multiple exige. Un ejemplo
con splits reales es la carpeta de.systembau.prourlaubapp («sección 7 · Instalar»).
Dentro de un .apkm, las 7.288 piezas van comprimidas (deflate). Dentro de un .xapk, van sin
comprimir (stored) casi todas (447 de 450). Ningún contenedor ni ninguna carpeta incluye
un .idsig. El .apkm de APKMirror añade una firma JAR propia al ZIP exterior
(META-INF/APKMIRRO.*), que llevan los 388; las piezas de dentro no la llevan.
7.2 La misma app en dos tiendas
Instalar una app de una tienda encima de la de otra solo funciona si las dos llevan el mismo
certificado. En el muestrario, 480 paquetes están a la vez en F-Droid y en IzzyOnDroid. En algo
más de la mitad el fichero es literalmente el mismo. Pero en casi un tercio el certificado es
otro, así que no se podrían actualizar de una tienda a la otra; casi siempre es porque F-Droid
firma con su propia clave.
Un ejemplo del mismo certificado con distinto fichero es ru.tech.imageresizershrinker, en
F-Droid y en IzzyOnDroid.
Con Google Play los pares son pocos, así que van con su recuento: de los 3 paquetes que están en Google Play y en F-Droid, ninguno comparte certificado (F-Droid firma con su clave); de 1 que está en Google Play y en IzzyOnDroid, ninguno; de los 6 que están en Google Play y en la web del autor, los 6 lo comparten (Firefox, Brave, WhatsApp, Viber, LarkPlayer y Kanaquiz).
8. Qué se rompe si se altera el orden
La demostración con una copia firmada en v1, v2 y v3, con su salida, está en la «sección 4.2 de
Alineación y zipalign · La demostración»: pasar zipalign a un APK ya
firmado reescribe el ZIP entrada por entrada y no conserva el APK Signing Block. La firma
v2/v3 desaparece aunque zipalign devuelva 0. Lo que diga después apksigner verify depende de
lo que quede: con la v1 dentro, la firma JAR sigue ahí y el error dice que anuncia una v2 que ya no
está («Signature stripped?»). Sin v1, ni eso. Repetimos la
prueba el 31 de octubre de 2026 con build-tools 37.0.0 sobre org.fossify.math (F-Droid,
minSdkVersion 26):
$BT/apksigner sign --ks k.p12 --ks-pass pass:prueba --v1-signing-enabled false \
--v2-signing-enabled true --v3-signing-enabled true --v4-signing-enabled false \
--out solo-v2v3.apk base.apk
$BT/zipalign -f -P 16 4 solo-v2v3.apk solo-v2v3-alineado.apk ; echo "exit=$?"
$BT/apksigner verify --verbose solo-v2v3-alineado.apk
exit=0
DOES NOT VERIFY
ERROR: Missing META-INF/MANIFEST.MF
Sin bloque de firma, el verificador busca la v1 y no la encuentra. Antes del zipalign,
apksigner verify --verbose solo-v2v3.apk daba Verifies con v2 y v3. Con la copia firmada en v1,
v2 y v3 y alineada después, apksigner verify --min-sdk-version 24 da DOES NOT VERIFY con dos
ERROR del tipo «JAR signature META-INF/PRUEBAS-.SF indicates the APK is signed using APK
Signature Scheme v2 [y v3] but no such signature was found. Signature stripped?». Es el mismo error
de la «sección 3.3 · La sutileza de verify que engaña a todo el mundo», por otra causa: allí un split sin minSdkVersion exige una v1 que no tiene; aquí
zipalign quitó el bloque de firma.
| Orden | Resultado |
|---|---|
| construir → alinear → firmar | Correcto |
| construir → firmar → alinear | Firma destruida. Hay que volver a firmar |
| construir → firmar → editar un fichero | Firma inválida |
alinear → firmar → zipalign -c |
Correcto: -c solo lee |
El corolario práctico: zipalign -c es seguro siempre; zipalign sin -c sobre un APK
firmado obliga a refirmar.
Y el corolario de diseño, más profundo: cualquier herramienta que reescriba el ZIP (apktool,
APKEditor o cualquier otra) invalida la firma por construcción. No es un fallo que corregir. Es
justo lo que hace útil a la firma.
8.1 Lo que sí se puede añadir después de firmar
La regla «nada toca el APK después de firmarlo» tiene una excepción conocida. El APK Signing Block admite pares que apksigner no conoce y que la firma no cubre. Las tiendas chinas usan esa
puerta para marcar el canal de descarga con un bloque Walle (0x71777777) o VasDolly
(0x881155ff). Lo lleva casi un tercio de las apps del mercado chino, y fuera de China casi no se
ve. Además, algunas apps chinas y un 6 % de las de Google Play llevan algún identificador que no
conocemos. Y lo importante: las 48 apps chinas con canal o con un identificador desconocido pasan
apksigner verify, aunque 22 de ellas tienen el bloque de firma fuera de múltiplo de 4.096. Un ejemplo con canal es cn.ninegame.gamemanager (tienda 360). Hay 4 piezas con comentario
al final del ZIP, y solo en 1 (del mercado chino) es un canal (channelId=2002).
En las apps de Google Play lo habitual es el bloque de relleno (0x42726577, que hace que el bloque
de firma mida un múltiplo de 4.096) y el de Play (0x2146444e). El de Play lo llevan tres de cada
cuatro apps más instaladas con bloque de firma y casi todas las del sorteo. El relleno está en
casi todas las apps con bloque de F-Droid, IzzyOnDroid y Google Play, y en dos de cada tres del
mercado chino. Que la firma no
cubra estos pares lo describe «APK Signing Block»; aquí solo
comprobamos que apksigner los verifica.
Fuentes
- apksigner — documentación oficial de Android — https://developer.android.com/tools/apksigner
Consultado el 12 de agosto de 2026. De aquí salen las tablas de opciones de
signyverifyde las secciones «3.2» y «3.3», y la sintaxis derotateylineagede la «sección 3.5 · rotate y lineage». Consultado de nuevo el 18 de octubre de 2026: de aquí sale también que, sin--min-sdk-version,apksignerusa elminSdkVersiondel manifiesto («sección 3.1 · verify: leer una firma ajena»). La opción--v4-signature-filede la tabla deverifyno sale de aquí: esta página no la documenta, y tampocoapksigner verify --helpdebuild-tools37.0.0; está en el código (fuente 13) y la «sección 3.3 · La sutileza de verify que engaña a todo el mundo» la ejecuta. - zipalign — documentación oficial de Android — https://developer.android.com/tools/zipalign
Consultado el 12 de agosto de 2026. De aquí salen la tabla de opciones de la «sección 5 · zipalign» y la
regla de orden de la «sección 2 · El orden del pipeline, que no es negociable»: con
apksigner, alinear antes de firmar; conjarsigner, después. Consultado de nuevo el 18 de octubre de 2026 (página actualizada el 15 de agosto de 2024): «If you use apksigner, zipalign must be used before the APK file has been signed». - bundletool — documentación oficial de Android — https://developer.android.com/tools/bundletool
Consultado el 12 de agosto de 2026. De aquí sale la sintaxis de
install-apksde la «sección 7 · Instalar». - Sign your app — documentación oficial de Android Studio —
https://developer.android.com/studio/publish/app-signing
Consultado el 12 de agosto de 2026. De aquí salen la ruta
$HOME/.android/debug.keystorey la afirmación literal de que el certificado de depuración es inseguro por diseño y que las tiendas, incluida Google Play, no aceptan aplicaciones firmadas con él. - Client authentication — Google Play services —
https://developers.google.com/android/guides/client-auth
Consultado el 12 de agosto de 2026. De aquí salen la contraseña
androiddel debug keystore, el aliasandroiddebugkey, las rutas en macOS/Linux y Windows, y la orden dekeytoolpara listarlo. - uber-apk-signer — repositorio oficial —
https://github.com/patrickfav/uber-apk-signer
Consultado el 12 de agosto de 2026 vía la API de GitHub y
/releases/latest. De aquí salen la licencia Apache-2.0, la versión v1.3.0 del 16 de febrero de 2023, el último push del 30 de octubre de 2023 y los recuentos de la «sección 6 · uber-apk-signer». - Ejecuciones locales sobre el muestrario — realizadas el 31 de octubre de 2026 con
build-tools37.0.0 (apksigner0.9,zipalign) y OpenJDK 21.0.10 (keytool), sobre piezas del «muestrario»:org.fossify.math(secciones «3.2», «3.3», «3.4», «4» y «8»), Maps Go (3.1 y 3.5),com.termuxyorg.videolan.vlc(5),tk.hack5.treblecheck(2 y 5) y la carpetade.systembau.prourlaubapp(7). El keystoredemo.p12de la «sección 4.2 · Listar el keystore» se creó el 12 de agosto de 2026 (Fecha de Creación: 12 ago 2026); el de la «sección 3.2 · sign: firmar de verdad» se creó con la orden de la «sección 4.1 · Crear un keystore PKCS#12» el 31 de octubre. Las secciones «3.5» y «7» salen de la fuente 10. - AOSP —
build/make/tools/zipalign/ZipAlign.cppen la etiquetaandroid-16.0.0_r1— https://android.googlesource.com/platform/build/+/refs/tags/android-16.0.0_r1/tools/zipalign/ZipAlign.cpp Consultado el 25 de septiembre de 2026. De aquí sale quezipalignsolo mira el offset de cada entrada delZIP(getAlignmentdevuelve el tamaño de página para las.so) y no lee su contenido ELF, de la «sección 5 · zipalign». - AOSP —
tools/base,DefaultSigningConfig.ktyGradleKeystoreHelper.kt, etiquetastudio-2026.1.2— https://android.googlesource.com/platform/tools/base/+/refs/tags/studio-2026.1.2/build-system/builder/src/main/java/com/android/builder/signing/DefaultSigningConfig.kt Consultado el 25 de septiembre de 2026. De aquí salen la contraseña y el alias de la clave de depuración de la «sección 4.4 · El debug keystore». - Emulador Android 14
arm64-v8a— ejecutado el 25 de septiembre de 2026. De aquí salen la rotación conrotateylineagede la «sección 3.5 · rotate y lineage» y las tres órdenes de la «sección 7 · Instalar». keytoolrepetido localmente, y su documentación — el 18 y el 31 de octubre de 2026, la orden de la «sección 4.1 · Crear un keystore PKCS#12» con Temurin 21.0.10+7, y https://docs.oracle.com/en/java/javase/21/docs/specs/man/keytool.html y https://docs.oracle.com/en/java/javase/17/docs/specs/man/keytool.html, consultadas el mismo día. De aquí salen la nota sobreSHA384withRSAde la «sección 4.1 · Crear un keystore PKCS#12» y la tabla «Default Signature Algorithms» de cada versión:SHA384withRSApara RSA de hasta 7.680 bits en el JDK 21,SHA256withRSAhasta 3.072 en el 17.- Behavior changes: all apps (Android 14) —
https://developer.android.com/about/versions/14/behavior-changes-all
Consultado el 18 de octubre de 2026. De aquí salen el mínimo de
targetSdkVersion23, el mensaje deINSTALL_FAILED_DEPRECATED_SDK_VERSION, que las aplicaciones ya instaladas se conservan al actualizar y la opción--bypass-low-target-sdk-blockde la «sección 7 · Instalar». - AOSP —
tools/apksig,ApkSignerTool.java— https://android.googlesource.com/platform/tools/apksig/+/184702d9d18877edf9e5296c4e191cf0aa2b5fbb/src/apksigner/java/com/android/apksigner/ApkSignerTool.java Consultado el 18 de octubre de 2026. De aquí sale la opción--v4-signature-filedeverify(«sección 3.3 · La sutileza de verify que engaña a todo el mundo»), que el métodoverifyreconoce («Input V4 Signature File») aunque no figure enhelp_verify.txt, el texto deapksigner verify --help. apksigner,zipalign,aapt2ykeytoolejecutados localmente — el 18 de octubre de 2026, conbuild-tools37.0.0 (apksigner0.9) y Temurin 21.0.10, sobreAPKmínimos generados conaapt2 linky claves de prueba creadas conkeytool -genkeypair. De aquí salen: la alineación que haceapksigner signsinzipalignprevio y con--alignment-preserved truesobre unAPKmínimo, y los valores por defecto que daapksigner sign --help(«sección 2 · El orden del pipeline, que no es negociable»); y las salidas deverify --print-certsdeAPKrotados conminSdkVersion21, 24 y 28 («sección 3.5 · rotate y lineage»). La prueba de la «sección 2 · El orden del pipeline, que no es negociable» sobre una pieza real y elzipalignsobre unAPKfirmado solo con v2 y v3 («sección 8 · Qué se rompe si se altera el orden») se repitieron el 31 de octubre de 2026.- AOSP —
PackageManagerShellCommand.javaen la etiquetaandroid-17.0.0_r1— https://android.googlesource.com/platform/frameworks/base/+/refs/tags/android-17.0.0_r1/services/core/java/com/android/server/pm/PackageManagerShellCommand.java Consultado el 18 de octubre de 2026 con?format=TEXT. De aquí sale la nota de la «sección 7 · Instalar»:case "-r": // ignore(línea 3590) ycase "-R": replaceExisting = false;(líneas 3592-3593).