El mapa de subcomandos
Qué hace cada subcomando del CLI y en qué familia entra: los que corren, los que generan, los que informan y los que migran. Más el que casi nadie ejecuta y debería.
Las cuatro familias
Los que generan ficheros
Es la distinción que importa antes de ejecutar nada. Los de la segunda familia escriben en tu proyecto, y conviene tener el árbol limpio antes para poder leer el diff:
| subcomando | qué escribe |
|---|---|
init |
src-tauri/ entero |
add |
Cargo.toml, lib.rs, capabilities/, y el package.json del frontend |
icon |
el directorio de iconos completo, sobrescribiendo |
signer generate |
un par de claves — escribe la exclusión antes |
android init / ios init |
src-tauri/gen/ entero |
migrate |
la configuración, las dependencias y los ficheros de permisos |
La regla es la misma para todos: ejecutarlos con el repositorio sin cambios pendientes, para que lo que aparezca en el diff sea exactamente su obra. Con add en particular vale la pena leer el diff entero, porque una de las cosas que toca es el fichero de permisos.
Los tres que casi nadie ejecuta
completions. Genera el autocompletado del shell. Cuesta dos minutos y elimina la necesidad de recordar el nombre de una bandera. Es la mejora de ergonomía más barata del framework.
permission ls. Lista los permisos que ofrecen tu aplicación y los plugins instalados. Es la única forma cómoda de descubrir que un plugin ofrece un permiso más estrecho que el que el subcomando add te puso por defecto. Fase V lo usa a fondo, y merece conocerlo desde ahora.
inspect. Poco glamuroso y salva una situación muy concreta: el instalador de Windows identifica una instalación previa por un código, y si ese código cambia entre versiones, la actualización instala una segunda copia en vez de sustituir la primera. Consultarlo y anotarlo antes de la primera publicación evita ese accidente. Nivel 59.
A cuál acudir
| tengo este problema | ejecuta |
|---|---|
| algo no compila y no sé si es mi entorno | info |
| añadí un plugin y no funciona | permission ls, y mira capabilities/ |
| quiero otro formato de instalador sin recompilar | bundle |
| voy a publicar la primera versión de Windows | inspect, y anota el código |
| tengo un proyecto de la versión 1 | migrate, y después la fase V |
| no me acuerdo de las banderas | completions, una vez |