Diagnóstico de fallos

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

Es un índice de síntomas. Entra por el mensaje literal que tengas delante, no por el concepto: cuando algo falla, lo único que tienes es una cadena de texto y ninguna pista de a qué capa pertenece.

Cada entrada tiene la misma forma: síntoma literal, qué significa, causa raíz, qué comprobar y cómo se arregla. Y sigue una convención de honestidad. (reproducido) marca lo que provocamos en la máquina de referencia, con la cadena copiada de la salida real. (fuente) marca lo copiado del código que lo emite (AOSP, jadx o apktool), con el fichero identificado pero sin reproducir aquí. Lo que no hemos verificado está, con el motivo, en el recuadro «Lo que no hemos podido comprobar» del final de esta sección.

Dos avisos generales. Los mensajes de error mienten sobre la causa con frecuencia: el caso de manual está en «§4.2 · La trampa mayor: zipalign después de firmar (reproducido)», donde un zipalign ejecutado un paso tarde produce Signature stripped?, que suena a ataque y es un error de orden. Y el error real casi nunca está en la salida de la orden que falló. En instalación está en logcat; en apktool, en el log de aapt2 y no en la excepción; en jadx, en el .java generado y no en la consola.

El reparto con «Qué rechaza cada lector»: aquí se va del síntoma al diagnóstico, con el código que lo produce; allí, de la condición a la reacción de cada lector de la plataforma, con su línea en AOSP. Las entradas de este catálogo remiten a la sección de allí que les corresponde.

Casi todas las reproducciones con herramientas usan el mismo APK, la calculadora de Fossify 1.4.0 de F-Droid (paquete org.fossify.math, versionCode 10, minSdk 26, targetSdk 36, firmado solo con v2). Las copias manipuladas se firman con una clave local de prueba, así que sus tamaños y sus digests dependen de esa clave; lo que se repite es la forma del mensaje.

1.1 Índice de cadenas literales

La primera columna es un fragmento que puedes buscar tal cual en la salida que tengas delante; la segunda, dónde se trata.

Cadena Sección
INSTALL_PARSE_FAILED_NOT_APK · Failed to load asset path «§2.2», «§2.5»
INSTALL_PARSE_FAILED_BAD_MANIFEST · INSTALL_PARSE_FAILED_MANIFEST_EMPTY «§2.2 · Fallos de análisis del paquete»
No packages found in split · Inconsistent package · Inconsistent version · Missing base APK in <dir> «§2.2 · Fallos de análisis del paquete»
INSTALL_PARSE_FAILED_UNEXPECTED_EXCEPTION · Corrupt XML binary file «§2.2», «§8.3»
INSTALL_PARSE_FAILED_NO_CERTIFICATES · Attempt to get length of null array · No signature found in package of version «§2.3», «§2.5»
Failed to collect certificates from … using APK Signature Scheme v3 (o v2, v4) «§2.3», «§3.2»
INSTALL_PARSE_FAILED_INCONSISTENT_CERTIFICATES · has mismatched certificates «§2.3 · Los cinco que hay que conocer al detalle»
INSTALL_PARSE_FAILED_BAD_PACKAGE_NAME · bad character · must have at least one '.' separator · is not a valid Android package name «§2.3 · Los cinco que hay que conocer al detalle»
INSTALL_PARSE_FAILED_MANIFEST_MALFORMED · does not contain an <application> or <instrumentation> «§2.3», «§2.5»
-124 · Targeting R+ (version 30 and above) requires the resources.arsc «§2.3», «§2.5»
INSTALL_FAILED_INVALID_APK: Full install must include a base package «§2.3», «§2.5»
signatures are inconsistent · inconsistent with · was defined multiple times «§2.3», «§2.5»
Failed to extract native libraries, res=-2 «§2.5», «§7»
Library '…' is compressed - will not be able to open it directly from apk «§2.5 · Lo que responde adb install, reproducido»
is not PAGE(16384)-aligned · 16kB AppCompat: · falling back to extraction from apk «§2.5 · Lo que responde adb install, reproducido»
Failed to extract native libraries, res=-113 · INSTALL_FAILED_NO_MATCHING_ABIS «§2.4», «§2.5»
INSTALL_FAILED_UPDATE_INCOMPATIBLE · signatures do not match newer version; ignoring! · New package has a different signature «§2.4», «§2.5»
INSTALL_FAILED_SHARED_USER_INCOMPATIBLE · has no signatures that match those in shared user «§2.4 · Fallos de instalación»
INSTALL_FAILED_MISSING_SHARED_LIBRARY · requires unavailable shared library «§2.4 · Fallos de instalación»
INSTALL_FAILED_CONFLICTING_PROVIDER · Can't install because provider name «§2.4 · Fallos de instalación»
INSTALL_FAILED_DUPLICATE_PERMISSION · attempting to redeclare permission «§2.4 · Fallos de instalación»
INSTALL_FAILED_VERIFICATION_FAILURE · Install not allowed for · Additional verifiers required, but none installed. «§2.4 · Fallos de instalación»
INSTALL_FAILED_USER_RESTRICTED · User restriction prevents installing «§2.4 · Fallos de instalación»
INSTALL_FAILED_VERSION_DOWNGRADE · Downgrade detected «§2.4», «§2.5»
INSTALL_FAILED_MISSING_SPLIT · Missing split for «§2.4», «§2.5»
INSTALL_FAILED_OLDER_SDK · Requires newer sdk version «§2.4», «§2.5»
INSTALL_FAILED_DEPRECATED_SDK_VERSION · App package must target at least SDK version «§2.4», «§2.5»
INSTALL_FAILED_TEST_ONLY · Did you forget to add -t? «§2.4», «§2.5»
INSTALL_FAILED_MULTI_ARCH_NOT_SUPPORTED, que no existe «§2.4 · Fallos de instalación»
Zip: Found duplicate entry · Duplicate entries in archive «§2.5 · Lo que responde adb install, reproducido»
Zip: failed to read at offset 0 · Failed to open APK '…': I/O error · Failed to read data: End of file. «§2.5 · Lo que responde adb install, reproducido»
DOES NOT VERIFY «§3.1 · DOES NOT VERIFY — el prefijo común»
The APK contains a v3.2 signature block, but an error was encountered with one of the hybrid signers «§3.1 · DOES NOT VERIFY — el prefijo común»
Missing META-INF/MANIFEST.MF «§3.1», «§3.2», «§4.2»
but no such signature was found. Signature stripped? «§3.1», «§4.2»
CHUNKED_SHA256 digest mismatch «§3.1», «§3.2»
requires a minimum of signature scheme v2 «§3.1», «§3.3»
not protected by signature «§3.3 · Target SDK version 36 requires a minimum of signature scheme v2 (reproducido)»
Verified using v1 scheme (JAR signing): false «§3.4 · Verified using v1 scheme: false con el MANIFEST.MF dentro (reproducido)»
keystore password was incorrect · does not contain a key «§3.5 · Fallos al firmar (reproducidos)»
Malformed APK: not a ZIP archive · ApkFormatException: Missing AndroidManifest.xml «§3.5», «§8.1», «§8.5»
(BAD - n) · Verification FAILED · (OK - compressed) «§4.1 · (BAD - n) de zipalign -c (reproducido)»
empty/missing DT_HASH/DT_GNU_HASH · Fatal signal 4 (SIGILL) · cannot be smaller than system page size «§4.3 · zipalign -c pasa y el APK sigue siendo incompatible con 16 KB»
Could not find framework resources for package ID 1. · Can't find framework resources for package of id: 1 «§5.1», «§5.2»
Could not decode arsc file «§5.1», «§5.2»
Invalid resource config detected. Dropping resources: · Invalid config flags detected. «§5.1», «§5.2»
was not found or was not readable · already exists. Use -f option · Could not decode XML. · Could not find nine patch chunk. «§5.2 · Las excepciones de brut.androlib (3.x)»
entry: pkgId=0x · overlayable: pkgId=0x «§5.2 · Las excepciones de brut.androlib (3.x)»
Exception in thread "main" java.lang.NullPointerException: Cannot invoke "String.isEmpty()" (de apktool d) «§5.2 · Las excepciones de brut.androlib (3.x)»
Execution failed (exit code = 1) · is private · Multiple resources «§5.3 · Fallos de reconstrucción por aapt2»
error: must not undeclare prefix. · error: failed to read PNG signature · error: attribute android:… not found. (líneas de aapt2 dentro de apktool b) «§5.3 · Fallos de reconstrucción por aapt2»
Legacy aapt is no longer supported. «§5.3 · Fallos de reconstrucción por aapt2»
(prevents rebuild) «§5.4 · Lo que apktool no hace, y hay que saber»
// decompilation failed · // JADX WARNING: inconsistent code, que no existen · Class decompilation failed «§6.1 · Corrección previa: dos cadenas que circulan y no existen»
JADX ERROR: · JADX WARN: · JADX INFO: · JADX DEBUG: «§6.2 · Los marcadores reales, con su fichero»
Code decompiled incorrectly, please refer to instructions dump. «§6.2», «§6.3»
Method not decompiled: · Method dump skipped · Can't load method instructions · Blocks not ready for simple mode «§6.2 · Los marcadores reales, con su fichero»
Load error · Code generation failed «§6.2», «§6.4»
OutOfMemoryError «§6.5 · Salida vacía, cuelgues y OutOfMemoryError»
Load failed! No classes for decompile! · finished with errors, count: · Incorrect arguments · Process error: «§6.6 · Los códigos de salida, que sí sirven para automatizar»
NoClassDefFoundError · UnsatisfiedLinkError · locales: '--_--' «§7 · Fusión de splits»
failed opening zip: Invalid file. · could not identify format of APK. «§8.1», «§8.5»
corrupt resources.arsc: chunk's data extends past the end of the document «§8.2 · resources.arsc que no parsea (reproducido)»
Bad XML block: · failed to initialize ResXMLTree. «§8.3 · AXML malformado (reproducido)»
Bad checksum ( · Expected valid zip or dex file «§8.4 · DEX con checksum inválido (reproducido)»
java.lang.VerifyError · Verifier rejected class «§9.5 · java.lang.VerifyError tras editar smali (fuente)»
[BT:1.18.3] Error: Unable to determine the location of ADB. «Fusión de splits → §9 · La alternativa: no fusionar»

1.2 Índice de síntomas sin mensaje

Cuando no hay cadena que buscar, se entra por lo que ves:

Síntoma Sección
Instala, arranca y se cierra sin traza «§9.1 · La aplicación instala, arranca y se cierra»
Faltan textos traducidos, o los iconos salen borrosos «§7 · Fusión de splits»
Muere en System.loadLibrary «§7», «§4.3»
java.lang.VerifyError al usar la clase parcheada «§9.5 · java.lang.VerifyError tras editar smali (fuente)»
Funciona en el emulador y no en el dispositivo, o al revés «§9.2 · Funciona en emulador y no en dispositivo, o al revés»
Funciona la primera vez y luego no «§9.4 · Funciona la primera vez y luego no»
Un conjunto de splits sacado de un móvil falla o sale en inglés en otro móvil «§7 · Fusión de splits»
apksigner o aapt2 no abren un .apkm o un .xapk «§8.1», «§8.5»

Cuando el aviso es de pantalla y no trae código. Quien instala tocando el fichero ve un aviso («App no instalada», un problema al analizar el paquete, un bloqueo de Play Protect) y ningún INSTALL_*. Para llevar ese aviso al código: conecta el móvil por adb, vacía el registro con adb logcat -c, repite la instalación y vuelca adb logcat -d -s PackageManager PackageInstallerSession («§2.1 · De dónde salen y cómo se leen»). No hemos verificado qué aviso corresponde a qué familia de códigos (INSTALL_PARSE_FAILED_* frente a INSTALL_FAILED_*).

1.3 Antes de empezar

adb (Android Debug Bridge) es el programa del ordenador que habla con un móvil o con un emulador. Para usarlo con un móvil hay que activar la depuración USB en las opciones de desarrollador y conectarlo por cable; un emulador se conecta solo. logcat es el registro del sistema: donde Android escribe el motivo de cada fallo. Se lee con los tres comandos de la «sección 2.1 · De dónde salen y cómo se leen». Los términos split, ABI, esquema de firma y alineación se explican en el «glosario».

Las causas más comunes de que un APK no instale son cinco. La última columna dice cuánto se ve cada una en el muestrario (el detalle está en la sección que se cita):

Lo que pasa Código típico Qué hacer En el muestrario
El APK no está firmado o la firma no vale INSTALL_PARSE_FAILED_NO_CERTIFICATES Firmar con apksigner («§3 · Firma») Ninguna de las 15.183 piezas va sin firma («§3.2 · Bloque desaparecido frente a contenido modificado (reproducido)»)
Hay otra copia instalada con otra firma INSTALL_FAILED_UPDATE_INCOMPATIBLE adb uninstall (borra los datos) 150 de 218 paquetes que están en F-Droid y en IzzyOnDroid con ficheros distintos (69 %; «§2.4 · Fallos de instalación»)
Falta un split de los que la app exige INSTALL_FAILED_MISSING_SPLIT adb install-multiple con el conjunto completo 447 de 454 bases de conjuntos de Google Play declaran requiredSplitTypes («§2.4 · Fallos de instalación»)
Ninguna ABI del dispositivo en lib/ INSTALL_FAILED_NO_MATCHING_ABIS Añadir el split de ABI del dispositivo 278 de 365 carpetas de adb traen el split de arm64_v8a y 87 no traen ninguno («§2.4 · Fallos de instalación»)
targetSdk por debajo del mínimo instalable INSTALL_FAILED_DEPRECATED_SDK_VERSION Subirlo, o --bypass-low-target-sdk-block 10 apps de F-Droid de 4.766 con targetSdk menor de 24 («§2.4 · Fallos de instalación»)
Alineación a 16 KB Falla zipalign -c -P 16 4 zipalign -P 16 -f 4, antes de firmar 75 piezas de F-Droid de 4.766 («§4.1 · (BAD - n) de zipalign -c (reproducido)»)

2. Instalación: los códigos INSTALL_*

2.1 De dónde salen y cómo se leen

Cuando adb install falla, devuelve un nombre en mayúsculas. Si empieza por INSTALL_PARSE_FAILED_, Android no pudo leer el fichero: el fallo está dentro del APK y lo produce el analizador (parser) del paquete. Si empieza por INSTALL_FAILED_, lo leyó bien pero no lo acepta, por lo que ya hay instalado, por el dispositivo o por una política. El motivo concreto casi nunca está en esa línea: está en logcat, que se explica abajo.

Los códigos están enumerados en frameworks/base/core/java/android/content/pm/PackageManager.java de AOSP (el código abierto de Android). Todos los valores son negativos, todos los símbolos están marcados @hide (no son API pública) y adb install los devuelve como texto, sin el número. INSTALL_PARSE_FAILED_* ocupa −100 a −109, más −124 y −125; INSTALL_FAILED_*, −1 a −29 y −110 en adelante.

Ojo: nueve códigos salen como número y no como texto, porque PackageManager.installStatusToString() no tiene un case para ellos: −26, −27, −119, −120, −124, −125, −126, −127 y −129. El que más sorprende es -124, el de resources.arsc comprimido o desalineado («§2.3 · Los cinco que hay que conocer al detalle»). El instalador devuelve un código seco; el mensaje que dice qué entrada, qué certificado o qué split falla lo escribe PackageManager en el log del sistema. Las condiciones de cada lector del instalador, con su línea en AOSP, están en la «sección 5 de Qué rechaza cada lector · El instalador».

Para verlo, vacía el registro antes de instalar y vuélcalo después, filtrado por las etiquetas del servicio de paquetes, de la sesión de instalación y de la extracción de bibliotecas nativas (PackageManagerService.java:348, PackageInstallerSession.java:265 y com_android_internal_content_NativeLibraryHelper.cpp:17):

adb logcat -c
adb install app.apk
adb logcat -d -s PackageManager PackageInstallerSession NativeLibraryHelper

-d vuelca y sale, y -s silencia todas las etiquetas menos las que se nombran, que salen con todos sus niveles (logcat.cpp:382-385 y :434-459). El motivo de una sesión fallida queda en una línea de PackageInstallerSession, Marking session … as failed: o Session […] was destroyed because of […] (:6515 y :6634).

Reproducidos: los mensajes de la «sección 2.5 · Lo que responde adb install, reproducido» son la salida literal de adb install en un emulador Android 14 arm64-v8a, con APK de prueba construidos con aapt2 y firmados con apksigner, el 25 de septiembre de 2026. INSTALL_FAILED_NO_MATCHING_ABIS lo vimos además el 13 de agosto con los splits de Google Keep de la descarga anterior, que ya no están en el muestrario («Formatos y extensiones», secciones «3.1» y «6.2»). Los valores, las descripciones y las condiciones internas proceden del código de AOSP en la etiqueta android-17.0.0_r1, leído directamente (?format=TEXT, decodificado) el 25 de septiembre de 2026.

2.2 Fallos de análisis del paquete

Código Valor Qué significa Dónde se lanza y con qué condición
..._NOT_APK −100 La ruta no es un fichero o no acaba en .apk ApkLiteParseUtils: directorio sin paquetes (No packages found in split), o ApkAssets.loadFromFd lanza IOException
..._BAD_MANIFEST −101 No se pudo recuperar el manifiesto ApkLiteParseUtils: splits que discrepan del primero (Inconsistent package…, Inconsistent version…), nombre de split repetido, o Missing base APK in <dir>
..._UNEXPECTED_EXCEPTION −102 Excepción inesperada parseApkLiteInner(): catch general de XmlPullParserException | IOException | RuntimeException. Cajón de sastre: no dice nada por sí mismo, el motivo está en logcat
..._NO_CERTIFICATES −103 Sin certificados utilizables «§2.3 · Los cinco que hay que conocer al detalle»
..._INCONSISTENT_CERTIFICATES −104 Certificados incoherentes «§2.3 · Los cinco que hay que conocer al detalle»
..._CERTIFICATE_ENCODING −105 CertificateEncodingException en algún fichero ApkSignatureVerifier
..._BAD_PACKAGE_NAME −106 Nombre de paquete inválido o ausente en el manifiesto «§2.3 · Los cinco que hay que conocer al detalle»
..._BAD_SHARED_USER_ID −107 sharedUserId inválido ParsingPackageUtils (nombre inválido, o sharedUserId en una biblioteca SDK o estática; comprobado en android-17.0.0_r1)
..._MANIFEST_MALFORMED −108 Problema estructural en el manifiesto «§2.3 · Los cinco que hay que conocer al detalle»
..._MANIFEST_EMPTY −109 Ni <application> ni <instrumentation> El instalador ya no lo lanza. Solo lo emite PackageParser, el analizador antiguo, marcado @Deprecated. ParsingPackageUtils trata el mismo caso como error diferido (MISSING_APP_TAG) y lo devuelve como ..._MANIFEST_MALFORMED con targetSdk 30 o superior; con 29 o menos, el APK instala («§2.5 · Lo que responde adb install, reproducido»)
..._RESOURCES_ARSC_COMPRESSED −124 resources.arsc comprimido o desalineado «§2.3 · Los cinco que hay que conocer al detalle»

La mayoría de las condiciones de la última columna tienen su fila, con la línea de AOSP, en la «sección 5 de Qué rechaza cada lector · El instalador»; las de firma, en su «sección 4 · El verificador de firmas».

En la práctica no verás un manifiesto sin <application> ni <instrumentation>: ningún APK publicado del muestrario lo tiene. El caso de MANIFEST_MALFORMED con targetSdk 30 o más, y el de Success con 29 o menos, solo se pueden construir; la fila correspondiente de la «sección 2.5 · Lo que responde adb install, reproducido» sigue siendo una reproducción con un APK de prueba.

2.3 Los cinco que hay que conocer al detalle

Cada uno tiene su fila en la «sección 5 de Qué rechaza cada lector · El instalador», y los dos de firma, en su «sección 4 · El verificador de firmas».

INSTALL_PARSE_FAILED_NO_CERTIFICATES. El paquete no tiene firma utilizable, o no la que el rango de API exige. Lo produce ApkSignatureVerifier.java en varios sitios con mensajes distintos: cuando el esquema mínimo requerido es más nuevo que cualquiera de los presentes —"No signature found in package of version … or newer for package …"—, cuando se captura SignatureNotFoundException y no se puede caer a un esquema anterior —"No APK Signature Scheme v4/v3/v2 signature in package …"— y, en el camino de v1, "Package … has no certificates at entry AndroidManifest.xml". Y hay un cuarto mensaje, el de un bloque de firma que está y no verifica: "Failed to collect certificates from " + apkPath + " using APK Signature Scheme v3" —o v2, o v4, según el esquema que se intentó, empezando por el más alto que lleve el APK— (ApkSignatureVerifier.java:341-343, :385-387 y :414-416) (fuente).

En la práctica hay cuatro orígenes:

Comprobar: apksigner verify --verbose --min-sdk-version <el minSdk real> app.apk, y el inventario físico de META-INF/. Arreglo: firmar en el orden correcto —alinear y después apksigner sign con v2 y v3 («Pipeline de modificación → §7.4 · La receta completa, ejecutada»).

INSTALL_PARSE_FAILED_INCONSISTENT_CERTIFICATES. Dentro del paquete —o del conjunto de splits— no todo está firmado por lo mismo. Dos sitios: ApkSignatureVerifier.java en la verificación completa de v1, cuando una entrada del ZIP tiene firmas distintas de las del manifiesto ("Package … has mismatched certificates at entry …"); y ParsingPackageUtils.getSigningDetails() / FrameworkParsingPackageUtils, cuando !Signature.areExactMatch(...) entre un split y el base ("<baseCodePath> has mismatched certificates").

Pero si instalas splits refirmados por separado o mezclados de dos descargas, no se suele llegar aquí. Con adb install-multiple o cualquier instalador que use una sesión de PackageInstaller, la sesión compara antes cada split con el primero y falla con INSTALL_FAILED_INVALID_APK: … signatures are inconsistent (PackageInstallerSession.assertApkConsistentLocked). Lo mismo si discrepan el paquete o el versionCode: … version code N inconsistent with M. Comprobar: un bucle de apksigner verify --print-certs sobre todos los splits tiene que devolver un solo certificate SHA-256 digest («Pipeline de análisis → §5.4 · Firma y splits»). Arreglo: refirmar todos con la misma clave, cada uno alineado antes.

INSTALL_PARSE_FAILED_BAD_PACKAGE_NAME. Lo produce FrameworkParsingPackageUtils.validateName(), cuyas reglas están implementadas ahí literalmente y no en ninguna especificación. Recorre carácter a carácter con dos banderas, front y hasSep: [a-zA-Z] siempre vale y pone front = false; [0-9] y _ valen solo si front == false, o sea que un segmento no puede empezar por dígito ni por subrayado; . pone hasSep = true y front = true; y cualquier otro carácter da "bad character '<c>'". Con requireFilename añade "Invalid filename" y "the length of the name is greater than 223"; y al final, con requireSeparator y sin ningún punto, "must have at least one '.' separator". El paquete se valida con requireSeparator=true, requireFilename=true; los nombres de split con false, false; los tipos con false, true. Aparece casi siempre tras un --rename-manifest-package con un guion, un segmento que empieza por dígito (com.ejemplo.2app) o ningún punto. aapt2 no deja construirlo: error: attribute 'package' in <manifest> tag is not a valid Android package name: 'com.ejemplo.2app'., así que el error solo llega al instalador desde herramientas que reescriben el manifiesto por su cuenta.

INSTALL_PARSE_FAILED_MANIFEST_MALFORMED. Varios sitios de ApkLiteParseUtils.java, con mensajes muy informativos si llegas a verlos en logcat: "No start tag found", "No <manifest> tag", "Invalid manifest split types: ", un <uses-split> sin android:name, o un <uses-sdk-library> / <uses-static-library> mal formado o duplicado —aapt2, de nuevo, no deja enlazar un <uses-split> sin nombre—. Con targetSdk 30 o superior también lo da un manifiesto sin <application> ni <instrumentation>, que es el caso que el código antiguo llamaba MANIFEST_EMPTY. Los atributos de split que quedan en el manifiesto de un APK fusionado no dan este error («Fusión de splits → §5 · Saneado del manifiesto»): un split= sobrante hace que el instalador tome el APK por un split y responda INSTALL_FAILED_INVALID_APK: Full install must include a base package, y un isSplitRequired="true" sobrante da INSTALL_FAILED_MISSING_SPLIT («§2.4 · Fallos de instalación»). Sobre un APK fusionado el aapt2 dump xmltree … | grep -E "split=|splitTypes|isSplitRequired|isFeatureSplit|configForSplit" no debe devolver nada. Si el manifiesto ni siquiera se puede leer, el error está un nivel más abajo y aapt2 lo dice con precisión: «§8.3 · AXML malformado (reproducido)».

INSTALL_PARSE_FAILED_RESOURCES_ARSC_COMPRESSED (−124), con la trampa reproducida. Con targetSdk 30 o más (Android 11), resources.arsc, la tabla con todos los recursos, tiene que ir sin comprimir y empezar en una posición (offset) múltiplo de 4 bytes. Así el sistema puede leerla directamente del disco, sin copiarla a memoria (mmap). Si no es así, la instalación falla con −124. Con targetSdk 29 o menos, el mismo APK instala.

El mecanismo, en AOSP: ParsingPackageUtils.parseBaseApk(), tras un análisis correcto del manifiesto, comprueba assets.containsAllocatedTable() —la tabla tuvo que reservarse en RAM en vez de mapearse— y emite un error diferido con el identificador de cambio de comportamiento RESOURCES_ARSC_COMPRESSED = 132742131, anotado @EnabledAfter(targetSdkVersion = Q): solo se activa para targetSdk 30 y superior. El texto en AOSP es "Targeting R+ (version 30 and above) requires the resources.arsc of installed APKs to be stored uncompressed and aligned on a 4-byte boundary", y es lo que se ve en el emulador con targetSdk 36, con el código como número: Failure [-124: Failed parse during installPackageLI: Targeting R+ …]. Con targetSdk 29, el mismo APK responde Success.

¿Cuánto se ve en APK reales? Casi nada: 9 piezas en todo el muestrario, con la tabla comprimida o desalineada, y casi todas con targetSdk menor de 30, así que no darían −124.

Solo una cae en el caso del −124: dudeofx.eval 102 de F-Droid (targetSdk 36). Su tabla va sin comprimir, pero empieza en el byte 26.913, que no es múltiplo de 4 (sobra 1). zipalign -c -v 4 sí la señala (26913 resources.arsc (BAD - 1), y sale con 1) y aapt2 dump badging responde con normalidad. No la hemos instalado, así que el −124 no está comprobado en ese APK. La tabla desalineada de com.chessclock.android 31 de F-Droid (sobran 3 bytes) no daría −124 porque su targetSdk es 27.

Y aquí está la trampa: las herramientas locales no detectan una tabla comprimida. Toma la calculadora de Fossify, reempaquétala con resources.arsc comprimido —por ejemplo con zipfile de Python y ZIP_DEFLATED solo en esa entrada— y alinéala con zipalign -P 16 -f 4. Con esa copia, aapt2 dump badging responde con normalidad (package: name='org.fossify.math' versionCode='10' …) y zipalign -c -v 4 marca 3356762 resources.arsc (OK - compressed) saliendo con 0. Si no se alinea, zipalign sale con 1 por las demás entradas, pero la línea de resources.arsc sigue diciendo OK - compressed (con el offset 3322768). En el original, sin comprimir, marca 3356076 resources.arsc (OK). Lo reprodujimos el 31 de octubre de 2026 con build-tools 37.0.0.

La comprobación hay que hacerla a mano, mirando el método de compresión y el offset de los datos:

import struct, zipfile
apk = "app.apk"
info = zipfile.ZipFile(apk).getinfo("resources.arsc")
with open(apk, "rb") as f:
    f.seek(info.header_offset)
    cabecera = f.read(30)
nombre, extra = struct.unpack("<HH", cabecera[26:30])
offset_datos = info.header_offset + 30 + nombre + extra
# compress_type: 0 = guardado sin comprimir (stored), 8 = comprimido (deflate)
print(info.compress_type == 0, offset_datos % 4 == 0)   # tienen que salir True y True

El arreglo es reempaquetar forzando stored en esa entrada y alinear después.

2.4 Fallos de instalación

La tabla no recoge los 46 códigos INSTALL_FAILED_* de PackageManager.java, sino los que aparecen al instalar lo que producen los procesos de este bloque —un APK reempaquetado, refirmado o fusionado, o un conjunto de splits— o al llevarlo a un dispositivo, un usuario o una política que no lo admiten, más los genéricos que pueden salir con cualquier APK (−4, −110, −115) y −11, que ya no se lanza pero se sigue buscando. Se quedan fuera, entre otros, los de sesiones staged o multipaquete (−119, −120), ubicación y medios de instalación (−19, −20) y tiempo de verificación (−21).

Código Valor Qué significa
INSTALL_FAILED_INVALID_APK −2 El archivo del paquete es inválido
INSTALL_FAILED_INSUFFICIENT_STORAGE −4 No hay espacio suficiente en el dispositivo
INSTALL_FAILED_UPDATE_INCOMPATIBLE −7 Ya hay un paquete con ese nombre y firma distinta, y sus datos no se borraron
INSTALL_FAILED_SHARED_USER_INCOMPATIBLE −8 Pide un sharedUserId que ya existe en el dispositivo con otra firma
INSTALL_FAILED_MISSING_SHARED_LIBRARY −9 Usa una biblioteca compartida que el dispositivo no tiene
INSTALL_FAILED_DEXOPT −11 Heredado. En android-17.0.0_r1 un dexopt que falla no aborta la instalación: DexOptHelper lo deja escrito, «Don't fail application installs if the dexopt step fails»
INSTALL_FAILED_OLDER_SDK −12 El minSdkVersion es mayor que la versión del dispositivo
INSTALL_FAILED_CONFLICTING_PROVIDER −13 Trae un <provider> con una authority que ya usa otro paquete instalado
INSTALL_FAILED_TEST_ONLY −15 El manifiesto lleva android:testOnly="true" y no se pasó -t
INSTALL_FAILED_CPU_ABI_INCOMPATIBLE −16 Trae código nativo y ninguna ABI es compatible
INSTALL_FAILED_VERIFICATION_FAILURE −22 La verificación del paquete no salió bien
INSTALL_FAILED_VERSION_DOWNGRADE −25 El versionCode es menor que el instalado
INSTALL_FAILED_MISSING_SPLIT −28 Requiere al menos un split y no se aportó
INSTALL_FAILED_DEPRECATED_SDK_VERSION −29 El targetSdkVersion está por debajo del mínimo instalable: 23 en Android 14 y 24 desde Android 15. -t lo levanta en una aplicación testOnly, y --bypass-low-target-sdk-block en cualquiera
INSTALL_FAILED_INTERNAL_ERROR −110 Fallo del sistema
INSTALL_FAILED_USER_RESTRICTED −111 El usuario tiene restringido instalar aplicaciones
INSTALL_FAILED_DUPLICATE_PERMISSION −112 Define un permiso que ya define otro paquete instalado
INSTALL_FAILED_NO_MATCHING_ABIS −113 El código nativo no coincide con ninguna ABI del sistema
INSTALL_FAILED_ABORTED −115 Sin Javadoc en AOSP: solo /** @hide */

¿Cuántas apps reales chocarían con los límites de targetSdk y minSdk? Muy pocas, siempre por debajo del 1 % o 2 % según la fuente. Las de targetSdk menor de 24, que Android 15 y posteriores no instalan, se concentran en IzzyOnDroid y F-Droid; en el mercado chino el mínimo es 27. Las de minSdk mayor de 34, que Android 14 no instala (INSTALL_FAILED_OLDER_SDK), son algo más frecuentes entre las más instaladas de Play.

Ejemplos: org.jsl.wfwt 17 de F-Droid (targetSdk 16) y com.netvor.settings.database.provider 2 de IzzyOnDroid (targetSdk 22) no instalan en Android 14 ni en 15. de.musivum.notenkladde 1 de F-Droid (minSdk 35, targetSdk 37) y app.ninesevennine.twofactorauthenticator 10023001 de IzzyOnDroid (minSdk 35) dan INSTALL_FAILED_OLDER_SDK en Android 14. Los 10 de Play con minSdk mayor de 34 son sobre todo aplicaciones de sistema de Samsung y de Google, sueltas o bases de APKMirror.

INSTALL_FAILED_MULTI_ARCH_NOT_SUPPORTED no existe. Circula en foros, pero no aparece en PackageManager.java de la etiqueta android-17.0.0_r1. La constante real más cercana es INSTALL_FAILED_MULTI_ARCH_NOT_MATCH_ALL_NATIVE_ABIS = -131, para aplicaciones con android:multiArch="true" cuyo código nativo no cubre todas las ABIs del sistema.

Las condiciones de la mayoría de estos códigos, con su línea en AOSP, están en la «sección 5 de Qué rechaza cada lector · El instalador»; los que siguen añaden el mensaje y lo que suele haber detrás.

INSTALL_FAILED_UPDATE_INCOMPATIBLE. Ya hay instalada una app con el mismo nombre de paquete y firmada con otra clave. Android no deja que una firma distinta herede los datos de la anterior. Arreglo: adb uninstall <paquete>, que borra los datos de la app. En la práctica aparece siempre que instalas un APK refirmado encima del original, lo cual es inevitable («Pipeline de modificación → §7.3 · La firma original no se puede conservar, y no es culpa de las herramientas»).

Cómo lo decide AOSP. InstallPackageHelper.preparePackage(), en el camino de reemplazo, cuando las credenciales de firma nuevas no tienen CertCapabilities.INSTALLED_DATA respecto a las instaladas y no es un rollback válido a un ancestro del linaje: "New package has a different signature: " + pkgName. Pero el mensaje que se ve casi siempre es otro: antes, el mismo preparePackage() hace una comprobación temprana con PackageManagerServiceUtils.verifySignatures(), que salta primero con "Existing package " + packageName + " signatures do not match newer version; ignoring!".

Casos raros. Hay otras dos rutas al mismo código —fallo de checkUpgradeKeySetLocked, y un cambio de SDK en una biblioteca sin subir su versionMajor— y una cuarta que AOSP reconoce como reutilización indebida: en scanInstallPackages() se devuelve el mismo código cuando la actualización cambia PROPERTY_NO_APP_DATA_STORAGE, con un TODO en el fuente admitiendo que no corresponde. Así que no siempre es de firma.

Un caso real sin refirmar nada. El mismo paquete puede tener dos firmas legítimas, y es lo habitual entre F-Droid e IzzyOnDroid: de los paquetes que están en los dos con ficheros distintos, siete de cada diez llevan certificados distintos. Por ejemplo, com.scalepractice está en F-Droid (versionCode 12, certificado abb668524acf1231…) y en IzzyOnDroid (versionCode 11, certificado 27d476a460e60ff1…). Instalar una copia encima de la otra daría este error; no lo hemos probado en un dispositivo. Con las webs de los autores frente a Google Play ocurre lo contrario: en los pocos paquetes que están en los dos sitios, el certificado es el mismo.

INSTALL_FAILED_VERSION_DOWNGRADE. La comprobación real es PackageManagerServiceUtils.checkDowngrade(), más fina de lo que sugiere el nombre: falla si el versionCode nuevo es menor, o si son iguales y el baseRevisionCode nuevo es menor, o si el splitRevisionCode de cualquier split coincidente es menor — salvo que isDowngradePermitted() lo autorice, lo que ocurre con adb install -d sobre una compilación depurable. Cuida de no haber tocado el versionCode al reempaquetar sin querer: apktool lo repuebla desde apktool.yml.

INSTALL_FAILED_MISSING_SPLIT. PackageInstallerSession.validateApkInstallLocked(), en dos sitios y los dos con el mensaje "Missing split for " + mPackageName: en instalación completa, cuando baseApk.isSplitRequired() y stagedSplits.size() <= 1 o !stagedSplitTypes.containsAll(requiredSplitTypes); y heredando, cuando se han quitado todos los splits o los tipos aportados no cubren los requeridos. Mira el mecanismo moderno: requiredSplitTypes en la base y splitTypes en los splits. Es el que verás: lo declaran casi todas las bases de conjuntos de Google Play del «muestrario». Un ejemplo es la base del .apkm de Google Keep 5.26.411.03.97, con requiredSplitTypes="base__abi,base__density".

El booleano antiguo isSplitRequired ya no aparece donde lo lee el instalador (en <manifest>). Sí lo llevan unas pocas piezas en <application>, donde no tiene efecto. Por ejemplo, la base de com.manddprojectconsultant.screencam, que sale de una carpeta de adb, es decir, de una app que estaba instalada en un teléfono. Todas las bases del sorteo con ese atributo en <application> vienen de carpetas de adb, un indicio (no una prueba) de que no impide instalar. Más sobre ambos mecanismos en «Fusión de splits → §5.2 · Hay dos mecanismos, y el muestrario solo tiene el moderno». Arreglo: adb install-multiple con el conjunto completo, o fusionar y sanear el manifiesto.

INSTALL_FAILED_NO_MATCHING_ABIS y INSTALL_FAILED_CPU_ABI_INCOMPATIBLE. Casi siempre al fusionar splits cogiendo de menos. Es fácil que pase, porque la base casi nunca lleva .so: el código nativo viaja en los splits de ABI. Y una carpeta sacada con adb pull solo trae el split de ABI del teléfono de origen, que en nueve de cada diez casos es arm64-v8a. Una fusión hecha a partir de una carpeta así solo instala en dispositivos de 64 bits ARM. Una carpeta típica es air.conectagames.tute: base, arm64_v8a, en y xxhdpi.

Es el único de los tres ejes que produce un fallo duro —densidad e idioma degradan en silencio («Fusión de splits → §3.1 · El problema»)—, y se comprueba comparando las ABIs bajo lib/ con adb shell getprop ro.product.cpu.abilist. El texto que acompaña a NO_MATCHING_ABIS es el mismo que el de unas .so comprimidas, y lo que los distingue es el res=: «§2.5 · Lo que responde adb install, reproducido».

INSTALL_FAILED_DEPRECATED_SDK_VERSION. El mínimo es PackageManagerService.MIN_INSTALLABLE_TARGET_SDK, que vale 23 (Build.VERSION_CODES.M) en android-14.0.0_r1 y desde android-15.0.0_r1 es Flags.minTargetSdk24() ? Build.VERSION_CODES.N : Build.VERSION_CODES.M (PackageManagerService.java:576-577 en android-17.0.0_r1). Que el flag está activo lo dice la página de cambios de Android 15: «apps with a targetSdkVersion lower than 24 can't be installed». En el emulador Android 14 el mensaje dice 23 («§2.5 · Lo que responde adb install, reproducido»).

INSTALL_FAILED_CONFLICTING_PROVIDER (−13) (fuente). ComponentResolver.assertProvidersNotDefined(): "Can't install because provider name " + names[j] + " (in package " + pkg.getPackageName() + ") is already used by " + otherPackageName. Solo se comprueba en una instalación nueva, no al actualizar el mismo paquete. Para quien reempaqueta es el síntoma de un cambio de nombre de paquete: las android:authorities de los <provider> siguen siendo las de la original, que está instalada («Pipeline de modificación → §4.1 · Qué se puede cambiar»). Arreglo: cambiar también cada authority —y el código que la construya—, o desinstalar la original.

INSTALL_FAILED_DUPLICATE_PERMISSION (−112) (fuente). InstallPackageHelper.preparePackage(), cuando el paquete declara un <permission> que ya es de otro paquete y las firmas no casan: "Package " + … + " attempting to redeclare permission " + … + " already owned by " + sourcePackageName. Si el dueño es android, solo avisa en el log. El caso típico es el mismo: un APK renombrado que conserva los <permission> de la original con su nombre completo. Arreglo: renombrar esos permisos, o desinstalar la aplicación que los define.

¿Cuánto se ve al renombrar? Mucho: casi cualquier APK desencadenaría estos dos errores, porque casi todos declaran algún <provider> o <permission> propio (el 99 % de las más instaladas de Play). AndroidX, además, añade por su cuenta el permiso <paquete>.DYNAMIC_RECEIVER_NOT_EXPORTED_PERMISSION y el proveedor androidx.startup, con la authority <paquete>.androidx-startup. Si solo cambias el nombre del paquete en el manifiesto, esos nombres conservan el original y chocan con la app original si sigue instalada. Es una deducción del mecanismo: el medidor cuenta si hay un <provider> o un <permission> y busca por nombre los de AndroidX, pero no guarda las authorities ni los nombres.

INSTALL_FAILED_SHARED_USER_INCOMPATIBLE (−8) (fuente). PackageManagerServiceUtils.verifySignatures(), cuando el paquete pide un android:sharedUserId que ya existe y ninguna de sus firmas casa con la de ese usuario compartido —"Package " + packageName + " has no signatures that match those in shared user " + … + "; ignoring!"— o cuando su linaje de firma diverge del suyo. Para quien reempaqueta: refirmar una aplicación que comparte sharedUserId con otras del mismo autor la deja fuera de ese usuario («Pipeline de modificación → §7.3 · La firma original no se puede conservar, y no es culpa de las herramientas»). No hay arreglo mientras esté instalada otra aplicación de ese sharedUserId firmada con la clave original.

INSTALL_FAILED_MISSING_SHARED_LIBRARY (−9) (fuente). El manifiesto declara un <uses-library> que el dispositivo no tiene, con android:required="true", que es el valor por defecto (ParsingPackageUtils.java:2870-2877); al resolver las bibliotecas, SharedLibrariesImpl lanza "Package " + packageName + " requires unavailable shared library " + libName + "; failing!" (SharedLibrariesImpl.java:942-946 y :1029-1045). Lo mismo pasa con un <uses-static-library> ausente y, con targetSdk 31 o superior, con un <uses-native-library> obligatorio, que en el mensaje dicen static y native shared en lugar de shared (:947-953 y :959-966). Con android:required="false" la ausencia no impide instalar (:954-958 y :1046-1057).

En el muestrario:

  • INSTALL_FAILED_SHARED_USER_INCOMPATIBLE afecta a pocos APK, pero a esos casi seguro. sharedUserId es raro: como mucho un 4 % de las apps, según la fuente. Por ejemplo, la base de Word 16.0.20611.20014 y com.termux.boot 1000 de F-Droid.

  • INSTALL_FAILED_MISSING_SHARED_LIBRARY depende del atributo required, y el medidor no lo guarda: no podemos decir cuántas apps pedirían una biblioteca obligatoria que falte. Sí sabemos que declarar alguna <uses-library> es muy común: desde la mitad de las apps de F-Droid hasta casi todas las de Play y del mercado chino. <uses-native-library>, la que obliga a targetSdk 31 o más, es bastante menos frecuente.

  • testOnly="true" no aparece en ninguna app. INSTALL_FAILED_TEST_ONLY solo se encuentra con APK de desarrollo.

INSTALL_FAILED_VERIFICATION_FAILURE (−22) (fuente). No sale del análisis del paquete sino de su verificación: el verificador del sistema rechaza la instalación y VerificationUtils.processVerificationResponse() devuelve el código con "Install not allowed for " + originUri, o el paquete declara verificadores propios y no hay ninguno instalado (Additional verifiers required, but none installed.). En android-17.0.0_r1 lo da también la verificación del desarrollador (PackageInstallerSession.setSessionFailedDueToDeveloperVerification()). Con el flag verificationServiceAdb desactivado, adb install queda exento salvo que se fuerce; con él activo, las instalaciones por adb también pasan por el verificador, marcadas con FLAG_VERIFICATION_IS_ADB. En la configuración de lanzamiento de AOSP para esa etiqueta, cp2a, el flag está activado y es de solo lectura. El código solo dice que el rechazo del verificador llega con este código, no qué verificador hay detrás en un dispositivo con Google Play.

INSTALL_FAILED_USER_RESTRICTED (−111) (fuente). No es un fallo del APK. En AOSP solo lo devuelve InstallPackageHelper.installExistingPackageAsUser() —pm install-existing— cuando el usuario tiene DISALLOW_INSTALL_APPS; con la misma restricción, una sesión de instalación normal ni se crea: PackageInstallerService.createSessionInternal() lanza SecurityException("User restriction prevents installing").

2.5 Lo que responde adb install, reproducido

Ejecutado el 25 de septiembre de 2026 en un emulador Android 14 arm64-v8a (sdk_phone64_arm64, compilación userdebug), con APK de prueba construidos con aapt2 2.20-15087165 y firmados con apksigner 0.9. adb install escribe adb: failed to install <apk>: Failure [<código>: <mensaje>], e install-multiple, adb: failed to finalize session y debajo Failure […]; la tabla da lo que va entre corchetes. vmdl….tmp es el directorio temporal de la sesión, distinto en cada intento.

Caso Lo que devuelve
Sin firmar INSTALL_PARSE_FAILED_NO_CERTIFICATES: Failed to collect certificates from /data/app/vmdl….tmp/base.apk: Attempt to get length of null array
Solo v1, con targetSdk 36 INSTALL_PARSE_FAILED_NO_CERTIFICATES: Scanning Failed.: No signature found in package of version 2 or newer for package com.ejemplo.prueba
resources.arsc comprimido, targetSdk 36 -124: Failed parse during installPackageLI: Targeting R+ (version 30 and above) requires the resources.arsc of installed APKs to be stored uncompressed and aligned on a 4-byte boundary
El mismo, con targetSdk 29 Success
Sin <application>, targetSdk 30 INSTALL_PARSE_FAILED_MANIFEST_MALFORMED: Failed parse during installPackageLI: /data/app/vmdl….tmp/base.apk (at Binary XML file line #1): <manifest> does not contain an <application> or <instrumentation>
El mismo, con targetSdk 29 Success
minSdkVersion 35 en Android 14 INSTALL_FAILED_OLDER_SDK: Requires newer sdk version #35 (current version is #34)
targetSdkVersion 21 INSTALL_FAILED_DEPRECATED_SDK_VERSION: App package must target at least SDK version 23, but found 21. Con --bypass-low-target-sdk-block, Success
android:testOnly="true" sin -t INSTALL_FAILED_TEST_ONLY: Failed to install test-only apk. Did you forget to add -t?. Con -t, Success, también con targetSdk 21
La misma aplicación firmada con otra clave INSTALL_FAILED_UPDATE_INCOMPATIBLE: Existing package com.ejemplo.prueba signatures do not match newer version; ignoring!
Un versionCode menor que el instalado INSTALL_FAILED_VERSION_DOWNGRADE: Downgrade detected: Update version code 2 is older than current 3. Con -r -d, en esta compilación userdebug, Success
split="config.es" en un APK completo INSTALL_FAILED_INVALID_APK: Full install must include a base package
android:isSplitRequired="true" en <manifest>, sin splits INSTALL_FAILED_MISSING_SPLIT: Missing split for com.ejemplo.prueba. En <application> no hace nada: se instala
install-multiple con el split firmado por otra clave INSTALL_FAILED_INVALID_APK: /data/app/vmdl….tmp/split-es-vc2-b.apk signatures are inconsistent
install-multiple con un split de otra versión INSTALL_FAILED_INVALID_APK: /data/app/vmdl….tmp/split-es-vc3-a.apk version code 3 inconsistent with 2
install-multiple con el mismo split dos veces INSTALL_FAILED_INVALID_APK: Split config.es was defined multiple times
install-multiple con un split y sin el base INSTALL_FAILED_INVALID_APK: Full install must include a base package
install-multiple con un config.<abi> que no es la ABI del dispositivo (visto el 13 de agosto con los splits de Google Keep de la descarga anterior) INSTALL_FAILED_NO_MATCHING_ABIS: INSTALL_FAILED_NO_MATCHING_ABIS: Failed to extract native libraries, res=-113
Dos entradas AndroidManifest.xml en el ZIP INSTALL_PARSE_FAILED_NOT_APK: Failed to parse /data/app/vmdl….tmp/base.apk: Failed to load asset path /data/app/vmdl….tmp/base.apk
install --incremental con el .idsig de otro APK INSTALL_PARSE_FAILED_NOT_APK: Failed to parse …: Failed to load asset path …
install --incremental con el .idsig truncado Falla en el ordenador, antes de llegar al dispositivo: Failed to read data: End of file.

Cuatro cosas que no se deducen del código leído en frío:

  • El APK sin firmar no dice que le falte la firma. Attempt to get length of null array es el texto de una excepción interna, no un mensaje pensado para nadie.
  • Las dos entradas duplicadas no llegan a la firma. Las rechaza libziparchive al abrir el fichero, y lo que queda en logcat es Zip: Found duplicate entry AndroidManifest.xml y Failed to open APK '…': Duplicate entries in archive.
  • Con el .idsig de otro APK, tampoco. En una instalación incremental el sistema de ficheros comprueba cada bloque contra el árbol de Merkle del .idsig, y el primer bloque ya falla: Zip: failed to read at offset 0 y Failed to open APK '…': I/O error. La verificación v4 que describe el código, y que acabaría en NO_CERTIFICATES, no llega a ejecutarse. Sin --incremental, el .idsig se ignora y el APK se instala por v2 o v3.
  • adb install sin -r también reemplaza. Instalar dos veces el mismo APK responde Success las dos veces.

Los splits de Keep de aquel 13 de agosto ya no están en el muestrario. El .apkm de Keep de octubre trae la base, 24 idiomas, la densidad xhdpi y un solo split de ABI, split_config.armeabi_v7a.apk; la base declara requiredSplitTypes="base__abi,base__density". En un emulador sin ABI de 32 bits debería dar el mismo error, pero no lo hemos vuelto a instalar.

Si no tienes un .apkm, prueba con una carpeta de adb con split_config.arm64_v8a.apk (como la de air.conectagames.tute) en un emulador x86_64 sin traducción de código. Debería producir el mismo res=-113; tampoco lo hemos probado.

Failed to extract native libraries no dice qué falló: lo dice el res=. PackageInstallerSession.extractNativeLibraries() falla con el código que le devuelve NativeLibraryHelper y lo repite en el texto: "Failed to extract native libraries, res=" + res.

  • Con res=-113 es INSTALL_FAILED_NO_MATCHING_ABIS: no hay en lib/ ninguna ABI del dispositivo, casi siempre porque falta el split de ABI («sección 6.2 de Formatos y extensiones · Extraer el base»).
  • Con res=-2 es INSTALL_FAILED_INVALID_APK, y lo que pasó lo dice logcat con la etiqueta NativeLibraryHelper («§2.1 · De dónde salen y cómo se leen»). Con extractNativeLibs="false", o hay una .so comprimida (Library '…' is compressed - will not be able to open it directly from apk, un rechazo incondicional) o una stored cuyo offset no es múltiplo de la página (… is not PAGE(16384)-aligned …, con 4096 en un dispositivo de 4 KB).

En un dispositivo de 16 KB con Android 16 o posterior, una .so alineada a 4 KiB no da -2: el instalador la extrae y deja 16kB AppCompat: Library '…' is not PAGE(16384)-aligned - falling back to extraction from apk, salvo con android:pageSizeCompat="disabled" en el manifiesto o la propiedad pm.16kb.app_compat.disabled en el sistema (com_android_internal_content_NativeLibraryHelper.cpp:308-342 y :546-556) (fuente). Los de alineación, reproducidos en emuladores de 16 KB de Android 15 y 16, están en la «sección 6.4 de Código nativo y ELF · Qué pasa en el dispositivo». El mismo texto de adb install, dos causas sin relación. Ninguna app del muestrario combina extractNativeLibs="false" con una .so comprimida ni con una sin comprimir fuera de múltiplo de 4.096 («§4.3 · zipalign -c pasa y el APK sigue siendo incompatible con 16 KB»): como era de esperar, porque no instalaría.

Los casos de la tabla, ordenados por lector y con la línea de AOSP de cada mensaje, están en la «sección 5 de Qué rechaza cada lector · El instalador».

3. Firma

3.1 DOES NOT VERIFY — el prefijo común

apksigner verify responde siempre con esa línea, sale con código 1, y el motivo va en las líneas ERROR: siguientes. Los que se ven de verdad:

Línea ERROR: Causa
Missing META-INF/MANIFEST.MF No hay firma ninguna, se destruyó el APK Signing Block y no había v1, o es un split de Google Play sin minSdk firmado solo con v2 o v3: apksigner no sabe qué esquema exigir y cae al camino de v1 (con --min-sdk-version 24 verifica) · «§3.2 · Bloque desaparecido frente a contenido modificado (reproducido)»
JAR signature META-INF/X.SF indicates the APK is signed using APK Signature Scheme v2 but no such signature was found. Signature stripped? Había v1 y v2/v3, y el bloque desapareció · «§4.2 · La trampa mayor: zipalign después de firmar (reproducido)»
APK integrity check failed. CHUNKED_SHA256 digest mismatch. El contenido cambió después de firmar · «§3.2 · Bloque desaparecido frente a contenido modificado (reproducido)»
Target SDK version 36 requires a minimum of signature scheme v2; the APK is not signed with this or a later signature scheme Se firmó solo con v1 · «§3.3 · Target SDK version 36 requires a minimum of signature scheme v2 (reproducido)»
The APK contains a v3.2 signature block, but an error was encountered with one of the hybrid signers Firma híbrida con ML-DSA que la Java 21 de apksigner no puede leer. No es un defecto del APK: con Java 25 verifican los 34 que fallaban
Verified using vN scheme: false sin DOES NOT VERIFY No es un error: es la trampa del rango de SDK · «§3.4 · Verified using v1 scheme: false con el MANIFEST.MF dentro (reproducido)»

En el muestrario ningún APK falla apksigner verify por causas propias. Las pocas piezas que no verifican (entre el 1 % y el 3 % en Play, ninguna fuera) se deben a lo que le preguntamos a apksigner, no a una firma rota. Medido con apksigner de build-tools 37.0.0 y Java 21.0.10, sin --min-sdk-version, hay dos casos:

  • Splits sin minSdk y sin v1, que dan Missing META-INF/MANIFEST.MF. Son de seis apps (com.mi.globalbrowser y cinco de Microsoft Office) y todos verifican con el --min-sdk-version de su base. Un ejemplo: el split_lenssampledoc.apk de Office Hub 16.0.20611.20024.
  • Bloques v3.2 («hybrid signers») que la Java de apksigner no puede leer porque no trae ML-DSA; con Java 25.0.5 verifican. Un ejemplo: split_config.xxhdpi.apk de com.astropeak.congklak.

3.2 Bloque desaparecido frente a contenido modificado (reproducido)

Es la distinción que más tiempo ahorra, y las dos familias se confunden constantemente.

ERROR: Missing META-INF/MANIFEST.MF significa que el verificador no encontró ningún bloque de firma y cayó al camino de v1, donde lo primero que busca es MANIFEST.MF. Hay dos formas de llegar ahí. La primera: el APK nunca se firmó. apktool y APKEditor producen APK sin firma por diseño, y bundletool build-apks sin --ks también, si no hay ~/.android/debug.keystore. La segunda: se firmó y después otra herramienta reescribió el fichero y borró la firma; por ejemplo, se ejecutó zipalign después de firmar un APK que solo tenía v2/v3 («§4.2 · La trampa mayor: zipalign después de firmar (reproducido)»). Hay una tercera causa que no es un defecto del APK: un split sin minSdk («§3.1 · DOES NOT VERIFY — el prefijo común»).

En el muestrario no hay ningún APK sin firmar. Para verlo hay que quitar la firma a una copia o reconstruir con apktool b. Lo que sí se reproduce es el segundo caso: firmamos una copia de la calculadora de Fossify solo con v2 y v3, con una clave local de prueba, y la pasamos por zipalign -f -P 16 4. apksigner verify da ERROR: Missing META-INF/MANIFEST.MF y zipalign sale con 0. El muestrario no trae ningún .aab ni .apks, así que lo que decimos de bundletool es (fuente).

Si unzip -l app.apk | grep -E 'META-INF/(MANIFEST\.MF|[^/]*\.(SF|RSA|DSA|EC))$' no devuelve nada, lo que separa los dos casos es la copia de antes de alinear. Si esa lleva el APK Signing Block (el magic APK Sig Block 42 justo delante del Central Directory, que el volcador de la «sección 9 de APK Signing Block · El volcador» localiza) y la alineada no, es el segundo caso, y hay que firmar el de antes de alinear.

No te guíes por el tamaño. Si las .so ya estaban alineadas a 16 KiB (apksigner lo hace por defecto, ApkSigner.java:1418-1419 y Constants.java:47 de apksig), el APK sale más pequeño, porque pierde el bloque y el relleno que lo alineaba a 4 KiB; si no lo estaban, el relleno de zipalign -P 16 puede hacerlo crecer. Sobre un APK sintético con tres .so, 5.188 bytes menos en el primer caso —4.096 de bloque y 1.092 de relleno— y 27.580 más en el segundo.

En la práctica, las .so sin comprimir de casi todos los APK actuales ya están en múltiplos de 16.384 (entre el 85 % y el 96 % según la fuente). La excepción es el mercado chino, donde es raro.

Ojo: tener entradas en META-INF/ no quiere decir tener firma v1, y pasa a menudo. En la calculadora de Fossify, unzip -l muestra 104 entradas en META-INF/ (85 .version de AndroidX, entre otras) y ninguna de firma v1, así que grep META-INF no sirve para detectar la firma.

CHUNKED_SHA256 digest mismatch significa lo contrario: el bloque sigue ahí y es legible, y lo que no cuadra es el digest. Firmamos una copia de la calculadora de Fossify con v2 y v3 y una clave local de prueba (7.049.393 bytes) y cambiamos un solo byte de resources.arsc (el desplazamiento 1.000 dentro de la tabla, el byte 3.358.284 del fichero), sin mover ningún offset: el fichero mide exactamente lo mismo antes y después (reproducido el 31 de octubre de 2026):

DOES NOT VERIFY
ERROR: APK Signature Scheme v3 signer #1: APK integrity check failed. CHUNKED_SHA256 digest mismatch. Expected: <09eb7d31…0606eebc>, actual: <726e289a…060b59a6>

Los digests cambian con la clave y con el fichero: lo que debe verse es la forma del mensaje.

Al instalar, el mismo caso no pasa del análisis del paquete, que verifica la firma entera salvo para los APK del sistema: INSTALL_PARSE_FAILED_NO_CERTIFICATES con Failed to collect certificates from … using APK Signature Scheme v3 («§2.3 · Los cinco que hay que conocer al detalle») (fuente).

La regla: digest mismatch es contenido modificado —«alguien tocó el fichero»—; Signature stripped? y Missing META-INF/MANIFEST.MF son bloque desaparecido —casi siempre, «se ejecutó una herramienta en el orden equivocado»—. El arreglo, en los dos casos, es volver a firmar («§3.5 · Fallos al firmar (reproducidos)»).

3.3 Target SDK version 36 requires a minimum of signature scheme v2 (reproducido)

Firmando una copia de la calculadora de Fossify con una clave local de prueba, con --v1-signing-enabled true y las demás a false:

DOES NOT VERIFY
ERROR: Target SDK version 36 requires a minimum of signature scheme v2; the APK is not signed with this or a later signature scheme
WARNING: META-INF/com/android/build/gradle/app-metadata.properties not protected by signature. …
WARNING: META-INF/version-control-info.textproto not protected by signature. …

Firmar solo con v1 es no firmar si la app apunta a targetSdk 30 o más: la firma es criptográficamente correcta y el APK no se instala, porque Android exige un esquema mínimo según el targetSdkVersion. Con un targetSdk menor, Android admite v1. Hay apps firmadas solo con v1 (sobre todo en F-Droid, un 8 %), pero ninguna del muestrario apunta a 30 o más. Un ejemplo es com.tencent.tmgp.yongyong.mrzh 744 del mercado chino: firma solo v1 y targetSdk 28, así que no cae en este error. De las trece herramientas de manipulación de APK que compara la «sección 4 de Comparativa y selección · Las trece herramientas de manipulación de APK», cuatro firman solo con v1, y sus APK parecen correctos hasta el último paso.

Fíjate también en los WARNING: la firma JAR no cubre las entradas de META-INF/, así que cualquiera puede modificarlas sin invalidarla. Es la debilidad que motivó v2. En esta copia son 104 líneas WARNING: … not protected by signature, una por cada entrada de META-INF/, entre ellas META-INF/com/android/build/gradle/app-metadata.properties y META-INF/version-control-info.textproto.

Arreglo: --v2-signing-enabled true --v3-signing-enabled true; v1 solo si minSdkVersion < 24. Esa regla se cumple en el muestrario: ninguna app con minSdk menor de 24 carece de v1. Lo contrario es común: muchas llevan v1 sin necesitarla, más de la mitad de las de F-Droid con minSdk 24 o más.

3.4 Verified using v1 scheme: false con el MANIFEST.MF dentro (reproducido)

No hay fallo. apksigner verify no responde «¿está presente este esquema?» sino «¿se usó este esquema para verificar en el rango de API que me has dado?». El mismo APK, la calculadora de Fossify firmada con v1+v2+v3 y una clave local de prueba (PROC), con dos rangos distintos, da Verified using v1 scheme (JAR signing): false con --min-sdk-version 24 y true con 21 — y META-INF/PROC.SF, META-INF/PROC.RSA y META-INF/MANIFEST.MF están dentro en los dos casos. Para saber qué esquemas hay, mira el ZIP y el APK Signing Block; para saber si instalará, ejecuta verify con el minSdkVersion real de la aplicación.

3.5 Fallos al firmar (reproducidos)

Síntoma Causa Arreglo
Failed to load signer "signer #1" + java.io.IOException: keystore password was incorrect Contraseña del keystore incorrecta Revisar --ks-pass; preferir env: o file: sobre pass:
Failed to load signer "signer #1": x.p12 entry "ALIAS" does not contain a key El alias no existe keytool -list -v -keystore x.p12
com.android.apksig.apk.ApkFormatException: Malformed APK: not a ZIP archive No es un ZIP «§8.1 · El fichero no es lo que dice ser (reproducido)»
com.android.apksig.apk.ApkFormatException: Missing AndroidManifest.xml Es un ZIP pero no un APK Se cogió el contenedor en vez del APK de dentro

Y la imposibilidad de fondo: la firma original nunca se puede conservar tras modificar el contenido. No es una limitación de las herramientas, es la propiedad que hace útil a la firma («Pipeline de modificación → §7.3 · La firma original no se puede conservar, y no es culpa de las herramientas»).

3.6 Canales de las tiendas chinas

Muchas apps del mercado chino, casi la mitad, llevan escrito dentro del propio APK por qué tienda llegaron. Casi siempre va en el APK Signing Block, con Walle (0x71777777), el par channelId (0x71717874) o VasDolly (0x881155ff); un mismo APK puede llevar dos pares. Muy de vez en cuando va en META-INF/ o en el comentario del ZIP. Ejemplos: cn.ninegame.gamemanager 80506001 (canal Walle), com.tencent.tgclub 2026081227 (par 0x71717874 con channelId=…) y com.suning.mobile.ebuy 596 (canal en META-INF/config_channel.txt), los tres de la tienda 360.

Como zipalign («§4.2 · La trampa mayor: zipalign después de firmar (reproducido)») reescribe el ZIP y no reproduce el bloque, y un refirmado lo regenera sin esos pares, alinear o refirmar después de firmar borra el canal. Esto último es una deducción del mecanismo: no lo hemos comprobado con un APK del mercado chino concreto. Lo que no vemos en el muestrario es qué pasa al instalar esas apps fuera de China.

En el resto, el mercado chino firma casi siempre con v1+v2 o v1+v2+v3. Y el miedo habitual al targetSdk bajo no se confirma: el mínimo es 27 y la mediana, 30.

4. Alineación

4.1 (BAD - n) de zipalign -c (reproducido)

Algunas entradas del APK se guardan sin comprimir para que Android las lea directamente. Para eso tienen que empezar en una posición (offset) múltiplo de 4 bytes o, en el caso de las .so, de 16.384 (16 KiB). zipalign -c comprueba esas posiciones. Si alguna falla, termina con Verification FAILED y marca cada entrada mala. Esta es la salida real de zipalign -c -v -P 16 4 sobre split_config.arm64_v8a.apk, extraído del .apkm de Photomath 8.48.0 (build-tools 37.0.0, 31 de octubre de 2026):

$ zipalign -c -v -P 16 4 split_config.arm64_v8a.apk
      49 AndroidManifest.xml (OK - compressed)
    4096 lib/arm64-v8a/libcrashlytics-common.so (BAD - 4096)
  761856 lib/arm64-v8a/libcrashlytics-handler.so (BAD - 8192)
  950272 lib/arm64-v8a/libcrashlytics-trampoline.so (OK)
  962560 lib/arm64-v8a/libcrashlytics.so (BAD - 12288)
 1159168 lib/arm64-v8a/libimage_processing_util_jni.so (BAD - 12288)
Verification FAILED

El n no es un código de error: es el resto de dividir el offset de los datos entre la alineación exigida, cuántos bytes sobran sobre el último múltiplo. Aquí, 4096 = 4096 mod 16384 y 761856 = 46 × 16384 + 8192. Causa raíz: el APK está alineado a 4 KiB y se le exige 16 KiB; la misma pieza con zipalign -c 4 sale con 0. Arreglo: zipalign -P 16 -f 4 entrada.apk salida.apk, antes de firmar. Otros dos ejemplos: split_config.arm64_v8a.apk de la carpeta de adb de com.dgca.gov.kw, con 4096 lib/arm64-v8a/libpl_droidsonroids_gif.so (BAD - 4096), que sale con 1 con -P 16 y con 0 con -c 4; y split_config.armeabi_v7a.apk del .apkm de Gmail Go 2022.10.10, con una .so en el offset 4096. La medición de todo el muestrario, con los offsets, está en la «sección 5.1 de Alineación y zipalign · Un caso que no cumple».

En el muestrario el fallo es un patrón, no un caso: fallan zipalign -c -P 16 4 entre el 0,5 % y el 2,5 % de las piezas según la fuente, y el 19 % en el mercado chino. Casi siempre es una .so que empieza en un múltiplo de 4.096 y no de 16.384. En Google Play suele ser el split de arquitectura, con la primera .so en el byte 4.096; no falla ninguna base ni ningún split de idioma o de densidad. Fuera de Play son APK únicos: por ejemplo tk.hack5.treblecheck 5001001 de F-Droid (tres .so de tres ABI mal alineadas) y com.zhulang.reader 26072900 de la tienda 360. Solo un puñado de piezas falla por la regla de 4 bytes; las demás, por la de 16 KB.

Los tres veredictos por entrada: (OK) es stored y alineada; (OK - compressed) es comprimida y la alineación no le aplica, por eso un APK con todas las .so comprimidas pasa siempre («sección 5.2 de Alineación y zipalign · La trampa de interpretar el resultado»); (BAD - n) es stored desalineada por n bytes.

4.2 La trampa mayor: zipalign después de firmar (reproducido)

El fallo de manual del ecosistema, y el que produce el diagnóstico más engañoso: zipalign sale con 0 y apksigner verify responde, con una segunda línea ERROR: igual para v3 (lo reprodujimos el 31 de octubre de 2026 con la calculadora de Fossify, firmada con v1+v2+v3 por el firmante PROC con una clave local de prueba y pasada por zipalign -f -P 16 4; el APK pasa de 7.176.560 a 7.170.903 bytes):

DOES NOT VERIFY
ERROR: JAR signer PROC.RSA: JAR signature META-INF/PROC.SF indicates the APK is signed using APK Signature Scheme v2 but no such signature was found. Signature stripped?
…

o, si el APK no tenía v1 (firmado solo con v2+v3, de 7.049.393 a 7.044.793 bytes), DOES NOT VERIFY / ERROR: Missing META-INF/MANIFEST.MF.

zipalign no invalida la firma: la borra. Reescribe el ZIP y el APK Signing Block no se reproduce. El .SF de v1 sobrevive y sigue declarando X-Android-APK-Signed: 2, 3, y el verificador acusa de un stripping que no hubo. La regla: alinear antes de firmar, y nada toca el APK después. Arreglo: recuperar el APK de antes de firmar, alinearlo y firmar después. La demostración, con su salida, está en la «sección 4.2 de Alineación y zipalign · La demostración», y qué produce cada orden de los pasos, en la «sección 8 de Firma y empaquetado · Qué se rompe si se altera el orden».

Qué mensaje ves depende de si el APK llevaba v1. Sin v1, alinear después de firmar da Missing META-INF/MANIFEST.MF; con v1, el Signature stripped?. En Play es más probable el primero: casi dos de cada tres apps no llevan v1. En el mercado chino casi todas la llevan.

4.3 zipalign -c pasa y el APK sigue siendo incompatible con 16 KB

Para funcionar en móviles con páginas de 16 KB, una .so necesita dos cosas. La primera: estar bien colocada dentro del ZIP; eso lo comprueba zipalign. La segunda: estar compilada para páginas de 16 KB; eso lo dice su cabecera ELF y se ve con llvm-readelf -l, en la columna Align (p_align, la alineación de cada segmento LOAD, que tiene que ser 2**14 = 16.384).

zipalign solo mira lo primero. zipalign -c responde a «¿están alineadas las entradas que debían estarlo?», no a «¿cumple este APK la regla de 16 KB?». Los dos controles son necesarios y ninguno basta («Alineación → §3.1 · Qué es», y «Código nativo y ELF»).

Un APK con extractNativeLibs="true" (o sin el atributo, que vale lo mismo) casi siempre comprime sus .so, y entonces zipalign no tiene ninguna a la que aplicar la regla. Pero no siempre: más o menos una de cada diez apps de Play con ese valor lleva alguna .so sin comprimir. Dos ejemplos: com.tencent.tmgp.yongyong.mrzh 744 del mercado chino, con 8 .so sin comprimir y 39 comprimidas, y com.github.howeyc.crocgui 48 de F-Droid, sin el atributo y con 4 .so sin comprimir.

Con extractNativeLibs="false", que es lo más común, ocurre lo contrario: las .so van sin comprimir y alineadas. Ninguna app publicada combina false con una .so comprimida o fuera de múltiplo de 4.096, que son los dos casos que dan res=-2 en la «sección 2.5 · Lo que responde adb install, reproducido».

No es un riesgo teórico. Entre las apps con .so de arm64-v8a que pasan zipalign -c -P 16 4 en todas sus piezas, entre el 5 % y el 16 % tienen una .so con algún segmento LOAD de p_align menor de 16.384; en el mercado chino, casi todas. Esas apps pasan el control de zipalign y siguen sin cumplir la regla de 16 KB. Aquí «pasa» es la regla de la guía de Android (.so a 16.384 y el resto a 4 bytes); no aplicamos el cargador de Android 17 («§4.4 · Cuántas apps reales verán cada síntoma»). Ejemplos: xzr.perfmon 16 de IzzyOnDroid y org.rayg.streaktracker 12 de F-Droid.

Cuando el que falla es el segundo, el síntoma en un dispositivo de 16 KB depende de la versión, y solo en una habla de alineación (reproducido):

  • Android 15 de salida: la aplicación instala y System.loadLibrary falla con dlopen failed: empty/missing DT_HASH/DT_GNU_HASH in "…" (new hash type from the future?); con un p_align de 8 KiB, peor: carga y muere en la primera llamada con Fatal signal 4 (SIGILL).
  • Android 16: carga en el modo de compatibilidad, con un aviso al usuario y pageSizeCompat=4 en dumpsys package. Solo si el manifiesto lo desactiva, o si el p_align no es exactamente 4 KiB, falla con "…" program alignment (4096) cannot be smaller than system page size (16384).

La matriz completa está en la «sección 6.4 de Código nativo y ELF · Qué pasa en el dispositivo».

4.4 Cuántas apps reales verán cada síntoma

Una app solo puede ver los síntomas de 4.3 si lleva código nativo de 64 bits ARM (arm64-v8a), y eso es lo habitual: más de la mitad en F-Droid y la gran mayoría en Play. De esas, la tabla da cuántas tienen alguna .so con segmentos ELF de 4 KiB y cuántas son compatibles con 16 KB. «Compatible» se mide de dos maneras, y cada columna dice cuál: con la guía de Android (los ELF están a 16 KiB y, si las .so no se extraen, también el ZIP) o con el cargador de Android 17 (ninguna .so de arm64-v8a pasa a modo de compatibilidad; además de p_align mira RELRO y el solape de segmentos).

Fuente Apps con .so de arm64-v8a Con ELF de 4 KiB Compatibles (guía de Android) Compatibles (cargador de Android 17)
F-Droid 2.689 18 % 82 % 78 %
IzzyOnDroid 790 15 % 84 % 80 %
Google Play (más instaladas) 546 12 % 86 % 74 %
Google Play (sorteo) 310 11 % 85 % 77 %
Mercado chino 98 93 % 7 % 1 %
Webs de autores 5 0 5 5

Cada fila usa su propio denominador, el de la segunda columna. El resultado baja unos puntos con el cargador de Android 17 porque mira además RELRO y el solape de segmentos. Fíjate en el mercado chino: es el caso extremo, casi ninguna app es compatible. Las apps con ELF de 4 KiB deberían ver el modo de compatibilidad en Android 16 y el fallo de carga en Android 15 («§4.3 · zipalign -c pasa y el APK sigue siendo incompatible con 16 KB»); eso lo deducimos de los ELF, no hemos instalado nada.

5. apktool

Las cadenas literales de esta sección salen del código de apktool, leído directamente en el commit 79b6338 del 10 de agosto de 2026 —rama main, que es la 3.x— y en los tags v2.7.0 y v2.9.3 para las variantes antiguas.

Con APK reales, apktool falla poco, y cuando falla suele ser culpa de aapt2. Lo probamos en octubre de 2026 con apktool 3.0.3 sobre una submuestra de 112 piezas base o únicas, las primeras por SHA-256 de cada fuente (no es una muestra aleatoria). apktool d terminó bien en 111 y apktool b falló en 5 de 111, siempre por aapt2 («§5.3 · Fallos de reconstrucción por aapt2»). Los fallos de las secciones «5.1» y «5.2» (Could not find framework resources, Could not decode arsc file, Invalid resource config detected) no han aparecido en esa submuestra y siguen siendo (fuente). Ejemplo de apktool d con código 1: com.ss.android.ugc.aweme.lite 400901 del mercado chino, con una NullPointerException en String.isEmpty().

5.1 El aviso de versión, que es la mitad del problema

Las cadenas cambiaron entre 2.x y 3.x, y las que circulan por los foros son las antiguas: si buscas un mensaje y no aparece, casi siempre es esto.

2.x 3.x (main)
Paquete brut.androlib.err · clase CantFindFrameworkResException Paquete brut.androlib.exceptions · clase FrameworkNotFoundException
Can't find framework resources for package of id: 1 Could not find framework resources for package ID 1. + salto de línea + You must install proper framework files, see project website for more info.
Could not decode arsc file (sin punto) Could not decode arsc file. (con punto)
Invalid config flags detected. Dropping resources: Invalid resource config detected. Dropping resources: %s %s

El texto de ayuda de --keep-broken-res en el Main.java de 3.x sigue citando la redacción 2.x del mensaje al que remite: está desactualizado en el propio proyecto.

5.2 Las excepciones de brut.androlib (3.x)

Clase Mensaje literal
AndrolibException Clase base, sin mensaje fijo. Extiende brut.common.BrutException
FrameworkNotFoundException Could not find framework resources for package ID <id>. + You must install proper framework files, see project website for more info.
InFileNotFoundException · OutDirExistsException · RawXmlEncounteredException · NinePatchNotFoundException Input file (<ruta>) was not found or was not readable. · Destination directory (<ruta>) already exists. Use -f option if you want to overwrite it. · Could not decode XML. · Could not find nine patch chunk.

InFileNotFoundException, OutDirExistsException y FrameworkNotFoundException se imprimen sin traza de pila y con salida 1; el resto, con traza. Y falta una más, UndefinedResObjectException, cuyo mensaje es estructurado —entry: pkgId=0x%02x, typeId=0x%02x, entryId=0x%04x, config=%s, overlayable: pkgId=0x%02x, name=%s— y dice exactamente qué identificador no resolvió.

Could not find framework resources for package ID 1. apktool no tiene el APK de framework para resolver los identificadores del espacio 0x01....... Trae empotrado el framework estándar, así que con aplicaciones normales de Play no pasa: pasa con las de sistema y de fabricante —Samsung, MIUI, HTC—. Arreglo: apktool if framework-res.apk, o apktool if -t miui framework-miui-res.apk y luego apktool d -t miui app.apk.

En la prueba con 112 piezas (apktool 3.0.3) no apareció en ninguna. Tampoco en las dos apps de fabricante de la submuestra, ambas de APKMirror: la música de Samsung 16.2.45.1 y com.vivo.easyshare 7.1.1.7 de vivo. Son apps actualizables, no el framework-res.apk de sistema: que «pasa con las de sistema y de fabricante» no se puede comprobar con datos estáticos. El fallo de framework que sí aparece con apps recientes es otro: el framework que trae apktool no conoce atributos nuevos de Android, y apktool b falla con error: attribute android:zygotePreloadNativeLib not found (Brave, Bravearm64Universal.apk, de las webs de autores).

Could not decode arsc file. El lector de resources.arsc de apktool se atascó. resources.arsc está hecho de bloques (chunks) y cada uno empieza diciendo cuánto mide. Las issues cerradas identifican el patrón: el tamaño declarado de un chunk no corresponde al contenido. iBotPeaches en la #3036: «what appears to be happening is the reported size of a chunk is wrong … the chunks we are reading are exceeding the size that was reported of that chunk»; en la #2989: «The header chunk is lying about its reported size.» La segunda familia son las tablas sparse (#3199, #3298): un formato compacto que guarda solo los recursos que tienen valor en cada configuración. Ahí el criterio correcto no es el orden de los chunks sino el propio flag de sparse, con el umbral de AOSP de al menos 1.000 recursos.

Las tablas sparse son corrientes en Google Play (alrededor de una de cada diez apps) y casi no existen fuera. Solo aparecen con minSdk 26 o más (Android 8). Un ejemplo es la base del .apkm de CallApp 2.150W (minSdk 32). En la prueba con 25 piezas de las más instaladas de Play, apktool d no falló con ninguna; no hemos cruzado cuáles eran sparse.

--force-manual-size no existe y nunca ha existido en apktool: lo buscamos en los 2.376 commits de todas las ramas del repositorio, desde 2010, y en la documentación oficial, con cero apariciones. El control de sparse es la clave sparseResources de apktool.yml, no un flag; si una guía lo menciona, viene de un fork.

Qué comprobar: si aapt2 dump resources sí lee el fichero, el problema es de apktool y no de la tabla. Arreglos por coste: apktool d -r, --keep-broken-res, o APKEditor, que usa otro lector.

Invalid resource config detected. Dropping resources: … es un aviso, no un error: apktool ha encontrado una configuración que no entiende y está descartando esos recursos; la ejecución continúa y el resultado está incompleto. --keep-broken-res los conserva, y hay que arreglarlos a mano antes de reconstruir.

5.3 Fallos de reconstrucción por aapt2

Aquí está el detalle que hace perder más tiempo: apktool no aporta ningún mensaje propio. Cuando apktool b falla, su mensaje (Execution failed (exit code = 1): [.../aapt2, link, -o, ..., --manifest, ...]) no dice nada. El error de verdad lo escribió aapt2 unas líneas más arriba, como aviso: lee la salida hacia arriba o sube el nivel de log.

Por qué pasa: el envoltorio de aapt2 captura la BrutException y la reenvuelve en un AndrolibException(ex) sin mensaje, solo con la causa, así que lo que ves es lo que produce brut.util.OS.exec. Los errores reales de aapt2 (los error: resource … is private, los Multiple resources) llegan por otro camino: un reenviador de flujos que los registra en el log a nivel warn. Por eso aparecen en el log y nunca en el texto de la excepción, y por eso buscar «Multiple resources» en el código de apktool no devuelve nada.

Error de aapt2 Causa Arreglo
resource … is private El APK original referencia un recurso del framework marcado como privado. Es legal en un binario construido y aapt2 lo rechaza al enlazar, porque su trabajo es impedirlo apktool d -r, o APKEditor
Multiple resources / símbolos duplicados Identificadores que apktool no supo resolver y sustituyó por @null. Issue #2836: «This works for the first resource, but as you see becomes duplicate symbols» Actualizar apktool, o APKEditor
must not undeclare prefix Un XML de recursos que apktool d dejó con un espacio de nombres mal cerrado Corregir el XML a mano antes de reconstruir
failed to read PNG signature: file does not start with PNG signature Un .png que no lo es (por ejemplo un recurso protegido) Sustituir el fichero o borrar la referencia
attribute android:… not found Un atributo más nuevo que el framework de apktool Actualizar apktool o instalar un framework más reciente (apktool if)

En la prueba con 112 piezas, apktool b falló en 5 de 111, y todas las veces el error real de aapt2 estaba en el registro y ninguna en el texto de la excepción. Dos fueron por un recurso privado del framework y los otros tres, uno por cada una de las tres últimas filas. Ejemplos: com.vivo.easyshare 7.1.1.7, con resource android:style/Preference.RingtonePreference is private; com.fudme.cambridgepizza, con resource android:style/TextAppearance.Material.Notification… is private; com.xingin.xhs 9510803 del mercado chino, con must not undeclare prefix; y com.ifeng.newvideo 73440, también del mercado chino, con failed to read PNG signature. La causa de estas dos últimas filas la deducimos del mensaje de aapt2: no abrimos el fichero.

Dos datos más: apktool siempre pasa --legacy a aapt2 —comentario del fuente: «Treats error that used to be valid in aapt1 as warnings in aapt2»— y aapt1 ya no existe, Main.java responde Legacy aapt is no longer supported. desde 2025.

5.4 Lo que apktool no hace, y hay que saber

  • No firma. La FAQ oficial: «Apktool builds unsigned APKs. This means some directories and files like META-INF are missing.»
  • No alinea. Verificado por inspección del código fuente de la rama main: no hay ninguna referencia a zipalign, a alineación de página ni a 16.384. Registra qué entradas van stored en doNotCompress y las escribe sin comprimir, pero nunca las alinea: zipalign es estrictamente externo.
  • --copy-original solo sirve para v1 (FAQ), y --match-original impide reconstruir: la ayuda dice literalmente Keep files closest to original as possible (prevents rebuild).
  • Hay APK que no soporta: los construidos con herramientas modificadas para OEM concretos «are not built with regular AOSP tools and are not compatible with Apktool».

6. jadx

Los literales de esta sección salen del código de jadx, leído directamente en el commit e738a26 del 5 de agosto de 2026, con fichero y línea identificados. Desde octubre de 2026 hay además una prueba con APK reales: jadx 1.5.6 sobre la misma submuestra de 112 piezas que la «sección 5 · apktool» («§6.5» y «§6.6»). No sabemos si la versión medida (1.5.6) y el commit leído (e738a26) coinciden.

6.1 Corrección previa: dos cadenas que circulan y no existen

Cadena que circula Realidad
// decompilation failed No existe en jadx. No aparece en ninguna parte del árbol. Lo más parecido es "Class decompilation failed", mensaje de una JadxRuntimeException del modo --single-class, no un comentario del código generado
// JADX WARNING: inconsistent code La forma real es /* JADX WARN: <mensaje> */. Y no se puede buscar en el fuente: se compone en ejecución como "JADX " + nivel.name() + ": " en JadxCommentsAttr, así que grepear el repositorio no devuelve nada y lleva a concluir que es falsa

6.2 Los marcadores reales, con su fichero

Literal Dónde se emite Qué significa
/* JADX ERROR: <msg> … */ (con dos espacios tras /*) codegen/utils/CodeGenUtils.java:48 Error duro en ese nodo. Si hay causa, la traza de pila Java completa va incrustada dentro del comentario
/* JADX WARN: … */, /* JADX INFO: … */, /* JADX DEBUG: … */ JadxCommentsAttr + CodeGenUtils.addComments Aviso del nivel correspondiente. Por defecto --comments-level es info: WARN e INFO se emiten, DEBUG no
Code decompiled incorrectly, please refer to instructions dump. + To view partially-correct add '--show-bad-code' argument codegen/MethodGen.java:114-127 El peligroso. Ver «§6.3 · Code decompiled incorrectly — el que hay que tomarse en serio». La falta de la palabra «code» en el segundo está en el fuente, no es errata de este documento
throw new UnsupportedOperationException("Method not decompiled: …") MethodGen.java:365-373 El método no se reconstruyó; se emite un lanzamiento para que el fichero siga siendo parseable
Method dump skipped, instruction units count: <n> + To view this dump add '--comments-level debug' option MethodGen.java:381 y :385 El volcado se omitió por tamaño; el umbral es más de 200 unidades de instrucción
// Can't load method instructions: <msg> / // Can't load method instructions. · // Blocks not ready for simple mode, using fallback MethodGen.java:402, :410 · :308 No se pudieron decodificar las instrucciones · cayó al modo de respaldo
Load error · Code generation failed RootNode.java:192 · ClassNode.java:409 Fallo al cargar la entrada · ver «§6.4 · Un fichero .java cuyo contenido entero es una traza de pila»

Mensajes representativos tras JADX WARN:, verbatim del fuente: Multi-variable type inference failed, Type inference incomplete: some casts might be missing, Unreachable blocks removed: , Failed to restore switch over string. Please report as a decompilation issue.

6.3 Code decompiled incorrectly — el que hay que tomarse en serio

No es un comentario de una línea: es un bloque de tres.

/*
    Code decompiled incorrectly, please refer to instructions dump.
    To view partially-correct add '--show-bad-code' argument
*/

Significa que jadx llegó a producir Java y luego detectó que su propia reconstrucción no es coherente con el grafo de partida; por defecto no lo enseña y sustituye el cuerpo por el volcado.

El mecanismo, que aclara la confusión habitual: ClassGen.addMethodCode tiene tres niveles. Aviso (addWarn) pone la bandera INCONSISTENT_CODE, añade el comentario JADX WARN y suma al contador — un solo aviso ya basta para que el método caiga al modo de respaldo. Error (addError) añade el atributo JADX_ERROR y fuerza el respaldo igualmente. El fallo de clase entera es «§6.4 · Un fichero .java cuyo contenido entero es una traza de pila». Y --show-bad-code no arregla nada: solo cambia la bandera para que se imprima el Java parcialmente reconstruido —que puede ser incorrecto— en lugar del volcado. Es la opción correcta para auditar y la peligrosa para confiar.

Y el dato que corrige un error extendido: jadx no emite smali en el fichero .java. Lo que pone en el modo de respaldo es su volcado de instrucciones interno, en su propia representación; el smali de verdad existe solo como superficie de API —JavaClass.getSmali()—, alimenta la pestaña «Smali» de jadx-gui y nunca aparece en la salida de la CLI.

6.4 Un fichero .java cuyo contenido entero es una traza de pila

La clase entera falló. ClassNode.generateClassCode() captura StackOverflowError | Exception, registra "Code generation failed" y devuelve como contenido del fichero la traza de pila en crudo. Un pipeline que cuente .java producidos concluirá que la clase se decompiló.

6.5 Salida vacía, cuelgues y OutOfMemoryError

Causa raíz, con explicación del mantenedor. La issue #2676, cerrada: «errors during instructions decoding handled per single instruction, but there are several big methods (~100K instruction units) with errors at almost all instructions, so all these errors are collected to be added into generated code later (JADX_ERROR attribute). This is very slow and eats a lot of memory.» Es decir: un DEX con anti-análisis produce un error por instrucción, y acumularlos mata el proceso. La #2744 es análoga para código muy ofuscado. Arreglos: JAVA_OPTS="-Xmx8g", -j 4, excluir paquetes, jadx-gui con su caché en disco, o -m fallback.

En la prueba con 112 piezas, no terminar es sobre todo cosa del mercado chino: allí no acabaron 5 de 20 (cuatro pasaron los 900 s y una se quedó sin memoria). Fuera, solo dos.

6.6 Los códigos de salida, que sí sirven para automatizar

Código Condición
0 Éxito
1 JadxArgsValidateException (Incorrect arguments: {}) o cualquier Throwable (Process error:)
2 No se cargó ninguna clase y se pasó --no-res: Load failed! No classes for decompile!
3 Decompiló, pero con errores. Imprime el informe y luego finished with errors, count: {}

El 3 es el que importa: hay salida, y parte de ella son trazas de pila y volcados de instrucciones. Un 0, en cambio, no garantiza cobertura completa: los avisos no cuentan como error y ya bastan para que un método caiga al modo de respaldo. El informe previo lo emite ErrorsCounter.printReport() con los formatos "{} errors occurred in following nodes:" y "{} warnings in {} nodes".

Con APK reales, terminar con 3 es lo normal: en la prueba con 112 piezas (jadx 1.5.6) es lo que pasa en casi todas las de fuera del mercado chino. Los ficheros con algún marcador de fallo (JADX ERROR:, Method not decompiled: o Code decompiled incorrectly) son pocos, en torno al 1 % de los .java de cada pieza. Pero en las apps más instaladas de Google Play los cuerpos Method not decompiled: llegan a cientos por pieza.

Ojo con el 0: no garantiza nada. Las piezas chinas que acaban con 0 son todas protegidas, y jadx solo ve el stub («§9.6 · APK protegidos: qué enseña cada herramienta»). Ejemplos: com.cmbchina.ccd.pluto.cmbActivity 160 (protegida con Bangcle/SecNeo; jadx acaba con 3 y saca 3.623 .java) y com.cn21.ecloud 638 (protegida con Ijiami; jadx acaba con 0 y saca 5 .java), las dos del mercado chino.

7. Fusión de splits

Las causas y la detección de cada fallo de una fusión, con la salida reproducida de la fusión ingenua, están en la «sección 10 de Fusión de splits · Qué se rompe al fusionar, y cómo se detecta»; aquí queda el índice por síntoma.

Síntoma Qué suele ser Dónde se trata
NoClassDefFoundError en ejecución Falta un DEX, la renumeración dejó un hueco, o el DEX de un feature module quedó delante de los del base y sombreó una clase «Fusión de splits → §10.1 · NoClassDefFoundError en ejecución»
Los textos salen en inglés; los iconos, borrosos; locales: '--_--' La tabla de recursos no se fusionó «Fusión de splits → §10.2 · Recursos que no aparecen»
Los textos salen en inglés o los iconos borrosos en otro móvil El conjunto viene de una carpeta de adb pull y solo trae lo que tenía el móvil de origen: sus idiomas (lo normal, en y es), su densidad (xxhdpi) y su ABI (arm64_v8a) «sección 3 de Pipeline de modificación · La bifurcación fundamental»
Un módulo de funcionalidad no está · dos Package con el mismo id= Se descartó el paquete propio del módulo · colisión real de package ID, que es un aborto y no un aviso «Fusión de splits → §10.3 · Módulos de funcionalidad que se pierden» y «§10.4 · Colisiones de identificador»
INSTALL_FAILED_MISSING_SPLIT sobre el fusionado Quedaron atributos de split en el manifiesto «§2.3 · Los cinco que hay que conocer al detalle» y «Fusión de splits → §5 · Saneado del manifiesto»
No instala: INSTALL_FAILED_INVALID_APK: Failed to extract native libraries, res=-2 extractNativeLibs="false" con .so comprimidas, o stored sin alinear a la página fuera del modo de compatibilidad de 16 KB «§2.5 · Lo que responde adb install, reproducido» y «Fusión de splits → §7.2 · extractNativeLibs: el atributo que hay que unificar»
Instala y muere en System.loadLibrary con UnsatisfiedLinkError No se fusionó el split de ABI: unzip -l final.apk | grep ' lib/' no lista la del dispositivo «Fusión de splits → §3.1 · El problema»
Arranca y se cierra sin traza La aplicación consulta sus propios splits en ejecución. No tiene arreglo dentro del alcance de esta documentación «§9.1 · La aplicación instala, arranca y se cierra» y «Fusión de splits → §10.5 · Aplicaciones que comprueban su propia estructura de splits»

Los conflictos reales son casi siempre los mismos ficheros: el manifiesto, la tabla de recursos, los ficheros de firma de META-INF/ y, cuando hay módulos de funcionalidad, classes.dex y sus compañeros. Lo vemos cruzando las rutas de todos los splits de los 773 conjuntos del muestrario. Fuera de esas cuatro categorías no hay conflicto en ninguno: nada de res/, lib/ ni assets/ aparece con tamaño distinto. Contamos como conflicto una ruta que está en dos piezas o más con distinto tamaño descomprimido; el muestrario no guarda el CRC-32, así que es una cota inferior.

Casi siempre son seis rutas o menos. El caso extremo es TikTok 47.4.16: 125 piezas, 20 rutas y los classes.dex a classes15.dex. Con el CRC-32 exacto, el .apkm de HealthKart 18.4.2 tiene 6 rutas en conflicto y el de Twitch 31.8.0 BETA, 2 («Fusión de splits → §2.2 · Qué colisiona de verdad: medido»).

Y una carpeta de adb solo trae lo que tenía el móvil de origen. Muchas no traen ningún split de idioma, densidad o ABI, y lo más repetido es arm64_v8a + en + xxhdpi. Una carpeta típica es air.conectagames.tute.

8. Formatos

8.1 El fichero no es lo que dice ser (reproducido)

Qué pasa aapt2 dice apksigner dice
No es un ZIP error: failed opening zip: Invalid file. ApkFormatException: Malformed APK: not a ZIP archive
Es un ZIP sin AndroidManifest.xml error: could not identify format of APK. ApkFormatException: Missing AndroidManifest.xml

La segunda fila aparece constantemente al pasar el contenedor —un .xapk, un .apkm— a una herramienta que espera un APK; la detección estructural del paso 0 de «Pipeline de análisis» lo resuelve antes de llegar aquí. Lo que hace el lector de ZIP de la plataforma con cada malformación está en la «sección 3 de Qué rechaza cada lector · libziparchive: el ZIP».

Con el .apkm de Google Keep 5.26.411.03.97 y con el .xapk de Telegram 13.1.0, apksigner verify termina con Exception in thread "main" com.android.apksig.apk.ApkFormatException: Missing AndroidManifest.xml y aapt2 dump badging con error: could not identify format of APK. (reproducido el 31 de octubre de 2026). Pasa con todos los contenedores del muestrario: ninguno trae AndroidManifest.xml en la raíz, porque el manifiesto está dentro de cada APK que contienen, y todos se abren como ZIP. El .apkm de APKMirror lleva firma JAR propia (META-INF/MANIFEST.MF, APKMIRRO.SF y APKMIRRO.RSA), pero apksigner falla antes de verificarla, al buscar el manifiesto para leer el minSdk. Más sobre estos formatos en «§8.5 · Los contenedores reales».

8.2 resources.arsc que no parsea (reproducido)

Lo provocamos sobre la calculadora de Fossify, cuyo resources.arsc mide 3.572.644 bytes, inflando el campo size del chunk raíz en 1.000.000 y truncando el fichero:

size_grande.apk: error: corrupt resources.arsc: chunk's data extends past the end of the document (type=02 header_size=12 size=4572644).
truncado.apk:   error: corrupt resources.arsc: chunk's data extends past the end of the document (type=02 header_size=12 size=3572644).

Un chunk declara un tamaño mayor que lo que queda de fichero: la misma familia de fallo que las issues de apktool de «§5.2 · Las excepciones de brut.androlib (3.x)», y el mensaje da los tres campos de la cabecera, que es lo que hace falta para localizarlo con xxd. Lo que aapt2 tolera y sorprende: con packageCount = 99 en un fichero de un paquete, aapt2 dump resources lo lee entero sin protestar —su lector no confía en ese contador, recorre hasta que se acaban los datos—. Un lector propio que sí confíe en él leerá fuera de rango. Lo que hace LoadedArsc en el dispositivo con cada chunk mal formado está en la «sección 9 de Qué rechaza cada lector · LoadedArsc y AttributeResolution: los recursos».

El caso legítimo que rompe lectores estrictos: un resources.arsc de 40 bytes exactos, una tabla válida y vacía (packageCount = 0). Es rarísimo, 22 piezas en todo el muestrario, casi todas módulos o splits de Google Play. Ejemplos: split_pytorchlibrary.apk de Quvideo 9.38.5, los splits de densidad del módulo electronicmoney de DANA 2.149.1 y un APK único de IzzyOnDroid (com.programminghoch10.AntiBrightnessChange 60). La tabla es solo la cabecera y un string pool vacío. aapt2 dump resources la lee sin protestar (responde Binary APK y sale con 0; lo comprobamos el 31 de octubre de 2026 sobre AntiBrightnessChange). Que rompa cualquier lector que asuma al menos un paquete es una afirmación de diseño: solo probamos aapt2. El volcado y su descodificación están en la «sección 4.3 de Fusión de splits · El caso degenerado: la tabla de 40 bytes».

8.3 AXML malformado (reproducido)

Los tres mensajes salen del mismo código de AOSP (ResourceType.cpp) que usa el dispositivo, así que reproducirlos con aapt2 predice lo que dirá el instalador. Los provocamos sobre el manifiesto de la calculadora de Fossify, que mide 21.476 bytes:

Provocado Salida literal
size del chunk raíz mayor que el fichero W ResourceType: Bad XML block: header size 8 or total size 25572 is larger than data size 21476
Fichero truncado a la mitad W ResourceType: Bad XML block: header size 8 or total size 21476 is larger than data size 10738
Tipo del chunk raíz cambiado a 0x00FF W ResourceType: Bad XML block: expected root block type 3, got 255

Los tres van seguidos de <fichero>: error: failed to parse binary AndroidManifest.xml: failed to initialize ResXMLTree., que en el dispositivo es INSTALL_PARSE_FAILED_UNEXPECTED_EXCEPTION (−102): ApkAssets.openXml() lanza FileNotFoundException con "Corrupt XML binary file" y el catch general de parseApkLiteInner() la convierte en ese código. El resto de lo que ResXMLTree rechaza o deja pasar, con su línea en AOSP, está en la «sección 8 de Qué rechaza cada lector · ResXMLTree: el XML binario».

8.4 DEX con checksum inválido (reproducido)

Corrompimos los bytes 8 a 11 —el Adler-32— de un classes.dex de la calculadora de Fossify (cuyo Adler-32 es 73027441 y cuyo SHA-1 es correcto) y volvimos a ejecutar dexdump -f:

E dexdump : dexdump.cc:2037 Failure to verify dex file 'checksum_malo.dex': Bad checksum (73027441, expected efbeadde)

Cómo se lee. El primer número es el checksum calculado sobre el contenido; el segundo, precedido de expected, es el que estaba escrito en la cabecera — la redacción es contraintuitiva, porque expected es lo que el fichero afirma, no lo que debería ser.

El detalle que enseña la estructura. Corrompiendo en cambio la signature SHA-1 —bytes 12 a 31— el mensaje es también de checksum, Bad checksum (709a6bcb, expected 73027441), porque el Adler-32 cubre todo lo que va detrás del byte 11, incluida la signature: tocar la firma rompe primero el checksum. Y con la magic rota, Expected valid zip or dex file. En resumen, Bad checksum es el mensaje del Adler-32: un SHA-1 de cabecera que no cuadra no da ningún mensaje en dexdump, apktool ni smali.

En la práctica no verás Bad checksum en un APK publicado: el Adler-32 es correcto en todo el muestrario. Solo aparece si alguien edita el DEX a mano con un editor hexadecimal sin recalcular la cabecera (el ensamblador smali la recalcula solo; un sed sobre el binario, no). Lo que sí es frecuente es el SHA-1 mal: un 6 % en F-Droid, uno de cada cuatro en el mercado chino, casi nunca en Google Play. En esas piezas, dexdump -f abre el DEX sin quejarse: por ejemplo net.iptux.xposed.usbdebugging 4 de IzzyOnDroid (SHA-1 calculado f74b1600…, escrito eb9b9015…, Adler-32 correcto; lo comprobamos el 31 de octubre de 2026). No hemos estudiado por qué hay tantos en F-Droid. Y si ART comprueba ese SHA-1 no lo podemos saber con datos estáticos. Lo que comprueba DexFileVerifier en el dispositivo está en la «sección 6 de Qué rechaza cada lector · El verificador de DEX».

8.5 Los contenedores reales

Un .apkm (APKMirror), un .xapk (APKPure) y una carpeta de adb pull son contenedores de splits, no APK. Se distinguen por dentro:

Formato Qué trae Firma exterior Piezas
.apkm (388) base.apk, los splits, info.json, icon.png y APKM_installer.url JAR (META-INF/APKMIRRO.*) en los 388 mediana 12, máximo 125
.xapk (72) los APK y manifest.json, e icon.png en 58 de 72 ninguna (0 de 72) mediana 3 (de 2 a 22)
carpeta de adb (365) base.apk y los splits del móvil las de cada APK mediana 4, máximo 7

Ninguno lleva AndroidManifest.xml en la raíz, así que apksigner y aapt2 fallan igual que en «§8.1 · El fichero no es lo que dice ser (reproducido)». La firma JAR exterior del .apkm es solo del ZIP de fuera: ninguna pieza interna lleva APKMIRRO.*. Alguna vez el contenedor trae además un .obb con los datos del juego, que se copia a Android/obb/ y no forma parte de ningún APK (lo hemos visto en dos .apkm: Plants vs. Zombies 2 13.5.1 y Scary Teacher, de Zakg). Y si APKPure te da un .apk, es un APK normal, no un .xapk con otra extensión. Todos los conjuntos de Google Play comparten paquete, versionCode y certificado, y una carpeta de adb solo trae lo que tenía el móvil de origen («sección 7 · Fusión de splits»). Dos ejemplos: el .apkm de Keep 5.26.411.03.97 (27 piezas y firma APKMIRRO) y el .xapk de Telegram 13.1.0, con manifest.json, org.telegram.messenger.apk, config.arm64_v8a.apk y config.xxhdpi.apk.

9. Síntomas de protección activa que se confunden con errores de herramienta

Los cuatro primeros comparten una propiedad: el pipeline no falla en ningún paso y el problema aparece en ejecución; el quinto, «§9.5 · java.lang.VerifyError tras editar smali (fuente)», es el error propio que más se les parece. Aquí se detectan y se informan; neutralizarlos está fuera del alcance de esta documentación, y el mecanismo de cada uno está en «Anti-análisis y hardening» y «Packers».

9.1 La aplicación instala, arranca y se cierra

No es un fallo del reempaquetado: el APK verifica, alinea e instala. Suele ser una comprobación de integridad en ejecución: la aplicación compara la huella SHA-256 de su propio certificado —vía PackageManager.getPackageInfo(..., GET_SIGNING_CERTIFICATES)— contra una constante, o el digest de una entrada del ZIP, o consulta una atestación remota. Refirmar cambia la huella por construcción, así que la comprobación falla siempre, y que cambió se ve con apksigner verify --print-certs sobre el original y sobre el modificado. Otra variante: un APK fusionado en el que la aplicación consulta sus propios splits (ApplicationInfo.splitSourceDirs, splitNames, SplitInstallManager) y los encuentra vacíos —la issue #211 de APKEditor, abierta en septiembre de 2025, recoge una veintena de aplicaciones fusionadas desde Play que caen con segfault en libpairipcore.so en Android 14 y 15, aunque ese caso concreto es antimanipulación de PairIP y no la consulta de splits (ver «Fusión de splits → §10.5 · Aplicaciones que comprueban su propia estructura de splits»).

PairIP lo añade Google Play al APK que entrega, y solo se ve en apps de Play. Tiene dos formas. La protección completa (la máquina virtual libpairipcore.so y la clase com.pairip.SignatureCheck que comprueba el certificado, siempre juntas) la lleva un 5 % de las más instaladas. La comprobación de licencia sola (com.pairip.licensecheck y com.pairip.application, sin la .so), que no comprueba la firma, es más común en el sorteo: una de cada cuatro. Refirmar o fusionar splits de una app con la protección es lo que describe la issue #211. Qué le pasa a cada una en ejecución no se puede saber con los ficheros. Ejemplos: la base del .apkm de com.teacapps.barcodescanner 3.3.6 lleva la protección, y la de com.eslamegyp.asd26, solo la licencia.

Que el DEX haga referencia a las API que leen la firma propia no es señal de integridad: lo hace la gran mayoría de las apps, en todas las fuentes. No sabemos cuántas veces es código de la propia app y cuántas de una biblioteca. Lo mismo vale para el cliente de Play Integrity en el DEX, que llevan más de un tercio de las más instaladas de Play y casi ninguna de fuera. Un ejemplo de Play Integrity sin PairIP es PGT +GFX, Launcher & Optimizer 0.21.7 de APKPure.

9.2 Funciona en emulador y no en dispositivo, o al revés

Detección de entorno: anti-emulador —ro.product.model, ro.kernel.qemu, /dev/qemu_pipe, el número de serie, los sensores— o, al revés, anti-debug/anti-root que solo se dispara en el dispositivo real. Los indicadores sobreviven a la ofuscación porque son cadenas que llegan al sistema, así que dexdump -d app.apk | grep -oE "ro\.kernel\.qemu|/dev/qemu_pipe|goldfish|TracerPid" los encuentra en el DEX (se ejecuta sobre el APK para que entren todos los classes*.dex).

Pero el comando ni basta ni es concluyente. No es concluyente porque casi todas las apps más instaladas de Google Play (un 85 %) llevan alguna de las cuatro cadenas en el DEX, y el medidor no distingue si vienen de la propia app o de una biblioteca: la cadena no prueba que esa app se defienda. Y no basta porque a veces las cadenas solo están en las bibliotecas nativas (.so), donde dexdump no mira; para esas apps hay que pasar strings por lib/. Dos ejemplos de cadenas solo en las .so: com.filestech.notes_tech 5012 de F-Droid (TracerPid) y com.sidhant.binarypuzzle 22 de F-Droid (/dev/qemu_pipe y goldfish).

9.3 Decompila, pero el código no tiene sentido

Cuatro causas que hay que separar antes de sacar conclusiones:

Lo que se ve Causa Cómo se distingue
Métodos con Code decompiled incorrectly o JADX ERROR Límite del decompilador El marcador está ahí y se ve. Es «§6 · jadx»
La aplicación habla por red y no hay ni una URL en el DEX Cifrado de strings de un ofuscador comercial dexdump -d | grep -oE 'https?://…' casi no devuelve nada (umbral y cifras debajo de la tabla)
Todo el flujo es un switch gigante dentro de un while Aplanamiento de control de flujo La estructura es uniforme en muchos métodos a la vez
classes.dex minúsculo, un .so grande y un assets/ opaco Packer (el DEX que se ve es el stub) o un marco multiplataforma Si el .so es libflutter.so/libapp.so, libunity.so/libil2cpp.so, libhermes.so/libreactnativejni.so o libmonodroid.so, no es un packer: «§9.7 · Marcos multiplataforma: la lógica no está en el DEX». Si no, «§6.4 de Pipeline de análisis · Comprobación 3 — la forma del DEX»
La app hace cosas y el DEX tiene pocas clases de la app Lógica en libapp.so (Flutter), libil2cpp.so + global-metadata.dat (Unity), index.android.bundle en Hermes (React Native), ensamblados de .NET (Xamarin) o assets/www (Cordova, Capacitor) Los marcadores de cada marco («§9.7 · Marcos multiplataforma: la lógica no está en el DEX»)

Cuántas apps no tienen ninguna URL. Una app con el permiso INTERNET y ninguna URL (http:// o https://) en el DEX casi solo se ve en apps protegidas (la definición de «protegida» es la de la «sección 9.6 · APK protegidos: qué enseña cada herramienta»). En el mercado chino pasa en 28 de 100, y 27 de ellas están protegidas. En F-Droid también se ve, pero no es señal de cifrado: la mitad tienen la lógica fuera del DEX (Flutter, SDL…), y además allí las apps llevan pocas URL en general. Ejemplos: com.simonramstedt.yoke 4 de F-Droid (ni protegida ni con marco), com.cb.oneclipboard.android.server 30103 de IzzyOnDroid (ídem) y com.jzzs.ParentsHelper 1006033 del mercado chino (protegida con Jiagu 360).

Cuántas apps tienen un DEX pequeño que no es un packer. La regla 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) no basta para decidir. En F-Droid, la mayoría de las apps que marca son un marco conocido (SDL, Flutter, Qt, Python…), y en el mercado chino solo acierta una de cada cuatro protegidas. Un ejemplo de falso positivo es se.voxelmanip.tensy 2 de F-Droid, que usa SDL.

R8 no es un protector. Es el compilador que acorta los nombres, y los nombres cortos (a.b.c) son ofuscación normal, no un fallo. Lo usa más de la mitad de las apps, y alrededor de dos de cada cinco tienen los nombres ofuscados. No esperes encontrar el fichero que permitiría volver a los nombres originales: mapping.txt (o proguard.map, seeds.txt, usage.txt) no viaja en ninguna pieza del muestrario, solo lo tiene quien compiló la app. Los ficheros *.map que sí aparecen son mapas de código JavaScript y de Mono dentro de assets/, no los de R8. Un ejemplo de app ofuscada aunque el marcador no sea de R8 es la base del .apkm de YouTube 21.41.531: D8 en classes.dex y ~~R8 solo en las clases j$.* de Google.

La regla. Antes de concluir «este código es raro» hay que descartar que el problema sea el decompilador con el recuento de «§6.6 · Los códigos de salida, que sí sirven para automatizar»: un método marcado como incoherente no es evidencia de nada.

9.4 Funciona la primera vez y luego no

Un packer que descifra el payload y lo cachea, o una atestación remota que ya ha reportado el dispositivo. Lo relevante es lo negativo: no es un fallo de reempaquetado, porque un APK mal reempaquetado falla de forma determinista.

9.5 java.lang.VerifyError tras editar smali (fuente)

No es una protección, y se confunde con «§9.1 · La aplicación instala, arranca y se cierra» porque también aparece en ejecución. Síntoma: la aplicación instala y arranca, y muere con java.lang.VerifyError la primera vez que se usa la clase parcheada, con el mensaje Verifier rejected class %s: %s —la clase y el motivo—. Causa típica: una edición de smali que desplazó el banco de registros —subir .locals con referencias v a lo que eran parámetros— o que deja un registro con tipos incompatibles donde confluyen dos ramas («Pipeline de modificación → §5.2 · El problema de los registros»). Es un fallo duro del verificador: rechaza la clase entera, no la instrucción, y la traza no apunta a la línea editada. Un método o un campo que no resuelven son, en cambio, un fallo blando: la clase carga y NoSuchMethodError o NoSuchFieldError saltan al ejecutar esa instrucción. Qué comprobar: desensamblar la clase con la información de registros y mirar el tipo de cada registro en el método que nombra el mensaje. --register-info necesita la jerarquía de clases del framework: sin -b ni -d, baksmali aborta antes de escribir nada, buscando /system/framework/core-oj.jar (Error occurred while loading class path files. Aborting.). Basta con darle como -b el android.jar del SDK pasado a DEX:

BT=~/Library/Android/sdk/build-tools/37.0.0
mkdir -p fw && $BT/d8 --min-api 24 --output fw ~/Library/Android/sdk/platforms/android-36/android.jar
baksmali d --register-info ALL -b fw/classes.dex --classes 'Lcom/ejemplo/Clase;' -o salida app.apk
#   si la clase está en otro DEX, app.apk/classes2.dex en lugar de app.apk

Las dos clases de fallo, con su línea en ART, están en la «sección 7 de Qué rechaza cada lector · ClassLinker y el verificador de bytecode»; el mecanismo de los registros, en la «sección 8.3 de Desensambladores smali · El problema de los registros al insertar código», y --register-info, en la «sección 6.3 de Desensambladores smali · Opciones principales».

9.6 APK protegidos: qué enseña cada herramienta

En una app protegida, las herramientas no fallan: enseñan el stub, un cascarón que descifra y carga el código verdadero en ejecución. Es cosa del mercado chino: allí casi cuatro de cada diez apps llevan un protector, sobre todo Bangcle/SecNeo, y en Play son muy pocas (contamos por nombres de .so y de clases de protectores, sin PairIP). APKiD, otra herramienta, coincide con esa medida en casi todas. Se reconocen por tres señales que se ven sin descompilar:

  1. El android:name de <application> apunta a una clase de empaquetador: com.secneo.apkwrapper.AW (Bangcle/SecNeo), s.h.e.l.l.S (Ijiami), com.stub.StubApp (Jiagu 360) o com.netease.nis.wrapper.MyApplication (NetEase).

  2. El DEX tiene pocas clases: lo que se ve es el stub, no la app.

  3. Hay una .so y un asset con el nombre de la familia.

El código de salida no dice que la app esté protegida: lo dice el recuento de clases. En la submuestra de 112 piezas, las 7 protegidas del mercado chino pasan apktool d y apktool b con 0, y jadx acaba con 0 en casi todas, sacando solo unos pocos .java, que son el stub. Ejemplos: com.cn21.ecloud 638 (Ijiami, Application s.h.e.l.l.S, 3 clases en el DEX; jadx sale con 0 y saca 5 .java), com.chinalife.ebz 273 (Bangcle/SecNeo, com.secneo.apkwrapper.AW, 7 clases; jadx saca 7 .java), com.youdao.translator 20260903 (NetEase, 30 clases, 31 .java) y com.cmbchina.ccd.pluto.cmbActivity 160 (Bangcle/SecNeo, 7.529 clases: aun protegida, jadx acaba con 3 y saca 3.623 .java), todas de la tienda 360. Entre las apps de protectores elegidas a propósito (fuera de las proporciones), com.tuniu.app.ui 384 lleva Baidu, con com.sagittarius.v6.StubApplication.

9.7 Marcos multiplataforma: la lógica no está en el DEX

Un marco multiplataforma guarda la lógica de la app fuera del DEX. En una app así, jadx y smali enseñan poco y eso no indica un packer. Lo que sí hay son marcadores:

Marco Marcadores
Flutter libflutter.so y libapp.so
Unity libunity.so, libil2cpp.so y global-metadata.dat
React Native libreactnativejni.so, assets/index.android.bundle y, con Hermes, libhermes.so
Xamarin y .NET MAUI libmonodroid.so y los ensamblados
Cordova y Capacitor assets/www o assets/public

No es un caso raro. Tienen la lógica fuera del DEX una de cada seis apps de F-Droid, más de un tercio de las más instaladas de Play y dos de cada tres del mercado chino. En F-Droid domina Flutter; en Play, Unity. Ejemplos: Flutter, la base del .apkm de Google Classroom 3.68; React Native, el .xapk de Flipkart 9.16; Unity, el .xapk de Real Bike Racing 2.0.0.

10. Árbol de diagnóstico

   ¿QUÉ HA PASADO?
        │
        ├─▶ NO INSTALA ───────────────────────────────────────────────────
        │     ¿el mensaje empieza por INSTALL_PARSE_FAILED_?
        │       sí → el fichero no se pudo leer                      §2.2
        │            NO_CERTIFICATES / INCONSISTENT_CERTIFICATES ─▶ firma  §3
        │            MANIFEST_MALFORMED ─▶ estructura del manifiesto  §2.3
        │            RESOURCES_ARSC_COMPRESSED ─▶ aapt2 y zipalign no lo ven: §2.3
        │       no → el sistema lo rechaza                            §2.4
        │            UPDATE_INCOMPATIBLE ─▶ refirmado: desinstalar
        │            MISSING_SPLIT ─▶ install-multiple, o sanear manifiesto
        │            INVALID_APK "Full install must include a base package"
        │                                  ─▶ split= sobrante         §2.3
        │            NO_MATCHING_ABIS ─▶ falta el split de ABI       §2.5
        │            INVALID_APK "Failed to extract native libraries"
        │              res=-113 ─▶ ninguna ABI del dispositivo       §2.5
        │              res=-2   ─▶ .so comprimida, o sin alinear
        │                          a la página                       §2.5
        │     ¿ni siquiera llega a un código INSTALL_*? ─▶ apksigner  §3.1
        │
        ├─▶ INSTALA Y FALLA AL USARLA ────────────────────────────────────
        │     ¿arranca y se cierra sin traza?     ─▶ integridad en ejecución §9.1
        │     ¿muere en System.loadLibrary?       ─▶ ABI sin fusionar    §7
        │     ¿NoClassDefFoundError?              ─▶ DEX mal renumerado   §7
        │     ¿falla solo la pantalla parcheada?  ─▶ verificación de ART:
        │                                            banco de registros
        │                                            (VerifyError)        §9.5
        │     ¿faltan textos o iconos?            ─▶ tabla sin fusionar   §7
        │     ¿va en emulador y no en real?       ─▶ detección de entorno §9.2
        │
        ├─▶ NO DECOMPILA / NO DESEMPAQUETA ───────────────────────────────
        │     apktool "Could not find framework resources" ─▶ apktool if §5.2
        │             "Could not decode arsc file"         ─▶ -r, o APKEditor
        │             "Execution failed (exit code = 1)"    ─▶ log de aapt2 §5.3
        │     jadx    exit 2, "No classes for decompile"    ─▶ ¿es un APK? §8.1
        │             OutOfMemoryError o cuelgue            ─▶ -Xmx, -j    §6.5
        │     aapt2   "could not identify format of APK" ─▶ es el contenedor §8.1
        │             "corrupt resources.arsc" §8.2 · "ResXMLTree" §8.3
        │
        └─▶ DECOMPILA MAL ────────────────────────────────────────────────
              PRIMERO: contar los marcadores                    §6.2, §6.6
              ¿jadx salió con 3? → hay huecos, y sabe cuántos
              ¿"Code decompiled incorrectly"? → ese Java puede mentir §6.3
              ¿el .java entero es una traza de pila? → clase fallida  §6.4
              descartado el decompilador:
              ¿ni una URL en el DEX?          ─▶ strings cifrados     §9.3
              ¿switch gigante en todos lados? ─▶ flujo aplanado       §9.3
              ¿DEX minúsculo + .so grande?    ─▶ packer: es el stub   §9.3
              ¿nombres a.b.c?                 ─▶ ofuscación normal, no un fallo  §9.3
                                                 (el mapping.txt no viaja en el APK)

Fuentes

Todas las URL se consultaron el 12 de agosto de 2026, salvo donde se indica otra fecha. Los ficheros de AOSP de las fuentes 1 y 2 son de la etiqueta android-17.0.0_r1, se consultaron el 25 de septiembre de 2026 y cuelgan de https://android.googlesource.com/platform/frameworks/base/+/refs/tags/android-17.0.0_r1/, descargados con ?format=TEXT y decodificados.

  1. AOSP — core/java/android/content/pm/PackageManager.java · https://android.googlesource.com/platform/frameworks/base/+/refs/tags/android-17.0.0_r1/core/java/android/content/pm/PackageManager.java · íntegras las tablas de «§2.2» y «§2.4» con sus valores y descripciones, la marca @hide de todos, y la comprobación de que INSTALL_FAILED_MULTI_ARCH_NOT_SUPPORTED no existe. Los valores y las descripciones de −8, −9, −13, −22, −111 y −112 se comprobaron el 18 de octubre de 2026 (fuentes 12 y 15).

  2. AOSP — los cinco ficheros que producen los errores de «§2.3» y «§2.4», bajo la misma raíz: core/java/android/content/pm/parsing/ApkLiteParseUtils.java (sitios y mensajes de NOT_APK, BAD_MANIFEST, UNEXPECTED_EXCEPTION y MANIFEST_MALFORMED); core/java/android/content/pm/parsing/FrameworkParsingPackageUtils.java (las reglas de validateName() y el límite de 223 caracteres); core/java/com/android/internal/pm/pkg/parsing/ParsingPackageUtils.java junto a core/java/android/content/pm/parsing/result/ParseInput.java (el error diferido RESOURCES_ARSC_COMPRESSED, su ChangeId 132742131 con @EnabledAfter(targetSdkVersion = Q) y el texto del error); core/java/android/util/apk/ApkSignatureVerifier.java (NO_CERTIFICATES e INCONSISTENT_CERTIFICATES); y services/core/java/com/android/server/pm/ con PackageInstallerSession.java, InstallPackageHelper.java y PackageManagerServiceUtils.java (MISSING_SPLIT, UPDATE_INCOMPATIBLE y VERSION_DOWNGRADE, incluido el TODO del propio AOSP sobre la reutilización del segundo).

  3. jadx — código fuente, commit e738a26 del 5 de agosto de 2026, repositorio clonado y leído directamente: codegen/MethodGen.java, codegen/utils/CodeGenUtils.java, dex/attributes/nodes/JadxCommentsAttr.java, dex/nodes/ClassNode.java, utils/ErrorsCounter.java y jadx-cli/…/JadxCLI.java · https://github.com/skylot/jadx/blob/e738a26/jadx-core/src/main/java/jadx/core/codegen/MethodGen.java#L114-L127, https://github.com/skylot/jadx/blob/e738a26/jadx-core/src/main/java/jadx/core/codegen/MethodGen.java#L365-L373 y https://github.com/skylot/jadx/blob/e738a26/jadx-core/src/main/java/jadx/core/codegen/MethodGen.java#L381-L385, comprobados el 18 de octubre de 2026 · todos los literales de «§6.2 · Los marcadores reales, con su fichero», el mecanismo de tres niveles de «§6.3 · Code decompiled incorrectly — el que hay que tomarse en serio», el comportamiento de clase fallida de «§6.4 · Un fichero .java cuyo contenido entero es una traza de pila» y los códigos de salida de «§6.6 · Los códigos de salida, que sí sirven para automatizar».

  4. jadx — issues cerradas #2676 y #2744 · https://github.com/skylot/jadx/issues/2676 · las explicaciones de causa raíz de skylot sobre el consumo de memoria por error-por-instrucción y el desbordamiento de pila en la inferencia de tipos («§6.5 · Salida vacía, cuelgues y OutOfMemoryError»), citadas literalmente.

  5. Apktool — código fuente, commit 79b6338 del 10 de agosto de 2026 (rama main, 3.x), repositorio clonado · https://github.com/iBotPeaches/Apktool/tree/79b6338/brut.apktool/apktool-lib/src/main/java/brut/androlib/exceptions y https://github.com/iBotPeaches/Apktool/blob/79b6338/brut.j.util/src/main/java/brut/util/OS.java, comprobados el 18 de octubre de 2026 · la tabla de «§5.2 · Las excepciones de brut.androlib (3.x)», el mensaje Execution failed (exit code = …) de «§5.3 · Fallos de reconstrucción por aapt2», el uso de --legacy, Legacy aapt is no longer supported. y la comprobación por inspección de que apktool no alinea («§5.4 · Lo que apktool no hace, y hay que saber»).

  6. Apktool — tags v2.7.0 y v2.9.3 · https://raw.githubusercontent.com/iBotPeaches/Apktool/v2.7.0/brut.apktool/apktool-lib/src/main/java/brut/androlib/err/CantFindFrameworkResException.java · las cadenas 2.x de «§5.1 · El aviso de versión, que es la mitad del problema».

  7. Apktool — issues cerradas #3036, #2989, #2824, #2836, #3199 y #3298 · https://github.com/iBotPeaches/Apktool/issues/3036 · las explicaciones de causa raíz de iBotPeaches sobre tamaños de chunk mentirosos, entradas duplicadas y tablas sparse («§5.2», «§5.3»). La ausencia de --force-manual-size se verificó sobre los 2.376 commits de todas las ramas y sobre https://apktool.org/docs/cli-parameters/.

  8. Apktool — FAQ oficial · https://apktool.org/docs/faq/ · las citas literales de «§5.4 · Lo que apktool no hace, y hay que saber».

  9. Ejecuciones locales sobre el muestrario — hechas el 12 de agosto de 2026 y repetidas el 31 de octubre de 2026 con build-tools 37.0.0 (apksigner 0.9, zipalign, aapt2 2.20-15087165, dexdump) y OpenJDK 21.0.10, sobre copias de la calculadora de Fossify 1.4.0 de F-Droid (org.fossify.math, versionCode 10, el mismo fichero que org.fossify.calculator_1.4.0.apk de la descarga anterior) y de las piezas de Photomath, com.dgca.gov.kw, Keep, Telegram, dudeofx.eval 102 y com.programminghoch10.AntiBrightnessChange 60 que se citan en cada sección. Los mensajes marcados (reproducido) de «§2.3», «§3.2» a «§3.5», «§4.1», «§4.2» y «§8.1» a «§8.4 · DEX con checksum inválido (reproducido)» salen de aquí o de la primera pasada, que usaba el mismo fichero. Los de «§2.5 · Lo que responde adb install, reproducido» son de otra ejecución: un emulador Android 14 el 25 de septiembre de 2026. La ejecución con apktool y jadx («§5» y «§6») es de octubre de 2026, sobre una submuestra de 112 piezas con apktool 3.0.3, jadx 1.5.6, baksmali y smali 3.0.7, y un tope de 900 s por herramienta. En ningún momento se ha escrito en el muestrario.

  10. AOSP — etiqueta android-17.0.0_r1, bajo https://android.googlesource.com/platform/frameworks/base/+/refs/tags/android-17.0.0_r1/ · Leído el 25 de septiembre de 2026 en android-16.0.0_r1 y comprobado en android-17.0.0_r1 el 18 de octubre de 2026. De services/core/java/com/android/server/pm/PackageManagerServiceUtils.java:528-530 (verifySignatures()) e InstallPackageHelper.java:1907 (preparePackage()) sale el mensaje signatures do not match newer version; ignoring! («sección 2.4 · Fallos de instalación»); de PackageInstallerSession.java:4776-4791 (validateApkInstallLocked()) y core/java/android/content/pm/parsing/ApkLiteParseUtils.java:445-446, que los atributos de split sobrantes dan Full install must include a base package o Missing split for y no MANIFEST_MALFORMED (secciones «2.3» y «10»); y de core/jni/android_content_res_ApkAssets.cpp:540 junto a parseApkLiteInner(), que un AXML corrupto da UNEXPECTED_EXCEPTION («sección 8.3 · AXML malformado (reproducido)»).

  11. Ejecución local — 25 de septiembre de 2026, unzip -l sobre la calculadora de Fossify 1.4.0 (org.fossify.math, versionCode 10): lleva 104 entradas en META-INF/ (85 .version de AndroidX, entre otras) y ninguna de firma v1, así que grep META-INF no sirve para detectar la firma («sección 3.2 · Bloque desaparecido frente a contenido modificado (reproducido)»).

  12. AOSP — etiqueta android-17.0.0_r1, la misma raíz de la fuente 10 · Consultado el 18 de octubre de 2026. De core/java/android/content/pm/PackageManager.java:2243, :2292, :2379, :2558 y :2573, los valores y descripciones de −8, −13, −22, −111 y −112; y bajo services/core/java/com/android/server/pm/: resolution/ComponentResolver.java:779-806 e InstallPackageHelper.java:5074-5080 (CONFLICTING_PROVIDER, solo en instalación nueva); InstallPackageHelper.java:1974-1992 (DUPLICATE_PERMISSION); PackageManagerServiceUtils.java:556-573 (SHARED_USER_INCOMPATIBLE); VerificationUtils.java:113-149, VerifyingSession.java:428-432 y PackageInstallerSession.java:3842-3858, con la exención de adb en :3140-3148 y el flag verificationServiceAdb en :3378-3382 (VERIFICATION_FAILURE); InstallPackageHelper.java:737-738 y PackageInstallerService.java:771-773 (USER_RESTRICTED); PackageInstallerSession.java:5548-5553 (el res= de Failed to extract native libraries, «sección 2.5 · Lo que responde adb install, reproducido»); y PackageManagerService.java:576-577 (MIN_INSTALLABLE_TARGET_SDK), que en android-14.0.0_r1 es Build.VERSION_CODES.M (:570) y desde android-15.0.0_r1 depende de Flags.minTargetSdk24() (:565-566).

  13. Behavior changes: all apps (Android 15) — https://developer.android.com/about/versions/15/behavior-changes-all · Consultado el 18 de octubre de 2026. De aquí sale que Android 15 no instala aplicaciones con targetSdkVersion menor que 24, y la opción --bypass-low-target-sdk-block («sección 2.4 · Fallos de instalación»).

  14. AOSP — el flag verification_service_adb en android-17.0.0_r1 — https://android.googlesource.com/platform/frameworks/base/+/refs/tags/android-17.0.0_r1/core/java/android/content/pm/flags.aconfig, https://android.googlesource.com/platform/build/release/+/refs/tags/android-17.0.0_r1/aconfig/cp2a/android.content.pm/verification_service_adb_flag_values.textproto y https://android.googlesource.com/platform/build/+/refs/tags/android-17.0.0_r1/core/build_id.mk · Consultados el 18 de octubre de 2026. De aquí salen la declaración del flag, su valor ENABLED con permiso READ_ONLY en la configuración cp2a y que esa es la de la etiqueta (BUILD_ID=CP2A.260605.016), de la «sección 2.4 · Fallos de instalación».

  15. AOSP — etiqueta android-17.0.0_r1, la misma raíz de la fuente 10 · Consultado el 18 de octubre de 2026. De core/java/android/content/pm/PackageManager.java:2245-2252, el valor y la descripción de −9, y de :2177-2724, las 46 constantes INSTALL_FAILED_* («sección 2.4 · Fallos de instalación»); de core/java/com/android/internal/pm/pkg/parsing/ParsingPackageUtils.java:2863-2890 y services/core/java/com/android/server/pm/SharedLibrariesImpl.java:90-98, :930-984 y :1009-1057, cuándo y con qué mensaje se lanza («sección 2.4 · Fallos de instalación»); de core/java/android/util/apk/ApkSignatureVerifier.java:83-86, :166-241, :341-343, :385-387 y :414-416, con core/java/android/content/pm/parsing/ApkLiteParseUtils.java:379-387, que al instalar la firma se verifica entera, el orden de los esquemas y el mensaje de un bloque que no verifica (secciones «2.3» y «3.2»); de core/jni/com_android_internal_content_NativeLibraryHelper.cpp:17, :308-342 y :546-556 y core/java/com/android/internal/content/NativeLibraryHelper.java:104-105, la etiqueta, los mensajes y las condiciones del res=-2 («sección 2.5 · Lo que responde adb install, reproducido»); y de services/core/java/com/android/server/pm/PackageManagerService.java:348 y PackageInstallerSession.java:265, :6515 y :6634, las etiquetas de logcat y las líneas del motivo («sección 2.1 · De dónde salen y cómo se leen»).

  16. logcat, etiqueta android-17.0.0_r1 — https://android.googlesource.com/platform/system/logging/+/refs/tags/android-17.0.0_r1/logcat/logcat.cpp · Consultado el 18 de octubre de 2026. De :382-385 y :434-459 salen -c, -d, -s y que una etiqueta sin prioridad sale con todos sus niveles («sección 2.1 · De dónde salen y cómo se leen»).

  17. apksig, 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 src/main/java/com/android/apksig/Constants.java, en el mismo árbol · Consultado el 18 de octubre de 2026. De ApkSigner.java:1418-1419 y Constants.java:47 sale que apksigner alinea por defecto las .so a 16.384 bytes («sección 3.2 · Bloque desaparecido frente a contenido modificado (reproducido)»).

  18. Ejecuciones locales sobre APK sintéticos — 18 de octubre de 2026, build-tools 37.0.0 (zipalign, apksigner 0.9, d8), baksmali 3.0.7, OpenJDK 21.0.10 y Python 3.12.10. Un APK con tres .so stored sin alinear, firmado con apksigner y pasado después por zipalign -f -P 16 4, pasa de 57.773 a 52.585 bytes —el bloque, de 4.096 bytes, empezaba en un múltiplo de 4.096 tras 1.092 bytes de relleno detrás de la última entrada—; firmado con --alignment-preserved true, de 25.005 a 52.585; en los dos casos el magic APK Sig Block 42 está antes y no después («sección 3.2 · Bloque desaparecido frente a contenido modificado (reproducido)»). baksmali d --register-info ALL sin -b sale con 255 y Error occurred while loading class path files. Aborting.; con -b sobre el android.jar de platforms/android-36 pasado por d8, escribe el smali con el tipo de cada registro («sección 9.5 · java.lang.VerifyError tras editar smali (fuente)»).

  19. Medidas sobre el muestrario — descrito en «El muestrario».