Diagnóstico de fallos
1. Cómo usar este catálogo
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 installen un emulador Android 14arm64-v8a, conAPKde prueba construidos conaapt2y firmados conapksigner, el 25 de septiembre de 2026.INSTALL_FAILED_NO_MATCHING_ABISlo 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 etiquetaandroid-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:
- Se olvidó firmar. apktool y APKEditor producen
APKsin firma por diseño, ybundletool build-apkssin--kstambién, si no hay~/.android/debug.keystore. - Se firmó solo con v1 teniendo un
targetSdkque exige v2 («§3.3 · Target SDK version 36 requires a minimum of signature scheme v2 (reproducido)»). - Se pasó
zipaligndespués de firmar («§4.2 · La trampa mayor: zipalign después de firmar (reproducido)»). - Se alteró el contenido después de firmar, que
apksignerllamaCHUNKED_SHA256 digest mismatch(«§3.2 · Bloque desaparecido frente a contenido modificado (reproducido)») y que llega al instalador con ese cuarto mensaje.
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_INCOMPATIBLEafecta a pocosAPK, pero a esos casi seguro.sharedUserIdes raro: como mucho un 4 % de las apps, según la fuente. Por ejemplo, la base de Word 16.0.20611.20014 ycom.termux.boot1000 de F-Droid. -
INSTALL_FAILED_MISSING_SHARED_LIBRARYdepende del atributorequired, 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 atargetSdk31 o más, es bastante menos frecuente. -
testOnly="true"no aparece en ninguna app.INSTALL_FAILED_TEST_ONLYsolo se encuentra conAPKde 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
APKsin firmar no dice que le falte la firma.Attempt to get length of null arrayes el texto de una excepción interna, no un mensaje pensado para nadie. - Las dos entradas duplicadas no llegan a la firma. Las rechaza
libziparchiveal abrir el fichero, y lo que queda enlogcatesZip: Found duplicate entry AndroidManifest.xmlyFailed to open APK '…': Duplicate entries in archive. - Con el
.idsigde otroAPK, 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 0yFailed to open APK '…': I/O error. La verificación v4 que describe el código, y que acabaría enNO_CERTIFICATES, no llega a ejecutarse. Sin--incremental, el.idsigse ignora y elAPKse instala por v2 o v3. adb installsin-rtambién reemplaza. Instalar dos veces el mismoAPKrespondeSuccesslas 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=-113esINSTALL_FAILED_NO_MATCHING_ABIS: no hay enlib/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=-2esINSTALL_FAILED_INVALID_APK, y lo que pasó lo dicelogcatcon la etiquetaNativeLibraryHelper(«§2.1 · De dónde salen y cómo se leen»). ConextractNativeLibs="false", o hay una.socomprimida (Library '…' is compressed - will not be able to open it directly from apk, un rechazo incondicional) o unastoredcuyo 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
minSdky sin v1, que danMissing META-INF/MANIFEST.MF. Son de seis apps (com.mi.globalbrowsery cinco de Microsoft Office) y todos verifican con el--min-sdk-versionde su base. Un ejemplo: elsplit_lenssampledoc.apkde Office Hub 16.0.20611.20024. - Bloques v3.2 («hybrid signers») que la Java de
apksignerno puede leer porque no trae ML-DSA; con Java 25.0.5 verifican. Un ejemplo:split_config.xxhdpi.apkdecom.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 mismatches contenido modificado —«alguien tocó el fichero»—;Signature stripped?yMissing META-INF/MANIFEST.MFson 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.loadLibraryfalla condlopen failed: empty/missing DT_HASH/DT_GNU_HASH in "…" (new hash type from the future?); con unp_alignde 8 KiB, peor: carga y muere en la primera llamada conFatal signal 4 (SIGILL). - Android 16: carga en el modo de compatibilidad, con un aviso al usuario y
pageSizeCompat=4endumpsys package. Solo si el manifiesto lo desactiva, o si elp_alignno 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 azipalign, a alineación de página ni a 16.384. Registra qué entradas vanstoredendoNotCompressy las escribe sin comprimir, pero nunca las alinea:zipalignes estrictamente externo. --copy-originalsolo sirve para v1 (FAQ), y--match-originalimpide reconstruir: la ayuda dice literalmenteKeep files closest to original as possible (prevents rebuild).- Hay
APKque 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:
-
El
android:namede<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) ocom.netease.nis.wrapper.MyApplication(NetEase). -
El
DEXtiene pocas clases: lo que se ve es el stub, no la app. -
Hay una
.soy unassetcon 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.
-
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@hidede todos, y la comprobación de queINSTALL_FAILED_MULTI_ARCH_NOT_SUPPORTEDno 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). -
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 deNOT_APK,BAD_MANIFEST,UNEXPECTED_EXCEPTIONyMANIFEST_MALFORMED);core/java/android/content/pm/parsing/FrameworkParsingPackageUtils.java(las reglas devalidateName()y el límite de 223 caracteres);core/java/com/android/internal/pm/pkg/parsing/ParsingPackageUtils.javajunto acore/java/android/content/pm/parsing/result/ParseInput.java(el error diferidoRESOURCES_ARSC_COMPRESSED, suChangeId 132742131con@EnabledAfter(targetSdkVersion = Q)y el texto del error);core/java/android/util/apk/ApkSignatureVerifier.java(NO_CERTIFICATESeINCONSISTENT_CERTIFICATES); yservices/core/java/com/android/server/pm/conPackageInstallerSession.java,InstallPackageHelper.javayPackageManagerServiceUtils.java(MISSING_SPLIT,UPDATE_INCOMPATIBLEyVERSION_DOWNGRADE, incluido elTODOdel propio AOSP sobre la reutilización del segundo). -
jadx — código fuente, commit
e738a26del 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.javayjadx-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». -
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.
-
Apktool — código fuente, commit
79b6338del 10 de agosto de 2026 (ramamain, 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 mensajeExecution 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»). -
Apktool — tags
v2.7.0yv2.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». -
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-sizese verificó sobre los 2.376 commits de todas las ramas y sobre https://apktool.org/docs/cli-parameters/. -
Apktool — FAQ oficial · https://apktool.org/docs/faq/ · las citas literales de «§5.4 · Lo que apktool no hace, y hay que saber».
-
Ejecuciones locales sobre el muestrario — hechas el 12 de agosto de 2026 y repetidas el 31 de octubre de 2026 con
build-tools37.0.0 (apksigner0.9,zipalign,aapt22.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 queorg.fossify.calculator_1.4.0.apkde la descarga anterior) y de las piezas de Photomath,com.dgca.gov.kw, Keep, Telegram,dudeofx.eval102 ycom.programminghoch10.AntiBrightnessChange60 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 conapktoolyjadx(«§5» y «§6») es de octubre de 2026, sobre una submuestra de 112 piezas con apktool 3.0.3, jadx 1.5.6,baksmaliysmali3.0.7, y un tope de 900 s por herramienta. En ningún momento se ha escrito en el muestrario. -
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 enandroid-16.0.0_r1y comprobado enandroid-17.0.0_r1el 18 de octubre de 2026. Deservices/core/java/com/android/server/pm/PackageManagerServiceUtils.java:528-530(verifySignatures()) eInstallPackageHelper.java:1907(preparePackage()) sale el mensajesignatures do not match newer version; ignoring!(«sección 2.4 · Fallos de instalación»); dePackageInstallerSession.java:4776-4791(validateApkInstallLocked()) ycore/java/android/content/pm/parsing/ApkLiteParseUtils.java:445-446, que los atributos de split sobrantes danFull install must include a base packageoMissing split fory noMANIFEST_MALFORMED(secciones «2.3» y «10»); y decore/jni/android_content_res_ApkAssets.cpp:540junto aparseApkLiteInner(), que unAXMLcorrupto daUNEXPECTED_EXCEPTION(«sección 8.3 · AXML malformado (reproducido)»). -
Ejecución local — 25 de septiembre de 2026,
unzip -lsobre la calculadora de Fossify 1.4.0 (org.fossify.math, versionCode 10): lleva 104 entradas enMETA-INF/(85.versionde AndroidX, entre otras) y ninguna de firma v1, así quegrep META-INFno sirve para detectar la firma («sección 3.2 · Bloque desaparecido frente a contenido modificado (reproducido)»). -
AOSP — etiqueta
android-17.0.0_r1, la misma raíz de la fuente 10 · Consultado el 18 de octubre de 2026. Decore/java/android/content/pm/PackageManager.java:2243,:2292,:2379,:2558y:2573, los valores y descripciones de −8, −13, −22, −111 y −112; y bajoservices/core/java/com/android/server/pm/:resolution/ComponentResolver.java:779-806eInstallPackageHelper.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-432yPackageInstallerSession.java:3842-3858, con la exención deadben:3140-3148y el flagverificationServiceAdben:3378-3382(VERIFICATION_FAILURE);InstallPackageHelper.java:737-738yPackageInstallerService.java:771-773(USER_RESTRICTED);PackageInstallerSession.java:5548-5553(elres=deFailed to extract native libraries, «sección 2.5 · Lo que responde adb install, reproducido»); yPackageManagerService.java:576-577(MIN_INSTALLABLE_TARGET_SDK), que enandroid-14.0.0_r1esBuild.VERSION_CODES.M(:570) y desdeandroid-15.0.0_r1depende deFlags.minTargetSdk24()(:565-566). -
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
targetSdkVersionmenor que 24, y la opción--bypass-low-target-sdk-block(«sección 2.4 · Fallos de instalación»). -
AOSP — el flag
verification_service_adbenandroid-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 valorENABLEDcon permisoREAD_ONLYen la configuracióncp2ay que esa es la de la etiqueta (BUILD_ID=CP2A.260605.016), de la «sección 2.4 · Fallos de instalación». -
AOSP — etiqueta
android-17.0.0_r1, la misma raíz de la fuente 10 · Consultado el 18 de octubre de 2026. Decore/java/android/content/pm/PackageManager.java:2245-2252, el valor y la descripción de −9, y de:2177-2724, las 46 constantesINSTALL_FAILED_*(«sección 2.4 · Fallos de instalación»); decore/java/com/android/internal/pm/pkg/parsing/ParsingPackageUtils.java:2863-2890yservices/core/java/com/android/server/pm/SharedLibrariesImpl.java:90-98,:930-984y:1009-1057, cuándo y con qué mensaje se lanza («sección 2.4 · Fallos de instalación»); decore/java/android/util/apk/ApkSignatureVerifier.java:83-86,:166-241,:341-343,:385-387y:414-416, concore/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»); decore/jni/com_android_internal_content_NativeLibraryHelper.cpp:17,:308-342y:546-556ycore/java/com/android/internal/content/NativeLibraryHelper.java:104-105, la etiqueta, los mensajes y las condiciones delres=-2(«sección 2.5 · Lo que responde adb install, reproducido»); y deservices/core/java/com/android/server/pm/PackageManagerService.java:348yPackageInstallerSession.java:265,:6515y:6634, las etiquetas delogcaty las líneas del motivo («sección 2.1 · De dónde salen y cómo se leen»). -
logcat, etiquetaandroid-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-385y:434-459salen-c,-d,-sy que una etiqueta sin prioridad sale con todos sus niveles («sección 2.1 · De dónde salen y cómo se leen»). -
apksig, etiquetaandroid-17.0.0_r1— https://android.googlesource.com/platform/tools/apksig/+/refs/tags/android-17.0.0_r1/src/main/java/com/android/apksig/ApkSigner.java ysrc/main/java/com/android/apksig/Constants.java, en el mismo árbol · Consultado el 18 de octubre de 2026. DeApkSigner.java:1418-1419yConstants.java:47sale queapksigneralinea por defecto las.soa 16.384 bytes («sección 3.2 · Bloque desaparecido frente a contenido modificado (reproducido)»). -
Ejecuciones locales sobre
APKsintéticos — 18 de octubre de 2026,build-tools37.0.0 (zipalign,apksigner0.9,d8),baksmali3.0.7, OpenJDK 21.0.10 y Python 3.12.10. UnAPKcon tres.sostoredsin alinear, firmado conapksignery pasado después porzipalign -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 magicAPK Sig Block 42está antes y no después («sección 3.2 · Bloque desaparecido frente a contenido modificado (reproducido)»).baksmali d --register-info ALLsin-bsale con 255 yError occurred while loading class path files. Aborting.; con-bsobre elandroid.jardeplatforms/android-36pasado pord8, escribe elsmalicon el tipo de cada registro («sección 9.5 · java.lang.VerifyError tras editar smali (fuente)»). -
Medidas sobre el muestrario — descrito en «El muestrario».