Desensambladores smali
Antes conviene leer «Bytecode Dalvik»
1. Qué es y por qué existe
smali es una sintaxis de texto para el bytecode Dalvik, y también el nombre del ensamblador que
la convierte en DEX. Su inverso, el desensamblador, se llama baksmali. Entre los dos forman el
único camino de ida y vuelta que existe para modificar el código de una aplicación de la que no
tienes el fuente.
La diferencia con el documento anterior es de naturaleza, no de grado.
«Decompilar a Java» es reconstruir: se adivina qué texto Java
habría producido esas instrucciones, y la respuesta puede ser buena, mala o silenciosamente falsa.
Desensamblar a smali es transcribir: cada instrucción del DEX se escribe como una línea de
texto, con sus registros y sus operandos, sin interpretar nada.
De ahí la propiedad que define este documento entero:
El
smalies fiel. El Java es una hipótesis.
Un método puede fallar al decompilar; no puede fallar al desensamblar, salvo que el DEX esté
corrupto. Si el fichero es válido, hay smali. Ese es el suelo sobre el que se apoya todo el
trabajo de modificación.
La medida lo respalda, con un límite. baksmali 3.0.7 desensambló los 564 DEX de una
submuestra de 117 piezas sin ningún error ni aviso, y con un .smali por clase. (Aquí un DEX es
cada classes*.dex de la raíz de la pieza base, o de la única pieza, de una app.) Salió igual de
bien en los 13 DEX de 5 apps con protector que elegimos a propósito. El límite está ahí: en esas
apps el desensamblado no falla, pero solo enseña el cargador («sección 8.5 · Lo que el smali no enseña: apps con protector»). Un ejemplo: com.gtgj.view 489, del mercado chino, trae un
classes.dex de 167.529.220 bytes con solo 5 clases, y baksmali escribe los 5 .smali en 0,56
segundos.
Aquí vemos la sintaxis, las herramientas y, lo que más duele en la práctica, qué se puede editar a este nivel y qué no. El juego de instrucciones subyacente, con sus opcodes, formatos y descriptores, está en «Bytecode Dalvik» y no se repite aquí.
2. Cuándo hay que bajar a smali obligatoriamente
Cuatro situaciones. Fuera de ellas, leer Java es más cómodo y basta.
1. Cuando hay que modificar y reempaquetar. No existe ninguna herramienta que recompile a DEX
el Java que salió de un decompilador. Ese Java no compila en general y nunca sirve para
reempaquetar: le faltan tipos, tiene referencias sintéticas, y la «sección 2 de
Decompiladores a Java · Qué se pierde, y por qué no vuelve» explica por qué. El smali, en cambio, vuelve
a DEX con las mismas instrucciones y los mismos registros, aunque no byte a byte («sección 6.4 · El viaje de ida y vuelta, medido»).
Toda modificación real de una aplicación pasa por aquí.
2. Cuando el decompilador ha fallado. Si jadx escribió JADX ERROR en el método o lo marcó con
Code decompiled incorrectly, el smali es lo único que queda. Y es suficiente: dice exactamente
lo que la máquina va a ejecutar.
3. Cuando hay que verificar una afirmación. Un informe que dice «esta aplicación envía el IMEI
a este dominio» se sostiene sobre lo que el smali muestra, no sobre lo que el Java sugiere. En
cualquier trabajo con consecuencias (auditoría, peritaje, análisis de malware) la cita es del
desensamblado.
4. Cuando el comportamiento depende de un detalle que el Java no muestra. Orden de evaluación,
aritmética de enteros con desbordamiento, comparaciones de referencias frente a equals, el tipo
exacto de una constante. El decompilador normaliza estas cosas; el desensamblador no puede.
Dos casos en los que el smali no basta. El primero: la lógica de la app no está en el DEX.
Entonces el smali solo enseña el envoltorio de Android que carga el resto. Pasa con Flutter, cuyo
código Dart está en libapp.so; con Unity, cuya lógica está en libil2cpp.so y en sus ficheros de
datos; y con React Native, cuyo JavaScript está en assets/index.android.bundle. Llevar uno de
estos marcos no quiere decir que toda la app esté hecha con él. En el
«muestrario» llevan algún marco de este tipo (Flutter,
Unity, React Native, Cocos2d-x, Capacitor, Cordova, Godot…) en torno al 17 % de las apps de
F-Droid, el 16 % de IzzyOnDroid, el 36 % de las más instaladas de Google Play, el 60 % del sorteo
de Google Play y 67 de cada 100 del mercado chino. Un ejemplo: cc.narumi.chaldea.fdroid 991, de
F-Droid y hecha con Flutter, tiene 7.369 clases en classes.dex y 129 en classes2.dex, pero casi
todo lo suyo está en lib/arm64-v8a/libapp.so, de 26.608.528 bytes. El segundo caso son las apps
con protector, cuyo DEX visible es un cargador («sección 8.5 · Lo que el smali no enseña: apps con protector»).
3. La sintaxis, directiva a directiva
Un fichero .smali describe una clase, y su nombre y ruta reproducen el nombre completo de la
clase: com/ejemplo/Utilidades.smali.
3.1 Directivas de clase
| Directiva | Qué declara |
|---|---|
.class |
Modificadores y descriptor de tipo de la clase. Siempre la primera línea |
.super |
Descriptor de la superclase |
.implements |
Una interfaz implementada. Se repite una vez por interfaz |
.source |
Nombre del fichero fuente que el DEX guarda para la clase. Muchas veces no es un nombre real: en las apps compiladas con R8 suele ser SourceFile o una marca r8-map-id-… |
.class public final Lcom/ejemplo/Utilidades;
.super Ljava/lang/Object;
.implements Ljava/io/Serializable;
.source "Utilidades.java"
En las apps reales, el valor de .source depende del compilador. baksmali lo escribe a partir
del campo source_file_idx de la clase en el DEX. No esperes encontrar el nombre real: según la
fuente, es lo que domina en algo menos de la mitad de las apps (el 44 % en F-Droid) o en algo más
(el 59 % en el sorteo de Google Play). En las más instaladas de Google Play y en IzzyOnDroid ganan
SourceFile y r8-map-id-…, que juntos suman más de la mitad. El resto tiene otros valores
(clase sin atributo, vacío o sintético).
Un ejemplo en un solo DEX: en classes.dex de Droid-ify 0.7.8, 6.320 de las 6.456 clases llevan
.source "r8-map-id-ae06e847…" (97,9 %) y las otras 136 no llevan .source. Lo cuentas con
grep -rl '^\.source "r8-map-id' smali/ | wc -l sobre el árbol que escribe baksmali.
Los tipos se escriben con descriptores, no con nombres de Java: I es int, Z es boolean,
[I es int[], Ljava/lang/String; es String. La tabla completa está en la «sección 7 de
Formato DEX · Descriptores de tipo y shorty».
3.2 Directivas de campo
| Directiva | Qué declara |
|---|---|
.field |
Un campo: modificadores, nombre, :, descriptor de tipo y valor inicial si es constante |
.field private static final MAX:I = 0x64
.field private nombre:Ljava/lang/String;
El valor inicial de un campo sale de la lista de valores iniciales de la clase (static_values en
el DEX). Lo lleva todo campo static final con una constante, y también algunos campos static
que no son final. Los campos de instancia no llevan valor inicial en el DEX: se inicializan en
<init>. Los demás campos estáticos se inicializan en <clinit>, y ahí es donde hay que
buscarlos.
Un ejemplo con el classes.dex de Droid-ify 0.7.8. Guarda valor inicial para 211 campos static:
39 sin final (9 con un valor distinto del de por defecto y 30 con el de por defecto) y 172 con
final (26 y 146). En coil3/util/FileSystemsKt.smali se lee, por ejemplo,
.field public static canvas:Landroidx/compose/ui/graphics/AndroidCanvas; = null. Es el recuento
completo de un solo DEX, no de una muestra. De esos valores por defecto, smali quita 24 al
reensamblar («sección 6.4 · El viaje de ida y vuelta, medido»).
3.3 Directivas de método
| Directiva | Qué declara |
|---|---|
.method … .end method |
Delimitan el método: modificadores, nombre, firma |
.registers |
Total de registros del método |
.locals |
Registros no dedicados a parámetros. Alternativa a .registers |
.param |
Nombre y anotaciones de un parámetro |
.end param |
Cierra un .param que lleva anotaciones dentro |
.line |
Número de línea del fuente original, del debug_info |
.local |
Desde ese punto, el registro guarda una variable local con ese nombre, tipo y, opcionalmente, firma genérica: .local v0, "restante":I. Sale del debug_info |
.end local |
Fin del ámbito de la variable de ese registro |
.restart local |
La variable de ese registro vuelve a estar viva tras un .end local |
.prologue |
Fin del preámbulo del método. baksmali la escribe si el DEX trae esa marca. La ponían compiladores antiguos como dx; con D8 y R8 casi no aparece |
.annotation … .end annotation |
Una anotación sobre la clase, campo, método o parámetro |
.subannotation … .end subannotation |
Una anotación anidada, como valor de un elemento de otra |
.enum |
Un valor enum como elemento de anotación: .enum Lcom/ejemplo/Modo;->RAPIDO:Lcom/ejemplo/Modo; |
.catch |
Un bloque try/catch sobre un tipo concreto de excepción |
.catchall |
Un bloque try/finally: captura cualquier excepción |
.packed-switch … .end packed-switch |
Tabla de saltos de un switch con valores contiguos |
.sparse-switch … .end sparse-switch |
Tabla de saltos de un switch con valores dispersos |
.array-data … .end array-data |
Datos literales de un array inicializado |
Que .prologue aparezca o no depende del compilador que hizo el DEX, no de la versión de
baksmali. Son dos ejemplos, no una proporción. org.droidtr.termbin 1, de F-Droid, tiene un DEX
035 sin marcador de D8 ni de R8, y sus 4 ficheros .smali llevan 12 líneas .prologue en total.
El classes.dex y el classes2.dex de Droid-ify 0.7.8 (compilado con R8) tienen 0 en sus 7.015
.smali. Se cuenta con grep -r '^ *\.prologue' smali/ | wc -l.
Las etiquetas son identificadores que empiezan por dos puntos, y los dos puntos forman parte
del identificador: se escriben igual en la definición que en la referencia (:cond_9, :goto_1e,
:try_start_0, :array_2c). Si los omites al referenciar, no ensambla: smali responde
missing COLON at 'cond_9'. La definición ocupa una línea propia; la referencia va como operando
de la instrucción o de la directiva. baksmali las genera con un prefijo según su uso y el número
en hexadecimal de la dirección de bytecode a la que apuntan, no correlativo: :cond_9 es el
destino que está en el offset 0x9 del método. Con --sequential-labels pasan a numerarse _0,
_1, _2. Son locales al método.
.catch referencia dos etiquetas de rango y una de destino:
:try_start_0
invoke-static {}, Lcom/ejemplo/Red;->conectar()V
:try_end_0
.catch Ljava/io/IOException; {:try_start_0 .. :try_end_0} :catch_0
3.4 v frente a p
Dentro de un método hay un único banco de registros, numerados desde v0. Los parámetros ocupan
siempre los últimos, y baksmali les da un nombre alternativo con prefijo p para que no haya que
contar:
- En un método de instancia,
p0es siemprethis,p1el primer parámetro declarado,p2el segundo… - En un método estático,
p0es el primer parámetro declarado. - Los tipos anchos (
longydouble) ocupan dos registros consecutivos. Sip1es unlong, el siguiente parámetro esp3, nop2.
p0 y v1 pueden ser el mismo registro físico. La notación p es azúcar de baksmali, no una
categoría distinta de almacenamiento. La «sección 5 · La misma clase en smali, comentada» lo demuestra sobre código real.
3.5 .registers frente a .locals: donde se equivoca todo el mundo
Las dos directivas declaran lo mismo con aritmética distinta, y solo puede aparecer una por método.
.registers N N = total de registros del método, parámetros incluidos
.locals M M = registros que NO son parámetros
N = M + (registros de parámetros)
Los «registros de parámetros» son el campo ins_size del code_item: el número de registros que
ocupan los argumentos entrantes, contando this en los métodos de instancia y contando dos por
cada long o double.
| Método | Parámetros | ins_size |
Si .locals 3 |
Equivale a |
|---|---|---|---|---|
static void f() |
ninguno | 0 | .locals 3 |
.registers 3 |
void f() (instancia) |
this |
1 | .locals 3 |
.registers 4 |
void f(int, int) (instancia) |
this, 2 int |
3 | .locals 3 |
.registers 6 |
static void f(long, Object) |
1 long, 1 ref | 3 | .locals 3 |
.registers 6 |
void f(long, boolean) (instancia) |
this, long, bool |
4 | .locals 3 |
.registers 7 |
El error clásico, y el motivo de este apartado: necesitas un registro más para tu parche, ves
.locals 2 y lo cambias a .locals 3 pensando que has añadido un registro al final. Lo que has
hecho es insertar un registro: como los parámetros viven al final del banco, subir el número de
locales desplaza todos los p hacia arriba. Si el método tenía .locals 2 y tres registros de
parámetros, p0 era v2; con .locals 3 pasa a ser v3. Todas las referencias explícitas a
v2, v3 y v4 que hubiera en el cuerpo apuntan ahora a otra cosa.
Como baksmali escribe los parámetros con notación p, el desplazamiento es transparente para
ellos, y por eso el error pasa desapercibido hasta que revienta. Lo que se rompe son las
referencias que usan la notación v sobre registros que resultaban ser parámetros, y el código que
se haya copiado de otro método.
Regla práctica: subir .locals es correcto y es la forma normal de hacer sitio, siempre que el
método esté escrito íntegramente en notación p para los parámetros. Mezclar v y p para el
mismo registro es lo que mata.
Hay un segundo límite, más duro: muchas instrucciones solo codifican registros de 4 bits, o sea
v0 a v15. Un método que ya usa dieciséis registros no admite uno más sin reescribir las
instrucciones afectadas a sus variantes /from16 o /16. La «sección 3.2 de
Bytecode Dalvik · Por qué existen las variantes /from16, /16 y /range» explica esas variantes.
Llegar a ese límite no es raro. Casi todos los DEX, entre el 90 % y el 98 % según la fuente,
tienen algún método con más de 16 registros. Y entre el 10 % y el 17 % tiene alguno con más de
256, donde ni /from16 basta.
El método más grande de F-Droid tiene 2.578 registros: está en el classes.dex de
com.raulshma.lenscast 1062. Pero la mayoría de los métodos es pequeña. En el classes.dex de
Droid-ify 0.7.8, de 30.460 métodos con código, 26.380 (87 %) usan 8 registros o menos, 3.014 usan
de 9 a 16 y 1.066 usan más de 16. El techo de 4 bits no afecta a casi todos los métodos, pero
cualquier parche a un método grande se lo encontrará.
3.6 Las instrucciones que más verás
El Dalvik tiene más de 200 instrucciones, pero para empezar a leer smali bastan unas pocas. Las
quince más frecuentes de cada fuente suman casi dos de cada tres instrucciones de los DEX del
muestrario: el 64 % en F-Droid y el 69 % en las más instaladas de Google Play. La tabla da qué
parte de las instrucciones de cada fuente es cada una, con el orden de F-Droid.
| Instrucción | Qué hace | F-Droid | Play, más instaladas | Mercado chino |
|---|---|---|---|---|
invoke-virtual |
llama a un método de un objeto | 11 % | 11 % | 11 % |
move-result-object |
recoge el objeto que devolvió la llamada anterior | 7 % | 8 % | 9 % |
invoke-static |
llama a un método estático | 6 % | 6 % | 7 % |
const/4 |
pone una constante pequeña (de −8 a 7) en un registro | 5 % | 5 % | 6 % |
iget-object |
lee un campo de un objeto | 5 % | 6 % | 6 % |
move-result |
recoge el número que devolvió la llamada anterior | 5 % | 4 % | 4 % |
invoke-direct |
llama a un constructor o a un método privado | 4 % | 4 % | 4 % |
if-eqz |
salta si el valor es cero o nulo | 3 % | 3 % | 5 % |
goto |
salta a otra etiqueta | 3 % | 3 % | 3 % |
const-string |
carga un texto en un registro | 3 % | 4 % | 4 % |
return-object |
devuelve un objeto | 3 % | 3 % | 2 % |
new-instance |
crea un objeto de una clase | 3 % | 3 % | 3 % |
return-void |
sale del método sin devolver nada | 3 % | 3 % | 4 % |
const/high16 |
carga una constante cuyos 16 bits bajos son cero (típica de los float) |
3 % | fuera de las 25 primeras | fuera de las 25 primeras |
check-cast |
comprueba que un objeto es de un tipo | 3 % | 3 % | 2 % |
Las instrucciones invoke-* y move-result* van casi siempre en pareja: la llamada y la recogida
de lo que devuelve. El detalle de cada una está en
«Bytecode Dalvik».
4. .registers sobre código real
Lo que sigue sí lo hemos ejecutado, con d8 y dexdump de build-tools 37.0.0. dexdump
enseña en crudo los campos del code_item (registers, ins, outs) que baksmali traduce a
directivas, y la «sección 5 · La misma clase en smali, comentada» pone al lado la salida de baksmali 3.0.7 (baksmali --version, el 18
de octubre de 2026) sobre el mismo fichero.
Clase de partida, escrita para este documento:
public class Saldo {
private int saldo;
public int retirar(int cantidad, boolean forzar) {
int restante = this.saldo - cantidad;
if (restante < 0 && !forzar) {
return -1;
}
this.saldo = restante;
return restante;
}
}
BT=~/Library/Android/sdk/build-tools/37.0.0
javac -g Saldo.java
$BT/d8 --release --min-api 24 --output . Saldo.class
$BT/dexdump -d classes.dex
Salida real, recortada al método que interesa:
Virtual methods -
#0 : (in LSaldo;)
name : 'retirar'
type : '(IZ)I'
access : 0x0001 (PUBLIC)
code -
registers : 4
ins : 3
outs : 0
insns size : 12 16-bit code units
000108: |[000108] Saldo.retirar:(IZ)I
000118: 5210 0000 |0000: iget v0, v1, LSaldo;.saldo:I // field@0000
00011c: b120 |0002: sub-int/2addr v0, v2
00011e: 3b00 0600 |0003: if-gez v0, 0009 // +0006
000122: 3903 0400 |0005: if-nez v3, 0009 // +0004
000126: 12f1 |0007: const/4 v1, #int -1 // #ff
000128: 0f01 |0008: return v1
00012a: 5910 0000 |0009: iput v0, v1, LSaldo;.saldo:I // field@0000
00012e: 0f00 |000b: return v0
catches : (none)
positions :
0x0000 line=4
0x0009 line=8
locals :
0x0000 - 0x000c reg=1 this LSaldo;
0x0000 - 0x000c reg=2 (null) I
0x0000 - 0x000c reg=3 (null) Z
Tres lecturas, todas verificables en ese volcado:
La aritmética. registers : 4 e ins : 3 dan .registers 4, y por tanto .locals 1, porque
4 − 3 = 1. Los tres registros de entrada son this, el int y el boolean. El único local es
v0, que sostiene restante.
El mapa v ↔ p. El bloque locals lo confirma sin ambigüedad: reg=1 es this, o sea
p0 es v1; reg=2 es el int, o sea p1 es v2; reg=3 es el boolean, o sea p2 es v3.
Y v0, que no aparece en la lista, es el local.
La prueba de que p no protege nada. En el offset 0007 está const/4 v1, #int -1. v1 es
p0, es decir this. El compilador ha decidido que en esa rama this ya no hace falta y
reutiliza su registro para el valor de retorno, que devuelve en la instrucción siguiente. Un
registro de parámetro es un registro normal: se puede pisar en cuanto su valor deja de ser
necesario, y D8 y R8 lo hacen de forma rutinaria.
Lo mismo se ve en una app real. En el classes.dex de Droid-ify 0.7.8, el método run() de la
clase androidx.appcompat.widget.Toolbar$$ExternalSyntheticLambda0 tiene .registers 2 y un solo
parámetro, this (p0). La instrucción
iget-object p0, p0, Landroidx/appcompat/widget/Toolbar$$ExternalSyntheticLambda0;->f$0:Landroidx/appcompat/widget/Toolbar;
guarda su resultado en p0, o sea, pisa this. Es un ejemplo, no una proporción: no medimos en
cuántos métodos pasa.
Un detalle más, que enlaza con la «sección 2.3 de
Decompiladores a Java · Los nombres de las variables locales»: la clase se compiló con javac -g, así que
el .class llevaba los nombres de los parámetros. En el volcado aparecen como (null). Los ha
borrado d8 --release. Los números de línea sí sobrevivieron (positions conserva line=4 y
line=8), de modo que un DEX puede traer información de depuración parcial: las líneas sí y los
nombres no.
Es lo normal en las apps reales. Entre las apps con algún método con código, el perfil más común
es ese, números de línea sin nombres: del 38 % al 62 % según la fuente. Otro buen trozo, entre el
20 % y el 52 %, trae «posiciones de R8»: los números de .line no son líneas del fuente, sino la
dirección de la instrucción más uno. Conservar nombres de parámetros o de variables es raro: menos
del 3 % en F-Droid, IzzyOnDroid y Google Play, y el 19 % en el mercado chino. Y sin ninguna
información de depuración queda una minoría, entre el 3 % y el 13 %.
En la práctica, fíjate en que en el smali de una app real verás pocos .param y .local, y que
las líneas .line no te llevan al fuente («sección 5.1 · Qué cambia en el smali de una app real»).
Cada app cuenta en un solo perfil. Una app es «sin depuración» si al menos el 90 % de sus métodos
no trae información de depuración; si no, es «con nombres» si al menos el 10 % de las tablas de
depuración distintas nombran parámetros o variables; si no, es «posiciones de R8» si la mitad o más
de los métodos con depuración usan esa numeración; y si no, «líneas, sin nombres». Un ejemplo de
cada perfil intermedio: S.N.A.K.E 1000001, de F-Droid, trae líneas sin nombres, y
InfinityLoop1309.NewPipeEnhanced 110904 trae posiciones de R8.
5. La misma clase en smali, comentada
Generado con
baksmali disassemble3.0.7 sobre el mismoclasses.dexde la «sección 4 · .registers sobre código real», el 13 de agosto de 2026. Los comentarios#son añadidos de este documento; el resto es la salida literal.La etiqueta es
:cond_9porque baksmali las numera con la dirección de bytecode del destino (0009:en el volcado de la «sección 4 · .registers sobre código real»), no correlativamente. Para que sean correlativas hay que pedir--sequential-labels(«sección 6.3 · Opciones principales»).
.class public LSaldo; # clase pública, descriptor de tipo con L…;
.super Ljava/lang/Object; # extiende Object
.source "Saldo.java" # nombre del fuente, del campo source_file_idx de la clase
# instance fields
.field private saldo:I # private int saldo — I es el descriptor de int
# direct methods
.method public constructor <init>()V
.registers 1 # 1 registro total; ins=1 (this) ⇒ .locals 0
.line 1
invoke-direct {p0}, Ljava/lang/Object;-><init>()V # super()
return-void
.end method
# virtual methods
.method public retirar(IZ)I # (int, boolean) → int
.registers 4 # 4 totales, ins=3 ⇒ equivale a .locals 1
# p0 = v1 = this
# p1 = v2 = cantidad (I)
# p2 = v3 = forzar (Z)
# v0 = el único local
.line 4
iget v0, p0, LSaldo;->saldo:I # v0 = this.saldo
# iget lee un campo de instancia int
sub-int/2addr v0, p1 # v0 = v0 - cantidad
# /2addr: destino y primer operando son el mismo
# registro. Ocupa 2 bytes en vez de 4
if-gez v0, :cond_9 # si v0 >= 0, saltar a :cond_9
# es la negación de (restante < 0) del fuente
if-nez p2, :cond_9 # si forzar != 0 (true), saltar a :cond_9
# negación de (!forzar). Los dos saltos juntos
# implementan el && con cortocircuito
const/4 p0, -0x1 # p0 (= v1 = this) pasa a valer -1
# se reutiliza el registro de this: ya no se usa
return p0 # return -1
.line 8
:cond_9 # el 9 es la dirección de bytecode
iput v0, p0, LSaldo;->saldo:I # this.saldo = v0
# ¡ojo! aquí p0 vuelve a ser this: este camino
# no pasó por el const/4 de arriba
return v0 # return restante
.end method
Merece la pena detenerse en el const/4 p0, -0x1. Escrito con notación p, parece que se está
machacando this, y eso es exactamente lo que ocurre, pero solo en la rama que retorna
inmediatamente después, donde this ya no se necesita. La rama de :cond_9 nunca ejecuta esa
instrucción, así que allí p0 sigue siendo this y el iput funciona.
Esta es la clase de razonamiento que hay que hacer para editar smali con seguridad, y la
razón por la que un parche que «solo añade una línea» puede romper un método que parecía no tener
nada que ver.
5.1 Qué cambia en el smali de una app real
La clase Saldo es limpia a propósito. Una app de verdad se ve distinta. Esto es lo que suele
cambiar:
- Nombres cortos. Si la app pasó por R8 con renombrado, las clases y los métodos se llaman
a,b,c… En el «muestrario», con el umbral de que al menos la mitad de los identificadores tenga de 1 a 3 caracteres, están ofuscadas el 44 % de las apps de F-Droid y el 41 % de las más instaladas de Google Play. Las cifras de los demás grupos y el tratamiento de R8 están en la «sección 10 de R8 y ProGuard · Medición propia: la fracción de identificadores cortos». .sourcepoco útil. Suele valerSourceFileo una marcar8-map-id-…, no el nombre del fichero original («sección 3.1 · Directivas de clase»)..lineque no son líneas del fuente. Son posiciones del código: números seguidos que no te llevan a ningún.kt(«sección 4 · .registers sobre código real»).- Kotlin y lambdas. Hay clases
…$$ExternalSyntheticLambdaNen el 37 % de las apps de F-Droid y en el 51 % de las más instaladas de Google Play, y métodos con sufijo$default. En Droid-ify 0.7.8, por ejemplo, el ficherocom/looker/droidify/FallbackIconInterceptor.smalitienelastIndexOf$defaultycopy$default. Esa app compilada con R8 no tiene ninguna llamada aIntrinsics.checkNotNullParametery sí 1.633 aIntrinsics.areEqual: no des por hecho que esas comprobaciones sigan ahí en una app con R8.
Ejemplo real: clase a0.c de acidburn.stims 7, de F-Droid, constructor recortado (la app tiene
2.500 clases):
.class public final La0/c;
.super Ljava/lang/Object;
.source "SourceFile"
# interfaces
.implements La0/a;
# instance fields
.field public final a:F
# direct methods
.method public constructor <init>(F)V
.registers 3
.line 1
invoke-direct {p0}, Ljava/lang/Object;-><init>()V
.line 2
.line 3
.line 4
iput p1, p0, La0/c;->a:F
.line 5
.line 6
const/4 v0, 0x0
.line 7
cmpg-float v0, p1, v0
.line 8
.line 9
if-ltz v0, :cond_11
...
.line 19
.line 20
const-string v0, "The percent should be in the range of [0, 100]"
Los números de .line suben de uno en uno hasta 25 en un método de 13 instrucciones: son
posiciones del código, no líneas de un fichero fuente. Lo que sí se conserva es lo que ayuda a
leer: los tipos, las llamadas y los textos. El ejemplo se repite con
baksmali disassemble classes.dex -o smali/ y leyendo smali/a0/c.smali.
6. baksmali y smali: las herramientas
6.1 El cambio de manos, que conviene conocer
El proyecto lo creó Ben Gruver (JesusFreke) en 2010 y fue la referencia absoluta durante más de
una década. Ese repositorio original, JesusFreke/smali, está hoy archivado: último push el 17
de enero de 2024, 6.631 estrellas, y sin desarrollo.
El proyecto vivo es google/smali, un fork que mantiene Google. Su README lo dice
explícitamente: el original ya no se mantiene activamente y Google se hizo cargo del código para
poder aplicarle los parches que necesitaba, cambiando el espacio de nombres de org.jf a
com.android.tools.smali. La primera release bajo Google fue la 3.0.0, construida sobre la
2.5.2 del original.
Si buscas documentación antigua, te encontrarás con clases org.jf.* y con URLs que ya no llevan a
ninguna parte. Es el mismo software.
6.2 Ficha de google/smali
| Dato | Valor |
|---|---|
| Repositorio | https://github.com/google/smali |
| Licencia | BSD de 3 cláusulas (Ben Gruver, 2010), con partes de AOSP bajo Apache-2.0 |
| Lenguaje | Java |
| Versión estable | 3.0.10, publicada en el Maven de Google el 4 de septiembre de 2026 (consultado el 24 de septiembre de 2026) |
| Último push | 14 de julio de 2026 (consultado el 12 de agosto de 2026) |
| Creado (el fork) | 9 de diciembre de 2022 |
| Tracción | 390 ★ · 67 forks · 24 issues abiertas |
| Archivado | No |
Consultado el 12 de agosto de 2026 vía la API de GitHub. La API reporta la licencia como
NOASSERTION porque el fichero LICENSE no es un texto estándar sin modificar: empieza con «The
majority of smali/baksmali is written and copyrighted by me (Ben Gruver) and released under the
following license», seguido de una BSD de 3 cláusulas, y añade el aviso de Apache-2.0 para el
código procedente de AOSP.
Lectura del mantenimiento: hay actividad reciente en el repositorio (commits en julio de 2026)
y también publicación, aunque no donde se suele mirar. Las versiones salen en el Maven de Google,
como dice el propio README: 3.0.7, 3.0.8 y 3.0.9 en 2024, y 3.0.10 el 4 de septiembre de 2026. En
GitHub Releases solo están hasta la 3.0.7, y releases/latest devuelve la 3.0.6 porque la 3.0.7 no
se marcó como última: si te fías de esa llamada, concluyes que no publica desde 2024. El respaldo
es Google y el componente está integrado en su propia cadena de herramientas, así que el riesgo de
abandono es bajo.
Las salidas de este documento son de la 3.0.7, la de los jars instalados el 13 de agosto de 2026.
Lo repetimos el 18 de octubre de 2026 con los jars 3.0.10 del Maven de Google: baksmali help,
baksmali disassemble --help y smali assemble --help salen idénticos, y el viaje de ida y vuelta
de la «sección 6.4 · El viaje de ida y vuelta, medido» sobre la clase de la «sección 4 · .registers sobre código real» da los mismos ficheros, byte a byte.
El proyecto también publica dexlib2, la biblioteca de lectura y escritura de DEX que hay
debajo. Es la que usan apktool y buena parte del ecosistema; a efectos prácticos, es la
implementación de referencia del formato fuera de AOSP.
6.3 Opciones principales
Todo lo de esta sección procede de baksmali disassemble --help y smali assemble --help
ejecutados el 13 de agosto de 2026 sobre la versión 3.0.7, que es lo único que enumera las
opciones: el README de google/smali no las documenta y remite a --help.
Los subcomandos de baksmali son cinco, y el que casi nadie usa es interesante:
deodex(de,x) - Deodexes an odex/oat file
disassemble(dis,d)- Disassembles a dex file.
dump(du) - Prints an annotated hex dump for the given dex file
help(h) - Shows usage information
list(l) - Lists various objects in a dex file.
deodex es la contrapartida directa de los artefactos que describe
«Artefactos auxiliares»: recupera un DEX
reensamblable a partir del .odex extraído de un dispositivo.
Desensamblar un DEX a un árbol de ficheros .smali:
baksmali disassemble classes.dex -o salida/
Volver a ensamblar:
smali assemble salida/ -o classes.dex
Opciones que importan, con la sintaxis exacta:
| Opción | Efecto |
|---|---|
-o, --output <dir> |
Directorio de salida. Por defecto out |
-a, --api <api> |
Nivel de API. Al ensamblar fija la versión que se escribe en la cabecera del DEX («sección 6.4 · El viaje de ida y vuelta, medido»). Por defecto -1 al desensamblar y 15 al ensamblar |
--parameter-registers <boolean> |
Notación pNN para los parámetros. Activa por defecto; se apaga con --parameter-registers=false |
--sequential-labels |
Etiquetas numeradas correlativamente en vez de por dirección de bytecode |
-l, --use-locals |
Emitir .locals (solo los no parámetros) en lugar de .registers (el total) |
--debug-info <boolean> |
Emitir .line, .local y .param. Activa por defecto; se apaga con --debug-info=false |
-r, --register-info <spec> |
Anotar cada instrucción con el estado de tipos. Acepta ALL, ALLPRE, ALLPOST, ARGS, DEST, MERGE, FULLMERGE |
--code-offsets |
Comentar cada instrucción con su offset dentro del método |
-j, --jobs <n> |
Hilos. Por defecto, tantos como núcleos |
--classes <lista> |
Desensamblar solo esas clases |
Tres correcciones sobre lo que suele circular por ahí. No existe --no-debug-info ni
--no-parameter-registers: las dos opciones son booleanas y se apagan con =false. Y -b no
es la abreviatura de nada relacionado con la depuración, sino de --bootclasspath. Si escribes
-b esperando quitar la información de depuración, se traga el siguiente argumento como si fuera
un classpath.
--register-info es la opción infravalorada del lote: anota en comentarios qué tipo tiene cada
registro en cada punto. Es justo la información que hace falta para no romper la verificación de
bytecode al insertar código, y evita tener que deducirla a mano.
6.4 El viaje de ida y vuelta, medido
La afirmación de que smali es «fiel y uno a uno» se puede comprobar, y conviene hacerlo porque es
lo que justifica editar a este nivel. Lo hicimos sobre el primer DEX de Droid-ify 0.7.8 (de
F-Droid). Mide 6,7 MB (6.665.956 bytes) y tiene 6.456 clases. Las órdenes, con baksmali y smali
3.0.7:
unzip -o -q com.looker.droidify_780.apk 'classes*.dex' -d dex/
baksmali disassemble dex/classes.dex -o smali/
smali assemble -a 23 smali/ -o vuelta.dex
$BT/dexdump -f vuelta.dex | grep -E 'class_defs_size|method_ids_size'
| Fichero | class_defs_size |
method_ids_size |
|---|---|---|
classes.dex original |
6.456 | 37.812 |
vuelta.dex |
6.456 | 37.812 |
La cabecera de este DEX ya es 035, y -a 23 es el valor que la conserva (más abajo se explica
por qué importa). Con el -a por defecto de smali sale lo mismo en esta app, salvo cuatro bytes
de tamaño.
Mismo número de clases y de métodos, y sin un solo aviso por el camino. Eso, por sí solo, prueba
poco: dos DEX con los mismos recuentos pueden tener cuerpos distintos. La prueba estándar es
desensamblar también la vuelta y comparar los dos árboles smali:
baksmali disassemble vuelta.dex -o smali-vuelta/
diff -r smali/ smali-vuelta/
Lo medimos el 18 de octubre de 2026 sobre el classes.dex de la «sección 4 · .registers sobre código real», con baksmali y smali
3.0.7 y smali assemble -a 24 (la API con la que lo generó d8): diff -r no imprime nada y
devuelve 0. Y el DEX reensamblado no es idéntico al original: mide 616 bytes frente a 764,
cmp lo ve distinto desde el byte 9 (la suma de comprobación) y dexdump -f da string_ids_size
10 frente a 11, porque la vuelta pierde la cadena ~~D8{…} que d8 deja como marca en la tabla de
cadenas. El viaje de ida y vuelta es exacto en instrucciones y registros, no byte a byte.
Con una app real pasa algo parecido. En classes.dex de Droid-ify 0.7.8, diff -r encuentra 8
ficheros distintos de 6.456, y solo se diferencian en 24 líneas: 12 valores iniciales = null y 12
= false de campos static, que smali quita al reensamblar. Son los valores por defecto del
campo, así que el programa se comporta igual. classes2.dex, con 559 clases, sale idéntico (0
ficheros distintos de 559). Los DEX reensamblados no son idénticos byte a byte: classes.dex
pasa de 6.665.956 a 8.117.516 bytes (un 21,8 % más) y classes2.dex de 447.292 a 505.172 (un
12,9 % más). También pierden cadenas que son marcas del compilador: classes.dex pasa de 44.043 a
44.042 cadenas (la marca ~~R8{…}) y classes2.dex de 2.011 a 2.009 (~~L8{…} y ~~R8{…}).
baksmali y smali no escriben ningún aviso ni error en estos dos DEX. El tamaño no sigue una
regla: Saldo se encoge de 764 a 616 bytes y Droid-ify crece. Para repetirlo sobre Droid-ify:
for n in classes classes2; do
baksmali disassemble dex/$n.dex -o s_$n
smali assemble -a 23 s_$n -o v_$n.dex
baksmali disassemble v_$n.dex -o sv_$n
diff -r s_$n sv_$n > diff_$n.txt; grep -c '^diff ' diff_$n.txt
done
Un tercer DEX real, classes3.dex de Viber 9.6.5.5, tiene 8.842 clases. Con
smali assemble -a 23 la vuelta tiene un method_id menos (65.147 pasa a 65.146) y el diff -r
entre los dos árboles smali sale vacío. El que falta es el de un método que nada usa:
Lcom/viber/voip/messages/ui/media/GoogleApiMapPreviewActivityV2;->getString, el único method_id
sin ningún uso.
A escala. Repetimos el viaje sobre la submuestra de 117 piezas de la «sección 1 · Qué es y por qué existe» (564 DEX), con
smali assemble -a según la cabecera de cada DEX (reglas más abajo). En todos los grupos salió
bien en el 100 % de los DEX: baksmali sin error y con un .smali por clase, vuelta con las
mismas clases y method_ids, y vuelta con la misma versión de cabecera. La única excepción es
classes3.dex de Viber, el del párrafo anterior, que perdió ese method_id sin uso. En los 13
DEX de las 5 apps con protector pasó igual: ninguna falla. El tamaño de la vuelta, dividido por
el del original, tiene una mediana de 1,00 en F-Droid, IzzyOnDroid y el sorteo de Google Play, de
1,08 en las más instaladas de Google Play, de 1,09 en el mercado chino y de 1,13 en las webs de los
autores, y un máximo de 1,28 (en F-Droid). El viaje es exacto en instrucciones y registros, no byte
a byte.
El desajuste de --api entre los dos programas conviene tenerlo muy presente: baksmali usa -1
(autodetectar) y smali usa 15 por defecto. Y --api fija dos cosas a la vez, no una: el
juego de opcodes que el ensamblador admite y la versión que escribe en la cabecera.
Lo segundo es lo visible. Sobre el mismo classes.dex de la «sección 4 · .registers sobre código real», desensamblado en smali/,
el 18 de octubre de 2026 con smali 3.0.7:
xxd classes.dex | head -1
smali assemble smali/ -o v-defecto.dex # -a 15 implícito
smali assemble -a 24 smali/ -o v-24.dex
smali assemble -a 34 smali/ -o v-34.dex
for f in v-defecto.dex v-24.dex v-34.dex; do xxd $f | head -1; done
00000000: 6465 780a 3033 3700 d26f 3465 6230 b9d7 dex.037..o4eb0..
00000000: 6465 780a 3033 3500 d93a a980 90ce 9faa dex.035..:......
00000000: 6465 780a 3033 3700 e03c 9ccb f7b0 3641 dex.037..<....6A
00000000: 6465 780a 3034 3000 e03c 9ccb f7b0 3641 dex.040..<....6A
El original es 037, la versión que escribe d8 --min-api 24 («sección 4 de
Formato DEX · magic y la tabla de versiones», que explica qué implica cada una). Con el valor
por defecto la vuelta sale 035: baja la versión de la cabecera sin avisar. Con -a 24 la
conserva, y con -a 34 la sube a 040.
No es un caso raro. Más de la mitad de las apps de F-Droid, IzzyOnDroid y Google Play tienen algún
DEX 037 o posterior, que smali assemble sin -a rebajaría a 035; en el mercado chino, el 21 %.
Contando DEX en lugar de apps, la proporción es parecida: el 56 % en F-Droid. Un ejemplo: net.typeblog.shelter 445, de F-Droid,
trae un classes.dex 037 (minSdk 24). Sin -a sale 035; con -a 24 y con -a 25, 037; con
-a 34, 040. En los cuatro casos el código de salida es 0 y no hay ningún aviso. Droid-ify 0.7.8
no sufre el problema porque su DEX ya es 035. Estas cifras no miden el riesgo que se explica a
continuación: un DEX 037 puede no tener ninguna interfaz con método privado.
Bajar a 035 no es inocuo. La 037 es la versión que añadió los métodos default de interfaz
(«the only difference between versions 035 and 037 is the addition of default methods and the
adjustment of the invoke», dice la especificación), y d8 con --min-api 24 o más los deja en el
DEX tal cual, incluidos los métodos privados de interfaz, que llama con invoke-direct. ART no
rechaza el fichero entero: un método default público en un DEX 035 se carga, y
class_linker.cc lo deja dicho en un FIXME (solo los nativos lanzan ClassFormatError). Pero su
verificador solo admite invoke-direct sobre un método de interfaz si el fichero es 037 o
posterior (SupportsDefaultMethods()); en un 035 marca la instrucción como
VERIFY_ERROR_CLASS_CHANGE, que al ejecutarse lanza IncompatibleClassChangeError. Y smali no
avisa: una interfaz con un método privado, compilada con d8 --min-api 24 y reensamblada sin
-a, sale 035 con código de salida 0.
Lo primero es lo que rompe builds. Opcodes.forApi(int) construye la tabla de opcodes por nivel de
API, así que un --api demasiado bajo hace fallar el ensamblado de instrucciones que el DEX
original sí tenía. Medido con smali 3.0.7:
| Instrucción | Ensambla desde |
|---|---|
invoke-polymorphic, invoke-custom |
-a 26 |
const-method-handle, const-method-type |
-a 28 |
Por debajo de ese umbral aborta sin generar fichero, y el mensaje no dice nada de la API:
in/T.smali[5,4] Cannot read field "format" because "opcode" is null
Además, smali termina con código de salida 0, así que un guion que solo mire el código no se
entera. Lo probamos con smali 3.0.7 sobre dos apps del muestrario, las dos con DEX 038:
app.murinelauncher 10205 (de F-Droid; tiene invoke-polymorphic) y com.droidheat.musicplayer
35 (de IzzyOnDroid; tiene invoke-custom). Sin -a y con -a 25 fallan, no escriben el fichero y
salen con 0; con -a 26 y -a 27 ensamblan y escriben 038, y con -a 28, 039. En la app de
F-Droid el error apunta a d81.smali[377,4]. Para repetirlo:
unzip -o -q app.murinelauncher_10205.apk classes.dex
baksmali disassemble classes.dex -o s
for a in 15 25 26 27 28; do rm -f v.dex; smali assemble -a $a s -o v.dex; echo "-a $a salida=$? fichero=$(test -f v.dex && echo si || echo no)"; done
Regla operativa: pasa siempre a smali assemble el mismo -a que corresponda al DEX
original, el que baksmali autodetectó y que dice la cabecera. Con el -a 15 por defecto la
vuelta sale 035 sea cual sea el original, con el riesgo de arriba. Lo que directamente no
ensambla es raro en un APK: invoke-polymorphic, invoke-custom, const-method-handle y
const-method-type salen de MethodHandle, VarHandle o de compilar con el desazucarado
desactivado, no de las lambdas, que D8 convierte en clases sintéticas con cualquier --min-api
(«sección 2.2 de Decompiladores a Java · El azúcar sintáctico»).
Las cifras lo confirman. Llevan alguna de estas instrucciones menos del 2 % de las apps en todos
los grupos, y ninguna del mercado chino. invoke-custom solo
aparece en una app de todo el muestrario (de IzzyOnDroid), y const-method-handle y
const-method-type en ninguna, así que el umbral -a 28 de esos dos no tiene ningún caso real que
lo pruebe. Las lambdas, en cambio, dejan clases …$$ExternalSyntheticLambdaN en el 37 % de las
apps de F-Droid.
Para elegir el -a, mira la cabecera del DEX (xxd -l 8 classes.dex) y usa esta tabla. Reparte
las apps según la versión más alta de sus DEX:
Cabecera del DEX |
-a que la conserva |
F-Droid | IzzyOnDroid | Play, más instaladas | Play, sorteo | Mercado chino |
|---|---|---|---|---|---|---|
| 035 | -a 23 o menos |
46 % | 40 % | 34 % | 37 % | 79 % |
| 037 | -a 24 o -a 25 |
23 % | 25 % | 29 % | 47 % | 18 % |
| 038 | -a 26 o -a 27 |
18 % | 20 % | 13 % | 9 % | 2 % |
| 039 | -a 28 |
12 % | 15 % | 24 % | 7 % | 1 % |
| 040, 041 | -a 34 da 040 |
0 | 0 | 0 | 0 | 0 |
Cada columna es un grupo por separado. Fíjate en la cabecera, no en el minSdk de la app: en las
más instaladas de Google Play hay DEX más viejos de lo que permitiría el minSdk en el 20 % de
las apps, y en el sorteo, en el 8 %. Un -a más alto que el de la cabecera sube la versión: -a 28
sobre un DEX 038 lo deja en 039. Dos ejemplos para probar: org.fossify.math 10 (de F-Droid)
tiene un DEX 038 (minSdk 26) y lo conservan -a 26 y -a 27; net.typeblog.shelter 445, con
un DEX 037 (minSdk 24), lo conservan -a 24 y -a 25.
6.5 Cuánto smali sale y cuánto tarda
Un DEX pequeño da pocos ficheros, pero uno de una app normal da miles y mucho texto. Conviene
saberlo antes de abrir nada. El classes.dex de Droid-ify 0.7.8 (6.665.956 bytes) da 6.456
ficheros .smali y 80.560.653 bytes de texto, unas 12 veces su tamaño. baksmali tarda entre 2,7
y 3,3 segundos en tres ejecuciones sobre una máquina con otras tareas (en una cuarta, con la
máquina cargada, 6,5). classes2.dex (447.292 bytes) da 559 ficheros y 3.961.507 bytes. Se mide
con time baksmali disassemble classes.dex -o smali/ y
find smali -name '*.smali' -print0 | xargs -0 cat | wc -c. Da los tamaños en bytes, no con
du -sh, que cuenta bloques de disco.
En la submuestra de 117 piezas de la «sección 1 · Qué es y por qué existe» (564 DEX), cuenta con segundos, no con minutos.
La mediana por DEX va de 1 s (IzzyOnDroid) a 6 s (las más instaladas de Google Play), y el peor
caso no pasa de 21 s. Cada DEX suele dar entre unos 900 y 9.000 ficheros .smali, y hasta
23.025 el que más.
Es mucho texto para leerlo entero: se consulta con grep, no se lee de arriba abajo. Y el tamaño
del DEX no manda. El de com.gtgj.view 489 (del mercado chino, protegida con Bangcle/SecNeo)
mide 167.529.220 bytes y solo tiene 5 clases: baksmali tarda 0,56 segundos («sección 8.5 · Lo que el smali no enseña: apps con protector»). Los
tiempos son órdenes de magnitud, no mediciones estables.
7. El crate smali de azw413
Una reimplementación de smali y baksmali en Rust, sin dependencias de Java.
| Dato | Valor |
|---|---|
| Repositorio | https://github.com/azw413/smali |
| Crate | https://crates.io/crates/smali |
| Licencia declarada en crates.io | GPL-3.0-only |
| Versión estable | 0.6.2, publicada el 5 de agosto de 2026 |
| Último push | 5 de agosto de 2026 |
| Creado | 22 de septiembre de 2022 |
| Descargas totales | 4.745 |
| Tracción | 23 ★ · 8 forks · 0 issues abiertas |
Consultado el 12 de agosto de 2026 vía la API de GitHub y la API de crates.io. Activo: las versiones 0.5.3, 0.6.0, 0.6.1 y 0.6.2 se publicaron todas entre el 4 y el 5 de agosto de 2026, y la 0.5.2 el 10 de junio de 2026. Es desarrollo reciente y vivo.
Qué cubre. Según su propio README: un parser, escritor y conjunto de tipos en Rust puro para el
formato smali, cubriendo la estructura completa de una clase de la VM Dalvik incluidas todas sus
instrucciones; lectura y escritura de ficheros DEX; soporte de multidex; manejo de anotaciones de
metadatos de Kotlin; edición de manifiestos de APK y de AAB; y manejo de errores pensado para
analizar ficheros no confiables sin romperse. Se declara completamente autocontenido, sin
dependencias de Java, y con el objetivo de ser 100 % compatible con la implementación de
smali/baksmali de Ben Gruver.
La licencia es dual. crates.io declara GPL-3.0-only en todas sus versiones publicadas, y el
repositorio publica junto a la GPL un fichero LICENSE-commercial, leído el 13 de agosto de
2026 vía la API de GitHub:
| Licencia | Condiciones |
|---|---|
GPL-3.0-only |
Copyleft fuerte: enlazar el crate, estática o dinámicamente, forma una obra combinada que queda entera bajo la GPL |
LICENSE-commercial |
A nombre de una organización o persona concreta. Con periodo de validez explícito, y al expirar se vuelve automáticamente a la GPLv3. Obliga a contribuir las mejoras aguas arriba: «All modifications and improvements must be contributed back to the original open-source repository through pull requests». Prohíbe redistribuir, clonar o hacer fork fuera de la organización licenciada |
Una nota. La FAQ de la GPL considera que la comunicación por tuberías, sockets o argumentos de línea de órdenes se da normalmente entre programas separados, a diferencia del enlazado en un mismo espacio de direcciones, aunque deja la línea exacta a los jueces. De ahí que, para usar el crate desde un programa con otra licencia, se invoque como ejecutable aparte en lugar de enlazarlo. Y como la licencia comercial caduca y revierte a la GPLv3, no elimina esas condiciones: las aplaza.
El punto ciego. 23 estrellas, 4.745 descargas y un solo autor. Es un proyecto personal, técnicamente ambicioso y activo, pero con un bus factor de uno. Apoyar sobre él una función crítica sin un plan de contingencia sería imprudente.
8. Qué se puede editar a nivel smali, y qué no
Aquí es donde la teoría se cobra el peaje.
8.1 Barato y seguro
Cambiar el valor de una constante. Sustituir const/4 v0, 0x0 por const/4 v0, 0x1 es la
edición canónica. No cambia el tamaño de la instrucción, no toca registros, no altera el flujo.
Cuidado con el rango: const/4 codifica un literal de 4 bits con signo, o sea de −8 a 7. Un valor
mayor exige const/16 o const, que ocupan más bytes, lo cual sigue siendo correcto porque el
ensamblador recalcula todos los offsets, pero deja de ser una sustitución de un carácter.
Invertir una condición. Cambiar if-eqz por if-nez, o if-gez por if-ltz. Mismo tamaño,
mismo formato, efecto opuesto. Es cómo se neutraliza una comprobación.
Eliminar una llamada sin retorno útil. Sustituir un invoke-* a un método void por nop, o
simplemente borrar la línea. El ensamblador recalcula offsets y etiquetas.
Cambiar el destino de un salto. Reapuntar una etiqueta a otra ya existente.
Editar el string de una constante. const-string v0, "..." admite cualquier contenido, y
smali se ocupa de la tabla de cadenas: el ensamblador añade la entrada. Si el DEX tiene más de
65.536 cadenas, smali también cambia solo const-string por const-string/jumbo en las que
quedan fuera del alcance de la primera, que codifica el índice en 16 bits. Lo comprobamos con una
clase de prueba hecha para este documento, con 70.000 cadenas distintas (smali 3.0.7, -a 23):
ensambló sin ningún error 65.532 const-string y 4.468 const-string/jumbo, y la tabla quedó en
70.004 cadenas (las 4 de más son LCadenas;, Ljava/lang/Object;, V y f). Para repetirlo:
python3 -I -c "f=open('Cadenas.smali','w');f.write('.class public LCadenas;\n.super Ljava/lang/Object;\n\n.method public static f()V\n .registers 1\n');[f.write(' const-string v0, \"s%05d\"\n'%i) for i in range(70000)];f.write(' return-void\n.end method\n')"
mkdir s && mv Cadenas.smali s/
smali assemble -a 23 s -o v.dex
baksmali disassemble v.dex -o s2
grep -c 'const-string/jumbo' s2/Cadenas.smali; grep -c 'const-string v0' s2/Cadenas.smali
Esos DEX grandes no son raros, sobre todo fuera de F-Droid. Tienen alguno de más de 65.536
cadenas el 12 % de las apps de F-Droid y de IzzyOnDroid, el 39 % de las más instaladas de Google
Play y 48 de cada 100 del mercado chino. Un ejemplo: 8 Ball Pool 56.33.0 (APKPure). Y todos usan
const-string/jumbo: los 808 de F-Droid y los 734 de las más instaladas de Google Play. No
repetimos la prueba de arriba con un DEX real de ese tamaño.
8.2 Caro, y por qué
Cambiar la firma de un método. Parece un cambio local y no lo es. La firma es parte de la
identidad del método en el DEX: aparece en el method_id_item, que referencia un proto_id_item
con la lista de tipos. Cambiarla implica que todas las invocaciones desde todas las clases
dejan de resolver, y esas invocaciones están repartidas por todos los classes*.dex del APK,
incluidos los que ni has desensamblado.
Tener varios DEX es lo habitual en Google Play. En el
«muestrario», la pieza base (o única) lleva más de un
classes*.dex en el 93 % de las más instaladas de Google Play, frente al 30 % de las apps de
F-Droid. En F-Droid la mediana es 1; en las más instaladas de Google Play, 6, y el peor 10 % llega
a 15 o más. El máximo, 37, es el de video.like 5.66.0 (pieza base.apk del .apkm de
APKMirror).
En Google Play el código también puede ir fuera de base.apk: 37 de las 658 apps más instaladas
(un 6 %) y 4 de las 369 del sorteo tienen un DEX propio en un split de funcionalidad. Un ejemplo
es com.adobe.reader 26.10.0 (pieza base.apk del .apkm de APKMirror): la base trae 9 DEX y 5
splits de funcionalidad llevan DEX propio. Y hay DEX que no se llaman classes*.dex: algún
fichero con formato DEX fuera de la raíz del ZIP aparece en el 39 % de las apps más instaladas de
Google Play, el 17 % del sorteo y el 9 % del mercado chino, y casi nunca en F-Droid e IzzyOnDroid.
baksmali classes.dex no los toca: hay que pedírselos aparte. Un ejemplo: app.simple.inure
10724, de F-Droid, lleva assets/rish/rish_shizuku.dex. «Fuera de la raíz» incluye plugins y
ficheros de assets/ y res/: no todos son código de la app.
Añadir un parámetro tiene un segundo efecto: sube ins_size, lo que desplaza todo el banco de
registros del método con el mecanismo de la «sección 3.5 · .registers frente a .locals: donde se equivoca todo el mundo». Hay que revisar el cuerpo entero.
Si el método sobrescribe uno de una superclase o implementa una interfaz, cambiar la firma rompe
además el enlace y ART lo detecta al cargar.
Añadir un campo. Hay que crear el .field, y luego inicializarlo, lo que significa tocar
<init> en todos sus constructores, o <clinit> si es estático. Un iput sobre un campo que no
existe en la clase produce error de verificación en tiempo de carga.
Añadir un método. Más fácil que lo anterior: un .method nuevo con .registers correcto suele
bastar. Pero si hay que llamarlo desde otra clase, esa clase también se toca.
Insertar código en medio de un método. El problema real, y merece su propio apartado.
8.3 El problema de los registros al insertar código
Insertar instrucciones requiere registros donde poner los valores intermedios. Y ahí empiezan las tres restricciones que se acumulan:
1. No hay registros libres. El compilador asigna el mínimo necesario. Un método con .locals 2
tiene exactamente dos, y los dos están en uso. Hay que subir el número, con el efecto de
desplazamiento de la «sección 3.5 · .registers frente a .locals: donde se equivoca todo el mundo».
2. El techo de 4 bits. La mayoría de las instrucciones codifican sus registros en 4 bits: solo
alcanzan v0 a v15. Si el método ya usa dieciséis, subir .locals empuja los parámetros por
encima de v15, y todas las instrucciones que los referencian dejan de poder codificarse. Hay
que reescribirlas a /from16 o /16, lo que cambia sus tamaños.
Con los dieciséis ocupados no queda ningún registro bajo libre, así que no hay forma de esquivar el
banco: hay que ampliarlo y compensar. Una vía es subir .registers (o .locals) y, al entrar en
el método, copiar a registros bajos los parámetros que han quedado por encima de v15
(move/from16, move-object/from16 o move-wide/from16, que leen un origen de 16 bits y
escriben un destino de 8), cambiando en el cuerpo sus pN por esos vN. La otra es reescribir los
invoke afectados a su variante /range, que admite registros de 16 bits siempre que sean
consecutivos. Y el registro que se gana tampoco es bajo: si .locals pasa de 16 a 17, el nuevo es
v16, que alcanzan las instrucciones con campos de 8 o 16 bits pero no las de 4; para usarlo con
una de esas hay que pasar el valor por un registro bajo con move/from16 (o move-object/from16,
move-wide/from16) o, si es un argumento, llevar el invoke a /range. Las variantes y sus
formatos están en la «sección 3.2 de Bytecode Dalvik · Por qué existen las variantes /from16, /16 y /range».
Funciona, y es tedioso.
3. La verificación de tipos de ART. Es la restricción que sorprende. ART verifica al cargar
que cada registro tiene un tipo coherente en cada punto del programa, y en particular que en
los puntos donde dos ramas confluyen el tipo coincide por ambos caminos. Un parche que deja un
registro conteniendo un int en una rama y una referencia en la otra produce un error de
verificación.
Y el error no ocurre donde está el bug: ocurre al cargar la clase, con un mensaje sobre tipos de registro que no señala la línea que editaste. La «sección 10 de Bytecode Dalvik · La verificación de bytecode de ART» cubre el verificador; el diagnóstico de estos fallos está en «Diagnóstico de fallos».
La consecuencia operativa: un DEX editado a mano que no supere la verificación falla al cargar
la clase, no al ejecutar la línea. La aplicación arranca y muere al tocar la funcionalidad
parcheada, con una traza que apunta a otro sitio.
8.4 Lo que no se toca desde aquí
Fuera del alcance del smali, aunque estén en el mismo APK:
- Los recursos.
resources.arscy losAXMLson otro formato. Se editan con las herramientas de «Desempaquetado y reempaquetado». - El código nativo. Lo que está en
lib/<abi>/*.soes ELF, y se trata en «Análisis binario y estático». Casi todas las apps de Google Play llevan alguna.so: el 94 % de las más instaladas y el 84 % del sorteo, frente al 57 % de F-Droid, el 59 % de IzzyOnDroid y las 100 de 100 del mercado chino. Eso no quiere decir que su lógica esté ahí: casi siempre son bibliotecas. Pero hay apps cuya lógica sí está fuera delDEX: las hechas con un marco como Flutter o Unity y las que llevan un protector (secciones «2» y «8.5»). Ahí elsmalisolo enseña el envoltorio. Los datos dicen cuántas apps llevan marcos o protectores, no cuántas los usan para escapar del análisis. - La firma. Cualquier cambio la invalida, y hay que rehacerla:
«Firma y empaquetado». Al firmar de nuevo se pierde lo que iba en el
bloque de firmas y no es una firma. En el «muestrario», 31
de las 100 apps del mercado chino llevan en ese bloque un dato de canal de distribución (Walle o
VasDolly), y el 79 % de las más instaladas de Google Play llevan el sello de origen de Google
Play. En Google Play, además, todas las piezas de una app van firmadas con el mismo certificado
(454 de 454 apps con más de una pieza): si cambias una, hay que firmar todas con la misma clave
nueva. Un ejemplo de canal:
cn.ninegame.gamemanager80506001, del mercado chino. Un ejemplo de app de Play con un solo certificado y un solo sello en todas sus piezas:de.systembau.prourlaubapp(carpeta deadb, piezabase.apk). Que se pierda lo del bloque de firmas sale del formato del bloque (ver «APK Signing Block»), no de volver a firmar una pieza real. Qué hace una app que comprueba su propia firma (PairIP: 45 de las 658 más instaladas, 99 de las 369 del sorteo) tras volver a firmarla no se puede medir de forma estática. Los ficheros de canal deMETA-INFno los medimos.
8.5 Lo que el smali no enseña: apps con protector
Hay aplicaciones cuyo DEX visible es solo un cargador. El código real va cifrado en otro sitio y
se descifra al ejecutar la app. Editar ese cargador no cambia la app.
Es cosa sobre todo del mercado chino. En el «muestrario»
tienen un empaquetador o protector distinto de PairIP 38 de las 100 apps de allí, más de la mitad
con Bangcle/SecNeo (21). En Google Play son el 2 % de las más instaladas y 1 de las 369 del
sorteo, y en F-Droid, IzzyOnDroid y las webs de los autores, ninguna. (La heurística mira nombres
de .so y de entradas del ZIP, y clases del cargador.) Cuando es un cargador, se nota en el
tamaño: entre las 38 con protector, la mediana es de 27,5 clases a la vista, con un mínimo de 3 y
un máximo de 11.909.
baksmali no falla con ellas. Desensambló sin error y con un .smali por clase los 13 DEX de las
5 apps con protector elegidas a propósito y los de las 7 apps con protector del mercado chino de la
submuestra de la «sección 1 · Qué es y por qué existe». Lo que el smali enseña es el cargador. Cuatro ejemplos:
com.gtgj.view489 (mercado chino, Bangcle/SecNeo): unclasses.dexde 167.529.220 bytes, cabecera 037, con solo 5 clases, todas decom.secneo.apkwrapper(H,AP,a,CPyAW), y 187method_ids.baksmaliescribe 5 ficheros en medio segundo. Lo que lee ocupa 19.172 bytes (data_off4.464 másdata_size14.708); el resto del fichero queda fuera de las secciones quebaksmalirecorre. Qué contiene ese resto (cifrado, relleno) no lo sabemos: lo sacamos de leer la cabecera, no de abrir el contenido. La vuelta consmali assemble -a 25ocupa 18.232 bytes.com.cmbchina.ccd.pluto.cmbActivity160 (mercado chino, Bangcle/SecNeo): 7.529 clases a la vista ylibDexHelper.so. La vuelta conserva clases ymethod_ids.com.applisto.appcloner.premium4.0.0 (Google Play, DexProtector): 9.027 clases a la vista ylibdexprotector.so.com.nnacres.app(99acres, del.xapkde APKPure, protegida con PairIP): 61.503 clases a la vista.
PairIP, el protector de Google Play, es distinto: deja la mayor parte del código a la vista. Lo
llevan el 7 % de las apps más instaladas de Google Play (45 de 658) y el 27 % del sorteo (99 de
369); en F-Droid, IzzyOnDroid y el mercado chino, ninguna. El tamaño y las secciones del DEX de
gtgj salen de dexdump -f classes.dex.
Fuentes
- google/smali — repositorio oficial — https://github.com/google/smali
Consultado el 12 de agosto de 2026 vía
https://api.github.com/repos/google/smali. De aquí salen la fecha de creación del fork, el último push y los recuentos de estrellas, forks e issues de la ficha de la «sección 6.2 · Ficha de google/smali». La versión no:releases/latestdevolvía la 3.0.6, que no era la última (fuente 10). - google/smali — README — https://raw.githubusercontent.com/google/smali/main/README.md
Consultado el 12 de agosto de 2026. De aquí sale el relato del cambio de manos de la «sección
6.1 · El cambio de manos, que conviene conocer»: que el original de JesusFreke ya no se mantiene, que Google se hizo cargo, el cambio de
espacio de nombres de
org.jfacom.android.tools.smaliy que la 3.0.0 se construyó sobre la 2.5.2. - google/smali — fichero LICENSE —
https://api.github.com/repos/google/smali/contents/LICENSE
Consultado el 12 de agosto de 2026. De aquí sale la licencia exacta: BSD de 3 cláusulas de
Ben Gruver, más Apache-2.0 para el código de AOSP, y la explicación de por qué la API de
GitHub la reporta como
NOASSERTION. - JesusFreke/smali — repositorio original — https://github.com/JesusFreke/smali Consultado el 12 de agosto de 2026 vía la API de GitHub. De aquí sale que está archivado, con último push el 17 de enero de 2024 y 6.631 estrellas.
- azw413/smali — repositorio del crate de Rust — https://github.com/azw413/smali
Consultado el 12 de agosto de 2026. De aquí salen la descripción de capacidades de la «sección
7 · El crate smali de azw413», la existencia del fichero
LICENSE-commercialjunto a la GPL-3.0, y los recuentos de estrellas, forks e issues. - crate
smalien crates.io — https://crates.io/api/v1/crates/smali Consultado el 12 de agosto de 2026. De aquí salen la licencia GPL-3.0-only declarada en todas las versiones, la versión 0.6.2 del 5 de agosto de 2026, el historial de versiones recientes y las 4.745 descargas totales. - Volcado de
dexdumpsobre una clase compilada al efecto — ejecutado el 12 de agosto de 2026 conbuild-tools37.0.0 (d8,dexdump) y OpenJDK 21.0.10 sobre la máquina de referencia. De aquí sale íntegra la «sección 4 · .registers sobre código real»: los valoresregisters : 4eins : 3, las ocho instrucciones con sus offsets, el bloquelocalscon el mapa de registros, y la evidencia de qued8 --releaseborra los nombres de parámetros pero conserva los números de línea. - baksmali y smali 3.0.7 ejecutados localmente — jars de
com.android.tools.smalidescargados del Maven de Google el 13 de agosto de 2026. De aquí salen íntegras la lista de subcomandos y la tabla de opciones de la «sección 6.3 · Opciones principales», tomadas debaksmali disassemble --helpysmali assemble --help, y todo lo medido sobre el «muestrario» en la «sección 6.4 · El viaje de ida y vuelta, medido»: el viaje de ida y vuelta de Droid-ify 0.7.8, ejecutado el 31 de octubre de 2026, y los 564DEXde una submuestra de 117 piezas. azw413/smali,LICENSE-commercial— https://github.com/azw413/smali/blob/master/LICENSE-commercial Leído el 13 de agosto de 2026 vía la API de GitHub. De aquí salen las cuatro condiciones de la licencia comercial de la «sección 7 · El crate smali de azw413».smali-baksmalien el Maven de Google — https://dl.google.com/android/maven2/com/android/tools/smali/smali-baksmali/maven-metadata.xml Consultado el 24 de septiembre de 2026. De aquí salen las versiones 3.0.7 a 3.0.10 y la fecha de la 3.0.10, el 4 de septiembre de 2026 («sección 6.2 · Ficha de google/smali»).google/smali— gramática del ensamblador — https://github.com/google/smali/blob/3713aeddd5faa8ba395999d1ee32c3fb3e68e3f4/smali/src/main/jflex/smaliLexer.jflex y https://github.com/google/smali/blob/d69d73658668ce394e871b1397a90a27e6aff428/smali/src/main/antlr/smaliParser.g Consultados el 18 de octubre de 2026 vía la API de GitHub. De aquí salen las directivas.end param,.local,.end local,.restart local,.subannotationy.enumde la tabla de la «sección 3.3 · Directivas de método», con su sintaxis (local_directive,parameter_directive,subannotation,enum_literal).- Frequently Asked Questions about the GNU Licenses — https://www.gnu.org/licenses/gpl-faq.html#MereAggregation y https://www.gnu.org/licenses/gpl-faq.html#GPLStaticVsDynamic Consultado el 18 de octubre de 2026. De aquí salen la nota de la «sección 7 · El crate smali de azw413» sobre tuberías, sockets y argumentos frente a enlazado en un mismo espacio de direcciones, y que enlazar estática o dinámicamente forma una obra combinada cubierta por la GPL.
- Ida y vuelta con
baksmaliysmali3.0.7, ejecutada localmente — el 18 de octubre de 2026, sobre elclasses.dexde la «sección 4 · .registers sobre código real» regenerado conjavac -gyd8 --release --min-api 24debuild-tools37.0.0. De aquí salen eldiff -rvacío, los tamaños de 764 y 616 bytes,cmp, losstring_ids_size, las cabeceras dexxdcon y sin-ay la interfaz con un método privado reensamblada como035de la «sección 6.4 · El viaje de ida y vuelta, medido», y la versión debaksmali --versioncitada en la «sección 4 · .registers sobre código real». Repetido el mismo día consmali-baksmali,smali,smali-dexlib2ysmali-util3.0.10 de https://dl.google.com/android/maven2/com/android/tools/smali/ (conjcommander1.85, la dependencia que declara su POM): las ayudas y los ficheros de salida coinciden con los de la 3.0.7 («sección 6.2 · Ficha de google/smali»). - AOSP — ART en la etiqueta
android-17.0.0_r1— https://android.googlesource.com/platform/art/+/refs/tags/android-17.0.0_r1/runtime/class_linker.cc, https://android.googlesource.com/platform/art/+/refs/tags/android-17.0.0_r1/runtime/verifier/method_verifier.cc, https://android.googlesource.com/platform/art/+/refs/tags/android-17.0.0_r1/runtime/verifier/verifier_enums.h y https://android.googlesource.com/platform/art/+/refs/tags/android-17.0.0_r1/libdexfile/dex/standard_dex_file.cc Consultados el 18 de octubre de 2026. De aquí sale lo que hace ART con unDEX035en la «sección 6.4 · El viaje de ida y vuelta, medido»:SupportsDefaultMethods()exige la versión 37 (kDefaultMethodsVersion); elFIXMEdeclass_linker.cc(líneas 9198-9216), que solo lanzaClassFormatErrorpara métodosdefaultnativos; la comprobación deinvoke-directsobre interfaces demethod_verifier.cc(líneas 4701-4712), yVERIFY_ERROR_CLASS_CHANGE(«IncompatibleClassChangeError») enverifier_enums.h. - Dalvik Executable format —
magic— https://source.android.com/docs/core/runtime/dex-format Consultado el 18 de octubre de 2026 (página actualizada el 9 de octubre de 2026). De aquí sale la cita sobre la diferencia entre las versiones035y037de la «sección 6.4 · El viaje de ida y vuelta, medido».