Нови Rive CLI омогућава програмерском агенту да ради на интерактивној графици као на пројектним датотекама. Агент може да пише у Rive Markup Language-у (RML), скриптама Luau и шејдерима, а затим затражи од CLI-ја да компајлира, прегледа, тестира и прикаже резултат. Особа може да прати локални преглед и дорађује дизајн. Запослени у компанији Rive представили су CLI као технички пробни приказ 11. септембра; страница за преузимање Rive CLI-ја, на којој смо проверили податке 27. септембра, наводи га у одељку Early Access.

Ова контролна листа прати документацију компаније Rive. BIG CHANGE је прегледао само документацију. Нисмо инсталирали CLI, направили датотеку нити тестирали графику коју је направио агент. Видео-приказ поступка компаније Rive показује предвиђени процес рада човека и агента.

Суштинска промена

  • Шта се променило: Rive сцене сада имају текстуални начин рада за програмерске агенте. Агент може да уређује RML у фасцикли пројекта, док CLI компајлира датотеку.riv за окружења за покретање или датотеку.rev за даљи рад у уређивачу Rive Editor-а.
  • Зашто је то важно: Дизајнери и фронтенд програмери или програмери игара могу да прегледају измене изворног кода поред осталих датотека пројекта и да користе провере CLI-ја током дораде. И даље морају да процене приказани дизајн и интеракције пре него што употребе ресурс у производу.
  • На шта обратити пажњу: Прелазак са локалног прототипа на веб засебна је одлука. Датотеке са скриптама морају да имају потписану --publish датотеку; за чисту .riv потребно је и повезивање са датотеком налога и радни простор нивоа Cadet или вишег. Проверите те услове и коначну графику пре објављивања.

Документовани кораци

  1. Проверите приступ и инсталирајте алат. Rive наводи подршку за macOS на Apple Silicon рачунарима, Linux x86_64 и Windows. Водич за почетак рада садржи засебна упутства за инсталацију на Windows-у и macOS/Linux-у; пратите актуелна упутства за Windows на тој страници. Покрените rive doctor након инсталације. У референтном приручнику за команде описана је и команда rive --version; забележите верзију коју сте стварно инсталирали, јер је ово пробна верзија. У саопштењу од 11. септембра Rive је навео да је коришћење CLI-ја током пробног периода бесплатно и без ограничења током пробног периода. Та временски ограничена изјава не утврђује трајну цену CLI-ја. Актуелна табела планова односи се на Rive налоге и уграђеног агента у уређивачу; пре објављивања проверите важеће услове.
  2. Направите текстуални пројекат и отворите преглед. rive create myproject прави scene.rml, rive.yaml, упутства за агента у датотеци AGENTS.md и CLAUDE.md, као и .gitignore. Покрените rive myproject у једном терминалу. Према наводима компаније Rive, алат прати фасциклу, поново гради пројекат након чувања измена и уписује myproject/build/myproject.riv. Почетна сцена садржи радну површину, временску линију и машину стања, али још нема нацртаних елемената. Почетни приказ је таман правоугаоник.
  3. Дајте програмерском агенту фасциклу пројекта и конкретан задатак за дизајн. У водичу за AI агенте се као примери наводе Claude Code, Cursor или други агент који може да чита и уписује датотеке и покреће команде љуске. Генерисана упутства објашњавају агенту како да користи rive docs и rive schema за проналажење подржаних објеката и својстава. RML је XML: елементи представљају типове Rive објеката, атрибути њихова својства, а угнежђивање повезује објекте. Агент може да уређује и .luau скрипте, .wgsl шејдере и ресурсе пројекта. Задајте му рад у фазама како бисте могли да усмерите распоред и понашање док се преглед ажурира.
  4. Проверите градњу пројекта и његов садржај. Затражите од агента да покрене rive myproject --verify, која компајлира пројекат без уписивања датотеке .riv, и rive inspect myproject --summary, која приказује проблеме и број објеката. За целу разрешену сцену документована је команда rive inspect myproject --json. Ако је потребна локална датотека за испоруку, без отварања прегледа, команда rive myproject --once уписује непотписану датотеку .riv. Ове провере могу да открију грешке при компајлирању и сценске објекте који недостају или су неочекивани. Rive-ов водич за RML упозорава да успешна градња не доказује да графика изгледа или се понаша како је замишљено.
  5. Снимите важна стања. rive myproject --screenshot=out.png прави PNG без отварања прозора. У примерима се користи --advance=1s за кадар након почетка анимације, --viewport=390x844 за одабрану величину распореда, --data=battery/level=100 за повезане податке и --pointer=click@120,60 --advance=20 за симулирани клик. Вредности и координате изаберите према сопственој сцени. Упоредите снимке различитих стања и величина приказа, а затим их сами прегледајте. Снимак без команде --advance приказује почетну позу сцене; то не мора бити први кадар анимације.
  6. Тестирајте скрипте ако их пројекат садржи. rive myproject --test покреће Luau скрипте пројекта Tests. Rive документује команде --verify --format=json и --test --format=json за аутоматизоване провере; неуспешна градња и тестови враћају излазни код различит од нуле. Агент може да користи те извештаје за дораду кода. Тестови покривају само експлицитно написане провере, зато ручно прегледајте интеракције које нису обухваћене тестовима.
  7. Изаберите рад са налогом када локални прототип буде спреман. Датотека .riv је ресурс за покретање; датотека .rev отвара се ради уређивања у Rive Editor-у. Rive наводи да локално прављење, преглед, провере, тестови и снимци екрана раде без пријаве и без интернета. rive login Пријава је потребна за --publish, --rev, rive push, rive pull и увоз датотеке са налога. Да бисте започели са извезеном резервном копијом уређивача, команда rive create myproject --from-rev=myfile.rev ради без пријаве. За почетак рада са датотеком налога, након пријаве употребите rive create myproject --from-remote-file. Тиме се пројекат повезује са том датотеком: команда rive push myproject отпрема нову ревизију; rive pull myproject преузима измене из уређивача, док команда замењује локалну сцену, скрипте и ресурсе након потврде. Пре преузимања проверите локалне измене.
  8. Пре објављивања проверите потписивање и ограничења извоза. rive myproject --publish прави потписану датотеку .riv и захтева пријаву. Према Rive-у, веб окружења за покретање и његов CDN одбијају непотписане скрипте, па датотека са скриптама намењеним вебу мора да се извезе овим поступком. --publish може да дода водени жиг. У референтном приручнику за команде пише да чиста датотека .riv захтева да пројекат буде повезан са датотеком налога преко команде rive push и да се та датотека налази у радном простору нивоа Cadet или вишег. Услов за водени жиг важи и ако сцена нема скрипте. --rev=<path> Такође захтева пријаву и може да се користи уз команду --once или --publish; уписује датотеку за уређивач, а не замену за ресурс за покретање. Пре објављивања проверите актуелни план налога и стварни извезени резултат.

Rive има и AI агента уграђеног у уређивач. Отвара се у бочној траци уређивача и подлеже условима плана уређивача и кредитима за вештачку интелигенцију. Овај водич описује рад са фасциклом и терминалом уз програмерског агента и CLI; два начина рада с агентом имају различите интерфејсе и услове наплате.

Извори и додатна литература