O novo CLI do Rive permite que um agente de programação trabalhe com gráficos interativos através de ficheiros de projeto. O agente pode escrever Rive Markup Language (RML), scripts Luau e shaders e, em seguida, pedir ao CLI que compile, inspecione, teste e renderize o resultado. Uma pessoa pode acompanhar a pré-visualização local e rever o design. A equipa do Rive apresentou o CLI como uma pré-visualização técnica em 11 de setembro; a página de transferências do Rive, consultada a 27 de setembro, classifica-o como Acesso Antecipado.

Esta lista segue a documentação do Rive. A BIG CHANGE analisou apenas a documentação. Não instalámos o CLI, não criámos um ficheiro nem testámos um gráfico produzido por um agente. O vídeo de demonstração do Rive mostra o fluxo de trabalho previsto entre a pessoa e o agente.

A grande mudança

  • O que mudou: As cenas do Rive passam a poder ser criadas e editadas em texto por agentes de programação. Um agente pode editar RML numa pasta do projeto, enquanto o CLI compila um .riv para runtimes ou um .rev para continuar o trabalho no Editor.
  • Por que isso importa: Designers e programadores de front-end ou de jogos podem rever as alterações ao código-fonte juntamente com os restantes ficheiros do projeto e utilizar verificações do CLI durante as iterações. Antes de utilizar o recurso num produto, continuam a ter de avaliar o design renderizado e as interações.
  • O que acompanhar: Publicar na Web um protótipo local é uma decisão separada. Os ficheiros com scripts precisam de uma compilação assinada --publish; para uma compilação limpa .riv também exige que o projeto esteja associado a um ficheiro de conta e que este se encontre num espaço de trabalho Cadet ou superior. Verifique estas condições e o gráfico final antes da implementação.

Lista de tarefas documentadas

  1. Confira o acesso e instale. O Rive indica como sistemas compatíveis o macOS em computadores com Apple Silicon, o Linux x86_64 e o Windows. O guia de primeiros passos apresenta instruções de instalação separadas para Windows e macOS/Linux; siga as instruções para Windows que constam da página. Depois da instalação, execute rive doctor. A referência de comandos também documenta rive --version; registe a versão efetivamente instalada, pois o software ainda está em fase de pré-visualização. No anúncio de 11 de setembro, o Rive afirmou que o CLI seria gratuito e sem limites durante o período de pré-visualização. Esta declaração, feita nessa data, não estabelece um preço permanente para o CLI. A tabela atual de planos diz respeito às contas Rive e ao Agente de IA integrado no Editor; consulte as condições atuais antes de publicar.
  2. Crie um projeto textual e abra a pré-visualização. rive create myproject cria scene.rml, rive.yaml, instruções para o agente em AGENTS.md e CLAUDE.md, além de um .gitignore. Execute rive myproject num terminal. Segundo o Rive, o CLI monitoriza a pasta, recompila sempre que há alterações guardadas e cria myproject/build/myproject.riv. A cena inicial inclui uma prancheta, uma linha temporal e uma máquina de estados, mas ainda não contém desenhos. A pré-visualização inicial mostra um retângulo escuro.
  3. Forneça a pasta do projeto a um agente de programação e atribua-lhe uma tarefa de design específica. O guia de agentes de IA do Rive menciona o Claude Code, o Cursor ou outro agente capaz de ler e modificar ficheiros e executar comandos na shell. As instruções geradas ensinam o agente a utilizar rive docs e rive schema para encontrar objetos e propriedades compatíveis. RML é XML: os elementos representam tipos do Rive, os atributos representam as respetivas propriedades e o aninhamento liga os objetos. O agente também pode editar .luau scripts, .wgsl shaders e recursos do projeto. Peça-lhe que trabalhe por etapas para poder ajustar a disposição e o comportamento à medida que a pré-visualização é atualizada.
  4. Confira a compilação e o conteúdo do projeto. Peça ao agente para executar rive myproject --verify, que compila sem criar um ficheiro .riv, e rive inspect myproject --summary, que comunica problemas e o número de objetos. A cena completa e resolvida pode ser inspecionada com rive inspect myproject --json. Se o projeto precisar de um ficheiro local distribuível sem abrir a pré-visualização, rive myproject --once guarda um ficheiro .riv sem assinatura. Estas verificações podem detetar erros de compilação e objetos de cena em falta ou inesperados. O guia de RML do Rive alerta que uma compilação sem erros não comprova que o gráfico tenha o aspeto ou o comportamento pretendidos.
  5. Capture os estados relevantes. rive myproject --screenshot=out.png renderiza um PNG sem abrir uma janela. Os exemplos do Rive usam --advance=1s para obter um quadro após o início da animação, --viewport=390x844 para escolher o tamanho do layout, --data=battery/level=100 para inserir dados vinculados e --pointer=click@120,60 --advance=20 para simular um clique. Escolha valores e coordenadas adequados à sua cena. Compare as capturas entre diferentes estados e tamanhos da janela e, depois, examine-as. Uma captura sem --advance mostra a pose de repouso definida pelo autor; não é necessariamente o primeiro fotograma da animação.
  6. Execute testes de scripts quando o projeto os incluir. rive myproject --test executa os scripts Luau do projeto Tests. O Rive documenta --verify --format=json e --test --format=json para verificações automatizadas; compilações e testes com falhas devolvem códigos de saída diferentes de zero. Um agente pode utilizar esses relatórios para rever o código-fonte. Os testes cobrem apenas as afirmações que foram programadas; examine também as interações que ficaram de fora.
  7. Escolha o fluxo de conta quando o protótipo local estiver pronto. Um .riv é o recurso de runtime; um .rev abre-se para edição no Rive Editor. Segundo o Rive, a criação local, a pré-visualização, a verificação, os testes e as capturas de ecrã funcionam sem iniciar sessão e sem ligação à Internet. É necessário rive login para --publish, --rev, rive push, rive pull e importar um ficheiro de conta remoto. Para começar com uma cópia de segurança exportada do Editor, rive create myproject --from-rev=myfile.rev funciona sem autenticação. Para começar com um ficheiro de conta, use rive create myproject --from-remote-file depois de iniciar sessão. Este comando associa o projeto ao ficheiro: rive push myproject envia uma revisão; rive pull myproject transfere para o computador as alterações do Editor e substitui a cena, os scripts e os recursos locais após a confirmação. Reveja as alterações locais antes de importar as alterações remotas.
  8. Confira os limites de assinatura e exportação antes de publicar. rive myproject --publish guarda um ficheiro assinado .riv e exige autenticação. Segundo o Rive, os runtimes da web e a sua CDN rejeitam scripts sem assinatura; portanto, ficheiros com scripts destinados à web devem seguir esse fluxo. --publish pode adicionar uma marca de água. A referência de comandos do Rive diz que uma compilação limpa .riv exige que o projeto esteja associado a um ficheiro de conta através de rive push e que esse ficheiro se encontre num espaço de trabalho Cadet ou superior. A condição da marca de água aplica-se mesmo que a cena não tenha scripts. --rev=<path> também exige autenticação e pode ser usada junto com --once ou --publish; guarda um ficheiro do Editor, não um substituto para um recurso de runtime. Verifique o plano atual da conta e o resultado efetivamente exportado antes da implementação.

O Rive também tem um Agente de IA integrado no Editor. É aberto a partir da barra lateral do Editor e está sujeito ao plano do Editor e às condições de créditos de IA. Este guia descreve o fluxo de trabalho com uma pasta e um terminal, utilizando um agente de programação com o CLI; as duas opções de agente têm interfaces e modelos de faturação diferentes.

Fontes e leitura complementar