Pipeline de modificación

Antes conviene leer «Pipeline de análisis» · «Anatomía de un APK»

referencia técnica · Actualizado el 15 de noviembre de 2026

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 layout en 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 APK de release está firmado y publicado, y el repositorio se perdió con el proveedor. El APK es 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

0 · ANALIZAR primero pipeline de análisis, pasos 0 a 4¿packer? ¿integridad en ejecución? ¿lógica en nativo? →parar1 · DESEMPAQUETAR apktool d · APKEditor decode ·unziprecursos a XML de texto y DEX a smali, o en crudo2 · EDITAR recursos ──▶ «§4 · Editar recursos» · código smali ──▶ «§5 · Editar código en smali»3 · REEMPAQUETAR apktool b (invoca aapt2) · APKEditorbuildsale SIN firma y SIN alinear. El ZIP ya no es el de entrada(«§6 · Reempaquetar: qué se pierde»)4 · ALINEAR zipalign -P 16 -f 4 entrada.apk salida.apk5 · FIRMAR apksigner sign --ks … ← SIEMPRE el último6 · VERIFICAR apksigner verify --verbose · zipalign -c7 · INSTALAR adb install · adb install-multiple

El diagrama tiene tres reglas, y las tres se incumplen constantemente:

  1. El paso 0 no es opcional. Si modificas una aplicación con packer, sale un APK que 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 solo classes.dex pequeñ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.
  2. zipalign va antes de apksigner, y nada toca el fichero después. El porqué es estructural y está en la «sección 7 · Alinear y firmar».
  3. Ninguna de las herramientas de desempaquetado cierra el ciclo. apktool no firma por diseño; APKEditor tampoco; aapt2 menos. 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 los DEX): 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 apktool 3.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

baksmali / apktool d[editar]smali / apktool bclasses*.dexsmali/**/*.smaliclasses*.dexZIPalinearfirmar

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 smali que aparece aquí procede de la «sección 5 de Desensambladores smali · La misma clase en smali, comentada», que sí está ejecutada con baksmali 3.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:

  1. 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.
  2. 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.
  3. Se rompe sharedUserId con otras aplicaciones del mismo autor, por lo mismo.
  4. 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.
  5. 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-multiple con 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 un APK de prueba. install responde Success aunque la aplicación ya esté instalada, e install -r también; con la versión instalada firmada por otra clave, los dos fallan con INSTALL_FAILED_UPDATE_INCOMPATIBLE: Existing package … signatures do not match newer version; ignoring!. uninstall responde Success. 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:

  • install reemplaza siempre; -r se acepta y se ignora (PackageManagerShellCommand.java:3590); -R lo desactiva; y reemplazar exige la misma firma que la de la versión instalada. Un APK refirmado 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, versionCode mayor), el instalador responde INSTALL_FAILED_VERSION_DOWNGRADE. adb install -r -d lo permite solo si la compilación del sistema es depurable o si la versión instalada es debuggable (PackageManagerServiceUtils.isDowngradePermitted()); en el emulador userdebug, Success («Diagnóstico de fallos → §2.5 · Lo que responde adb install, reproducido»). La alternativa es subir el versionCode en el versionInfo de apktool.yml antes de reconstruir.
  • install-multiple es la vía para splits sin fusionarlos: todos deben compartir packageName, versionCode y 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 de adb install. El instalador devuelve un código INSTALL_* seco. La causa concreta (qué entrada, qué certificado, qué split falta) la escribe PackageManager en 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.

  1. 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, -f y -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é»).
  2. apksigner — https://developer.android.com/tools/apksigner · la sintaxis de sign y verify de «§7.4 · La receta completa, ejecutada», las opciones --ks-pass, --min-sdk-version y --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, apksigner usa el minSdkVersion del manifiesto («§7.4 · La receta completa, ejecutada»).
  3. Behavior changes: Apps targeting Android 11 — https://developer.android.com/about/versions/11/behavior-changes-11 · la obligación de que resources.arsc vaya sin comprimir y alineado a 4 bytes desde targetSdk 30 («§6.3 · Lo que hay que preservar a mano, y por qué»).
  4. <application> — https://developer.android.com/guide/topics/manifest/application-element · el significado de android:extractNativeLibs y su efecto sobre la compresión de las .so («§6.3 · Lo que hay que preservar a mano, y por qué»).
  5. adb — https://developer.android.com/tools/adb · la sintaxis de install, install -r, install-multiple y uninstall de «§8 · Instalar y probar»; install-multiple se ejecutó el 13 de agosto y las otras tres el 25 de septiembre de 2026 («sección 8 · Instalar y probar»).
  6. Apktool — CLI Parameters — https://apktool.org/docs/cli-parameters/ · las opciones -r/--no-res y -s/--no-src de «§4.2 · Las dos vías, y por qué no dan lo mismo», --debuggable y --net-sec-conf de «§4.1 · Qué se puede cambiar» y --copy-original de «§6.2 · El inventario de lo que se pierde», no ejecutadas. Consultada de nuevo el 18 de octubre de 2026.
  7. Apktool — FAQ — https://apktool.org/docs/faq/ · la declaración de que apktool construye APK sin firmar («§2 · El pipeline canónico») y de que --copy-original solo sirve para el esquema v1 («§6.2 · El inventario de lo que se pierde»). Consultada de nuevo el 18 de octubre de 2026.
  8. APKEditor — README — https://raw.githubusercontent.com/REAndroid/APKEditor/master/README.md · los modos de decodificación xml, json, raw y sig y la independencia de aapt2 de «§4.2 · Las dos vías, y por qué no dan lo mismo», no ejecutados.
  9. Ejecuciones locales sobre el muestrario — 31 de octubre de 2026 con build-tools 37.0.0 (zipalign, apksigner 0.9, aapt2 2.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 de org.fossify.math_10.apk, y las de «§4.3 · Lo que sí está ejecutado: el manifiesto sin reconstruir» también sobre copias de io.github.jeffin_v.apiflow_5.apk y com.particlesdevs.photoncamera_17884.apk. Las salidas del resources.arsc comprimido 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 llamaba org.fossify.calculator_1.4.0.apk y que es el mismo (mismo SHA-256 y mismo tamaño). En ningún momento hemos escrito en el muestrario.
  10. PackageManagerShellCommand.java, etiqueta android-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 en android-16.0.0_r1 y consultado en android-17.0.0_r1 el 18 de octubre de 2026. De :3583-3593 y :3784-3785 sale que pm install arranca con replaceExisting = true, ignora -r (case "-r": // ignore, :3590) y solo deja de reemplazar con -R («sección 8 · Instalar y probar»).
  11. Apktool — código fuente, commit fd9d5d4 del 17 de octubre de 2026 (rama main, 3.x) — https://github.com/iBotPeaches/Apktool/blob/fd9d5d4/brut.apktool/apktool-cli/src/main/java/brut/apktool/Main.java y, bajo brut.apktool/apktool-lib/src/main/java/brut/androlib/, ApkBuilder.java, ApkDecoder.java, res/xml/ResXmlUtils.java y res/AaptInvoker.java. Consultado el 18 de octubre de 2026. De Main.java:169-187 y :573-589 salen las opciones de b de «§4.1 · Qué se puede cambiar» y que --debuggable y --net-sec-conf se ignoran junto a --copy-original; de ApkBuilder.java:182-220, que con el manifiesto binario no se aplican; de ResXmlUtils.java:126-226 y ApkBuilder.java:277-283, el network_security_config.xml que escribe --net-sec-conf y su aviso; de ApkDecoder.java:51-52, qué guarda original/ («§6.2 · El inventario de lo que se pierde»); y de AaptInvoker.java:144-146, que 3.x solo pasa a aapt2 --rename-resources-package. Del tag v2.9.3, apk/PackageInfo.java:21 y AaptInvoker.java:153-158 dan el renameManifestPackage de 2.x («sección 4.1 · Qué se puede cambiar»).
  12. aapt2 — https://developer.android.com/tools/aapt2 · Consultado el 18 de octubre de 2026. La opción --rename-manifest-package de link; y tools/aapt2/link/ManifestFixer.cpp:737-777 de frameworks/base en la etiqueta android-17.0.0_r1, que solo cambia package y completa los nombres de clase («sección 4.1 · Qué se puede cambiar»).
  13. 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. De resolution/ComponentResolver.java:779-806, INSTALL_FAILED_CONFLICTING_PROVIDER, que InstallPackageHelper.java:5074-5080 solo comprueba en una instalación nueva; de InstallPackageHelper.java:1974-1992, INSTALL_FAILED_DUPLICATE_PERMISSION («sección 4.1 · Qué se puede cambiar»); y de PackageManagerServiceUtils.java:920-946 con InstallPackageHelper.java:3113-3116, cuándo se permite -d («sección 8 · Instalar y probar»).
  14. 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. De profile_compilation_info.cc:1006-1008 sale que el perfil guarda por cada DEX su checksum y su número de tipos y de métodos; de :1337-1356, :1479-1499 y :2138-2152, que con el checksum distinto el DEX no encuentra sus datos y la verificación registra Dex checksum mismatch while verifying profile; y de dex2oat.cc:3225-3236, que esa verificación no aborta la compilación («sección 6.2 · El inventario de lo que se pierde»).
  15. apksig y PackageInstallerSession.java, etiqueta android-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. De ApkSigner.java:385-394 y :531-553 sale que apksigner sign descarta stamp-cert-sha256 y solo la reescribe con un firmante de source stamp («sección 6.2 · El inventario de lo que se pierde»); de PackageInstallerSession.java:5154-5180, que la sesión exige a cada split el paquete, el versionCode y las firmas del primero («sección 8 · Instalar y probar»).
  16. Ejecuciones locales sobre APK sintéticos — 18 de octubre de 2026, build-tools 37.0.0 (aapt2 2.20-15087165, zipalign, apksigner 0.9) y Python 3.12.10. Un APK firmado con --stamp-signer lleva stamp-cert-sha256 con el digest del certificado del sello y Verified for SourceStamp: true; refirmado con otra clave sin --stamp-signer, la entrada desaparece y verify da Verified for SourceStamp: false; reempaquetado con zipfile y pasado por zipalign, la conserva. Y tres splits generados con aapt2 link --split —base, config.es y config.xhdpi—, alineados y refirmados con la receta de la «sección 8 · Instalar y probar», dan un solo certificate SHA-256 digest.
  17. El muestrario — descargado entre el 19 y el 27 de octubre de 2026 y descrito en «El muestrario».