Pipeline de modificación
Antes conviene leer «Pipeline de análisis» · «Anatomía de un APK»
1. Qué es y por qué existe
Modificar un APK ajeno y redistribuirlo tiene implicaciones de propiedad intelectual, de licencia
y de responsabilidad sobre el binario resultante, y son problema de quien lo hace. Aquí describimos
el procedimiento técnico. El marco legal depende de la jurisdicción, de la licencia y del uso, y no
lo tratamos.
Hay cuatro usos legítimos habituales, y ninguno pasa por redistribuir:
- Análisis. Instrumentar una aplicación para observar qué hace: añadir trazas, desactivar el
pinning de certificados en una copia propia de laboratorio para poder ver el tráfico, marcar
debuggable. - Accesibilidad. Corregir contrastes, tamaños de fuente o etiquetas de un
layouten una aplicación que no se mantiene. - Investigación de seguridad. Reproducir una vulnerabilidad, construir la prueba de concepto, verificar un parche.
- Binarios propios sin fuente. Un caso real y poco vistoso: la aplicación es tuya, el
APKde release está firmado y publicado, y el repositorio se perdió con el proveedor. ElAPKes el único artefacto que queda.
Y una frontera dura, la misma que en el resto de la documentación: aquí no se documenta cómo saltarse PairIP, Play Integrity, un packer comercial ni una comprobación de integridad en ejecución. La «sección 10 · Qué NO se puede modificar de forma realista» explica por qué esas aplicaciones no son modificables de forma realista, y saberlo te ahorra tiempo.
Lo que añade esta página a «Herramientas» es el encadenado: qué paso va antes de cuál, qué se pierde en cada uno y dónde suele fallar cada eslabón.
2. El pipeline canónico
El diagrama tiene tres reglas, y las tres se incumplen constantemente:
- El paso 0 no es opcional. Si modificas una aplicación con packer, sale un
APKque instala y no arranca, y el diagnóstico cuesta horas. La «sección 6 de Pipeline de análisis · Paso 4 — Detectar protecciones antes de perder la tarde» da una pista barata (un soloclasses.dexpequeño en una app con bibliotecas nativas), pero es solo una pista: en el mercado chino se le escapan tres de cada cuatro apps protegidas. La «sección 10 · Qué NO se puede modificar de forma realista» da las cifras. zipalignva antes deapksigner, y nada toca el fichero después. El porqué es estructural y está en la «sección 7 · Alinear y firmar».- Ninguna de las herramientas de desempaquetado cierra el ciclo. apktool no firma por diseño;
APKEditor tampoco;
aapt2menos. Los pasos 4 y 5 son siempre manuales («Firma y empaquetado»).
2.1 Cómo saber si el APK ya viene tocado
Antes de modificar conviene saber si el APK es el original. Hay dos pistas baratas: la fecha de
las entradas del ZIP y el sello de Google Play (la entrada stamp-cert-sha256, «sección 6.2 · El inventario de lo que se pierde»).
Las compilaciones con AGP (el plugin de Gradle para Android) escriben 01-01-1981 01:01:02 en todas
las entradas. Esa fecha la llevan casi todas las piezas de Play y casi 9 de cada 10 de F-Droid, pero
pocas del mercado chino. El sello lo llevan casi todas las piezas de Play, y ninguna de F-Droid ni del
mercado chino.
Si un APK que dice venir de Google Play trae fechas variadas o le falta el sello, alguien lo ha
reescrito o no viene de Play. Pero es solo una pista: unas 400 piezas de F-Droid tienen fechas
variadas sin que eso diga nada malo. Ejemplos: pro.rudloff.lineageos_updater_shortcut 2 (fechas variadas) y
com.yixia.videoeditor 6792500, del mercado chino (casi todas en 1981 y unas pocas distintas).
3. La bifurcación fundamental
Lo primero que hay que decidir es qué vas a tocar, porque editar recursos y editar código son dos problemas de dificultad muy distinta.
| Recursos | Código | |
|---|---|---|
| Qué se edita | AXML y resources.arsc |
classes*.dex |
| Representación intermedia | XML de texto, o JSON | smali |
| ¿Hay inverso exacto? | Sí con ARSCLib/APKEditor; con aapt2, no |
Sí: smali es el inverso de baksmali |
| Qué valida el cambio | El compilador de recursos, al reconstruir | El verificador de ART, al cargar la clase |
| Cuándo falla | Al reempaquetar: se ve enseguida | Al ejecutar el código parcheado: se ve tarde |
| Dificultad típica | Baja | Alta |
La asimetría tiene una causa concreta. Un recurso es un dato: cambiar el texto de un string o el
color de un drawable no puede producir un programa incoherente, y si el reempaquetado sale, sale.
Una instrucción de bytecode, en cambio, es parte de un programa con invariantes de tipo por
registro que ART comprueba al cargar la clase. Si un parche deja un registro con un int en una
rama y una referencia en la otra, el fallo de verificación salta al cargar la clase, no en la
línea editada, con una traza que apunta a otro sitio. La «sección 8.3 de
Desensambladores smali · El problema de los registros al insertar código» lo desarrolla.
De ahí la regla de trabajo: si el objetivo se puede conseguir tocando solo recursos o solo el
manifiesto, hazlo así. Muchos cambios que parecen de código no lo son: un texto, un color, un
endpoint que estaba en un string, un flag booleano en res/values/bools.xml, la configuración de
seguridad de red. Y te ahorran el paso 5 entero.
Tocar el manifiesto cubre más casos de lo que parece. La configuración de seguridad de red
(networkSecurityConfig) la declaran dos de cada tres de las apps más instaladas de Play, aunque
pocas de F-Droid. El atributo debuggable="true", en cambio, casi no aparece en versiones
publicadas; un ejemplo es com.particlesdevs.photoncamera 17884, de IzzyOnDroid. Por eso
apktool b --debuggable («sección 4.1 · Qué se puede cambiar») hace falta casi siempre en una copia de laboratorio. Que esto
cubra muchos casos sin tocar código es una afirmación de método, no una medida: las cifras solo la
acompañan como contexto. Lo de res/values/bools.xml tampoco lo hemos medido.
4. Editar recursos
4.1 Qué se puede cambiar
| Objetivo | Dónde vive | Dificultad |
|---|---|---|
| Textos, colores, dimensiones, booleanos | resources.arsc: tipos string, color, dimen, bool |
Trivial |
layout, drawable vectorial, menu |
AXML bajo res/ |
Baja |
| Iconos y bitmaps | Ficheros bajo res/ |
Trivial: se sustituye el fichero |
debuggable, usesCleartextTraffic, networkSecurityConfig |
AndroidManifest.xml (AXML) |
Baja |
Permisos, componentes, exported |
AndroidManifest.xml |
Baja, con consecuencias grandes |
versionCode / versionName |
AndroidManifest.xml |
Trivial |
| Nombre de paquete | Manifiesto, tabla y referencias del DEX |
Alta: no es un cambio de recurso |
La última fila es la trampa clásica: renombrar el paquete no es editar un atributo. aapt2 link
ofrece --rename-manifest-package, que cambia package y deja absolutos los nombres de clase de
los componentes, y nada más. apktool no tiene esa opción: en 2.x se la pasaba a aapt desde la
clave packageInfo.renameManifestPackage de apktool.yml, y en 3.x esa clave ya no existe
(«sección 2.4 de Desempaquetado y reempaquetado · apktool.yml»).
Y aunque renombres el manifiesto, el DEX sigue conteniendo referencias al paquete original: en
clases, ContentProvider authorities, intent-filter y ficheros de configuración de bibliotecas.
Con la original instalada, lo normal es que no instale. Las authorities de sus <provider> siguen
siendo las de la original, y el instalador responde INSTALL_FAILED_CONFLICTING_PROVIDER (−13). Un
permiso propio que declaren las dos con firmas distintas da INSTALL_FAILED_DUPLICATE_PERMISSION
(−112) («sección 2.4 de Diagnóstico de fallos · Fallos de instalación»). Resuelto eso, instala,
y falla en el primer sitio donde alguien construya un nombre por concatenación.
Esto afecta a casi todas las apps. Solo el proveedor de arranque de AndroidX, cuya authority es
<paquete>.androidx-startup, ya está en unas 3 de cada 4 de F-Droid y en más de 8 de cada 10 de
Play. Y la mayoría declara además algún <permission> propio. Son cifras mínimas: nuestro medidor no
guarda el resto de las authorities. «Lo normal» vale para F-Droid, IzzyOnDroid y Play; en el
mercado chino, donde AndroidX está en la mitad de las apps, y en las apps sin AndroidX, no lo des por
hecho. Qué ocurre al instalar no lo hemos medido: solo hemos mirado qué declara cada manifiesto.
Para el primer caso de uso de la «sección 1 · Qué es y por qué existe», una copia de laboratorio en la que acoplar un depurador
o ver el tráfico, apktool b trae dos atajos. --debuggable pone android:debuggable="true" en el
manifiesto. --net-sec-conf apunta android:networkSecurityConfig a un
res/xml/network_security_config.xml cuyo base-config confía en las CA del sistema y en las del
usuario, con un aviso si el targetSdk es menor que 24. Las dos reescriben el manifiesto de texto.
Con -r, el manifiesto binario se copia tal cual y no hacen nada; junto a --copy-original, apktool
las ignora con un aviso («sección 2.6 de
Desempaquetado y reempaquetado · -r/--no-res: cuándo salva la papeleta»).
4.2 Las dos vías, y por qué no dan lo mismo
apktool decodifica los recursos a XML de texto y, al reconstruir, llama a aapt2 para que
los vuelva a compilar. Pero aapt2 no está escrito para reconstruir, sino para construir desde
fuentes: optimiza PNG, normaliza valores, reordena entradas y resuelve referencias a su manera. El
resultado es funcionalmente parecido y byte a byte distinto. Y hereda los fallos de aapt2, como
el clásico «resource … is private» al enlazar contra un recurso privado del framework: es legal en un
binario ya construido, y aapt2 lo rechaza por diseño.
APKEditor, sobre ARSCLib, lee y escribe resources.arsc y AXML directamente. No hay
compilación intermedia, así que no hay nada que perder por el camino ni fallos de aapt2 que
heredar: lo que no se toca, no cambia.
Un detalle que complica la edición a mano: en muchos APK actuales las rutas de res/ no se
pueden leer. El compilador las acorta (ficheros directamente en res/ sin carpeta de tipo, o una
carpeta r/), así que el nombre del fichero ya no dice su tipo ni su recurso; solo lo dice la tabla
resources.arsc. Pasa en más de 8 de cada 10 apps de F-Droid e IzzyOnDroid y en bastantes menos de
Play. Es mucho más raro que se borren también los nombres de recurso dentro de resources.arsc. Un
ejemplo de rutas acortadas es com.dsi.ant.service.socket 4.18.00; uno de nombres borrados, la pieza
com.jio.media.jiobeats.apk del .xapk de JioSaavn - Music & Podcasts 10.11. apktool y APKEditor
rehacen los nombres legibles a partir de resources.arsc. Con unzip y zip, en cambio, tendrás que
averiguar antes en la tabla qué fichero es cada uno. La definición de «ruta acortada» la inferimos de
la forma de la ruta.
El detalle de opciones de las dos está en «Desempaquetado y reempaquetado», secciones «2» y «3». Lo que aquí importa es cuándo usar cuál:
| Situación | Herramienta |
|---|---|
| Solo hay que tocar código, los recursos dan igual | apktool con -r/--no-res: no decodifica recursos, así que aapt2 no interviene |
Hay que tocar recursos y el APK es normal |
Cualquiera de las dos |
| apktool falla al reconstruir | APKEditor: es el motivo por el que existe |
| Hay que garantizar que el resto sale idéntico | APKEditor decode -t raw: no decodifica, luego no puede perder |
Solo hay que cambiar un fichero de res/ que no es AXML |
unzip + zip, o directamente reescribir la entrada del ZIP |
Y el diagnóstico que ahorra más tiempo, en dos órdenes. Si apktool d falla:
- prueba con
-r(no decodifica recursos): si funciona, el problema estaba en los recursos; - prueba con
-s(no desensambla losDEX): si funciona, estaba en el código.
Fíjate en que la condición es el éxito de la bandera que desactiva una mitad, no su fallo.
-s deja el DEX intacto y sigue decodificando recursos, así que un fallo con -s señala a
los recursos, no al código.
Salida no reproducida en esta sección. Las opciones citadas proceden de la documentación oficial de cada proyecto, consultada el 12 de agosto de 2026, y del documento de herramientas correspondiente, pero aquí no hemos pegado ninguna salida real. Sí hay salida de
apktool3.0.3 ejecutada en «Desempaquetado y reempaquetado».
4.3 Lo que sí está ejecutado: el manifiesto sin reconstruir
Para leer y comprobar un manifiesto no hace falta nada más que el SDK, y merece la pena hacerlo antes y después de cualquier edición:
BT=~/Library/Android/sdk/build-tools/37.0.0
$BT/aapt2 dump xmltree app.apk --file AndroidManifest.xml \
| grep -E "debuggable|usesCleartextTraffic|networkSecurityConfig|exported"
Un ejemplo ejecutado el 31 de octubre de 2026, con io.github.jeffin_v.apiflow 5 (32.872 bytes), una
pieza pequeña que declara usesCleartextTraffic y networkSecurityConfig:
$BT/aapt2 dump xmltree io.github.jeffin_v.apiflow_5.apk --file AndroidManifest.xml \
| grep -E "debuggable|usesCleartextTraffic|networkSecurityConfig|exported"
A: http://schemas.android.com/apk/res/android:usesCleartextTraffic(0x010104ec)=true
A: http://schemas.android.com/apk/res/android:networkSecurityConfig(0x01010527)=@0x7f040000
A: http://schemas.android.com/apk/res/android:exported(0x01010010)=true
En la calculadora de Fossify (org.fossify.math 10) el mismo filtro devuelve solo líneas exported
(39), porque no declara las otras tres. Una copia con debuggable activo es
com.particlesdevs.photoncamera 17884, de IzzyOnDroid: la salida es
A: …:debuggable(0x0101000f)=true. Lo ejecutamos con build-tools 37.0.0 (aapt2 2.20-15087165)
sobre copias de las piezas; no escribimos nada en el muestrario.
Aquí aapt2 hace de oráculo: si el manifiesto reescrito produce el xmltree que esperabas, la
edición es correcta a nivel de formato. Es la misma disciplina que pide cualquier fusión de splits.
5. Editar código en smali
5.1 El flujo
No existe ninguna herramienta que recompile a DEX el Java que salió de un decompilador, y no
por falta de ganas: ese Java no compila. Le faltan tipos, tiene referencias sintéticas, y un
ofuscador puede haber emitido identificadores que no son código Java válido. El smali, en cambio,
vuelve a DEX por construcción, instrucción a instrucción. Toda modificación real de una
aplicación pasa por aquí.
Salida no reproducida en esta sección. El
smalique aparece aquí procede de la «sección 5 de Desensambladores smali · La misma clase en smali, comentada», que sí está ejecutada conbaksmali3.0.7. Las instrucciones, los registros y los nombres de etiqueta son reales.
5.2 El problema de los registros
Es lo que hace difícil la edición. Hay un solo banco de registros por método y los
parámetros ocupan los últimos. Así que, si subes .locals para hacer sitio, desplazas todos los
p, y cualquier referencia v a un registro que era parámetro pasa a apuntar a otra cosa. Además,
lo que pase de v15 ya no cabe en las instrucciones de 4 bits. Y no es un caso raro: casi todas las
apps tienen algún método con más de 16 registros. El medidor guarda el máximo por DEX, así que dice
si hay «alguno», no cuántos. Un ejemplo es com.android.adbkeyboard 2 (máximo de 26 registros). La
aritmética está en la «sección 3.5 de
Desensambladores smali · .registers frente a .locals: donde se equivoca todo el mundo», y las tres restricciones
al insertar código (la última, los tipos que ART comprueba al cargar la clase), en la «sección
8.3 · El problema de los registros al insertar código».
5.3 Qué cambios son seguros
Baratos y seguros son los cambios que no alteran el tamaño de la instrucción, no tocan registros
ni cambian el flujo: una constante dentro del rango de su formato, una condición invertida, una
llamada void eliminada, un salto reapuntado o el literal de un const-string. Caros son
cambiar la firma de un método, añadir un parámetro o un campo e insertar código en medio, que es el
problema de «§5.2 · El problema de los registros» en estado puro. Cada uno, con su cuidado, en las secciones «8.1» y «8.2» de
«Desensambladores smali».
El DEX tiene un tope. Un classes.dex admite 65.536 referencias a métodos, y muchos están
casi llenos: en 87 de cada 100 de las apps más instaladas de Play, el DEX mayor pasa de 60.000. Si
añades código a uno de ellos, puede que tengas que moverlo a otro DEX. La calculadora de Fossify
(org.fossify.math 10), en cambio, tiene un solo DEX de 4.624.152 bytes, con 33.869 referencias a
métodos, y le sobra sitio.
5.4 La regla de oro del parcheo
Cuando el Java y el smali discrepan, el smali tiene razón. El Java del decompilador es una
hipótesis, y si buscas en él el método a parchear puedes acabar en el equivocado. R8 hace
inlining, outlining a métodos sintéticos compartidos y fusión de clases: un método que existía
en el fuente puede no aparecer, y uno de diez líneas puede salir con doscientas. Entiende sobre el
Java, pero localiza el parche sobre el desensamblado.
Más de la mitad de las apps de F-Droid y de Play traen el marcador de R8. Lo que hace R8 es comportamiento documentado de la herramienta; el análisis estático del muestrario no lo mide, y no se puede ver un método que ya no existe.
6. Reempaquetar: qué se pierde
6.1 La salida nunca es byte-idéntica a la entrada
Puedes comprobarlo sin apktool y sin APKEditor. Tomamos org.fossify.math_10.apk del
«muestrario» (la calculadora de Fossify; 7.047.681 bytes) y lo
reempaquetamos conservando el nombre y el método de compresión de cada entrada. Solo cambia el
contenido de un fichero, assets/dexopt/baseline.profm, que pasa de 713 a 9 bytes. El script copia
cada entrada con su nombre, su compress_type y su fecha; se salta MANIFEST.MF y los .SF, .RSA,
.DSA y .EC de la raíz de META-INF/, y no escribe relleno de alineación ni firma:
import sys, zipfile
src, dst = sys.argv[1], sys.argv[2]
cambio = {"assets/dexopt/baseline.profm": b"x" * 9}
with zipfile.ZipFile(src) as zi, zipfile.ZipFile(dst, "w") as zo:
for i in zi.infolist():
n = i.filename
if n.startswith("META-INF/") and n.count("/") == 1 and n.endswith((".SF", ".RSA", ".DSA", ".EC", "MANIFEST.MF")):
continue
z = zipfile.ZipInfo(n, i.date_time)
z.compress_type = i.compress_type
z.external_attr = i.external_attr
zo.writestr(z, cambio.get(n, zi.read(n)))
python3 -I reempaquetar.py org.fossify.math_10.apk reempaquetado.apk
ls -l org.fossify.math_10.apk reempaquetado.apk
7047681 org.fossify.math_10.apk
7009573 reempaquetado.apk
La salida es la del 31 de octubre de 2026, con Python 3.12 y zlib en su nivel por defecto (6). El
resultado pesa 38.108 bytes menos (7.047.681 − 7.009.573) sin haber quitado ninguna entrada. La
longitud de lo que pones en baseline.profm influye: con 713 bytes, los del original, la diferencia
sería de 37.404. El desglose:
| Parte | Bytes | Qué es |
|---|---|---|
| Relleno de alineación | +34.000 | zipalign lo dejó en las cabeceras locales y el reempaquetado no lo copia. 33.709 están en las cuatro copias de lib/*/libandroidx.graphics.path.so |
APK Signing Block |
+4.096 | Solo trae v2 y relleno |
Recompresión con deflate de nivel 6 |
−692 | El fichero queda 692 bytes más grande, no más pequeño |
| La propia edición | +704 | baseline.profm pasa de 713 a 9 bytes |
Suma: 34.000 + 4.096 − 692 + 704 = 38.108. Así que la diferencia no es solo recompresión: casi toda
es relleno. Para ver si es típico, medimos el campo extra (casi siempre relleno) de las cabeceras
locales de la pieza base o única de cada app, deducido de los desplazamientos. Lo normal es que sean
unos cientos o pocos miles de bytes, pero en el 10 % más grande llega a 65.000-81.000 (salvo en el
sorteo de Play). El APK Signing Block típico es de 4.096 bytes fuera de Play y de 12.288 en Play.
Comparando entrada a entrada el APK de partida contra el final ya firmado:
entradas: original 1584 final 1584
solo en el original : 0
solo en el final : 0
contenido distinto : 1 ['assets/dexopt/baseline.profm'] ← el cambio pedido
método distinto : 0
tamaño comprimido distinto (mismo contenido): 245 de 1584
245 de las 1.380 entradas comprimidas (18 %) tienen exactamente el mismo contenido y ocupan un
número de bytes distinto. Las otras 204 entradas van sin comprimir y no pueden cambiar. No hemos
tocado ninguna de las 245: se han vuelto a comprimir con deflate de nivel 6, y el original está
comprimido casi como con el nivel 9 (con ese nivel solo cambian 23). Con el nivel 1 cambiarían 1.209.
Ese es el suelo de lo que un reempaquetado cambia aunque no edites nada. Puedes repetir los tres
niveles con:
python3 -I -c "import zipfile,zlib; z=zipfile.ZipFile('org.fossify.math_10.apk'); [print(l, sum(len((lambda c,d: c.compress(d)+c.flush())(zlib.compressobj(l,zlib.DEFLATED,-15), z.read(i.filename)))!=i.compress_size for i in z.infolist() if i.compress_type==8)) for l in (1,6,9)]"
La cifra es de este fichero. No la hemos medido en el resto del muestrario.
6.2 El inventario de lo que se pierde
| Qué | Se pierde porque | ¿Se preserva? |
|---|---|---|
El APK Signing Block |
No es una entrada del ZIP: vive entre los datos y el Central Directory, y ninguna herramienta de reempaquetado lo reproduce |
No: hay que volver a firmar («§7 · Alinear y firmar») |
| Las entradas de firma v1 | Sus digests ya no cuadran | No: se descartan y se regeneran al firmar |
| El relleno de alineación | Vive en el extra field del Local File Header y depende del offset de destino, que ya no es el de origen |
Se recalcula con zipalign («§7 · Alinear y firmar») |
| El orden de las entradas | Lo decide el escritor del ZIP |
Solo si lo preserva a propósito |
| Los tamaños comprimidos | Distinta configuración de deflate («§6.1 · La salida nunca es byte-idéntica a la entrada») |
No de forma práctica |
| Las marcas de tiempo | Depende del escritor; AGP escribe 01-01-1981 01:01:02 en todas para que la build sea reproducible (la hora de ZIP tiene resolución de 2 s, de ahí los :02) |
Sí, si se fijan explícitamente |
| El método de compresión por entrada | Lo decide el escritor si no se le dice otra cosa | Sí, y es obligatorio («§6.3 · Lo que hay que preservar a mano, y por qué») |
La firma, con apktool b --copy-original |
La opción reinyecta el AndroidManifest.xml binario y los MANIFEST.MF, *.SF y *.RSA originales, pero no el APK Signing Block, y los digests de v1 de lo modificado ya no cuadran |
No: el APK «lleva firma» y no verifica. La FAQ de apktool lo limita al esquema v1; hay que quitar esas entradas y refirmar («§7 · Alinear y firmar») |
El perfil de assets/dexopt/baseline.prof y baseline.profm |
No se pierde la entrada, sino su utilidad: el perfil guarda, por cada DEX, el checksum y el número de tipos y de métodos del DEX para el que se generó (profile_compilation_info.cc:1006-1008 de ART). Si editas el código ya no casa, y dex2oat no aborta: registra Dex checksum mismatch while verifying profile y no usa para ese DEX los datos del perfil (:1337-1356, :1479-1499 y :2138-2152; dex2oat.cc:3225-3236) |
Solo sirve si los DEX salen byte a byte iguales; tras editar smali es peso muerto |
stamp-cert-sha256 |
Es una entrada normal con el SHA-256 del certificado del source stamp; lo que la valida es el bloque 0x6dff800d del APK Signing Block, que se pierde con él. El reempaquetado y zipalign la copian sin su bloque, y apksigner sign la descarta y solo la vuelve a escribir con --stamp-signer (ApkSigner.java:385-394 y :531-553 de apksig) |
No: refirmado sin --stamp-signer, el APK ya no la lleva |
Otros pares del APK Signing Block (sello, frosting de Play, información de dependencias) |
Viven en el mismo bloque que la firma y no se reescriben | No: el bloque nuevo solo trae lo que apksigner escribe (v2 y v3, más relleno). Lo medimos: al refirmar la base de air.conectagames.tute, el bloque pasa de v2, v3, sello, frosting y relleno a solo v2, v3 y relleno |
El canal de distribución (Walle, VasDolly, channelId=) |
Lo marcan algunas tiendas chinas en un par del bloque, en un fichero de META-INF/ o en el comentario del ZIP |
Depende de dónde esté: lo que va en el bloque se pierde al firmar; lo que va en META-INF/ o en el comentario del ZIP puede sobrevivir según la herramienta, y una app que lea un canal que ya no existe informará de otro |
Qué más hay en el bloque. En Play, casi todas las apps llevan en el bloque algo más que la firma:
sello, frosting, información de dependencias. En el mercado chino lo lleva la mitad, casi siempre
por el canal de distribución; en F-Droid, casi ninguna. Lo que se pierde al refirmar depende mucho
de dónde venga la app. El canal chino va dentro del bloque en 46 de 100 apps: Walle
(0x71777777), VasDolly (0x881155ff) o el par 0x71717874 con el texto channelId=…. Otras dos
lo llevan en META-INF/ o en el comentario del ZIP. Tres ejemplos: cn.ninegame.gamemanager
80506001 (Walle), com.tencent.tgclub 2026081227 (par 0x71717874) y com.suning.mobile.ebuy 596
(canal en META-INF/config_channel.txt).
El sello, comprobado con un caso real. Refirmamos la base de air.conectagames.tute (pieza
base.apk) con otra clave y sin --stamp-signer. Los pares del bloque pasaron de 0x7109871a (v2),
0xf05368c0 (v3), 0x6dff800d (sello), 0x2146444e (frosting) y 0x42726577 (relleno) a
0x7109871a, 0xf05368c0 y 0x42726577. apksigner verify pasó de Verified for SourceStamp: true
a false, y la entrada stamp-cert-sha256 desapareció del ZIP. Se repite con:
BT=~/Library/Android/sdk/build-tools/37.0.0
$BT/zipalign -P 16 -f 4 base.apk al-base.apk
$BT/apksigner sign --ks proc.p12 --ks-key-alias proc --ks-pass env:KSPASS --key-pass env:KEYPASS \
--out base-refirmada.apk al-base.apk
$BT/apksigner verify -v base-refirmada.apk | grep SourceStamp
python3 -I -c "import zipfile,sys; print('stamp-cert-sha256' in zipfile.ZipFile(sys.argv[1]).namelist())" base-refirmada.apk
En todo el muestrario la entrada y el bloque van juntos: cada pieza que tiene uno tiene también el
otro, y en todas el SHA-256 de la entrada es el del certificado del sello, un único certificado de
Google. Lo llevan casi todas las piezas de Play y ninguna de F-Droid, del mercado chino ni de las webs
de los autores. La excepción dentro de Play son los .apk sueltos de las webs de descarga, donde solo
lo lleva un tercio. Ojo al comparar cifras: contado por pieza sale un 98 % en las más instaladas de
Play, y contado por app (pieza base o única), un 79 %. No son la misma medida.
Las marcas de tiempo. Casi todas las piezas de Play y de las tiendas libres tienen todas las
entradas en 1981-01-01 01:01:02; en el mercado chino, solo 12 de cada 100. La calculadora de
Fossify lo cumple en sus 1.584 entradas.
Los perfiles de ART. assets/dexopt/baseline.prof está en 7 de cada 10 apps de F-Droid y en 9
de cada 10 de las más instaladas de Play. Las carpetas de adb también lo traen dentro de base.apk,
no aparte.
6.3 Lo que hay que preservar a mano, y por qué
Son dos cosas. Si te equivocas en cualquiera de ellas, sale un APK que no instala, o que instala y
no carga sus bibliotecas nativas:
1 · resources.arsc tiene que ir stored. Desde targetSdkVersion 30 es un requisito de
instalación, no una optimización, y las herramientas locales no lo detectan. aapt2 lee la
tabla comprimida sin protestar, y zipalign -c responde (OK - compressed) y sale con 0. El fallo
solo aparece al instalar, como INSTALL_PARSE_FAILED_RESOURCES_ARSC_COMPRESSED. La demostración,
con su salida, está en la «sección 2.3 de Diagnóstico de fallos · Los cinco que hay que conocer al detalle». La
comprobación tienes que hacerla a mano:
python3 -c "
import zipfile,sys; i=zipfile.ZipFile(sys.argv[1]).getinfo('resources.arsc')
print('OK stored' if i.compress_type==0 else 'FALLA: resources.arsc comprimido')" app.apk
Los datos del muestrario encajan con la regla. Entre las piezas con targetSdk 30 o más, solo una
incumple: dudeofx.eval 102 (targetSdk 36), que va sin comprimir pero con los datos fuera de
múltiplo de 4. Por debajo de 30, donde la regla aún no obliga, hay unas pocas; por ejemplo,
com.chessclock.android 31 (targetSdk 27) y nl.asymmetrics.droidshows 71110 (targetSdk 25).
Esa cifra junta dos casos, «comprimido» y «desalineado», y no los separa; el caso de targetSdk 36 es
de desalineado. No hemos instalado ninguna de las piezas para ver el error.
2 · Las .so tienen que ir stored si extractNativeLibs es false. Con
android:extractNativeLibs="false" en el manifiesto, el sistema carga las bibliotecas directamente
del APK, sin extraerlas, y para eso tienen que estar sin comprimir y alineadas a la página. Si el
reempaquetado las comprime, el APK no llega a instalarse:
INSTALL_FAILED_INVALID_APK: Failed to extract native libraries, res=-2. apktool lo anota en el campo
doNotCompress de apktool.yml precisamente porque la decodificación pierde esa información.
En el muestrario la regla se cumple en todas las fuentes: ninguna app con .so y
extractNativeLibs="false" tiene .so comprimidas, ni sin comprimir fuera de múltiplo de 4.096. Es
la forma más común: la usan dos de cada tres apps de F-Droid con .so y algo más de la mitad de las
más instaladas de Play. La calculadora de Fossify la sigue: extractNativeLibs="false" y cuatro .so
sin comprimir, todas a múltiplo de 16.384. Unas pocas apps hacen lo contrario (true o nada, y aun
así .so sin comprimir): no pasa nada, pero no se aprovecha.
Y una tercera, menor pero visible: el META-INF/ que no es de firma se conserva. Los
*.version, los services/ del mecanismo ServiceLoader y los *.kotlin_module no tienen nada que
ver con la firma, y borrarlos rompe la reflexión y el ServiceLoader en tiempo de ejecución. Solo hay
que quitar MANIFEST.MF, *.SF y *.RSA/*.DSA/*.EC de la raíz de META-INF/. Ojo con un
patrón demasiado amplio, que se lleva ficheros que no son firma: la calculadora de Fossify lleva
META-INF/versions/9/OSGI-INF/MANIFEST.MF, y algo así aparece en 1 de cada 10 piezas de F-Droid y en
casi la mitad de las del mercado chino. Otro ejemplo es com.byarchitect.operator 7. Y los
*.version y services/ que se llevaría por delante están en la mayoría de las piezas de F-Droid. El
script del reempaquetado de 6.1 filtra por «una sola barra» para respetar esta regla.
7. Alinear y firmar
7.1 El orden, y dónde está demostrado
zipalign antes de apksigner. Siempre. Pasado sobre un APK ya firmado, zipalign sale
con 0 y borra el APK Signing Block: apksigner verify responde DOES NOT VERIFY con
Signature stripped? si había v1, o con Missing META-INF/MANIFEST.MF si no la había. La
demostración, con su salida, está en la «sección 4.2 de
Alineación y zipalign · La demostración».
Qué produce cada orden de los pasos está en la tabla de la «sección 8 de
Firma y empaquetado · Qué se rompe si se altera el orden». El corolario práctico:
zipalign -c es seguro siempre; zipalign sin -c sobre un APK firmado obliga a
refirmar.
7.2 Un solo byte basta
Cambiar un byte de resources.arsc en un APK firmado, sin mover un solo offset, basta para
que apksigner verify responda DOES NOT VERIFY con CHUNKED_SHA256 digest mismatch. Aprende a
reconocer ese mensaje: digest mismatch significa que el contenido cambió después de firmar. En
cambio, Signature stripped? y Missing META-INF/MANIFEST.MF significan que el bloque entero
desapareció, casi siempre por un zipalign a destiempo. Son diagnósticos distintos con arreglos
distintos; la demostración, con su salida, está en la «sección 3.2 de
Diagnóstico de fallos · Bloque desaparecido frente a contenido modificado (reproducido)».
7.3 La firma original no se puede conservar, y no es culpa de las herramientas
Es la pregunta que todo el mundo hace, y la respuesta no es «las herramientas no saben»: es una imposibilidad criptográfica.
Una firma es Firma(clave_privada, digest(contenido)). Para verificarla se recalcula el digest del
contenido que se tiene delante y se comprueba, con la clave pública del certificado, que la firma
corresponde a ese digest. Si el contenido cambia, el digest cambia, y una firma válida para el
digest nuevo exige la clave privada. Esa clave no está en el APK: está en el keystore del
autor, y todo el mecanismo existe para que nadie más la tenga.
Dicho al revés: si se pudiera conservar la firma tras modificar el contenido, la firma no serviría
para nada. No es una limitación que alguien pueda arreglar: es la propiedad que hace útil a la
firma. Cualquier herramienta que reescriba el ZIP (apktool, APKEditor, zipalign) la invalida
por construcción.
Lo único que puedes hacer es volver a firmar con otra clave, y eso cambia la identidad de la aplicación. Sobre el ciclo completo ejecutado en «§6.1 · La salida nunca es byte-idéntica a la entrada»:
echo -n "original: "; $BT/apksigner verify --print-certs entrada.apk | grep -m1 "SHA-256 digest"
echo -n "modificado:"; $BT/apksigner verify --print-certs final.apk | grep -m1 "SHA-256 digest"
original: V2 Signer: certificate SHA-256 digest: affdb124d3f4720c2f98dbca9eacba0514fba4306e20a2786c861c3c0d6ff292
modificado:V3.0 Signer: certificate SHA-256 digest: 283d348b4c1b5ce510398c28595f9e211ae8655620b150863207eaef1dd2bfc6
El original es el de org.fossify.math 10: un certificado autofirmado, RSA 2048, con el
sujeto C=IN, O=Fossify, CN=Naveen Singh y válido hasta 2048. Imprime «V2 Signer» porque su bloque
solo trae v2 (0x7109871a) y relleno, sin v3. El modificado imprime «V3.0 Signer» porque se firmó con
v2 y v3. La segunda huella es la de una clave desechable creada con keytool para esta prueba (la
orden está en 7.4), así que saldrá distinta si lo repites. La conclusión no cambia: ninguna clave que
no sea la del autor puede producir la huella affdb124….
Las consecuencias prácticas son cinco, y todas inevitables:
- No se puede instalar encima de la original. El instalador rechaza la actualización con
INSTALL_FAILED_UPDATE_INCOMPATIBLE. Hay que desinstalar primero, lo que borra los datos de la aplicación. - Se pierden los permisos de nivel
signature. Los que se conceden a aplicaciones firmadas con la misma clave que quien los declara dejan de concederse. - Se rompe
sharedUserIdcon otras aplicaciones del mismo autor, por lo mismo. - Play deja de reconocerla. No hay actualizaciones desde la tienda, y los servicios de terceros que se registran por la huella del certificado (Maps, Firebase, el inicio de sesión social, las notificaciones push) pueden dejar de autenticar. En Play esto toca a la mayoría: 86 de cada 100 de las apps más instaladas llevan en el manifiesto la clave de Google Maps, los componentes de Firebase o el identificador de Facebook. En F-Droid, casi ninguna. Es un máximo, no una medida de fallos: esa meta-data indica que la app usa el servicio, no que deje de funcionar con otra huella. Firebase sin huella de certificado, como el servicio básico de mensajes, puede seguir funcionando; no lo hemos medido. El inicio de sesión con Google no deja meta-data y no lo contamos.
- La aplicación puede notarlo. Una comprobación de integridad en ejecución que compare la huella de su propio certificado contra una constante detecta el cambio («§10 · Qué NO se puede modificar de forma realista»).
7.3.1 Misma app, dos firmas: F-Droid frente a IzzyOnDroid
La misma app puede llegar firmada por claves distintas según de dónde la descargues: un caso real de
«dos copias, dos firmas». De los paquetes que están a la vez en F-Droid e IzzyOnDroid, muchos son el
mismo fichero byte a byte (la calculadora de Fossify, por ejemplo), y ahí no hay nada que comparar.
Pero cuando los ficheros difieren, lo normal es que también difiera el certificado: solo 68 de 218
comparten firma. Los demás no se pueden actualizar una encima de la otra; es el mismo choque
(INSTALL_FAILED_UPDATE_INCOMPATIBLE) que sufre un APK refirmado.
Un ejemplo es el paquete com.scalepractice: la copia de F-Droid (versión 12) lleva el certificado
abb66852…, y la de IzzyOnDroid (versión 11), el 27d476a4…. Ojo: eso no quiere decir que dos de
cada tres apps de IzzyOnDroid estén firmadas aparte; la proporción es solo entre las que difieren. Los
6 paquetes que están a la vez en la web de su autor y en Google Play comparten certificado.
7.4 La receta completa, ejecutada
Pasos 4 a 6 del pipeline, sobre el reempaquetado de org.fossify.math_10.apk de la «sección 6.1 · La salida nunca es byte-idéntica a la entrada», con
salida real. La clave es una desechable creada para la prueba:
BT=~/Library/Android/sdk/build-tools/37.0.0
# 0 · clave desechable de laboratorio (nunca la de una aplicación real)
keytool -genkeypair -keystore proc.p12 -storetype PKCS12 -alias proc -keyalg RSA -keysize 2048 \
-validity 365 -dname CN=lab -storepass procpass -keypass procpass
# 4 · alinear, con la regla de 16 KB para las .so
$BT/zipalign -P 16 -f 4 reempaquetado.apk alineado.apk
$BT/zipalign -c -P 16 4 alineado.apk; echo "check exit=$?"
# 5 · firmar — v2+v3; v1 solo si minSdk < 24
$BT/apksigner sign --ks proc.p12 --ks-type PKCS12 --ks-key-alias proc \
--ks-pass pass:procpass --key-pass pass:procpass \
--v1-signing-enabled false --v2-signing-enabled true --v3-signing-enabled true \
--out final.apk alineado.apk
# 6 · verificar
$BT/apksigner verify --verbose final.apk
check exit=0
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
La salida es la del 31 de octubre de 2026, con build-tools 37.0.0 (zipalign, apksigner 0.9) y
OpenJDK 21.0.10. Los tamaños fueron 7.009.573 bytes el reempaquetado, 7.044.273 el alineado y
7.053.489 el firmado, y los tres con 1.584 entradas gracias a --v1-signing-enabled false. La
orden no pasa --min-sdk-version: apksigner toma el minSdk del manifiesto, que en la
calculadora de Fossify es 26. Fijarlo a mano solo sirve para firmar como si el minSdk fuera otro,
y es peligroso: la «sección 8 de Fusión de splits · Firma, y por qué no hay alternativa» explica por qué.
Con estas versiones, apksigner sign deja además un fichero final.apk.idsig (el esquema v4, que
no hace falta para un adb install normal). Y si no pasas --v1-signing-enabled false, añade
también una firma v1 (META-INF/PROC.SF, PROC.RSA y MANIFEST.MF) aunque el minSdk sea 26; con
la base de air.conectagames.tute, que declara 24, pasa igual. La ayuda de apksigner dice que v1 se
activa «según el minSdk y el maxSdk», y no hemos averiguado por qué se activa con 26. La regla
del comentario del paso 5 («v1 solo si minSdk < 24») se cumple en un sentido: ninguna app del
muestrario con minSdk menor que 24 va sin firma v1. Al revés, en cambio, es muy frecuente llevar v1
con minSdk 24 o más: más de la mitad de las apps de F-Droid lo hacen.
Tres advertencias sobre esa orden. --ks-pass pass:... no se usa fuera de una demostración: la
contraseña queda en el historial del shell y en la tabla de procesos. En cualquier uso real, pasa
env: o file:.
Firmar solo con v1 hoy es no firmar. Sobre una copia de la calculadora firmada solo con v1
(--v1-signing-enabled true --v2-signing-enabled false --v3-signing-enabled false), con
targetSdk 36, apksigner verify responde DOES NOT VERIFY y
ERROR: Target SDK version 36 requires a minimum of signature scheme v2; the APK is not signed with this or a later signature scheme.
El APK no se instala aunque la firma v1 sea criptográficamente correcta. En el muestrario, las apps
que van solo con v1 son pocas (8 de cada 100 en F-Droid, casi ninguna en el resto), y todas tienen un
targetSdk de 29 o menos. Un ejemplo es com.tencent.tmgp.yongyong.mrzh 744 (solo v1, targetSdk
28). Esta salida añade avisos WARNING: META-INF/… not protected by signature, que en F-Droid salen
en más de la mitad de las piezas con v1. Los otros dos motivos de DOES NOT VERIFY del muestrario no
tienen que ver con esto: piezas de Play sin minSdk y sin v1 (Missing META-INF/MANIFEST.MF) y
piezas con firma v3.2, que la Java 21 de apksigner no entiende y la Java 25 sí.
La tercera advertencia es sobre las páginas de 16 KB. zipalign -P 16 solo resuelve una parte del
problema: coloca las .so sin comprimir en un desplazamiento múltiplo de 16.384 dentro del ZIP,
pero no cambia la .so. Si la biblioteca se compiló con segmentos alineados a 4 KB (p_align de
4.096 en sus PT_LOAD), reempaquetar no lo arregla: hay que recompilarla. «Compatible con 16 KB»
tiene aquí la definición de la guía de Android (todos los PT_LOAD de cada .so con p_align de
16.384 o más); la del cargador de Android 17 es más estricta y no la usamos. Fíjate en que el problema
de la .so es mucho más frecuente que el del ZIP: en el muestrario hay bastantes apps que pasan
zipalign -c -P 16 4 y siguen teniendo alguna .so de arm64-v8a de 4 KB (el «pasa zipalign» se
deduce de los desplazamientos de las entradas, sin ejecutar zipalign sobre cada pieza):
| Fuente | Apps con .so de arm64-v8a que pasan zipalign -P 16 y tienen una .so de 4 KB |
Apps con el ZIP mal alineado (algo que zipalign -P 16 sí arregla) |
|---|---|---|
| F-Droid | 418 de 2.689 (16 %) | 70 de 4.766 (1,5 %) |
| IzzyOnDroid | 101 de 790 (13 %) | 30 de 1.402 (2 %) |
| Google Play, las más instaladas | 50 de 546 (9 %) | 25 de 658 (4 %) |
| Google Play, sorteo | 15 de 310 (5 %) | 32 de 369 (9 %) |
| Mercado chino | 73 de 98 (74 %) | 18 de 100 (18 %) |
| Webs de los autores | 0 de 5 | 0 de 7 |
En F-Droid e IzzyOnDroid, todas las que fallan en el ZIP son APK únicos; en Play hay también
splits de ABI. Ejemplos de una .so de 4 KB en un
ZIP que pasa: xzr.perfmon 16 (IzzyOnDroid) y org.rayg.streaktracker 12 (F-Droid). Un ejemplo de
ZIP mal alineado es tk.hack5.treblecheck 5001001: libbinderdetector.so empieza en el
desplazamiento 806.912, cuyo resto al dividir por 16.384 es 4.096.
8. Instalar y probar
Las cuatro están ejecutadas en un emulador Android 14
arm64-v8a:install-multiplecon los splits de Telegram el 13 de agosto de 2026 («Formatos y extensiones → §6.2 · Extraer el base»), y las otras tres el 25 de septiembre con unAPKde prueba.installrespondeSuccessaunque la aplicación ya esté instalada, einstall -rtambién; con la versión instalada firmada por otra clave, los dos fallan conINSTALL_FAILED_UPDATE_INCOMPATIBLE: Existing package … signatures do not match newer version; ignoring!.uninstallrespondeSuccess. Esas ejecuciones usaron piezas que ya no están en el muestrario y no las hemos repetido.
ADB=~/Library/Android/sdk/platform-tools/adb
$ADB install final.apk # instala, o reemplaza conservando los datos
$ADB install -r final.apk # lo mismo: pm acepta -r y no hace nada con él
$ADB install-multiple base.apk split_config.arm64_v8a.apk split_config.es.apk split_config.xxhdpi.apk
$ADB uninstall com.ejemplo.app # borra los datos
Los nombres de la orden install-multiple son los de una carpeta sacada con adb, como la de
air.conectagames.tute: base.apk, split_config.arm64_v8a.apk, split_config.en.apk,
split_config.es.apk y split_config.xxhdpi.apk. Son nombres de ejemplo: aquí no los hemos
instalado. Las cinco piezas comparten paquete, versionCode (6022225) y certificado. Un .xapk usa
otros nombres: el de Telegram 13.1.0 (de APKPure, versionCode 72291) lleva
org.telegram.messenger.apk, config.arm64_v8a.apk y config.xxhdpi.apk, sin split de idioma.
Cuatro notas que ahorran tiempo:
installreemplaza siempre;-rse acepta y se ignora (PackageManagerShellCommand.java:3590);-Rlo desactiva; y reemplazar exige la misma firma que la de la versión instalada. UnAPKrefirmado exige desinstalar primero, con la pérdida de datos que eso implica («§7.3 · La firma original no se puede conservar, y no es culpa de las herramientas»).- Para probar un parche sobre una versión instalada más nueva (misma firma,
versionCodemayor), el instalador respondeINSTALL_FAILED_VERSION_DOWNGRADE.adb install -r -dlo permite solo si la compilación del sistema es depurable o si la versión instalada esdebuggable(PackageManagerServiceUtils.isDowngradePermitted()); en el emuladoruserdebug,Success(«Diagnóstico de fallos → §2.5 · Lo que responde adb install, reproducido»). La alternativa es subir elversionCodeen elversionInfodeapktool.ymlantes de reconstruir. install-multiplees la vía para splits sin fusionarlos: todos deben compartirpackageName,versionCodey clave de firma, o la instalación falla entera («Fusión de splits → §9 · La alternativa: no fusionar»). En el muestrario se cumple en todos los conjuntos de splits de Play, sea cual sea el formato. Eso no prueba que las tiendas no retoquen nada: solo que no lo han hecho en esos tres campos.- El error real está en
logcat, no en la salida deadb install. El instalador devuelve un códigoINSTALL_*seco. La causa concreta (qué entrada, qué certificado, qué split falta) la escribePackageManageren el log del sistema.
Y la prueba de humo mínima después de instalar: arranca la aplicación, ejercita la
funcionalidad parcheada y mira logcat aunque parezca que funciona. Un DEX editado que no
supere la verificación de ART falla al cargar la clase, no al ejecutar la línea editada. La
aplicación arranca bien y muere al tocar la pantalla parcheada, con una traza que apunta a otro
sitio («§5.2 · El problema de los registros»).
De dónde salen los splits. Una carpeta de adb se obtiene con adb shell pm path <paquete> y un
adb pull de cada ruta que devuelve. Es el método estándar, y aquí no lo hemos ejecutado: las
carpetas del muestrario ya vienen sacadas. Un .apkm es un ZIP con base.apk, varios
split_config.*.apk, un info.json, un icono (icon.png), APKM_installer.url y la firma JAR del
propio contenedor; suele traer unas 12 piezas. Un .xapk es un ZIP con <paquete>.apk, uno o
varios config.*.apk y un manifest.json, y a veces ficheros OBB; suele traer unas 3. Ningún
contenedor lleva AndroidManifest.xml en la raíz. Ejemplos: el .apkm con OBB de
com.zakg.scaryteacher.hellgame 10.5 y el .xapk de Telegram 13.1.0, con su pieza
org.telegram.messenger.apk. Para adb install-multiple los splits se pasan sueltos: tienes que
extraerlos, porque ningún contenedor se instala tal cual.
¿Cuántas apps llegan en splits? La mayoría de las de Play, pero no todas: unas 7 de cada 10 de las
más instaladas y casi 9 de cada 10 del sorteo. Una carpeta típica trae cuatro piezas: la base, un
split de arquitectura, uno de idioma y uno de densidad. El conjunto más repetido es
arm64_v8a + en + xxhdpi. También hay carpetas con un solo fichero.
Modificar una aplicación de splits sin fusionarla. Editas el split que lleva lo que hay que
cambiar, alineas y refirmas todos con la misma clave, y los instalas juntos. Casi siempre es el
base, pero no siempre: algunos conjuntos llevan classes*.dex también fuera de la base, en módulos
de función (8 de cada 100 de las más instaladas de Play). Y si el cambio es de textos o de imágenes,
puede estar en un split de idioma o de densidad, porque también llevan su propia tabla
resources.arsc. El bucle es:
BT=~/Library/Android/sdk/build-tools/37.0.0
mkdir -p refirmados
for f in *.apk; do
$BT/zipalign -P 16 -f 4 "$f" "refirmados/al-$f"
$BT/apksigner sign --ks clave.p12 --ks-key-alias alias --ks-pass env:KSPASS \
--key-pass env:KEYPASS --out "refirmados/$f" "refirmados/al-$f" && rm "refirmados/al-$f"
done
for f in refirmados/*.apk; do $BT/apksigner verify --print-certs "$f" 2>/dev/null \
| grep -m1 "SHA-256 digest" || echo "sin firma válida: $f"; done | sort -u | wc -l # → 1
$ADB install-multiple refirmados/*.apk
Lo probamos con las cinco piezas de air.conectagames.tute y una clave desechable. Ojo: antes y
después del refirmado el recuento da 1 certificado distinto, así que por sí solo no demuestra que la
firma haya cambiado; compáralo con el del original. Y el bucle hace dos cosas sin avisar. Deja un
fichero .idsig por cada pieza. Y los splits que no declaran minSdk (los split_config.*; lo
comprobamos con split_config.en.apk) reciben también firma v1, igual que la base (minSdk 24),
que sale con v2, v3 y entradas META-INF/PROC.* de v1. Conviene pasar --v1-signing-enabled false
a todas por igual, o dejar que cada una decida y comprobar con apksigner verify -v. El
comportamiento de v1 con minSdk 26 no está explicado («sección 7.4 · La receta completa, ejecutada»). Lo ejecutamos el 31 de octubre
de 2026, sobre copias.
La sesión de instalación compara cada split con el primero y exige el mismo paquete, el mismo
versionCode y las mismas firmas (PackageInstallerSession.java:5154-5180). Basta uno sin refirmar
para que todo falle con signatures are inconsistent
(«Diagnóstico de fallos → §2.5 · Lo que responde adb install, reproducido»). A cambio, la aplicación sigue
instalada como splits y ApplicationInfo.splitSourceDirs no se queda a null, que es lo que rompe
la fusión («Fusión de splits → §10.5 · Aplicaciones que comprueban su propia estructura de splits»). Lo que no evita es el cambio de
clave de «§7.3 · La firma original no se puede conservar, y no es culpa de las herramientas»: una comprobación de la propia firma en ejecución lo ve igual que en un APK
fusionado. PairIP, por ejemplo, trae una clase com.pairip.SignatureCheck («sección 8 de
Anti-análisis y hardening · PairIP»). El refirmado y el
recuento de certificados están ejecutados sobre tres splits sintéticos generados con
aapt2 link --split, con resultado 1; install-multiple con un base y su config.es firmados
con una clave propia responde Success en la «sección 7 de
Firma y empaquetado · Instalar».
9. Los puntos de fallo, paso a paso
Resumen para consulta. Cada síntoma está desarrollado en «Diagnóstico de fallos», con su causa raíz y su arreglo.
| Paso | Falla característico | Se ve como | Detalle |
|---|---|---|---|
| 0 · analizar | Packer, integridad en ejecución, lógica en nativo | Todo funciona hasta que la aplicación arranca y se cierra | «§10 · Qué NO se puede modificar de forma realista» y «Diagnóstico de fallos §9» |
| 1 · desempaquetar | Framework del fabricante no instalado | Los recursos no decodifican | «Diagnóstico de fallos §5» |
| 1 · desempaquetar | resources.arsc que no parsea |
Could not decode arsc file |
«Diagnóstico de fallos §5», «§8» |
| 2 · editar | Banco de registros desplazado | Verificación de ART al cargar la clase |
«§5.2 · El problema de los registros», «Diagnóstico de fallos §9.5» y «Qué rechaza cada lector → §7 · ClassLinker y el verificador de bytecode» |
| 3 · reempaquetar | aapt2 rechaza un recurso privado |
Falla el build, no se produce APK |
«§4.2 · Las dos vías, y por qué no dan lo mismo», «Diagnóstico de fallos §5» |
| 3 · reempaquetar | resources.arsc sale comprimido |
Nada local lo detecta; falla al instalar | «§6.3 · Lo que hay que preservar a mano, y por qué», «Diagnóstico de fallos §2.3» |
| 3 · reempaquetar | .so comprimidas con extractNativeLibs=false |
No instala: INSTALL_FAILED_INVALID_APK: Failed to extract native libraries |
«§6.3 · Lo que hay que preservar a mano, y por qué» |
| 4 · alinear | Alineación de 16 KB no cumplida | zipalign -c -P 16 4 sale con 1 |
«Diagnóstico de fallos §4» |
| 5 · firmar | Orden invertido | Signature stripped? / Missing META-INF/MANIFEST.MF |
«§7.1 · El orden, y dónde está demostrado» |
| 5 · firmar | Solo v1 | requires a minimum of signature scheme v2 |
«§7.4 · La receta completa, ejecutada» |
| 6 · verificar | Se editó algo después de firmar | CHUNKED_SHA256 digest mismatch |
«§7.2 · Un solo byte basta» |
| 7 · instalar | Firma distinta de la instalada | INSTALL_FAILED_UPDATE_INCOMPATIBLE |
«§7.3 · La firma original no se puede conservar, y no es culpa de las herramientas», «Diagnóstico de fallos §2» |
| 7 · instalar | Splits con firmas distintas | INSTALL_FAILED_INVALID_APK: … signatures are inconsistent |
«Diagnóstico de fallos §2» |
10. Qué NO se puede modificar de forma realista
Hay tres familias. En las tres, el pipeline de esta página produce un APK que instala
perfectamente y no funciona. Esa es la parte cara: el fallo no aparece en ninguno de los seis
pasos, sino en ejecución.
1 · Aplicaciones con packer. El classes.dex que desensamblas no es el código de la
aplicación: es un stub que descifra y carga el payload real en tiempo de ejecución. Puedes
parchear el stub con toda la corrección del mundo y no estás tocando la lógica. El modelo de
funcionamiento está en «Packers y protectores».
Extraer el payload está fuera del alcance de esta documentación.
El mercado chino concentra los casos: 38 de cada 100 apps chinas llevan un protector reconocible por
los nombres de sus .so y de su clase Application (sin contar PairIP), sobre todo Bangcle/SecNeo.
En Play son raros (2 de cada 100 entre las más instaladas, varias con DexProtector), y en F-Droid,
IzzyOnDroid y las webs de los autores no hay ninguno. Con APKiD 3.1.0 en vez de esa heurística, la
cifra china es parecida (40 de 98), y las dos formas de contar coinciden en 93 de 98. Un stub se nota
en el número de clases del DEX: la mediana de las apps protegidas chinas es de 25 clases, y la de
las demás, de 57.617.
La regla barata de la «sección 6.4 de Pipeline de análisis · Comprobación 3 — la forma del DEX» (un solo
classes.dex de menos de 400.000 bytes en una app con .so) es una pista, no una prueba. Solo
reconoce a 9 de las 38 protegidas chinas. Y en F-Droid marca 91 apps, casi todas por marcos de
desarrollo como SDL o Flutter, o sin explicación, pero ninguna con protector. Mira también la clase
Application y los nombres de las bibliotecas. Las herramientas tampoco avisan: en las 7 apps
protegidas chinas de la submuestra de herramientas, apktool d y apktool b terminaron bien en las 7
y jadx en 6. Que el APK reempaquetado «instale y no arranque» no se puede medir leyendo ficheros.
Dos ejemplos del mercado chino:
com.jzzs.ParentsHelper 1006033 (Jiagu 360) y com.corp21cn.mail189 185 (Ijiami, clase
Application s.h.e.l.l.S).
2 · Aplicaciones con comprobación de integridad en ejecución. La aplicación comprueba, desde
dentro, que sigue siendo la que se publicó: la huella SHA-256 de su propio certificado leída con
PackageManager.getPackageInfo(..., GET_SIGNING_CERTIFICATES), el CRC de una entrada concreta del
ZIP, el digest del classes.dex, o una atestación remota como Play Integrity. Refirmar cambia
la huella («§7.3 · La firma original no se puede conservar, y no es culpa de las herramientas»), así que estas comprobaciones fallan por construcción. El síntoma típico es que
la aplicación arranca y se cierra sin traza útil, o que funciona en modo degradado. Ver
«Anti-análisis y hardening». Neutralizar estas
comprobaciones está fuera del alcance de esta documentación.
PairIP tiene dos formas. La protección (la biblioteca libpairipcore.so, una máquina virtual y
la clase com.pairip.SignatureCheck, que comprueba el certificado) es poco frecuente: 5 de cada 100
de las más instaladas de Play. La comprobación de licencia (clases com.pairip.licensecheck y
com.pairip.application, sin libpairipcore.so) es mucho más común en el sorteo, donde la lleva una
de cada cuatro apps. Fuera de Play no aparece PairIP en ninguna forma. El cliente de Play Integrity
está en el DEX de casi 4 de cada 10 de las más instaladas, y casi nunca fuera de Play.
Ojo con una cifra que asusta y no debería: casi todas las apps leen su propia firma (por ejemplo,
PackageInfo.signatures o signingInfo). Pero una referencia en el DEX es una lectura, no una
comprobación que mate la app, y no dice si el código se ejecuta ni si es de la app o de una
biblioteca. Qué hace una app en ejecución al refirmarla o al fusionar sus splits no lo hemos medido.
Tres ejemplos de Play: la pieza base.apk del .apkm de com.teacapps.barcodescanner
3.3.6 con libpairipcore.so y com.pairip.SignatureCheck; la pieza base.apk de
com.eslamegyp.asd26 con solo com.pairip.licensecheck; y PGT: GFX, Launcher & Optimizer 0.21.7
(APKPure) con Play Integrity y sin PairIP.
3 · Aplicaciones con la lógica fuera del DEX. Si lo que hay que cambiar está en un .so, el
smali no llega: hay que editar ELF, lo que significa parchear instrucciones de máquina, mantener
el tamaño de los segmentos y no romper las reubicaciones. Es un problema de otro orden de dificultad
y de otras herramientas («Análisis binario y estático»).
Mover lógica a nativo es, de hecho, una técnica deliberada para escapar del alcance de esta
documentación.
Y pasa en una parte grande del muestrario. Llevan un marco de desarrollo cuya lógica no está en el
DEX (Flutter, React Native, Unity, Capacitor, Cordova, Godot y otros) 1 de cada 6 apps de F-Droid,
más de un tercio de las más instaladas de Play y dos tercios de las chinas. «Llevar» un marco quiere
decir que hay una prueba fuerte (nombre de biblioteca, entrada del ZIP o paquete en el DEX), no
que toda la app esté hecha con él. En F-Droid domina Flutter; en Play, Unity.
Dentro de eso hay dos casos distintos. Flutter, Unity y Godot llevan el código en bibliotecas
nativas. React Native y Cordova llevan JavaScript en assets/, que se edita sin smali, pero solo
si es texto. Y en React Native casi nunca lo es: el assets/index.android.bundle suele ser bytecode
de Hermes (no editable como texto), o directamente no está. Solo en 1 de cada 5 apps de F-Droid con
React Native es JavaScript en texto, y en Play casi ninguna. No des por hecho que React Native sea
editable. Tres ejemplos de Play: la pieza base.apk del .apkm de Google Classroom 3.68.991701869
(Flutter), la pieza com.flipkart.android.apk del .xapk de Flipkart Online Shopping App 9.16
(React Native) y la pieza com.wordsmobile.RealBikeRacing.apk del .xapk de Real Bike Racing 2.0.0
(Unity).
Y un cuarto caso que no es una protección sino una consecuencia del modelo de distribución: una aplicación instalada desde Play suele ser un conjunto de splits, no un fichero (entre 7 y 9 de cada 10, «sección 8 · Instalar y probar»). Modificar un conjunto exige una de dos cosas: parchear el split correcto y reinstalar el conjunto entero refirmado con la misma clave (la receta está al final de la «sección 8 · Instalar y probar»), o fusionarlos antes. La fusión tiene sus propios modos de fallo, en «Fusión de splits».
10.1 Cuántas apps caen en cada caso
Las tres familias de arriba no pesan igual en todos los orígenes. La tabla se lee por filas, y las filas se solapan (una app puede llevar PairIP y un marco a la vez), así que no se suman. «Packer o protector» es la heurística de nombres del caso 1; las cifras de APKiD están allí.
| Caso | F-Droid | IzzyOnDroid | Google Play, más instaladas | Google Play, sorteo | Mercado chino |
|---|---|---|---|---|---|
| Packer o protector (nombres) | 0 de 4.766 | 0 de 1.402 | 12 de 658 (2 %) | 1 de 369 | 38 de 100 (38 %) |
| PairIP con protección | 0 de 4.766 | 0 de 1.402 | 33 de 658 (5 %) | 2 de 369 | 0 de 100 |
| Play Integrity en el código | 0 de 4.766 | 1 de 1.402 | 253 de 658 (38 %) | 74 de 369 (20 %) | 2 de 100 |
Marco con la lógica fuera del DEX |
814 de 4.766 (17 %) | 222 de 1.402 (16 %) | 236 de 658 (36 %) | 222 de 369 (60 %) | 67 de 100 (67 %) |
En F-Droid no hay ni una app con protector ni con PairIP. En el mercado chino, en cambio, se juntan protectores y marcos, y las dos cifras se solapan. No hay cifra de «apps no modificables», porque la modificación no la probamos aquí: la tabla dice qué lleva cada app, no si el reempaquetado funciona.
Fuentes
Todas las URL se consultaron el 12 de agosto de 2026.
- zipalign — https://developer.android.com/tools/zipalign · la regla de alinear antes de
firmar («§7.1 · El orden, y dónde está demostrado»), las opciones
-c,-fy-P 16(«§7.4 · La receta completa, ejecutada») y el hecho de que las entradas comprimidas se marcan(OK - compressed)(«§6.3 · Lo que hay que preservar a mano, y por qué»). - apksigner — https://developer.android.com/tools/apksigner · la sintaxis de
signyverifyde «§7.4 · La receta completa, ejecutada», las opciones--ks-pass,--min-sdk-versiony--vN-signing-enabled, y la advertencia de que cualquier cambio posterior a la firma la invalida. Consultada de nuevo el 18 de octubre de 2026: sin--min-sdk-version,apksignerusa elminSdkVersiondel manifiesto («§7.4 · La receta completa, ejecutada»). - Behavior changes: Apps targeting Android 11 —
https://developer.android.com/about/versions/11/behavior-changes-11 · la obligación de que
resources.arscvaya sin comprimir y alineado a 4 bytes desdetargetSdk30 («§6.3 · Lo que hay que preservar a mano, y por qué»). <application>— https://developer.android.com/guide/topics/manifest/application-element · el significado deandroid:extractNativeLibsy su efecto sobre la compresión de las.so(«§6.3 · Lo que hay que preservar a mano, y por qué»).- adb — https://developer.android.com/tools/adb · la sintaxis de
install,install -r,install-multipleyuninstallde «§8 · Instalar y probar»;install-multiplese ejecutó el 13 de agosto y las otras tres el 25 de septiembre de 2026 («sección 8 · Instalar y probar»). - Apktool — CLI Parameters — https://apktool.org/docs/cli-parameters/ · las opciones
-r/--no-resy-s/--no-srcde «§4.2 · Las dos vías, y por qué no dan lo mismo»,--debuggabley--net-sec-confde «§4.1 · Qué se puede cambiar» y--copy-originalde «§6.2 · El inventario de lo que se pierde», no ejecutadas. Consultada de nuevo el 18 de octubre de 2026. - Apktool — FAQ — https://apktool.org/docs/faq/ · la declaración de que apktool construye
APKsin firmar («§2 · El pipeline canónico») y de que--copy-originalsolo sirve para el esquema v1 («§6.2 · El inventario de lo que se pierde»). Consultada de nuevo el 18 de octubre de 2026. - APKEditor — README — https://raw.githubusercontent.com/REAndroid/APKEditor/master/README.md
· los modos de decodificación
xml,json,rawysigy la independencia deaapt2de «§4.2 · Las dos vías, y por qué no dan lo mismo», no ejecutados. - Ejecuciones locales sobre el muestrario — 31 de octubre de 2026 con
build-tools37.0.0 (zipalign,apksigner0.9,aapt22.20-15087165), OpenJDK 21.0.10 (keytool) y Python 3.12 sobre macOS. De aquí salen las salidas pegadas de «§4.3», «§6.1» y «§7.4», ejecutadas sobre copias deorg.fossify.math_10.apk, y las de «§4.3 · Lo que sí está ejecutado: el manifiesto sin reconstruir» también sobre copias deio.github.jeffin_v.apiflow_5.apkycom.particlesdevs.photoncamera_17884.apk. Las salidas delresources.arsccomprimido y del byte cambiado que resumen «§6.3» y «§7.2» siguen siendo las del 12 de agosto de 2026, con el fichero que entonces se llamabaorg.fossify.calculator_1.4.0.apky que es el mismo (mismo SHA-256 y mismo tamaño). En ningún momento hemos escrito en el muestrario. PackageManagerShellCommand.java, 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 · Leído el 25 de septiembre de 2026 enandroid-16.0.0_r1y consultado enandroid-17.0.0_r1el 18 de octubre de 2026. De:3583-3593y:3784-3785sale quepm installarranca conreplaceExisting = true, ignora-r(case "-r": // ignore,:3590) y solo deja de reemplazar con-R(«sección 8 · Instalar y probar»).- Apktool — código fuente, commit
fd9d5d4del 17 de octubre de 2026 (ramamain, 3.x) — https://github.com/iBotPeaches/Apktool/blob/fd9d5d4/brut.apktool/apktool-cli/src/main/java/brut/apktool/Main.java y, bajobrut.apktool/apktool-lib/src/main/java/brut/androlib/,ApkBuilder.java,ApkDecoder.java,res/xml/ResXmlUtils.javayres/AaptInvoker.java. Consultado el 18 de octubre de 2026. DeMain.java:169-187y:573-589salen las opciones debde «§4.1 · Qué se puede cambiar» y que--debuggabley--net-sec-confse ignoran junto a--copy-original; deApkBuilder.java:182-220, que con el manifiesto binario no se aplican; deResXmlUtils.java:126-226yApkBuilder.java:277-283, elnetwork_security_config.xmlque escribe--net-sec-confy su aviso; deApkDecoder.java:51-52, qué guardaoriginal/(«§6.2 · El inventario de lo que se pierde»); y deAaptInvoker.java:144-146, que 3.x solo pasa aaapt2--rename-resources-package. Del tagv2.9.3,apk/PackageInfo.java:21yAaptInvoker.java:153-158dan elrenameManifestPackagede 2.x («sección 4.1 · Qué se puede cambiar»). - aapt2 — https://developer.android.com/tools/aapt2 · Consultado el 18 de octubre de 2026. La
opción
--rename-manifest-packagedelink; ytools/aapt2/link/ManifestFixer.cpp:737-777deframeworks/baseen la etiquetaandroid-17.0.0_r1, que solo cambiapackagey completa los nombres de clase («sección 4.1 · Qué se puede cambiar»). - AOSP, etiqueta
android-17.0.0_r1— bajo https://android.googlesource.com/platform/frameworks/base/+/refs/tags/android-17.0.0_r1/services/core/java/com/android/server/pm/ · Consultado el 18 de octubre de 2026. Deresolution/ComponentResolver.java:779-806,INSTALL_FAILED_CONFLICTING_PROVIDER, queInstallPackageHelper.java:5074-5080solo comprueba en una instalación nueva; deInstallPackageHelper.java:1974-1992,INSTALL_FAILED_DUPLICATE_PERMISSION(«sección 4.1 · Qué se puede cambiar»); y dePackageManagerServiceUtils.java:920-946conInstallPackageHelper.java:3113-3116, cuándo se permite-d(«sección 8 · Instalar y probar»). - ART, etiqueta
android-17.0.0_r1— https://android.googlesource.com/platform/art/+/refs/tags/android-17.0.0_r1/libprofile/profile/profile_compilation_info.cc y https://android.googlesource.com/platform/art/+/refs/tags/android-17.0.0_r1/dex2oat/dex2oat.cc. Consultado el 18 de octubre de 2026. Deprofile_compilation_info.cc:1006-1008sale que el perfil guarda por cadaDEXsu checksum y su número de tipos y de métodos; de:1337-1356,:1479-1499y:2138-2152, que con el checksum distinto elDEXno encuentra sus datos y la verificación registraDex checksum mismatch while verifying profile; y dedex2oat.cc:3225-3236, que esa verificación no aborta la compilación («sección 6.2 · El inventario de lo que se pierde»). apksigyPackageInstallerSession.java, etiquetaandroid-17.0.0_r1— https://android.googlesource.com/platform/tools/apksig/+/refs/tags/android-17.0.0_r1/src/main/java/com/android/apksig/ApkSigner.java y https://android.googlesource.com/platform/frameworks/base/+/refs/tags/android-17.0.0_r1/services/core/java/com/android/server/pm/PackageInstallerSession.java. Consultado el 18 de octubre de 2026. DeApkSigner.java:385-394y:531-553sale queapksigner signdescartastamp-cert-sha256y solo la reescribe con un firmante de source stamp («sección 6.2 · El inventario de lo que se pierde»); dePackageInstallerSession.java:5154-5180, que la sesión exige a cada split el paquete, elversionCodey las firmas del primero («sección 8 · Instalar y probar»).- Ejecuciones locales sobre
APKsintéticos — 18 de octubre de 2026,build-tools37.0.0 (aapt22.20-15087165,zipalign,apksigner0.9) y Python 3.12.10. UnAPKfirmado con--stamp-signerllevastamp-cert-sha256con el digest del certificado del sello yVerified for SourceStamp: true; refirmado con otra clave sin--stamp-signer, la entrada desaparece yverifydaVerified for SourceStamp: false; reempaquetado conzipfiley pasado porzipalign, la conserva. Y tres splits generados conaapt2 link --split—base,config.esyconfig.xhdpi—, alineados y refirmados con la receta de la «sección 8 · Instalar y probar», dan un solocertificate SHA-256 digest. - El muestrario — descargado entre el 19 y el 27 de octubre de 2026 y descrito en «El muestrario».