La nueva CLI de Rive permite que un agente de programación trabaje con gráficos interactivos como archivos de proyecto. El agente puede escribir Rive Markup Language (RML), scripts de Luau y sombreadores; después, puede pedir a la CLI que compile, inspeccione, pruebe y renderice el resultado. Una persona puede ver la vista previa local y revisar el diseño. El equipo de Rive presentó la CLI como una vista previa técnica el 11 de septiembre; la página de descargas de Rive, consultada el 27 de septiembre, la incluye en Early Access.

Esta lista de comprobación sigue la documentación de Rive. BIG CHANGE solo revisó la documentación. No instalamos la CLI, no creamos un archivo ni probamos gráficos generados por un agente. El vídeo explicativo de Rive muestra el flujo de trabajo previsto entre la persona y el agente.

El gran cambio

  • Qué ha cambiado: Las escenas de Rive ahora tienen una vía basada en texto para los agentes de programación. Un agente puede editar RML en una carpeta de proyecto, mientras la CLI compila un .riv para los entornos de ejecución o un .rev para seguir trabajando en el Editor.
  • Por qué importa: Diseñadores y desarrolladores de interfaces o videojuegos pueden revisar los cambios en el código fuente junto con los demás archivos del proyecto y usar comprobaciones de CLI durante la iteración. Aun así, antes de utilizar el recurso en un producto deben evaluar el diseño renderizado y las interacciones.
  • Qué conviene observar: Llevar un prototipo local a la web es una decisión aparte. Los archivos con scripts requieren compilar con la opción --publish para publicar en la web; una compilación limpia de .riv también requiere vincular el proyecto a un archivo de cuenta y disponer de un espacio de trabajo Cadet o superior. Antes del despliegue, compruebe esas condiciones y el gráfico exportado.

La lista de tareas documentada

  1. Compruebe el acceso e instale la CLI. Rive indica que son compatibles macOS en Apple Silicon, Linux x86_64 y Windows. Su guía de inicio ofrece instrucciones de instalación distintas para Windows y macOS/Linux; siga las instrucciones vigentes para Windows que aparecen en esa página. Después de instalarla, ejecute rive doctor. La referencia de comandos también documenta rive --version; anote la versión que instale, porque se trata de software en versión preliminar. En su anuncio del 11 de septiembre, Rive dijo que la CLI sería gratuita y sin límites durante la vista previa. Esa declaración fechada no establece un precio permanente para la CLI. La tabla actual de planes se refiere a las cuentas de Rive y al agente integrado en el Editor, así que consulte las condiciones vigentes antes de publicar.
  2. Cree un proyecto de texto y abra la vista previa. rive create myproject genera scene.rml, rive.yaml, instrucciones para agentes en AGENTS.md y CLAUDE.md, y un .gitignore. Ejecute rive myproject en una terminal. Según Rive, vigila la carpeta, vuelve a compilar cuando se guardan cambios y escribe myproject/build/myproject.riv. La escena inicial contiene una mesa de trabajo, una línea de tiempo y una máquina de estados, pero aún no incluye elementos gráficos. La vista previa inicial es un rectángulo oscuro.
  3. Proporcione al agente de programación la carpeta del proyecto y una tarea de diseño concreta. La guía de agentes de IA de Rive menciona Claude Code, Cursor u otro agente que pueda leer y escribir archivos y ejecutar comandos de shell. Las instrucciones generadas explican al agente cómo usar rive docs y rive schema para encontrar objetos y propiedades compatibles. RML es XML: los elementos representan tipos de Rive, los atributos representan sus propiedades y la jerarquía conecta los objetos. El agente también puede editar .luau scripts, .wgsl sombreadores y recursos del proyecto. Pídale que trabaje por etapas para poder orientar el diseño y el comportamiento mientras se actualiza la vista previa.
  4. Compruebe la compilación y su contenido. Pida al agente que ejecute rive myproject --verify, que compila sin escribir un archivo .riv, y rive inspect myproject --summary, que informa de los problemas y del número de objetos. La documentación indica que para ver la escena completa resuelta se puede usar rive inspect myproject --json. Si el proyecto necesita un archivo local distribuible sin abrir la vista previa, rive myproject --once escribe un archivo .riv sin firmar. Estas comprobaciones pueden detectar errores de compilación y objetos de escena ausentes o inesperados. La guía de RML de Rive advierte que una compilación limpia no demuestra que el gráfico tenga el aspecto o el comportamiento previstos.
  5. Capture los estados relevantes. rive myproject --screenshot=out.png renderiza un PNG sin abrir una ventana. Los ejemplos de Rive usan --advance=1s para capturar un fotograma después de que empiece la animación, --viewport=390x844 para elegir el tamaño de disposición, --data=battery/level=100 para los datos vinculados y --pointer=click@120,60 --advance=20 para simular un clic. Elija valores y coordenadas que correspondan a su propia escena. Compare capturas de distintos estados y tamaños de ventana y luego revíselas personalmente. Una captura sin --advance muestra la pose de reposo creada por el autor; no necesariamente el primer fotograma de la animación.
  6. Ejecute pruebas de scripts cuando el proyecto las incluya. rive myproject --test ejecuta los scripts Luau del proyecto Tests. Rive documenta --verify --format=json y --test --format=json para las comprobaciones automatizadas; las compilaciones y pruebas fallidas devuelven un código de salida distinto de cero. Un agente puede usar esos informes para revisar el código fuente. Las pruebas solo cubren las condiciones que se hayan definido; compruebe también las interacciones que no incluyan.
  7. Elija la opción de cuenta cuando el prototipo local esté listo. Un archivo .riv es el recurso para el entorno de ejecución; un archivo .rev se abre para editarse en Rive Editor. Rive dice que se pueden crear, previsualizar y verificar archivos localmente, ejecutar pruebas y tomar capturas sin iniciar sesión y sin conexión. Hace falta rive login para --publish, --rev, rive push, rive pull e importar un archivo remoto de la cuenta. Para empezar a partir de una copia de seguridad exportada del Editor, rive create myproject --from-rev=myfile.rev funciona sin iniciar sesión. Para empezar desde un archivo de la cuenta, use rive create myproject --from-remote-file después de iniciar sesión. Esta última opción vincula el proyecto a ese archivo: rive push myproject sube una revisión; rive pull myproject descarga los cambios del Editor y sobrescribe la escena, los scripts y los recursos locales tras la confirmación. Revise los cambios locales antes de descargarlos.
  8. Compruebe los requisitos de firma y exportación antes del lanzamiento. rive myproject --publish escribe un archivo firmado .riv y requiere iniciar sesión. Rive dice que los entornos web y su CDN rechazan scripts sin firmar, así que los archivos con scripts para la web deben exportarse por esta vía. --publish puede añadir una marca de agua. La referencia de comandos de Rive indica que una compilación limpia de .riv requiere que el proyecto esté vinculado a un archivo de cuenta mediante rive push y que ese archivo esté en un espacio de trabajo Cadet o superior. La condición de la marca de agua también se aplica si la escena no tiene scripts. --rev=<path> también requiere iniciar sesión y puede acompañar a --once o --publish; genera un archivo de Editor, no un sustituto del recurso para el entorno de ejecución. Antes del despliegue, compruebe el plan actual de la cuenta y el resultado exportado.

Rive también ofrece un agente de IA integrado en el Editor . Se abre desde la barra lateral del Editor y está sujeto al plan y a las condiciones de créditos de IA del Editor. El flujo de trabajo de esta guía, basado en carpetas y terminal, utiliza un agente de programación junto con la CLI; las dos opciones tienen interfaces y condiciones de facturación distintas.

Fuentes y lecturas adicionales