CLI baru Rive memungkinkan agen pengodean mengerjakan grafika interaktif sebagai berkas proyek. Agen dapat menulis Rive Markup Language (RML), skrip Luau, dan shader, lalu meminta CLI mengompilasi, memeriksa, menguji, dan merender hasilnya. Seseorang dapat melihat pratinjau lokal dan merevisi desain. Staf Rive memperkenalkan CLI ini sebagai pratinjau teknis pada 11 September; halaman Unduhan Rive, yang diperiksa pada 27 September, mencantumkannya di bagian Akses Awal.

Daftar periksa ini mengikuti dokumentasi Rive. BIG CHANGE hanya meninjau dokumentasi. Kami tidak memasang CLI, membuat berkas, atau menguji grafika yang dihasilkan agen. Video panduan Rive memperlihatkan proses yang dimaksud, dengan manusia dan agen bekerja bersama.

Perubahan besar

  • Yang berubah: Adegan Rive kini memiliki jalur berbasis teks untuk agen pengodean. Agen dapat mengedit RML di folder proyek, sementara CLI mengompilasinya menjadi berkas runtime .riv atau berkas .rev untuk pekerjaan lanjutan di Editor.
  • Mengapa ini penting: Desainer dan pengembang front-end atau gim dapat meninjau perubahan sumber bersama berkas proyek lainnya serta memakai pemeriksaan CLI selama iterasi. Mereka tetap perlu menilai hasil render dan interaksi sebelum menggunakan aset dalam produk.
  • Yang perlu dicermati: Memindahkan prototipe lokal ke web merupakan keputusan terpisah. Berkas dengan skrip memerlukan build --publish; build .riv yang bersih juga memerlukan pengaitan berkas akun dan ruang kerja Cadet atau lebih tinggi. Periksa persyaratan tersebut dan grafika akhir sebelum menerapkannya.

Daftar tugas yang didokumentasikan

  1. Periksa akses dan pasang perangkat lunak. Rive mencantumkan macOS pada Apple Silicon, Linux x86_64, dan Windows sebagai sistem yang didukung. Panduan Memulai menyediakan petunjuk pemasangan terpisah untuk Windows dan macOS/Linux; ikuti petunjuk Windows terkini di halaman tersebut. Jalankan rive doctor setelah pemasangan. Referensi perintah juga mendokumentasikan rive --version; catat versi yang benar-benar Anda pasang karena perangkat lunak ini masih pratinjau. Pengumuman Rive pada 11 September menyatakan CLI gratis tanpa batas selama masa pratinjau. Pernyataan bertanggal itu tidak menetapkan harga CLI permanen. Tabel paket terkini membahas akun Rive dan Editor Agent bawaan, jadi periksa ketentuan terbaru sebelum menerbitkan.
  2. Buat proyek teks dan buka pratinjau. rive create myproject membuat scene.rml, rive.yaml, instruksi agen di AGENTS.md dan CLAUDE.md, serta berkas .gitignore. Jalankan rive myproject di satu terminal. Menurut Rive, CLI memantau folder, membangun ulang saat berkas disimpan, dan menulis myproject/build/myproject.riv. Adegan awal memiliki artboard, linimasa, dan mesin status, tetapi belum ada gambar. Pratinjau awalnya berupa persegi panjang gelap.
  3. Berikan folder proyek kepada agen pengodean beserta tugas desain yang spesifik.Panduan Agen AI dari Rive menyebut Claude Code, Cursor, atau agen lain yang dapat membaca dan menulis berkas serta menjalankan perintah shell. Instruksi yang dihasilkan menjelaskan kepada agen cara menggunakan rive docs dan rive schema untuk menemukan objek dan properti yang didukung. RML adalah XML: elemen mewakili tipe Rive, atribut mewakili propertinya, dan penyarangan menghubungkan objek. Agen juga dapat mengedit .luau skrip, .wgsl shader dan aset proyek. Minta agen bekerja bertahap agar Anda dapat mengarahkan ulang tata letak dan perilaku sembari pratinjau diperbarui.
  4. Periksa build dan isinya. Minta agen menjalankan rive myproject --verify, yang mengompilasi tanpa menulis berkas .riv, serta rive inspect myproject --summary, yang melaporkan masalah dan jumlah objek. Untuk adegan lengkap yang telah diselesaikan, dokumentasi menyebut rive inspect myproject --json. Jika proyek memerlukan berkas lokal yang dapat dibagikan tanpa membuka pratinjau, rive myproject --oncemenulis berkas .riv tanpa tanda tangan. Pemeriksaan ini dapat menemukan kesalahan kompilasi serta objek adegan yang hilang atau tidak terduga. Panduan RML Rive memperingatkan bahwa build bersih tidak memastikan grafika terlihat atau berperilaku sesuai tujuan.
  5. Ambil gambar untuk keadaan yang penting. rive myproject --screenshot=out.png merender PNG tanpa jendela. Contoh Rive menggunakan --advance=1s untuk bingkai setelah animasi dimulai, --viewport=390x844 untuk ukuran tata letak yang dipilih, --data=battery/level=100 untuk data terikat, dan --pointer=click@120,60 --advance=20 untuk klik simulasi. Pilih nilai dan koordinat dari adegan Anda sendiri. Bandingkan hasil tangkapan di beberapa keadaan dan ukuran tampilan, lalu periksa sendiri. Hasil tangkapan tanpa --advance menampilkan pose awal yang dibuat; itu belum tentu bingkai pertama animasi pembuka.
  6. Jalankan uji skrip jika proyek memilikinya. rive myproject --test menjalankan skrip Luau Tests proyek. Rive mendokumentasikan --verify --format=json dan --test --format=json untuk pemeriksaan otomatis; build dan pengujian yang gagal mengembalikan kode keluar bukan nol. Agen dapat memakai laporan tersebut untuk merevisi sumbernya. Pengujian hanya mencakup pernyataan yang benar-benar ditulis, jadi tinjau interaksi yang tidak dicakup oleh pengujian.
  7. Pilih jalur akun ketika prototipe lokal siap. Berkas .riv adalah aset runtime; berkas .rev dibuka untuk diedit di Rive Editor. Rive menyatakan pembuatan lokal, pratinjau, verifikasi, pengujian, dan tangkapan layar dapat dilakukan tanpa masuk akun dan tanpa koneksi internet. rive login diperlukan untuk --publish, --rev, rive push, rive pull dan mengimpor berkas akun jarak jauh. Untuk memulai dari cadangan Editor yang diekspor, rive create myproject --from-rev=myfile.revdapat digunakan tanpa masuk. Untuk memulai dari berkas akun, gunakan rive create myproject --from-remote-filesetelah masuk. Cara kedua ini mengaitkan proyek dengan berkas itu: rive push myprojectmengunggah revisi; rive pull myprojectmengambil perubahan Editor dan menimpa adegan, skrip, dan aset lokal setelah konfirmasi. Tinjau perubahan lokal sebelum mengambil pembaruan.
  8. Periksa batas penandatanganan dan ekspor sebelum menerbitkan. rive myproject --publish menulis berkas .riv bertanda tangan dan memerlukan masuk akun. Rive menyatakan runtime web dan CDN-nya menolak skrip tanpa tanda tangan, jadi berkas yang memuat skrip untuk web harus memakai jalur ini. --publishdapat menambahkan tanda air. Referensi perintah Rive menyatakan build .riv yang bersih mensyaratkan proyek terhubung ke berkas akun melalui rive push dan berkas tersebut berada di ruang kerja Cadet atau lebih tinggi. Ketentuan tanda air tetap berlaku meskipun adegan tidak memiliki skrip. --rev=<path>juga memerlukan masuk akun dan dapat digunakan bersama --once atau --publish; perintah itu menulis berkas Editor, bukan pengganti aset runtime. Periksa paket akun terkini dan hasil ekspor yang sebenarnya sebelum menerapkan.

Rive juga memiliki Agen AI bawaan di Editor. Fitur ini dibuka dari bilah sisi Editor dan mengikuti ketentuan paket serta kredit AI Editor. Alur kerja folder dan terminal dalam panduan ini menggunakan agen pengodean yang dipasangkan dengan CLI; kedua jalur agen tersebut memiliki antarmuka dan konteks penagihan berbeda.

Sumber & bacaan lanjutan