.riv] 런타임 컨트롤, JavaScript 구성 편집, ViewModelInstance 디버깅 도구, 미디어 및 독립 수출, 번들 네이티브 MCP 사이드카 및 데스크톱 자동 업데이트 지원.

미디어 수출 및 녹음을 위해 미디어 수출 및 녹음을 참조하십시오. 릴리스 역사는 changelog에 속한다; 검증 증거는 보고서에 보관됩니다.

출시

• 준비된 릴리스 후보자: 2.5.9 (필요한 합격 및 간행).
• 현재 공개 릴리스 : 2.5.8 (GitHub 릴리스).
• macOS 다운로드 및 업데이트 응용 프로그램은 개발자 ID 서명, 표기, 및 stapled입니다. 업데이트자는 별도의 업데이트 서명을 유지합니다.

회귀 문

Repo는 응용 프로그램, 수출 및 창 크롬 표면에 대한 사전 구축 가드를 명시했습니다.

• npm run check:architecture 파일 크기 및 폴더 모양 예산 시행
• npm run check:deps 종속성-cruiser 수입 경계
• tests/smoke/ui-regressions.smoke.test.js 공유된 scrollbar 계약, 사용자 정의 창 크롬 구조, Tauri 창 구성 및 수출된 데모 크롬 계약
• `tests/unit/ui/window-chrome.test.

Rive Animation Viewer

A local and desktop viewer for .riv files with runtime controls, JavaScript configuration editing, ViewModelInstance debugging tools, media and standalone export, a bundled native MCP sidecar, and desktop auto-update support.

For media export and recording, see Media export and recording. Release history belongs in the changelog; validation evidence is kept in reports.

Release

• Prepared release candidate: 2.5.9 (native acceptance and publication pending).
• Current public release: 2.5.8 (GitHub release).
• macOS downloads and updater apps are Developer ID signed, notarized, and stapled; updater payloads retain their separate update signatures.

Regression Gates

The repo has explicit prebuild guards for the application, export, and window-chrome surfaces:

• npm run check:architecture enforces file-size and folder-shape budgets
• npm run check:deps enforces dependency-cruiser import boundaries
• tests/smoke/ui-regressions.smoke.test.js protects the shared scrollbar contract, custom window-chrome structure, Tauri window config, and exported demo chrome contract
• tests/unit/ui/window-chrome.test.js protects desktop window-control wiring and Tauri/non-Tauri behavior split
• npm run test runs the full Vitest suite before every package build
• cargo check --manifest-path src-tauri/Cargo.toml validates the native Tauri layer

These gates reduce regression risk, but they remain code and DOM contract tests. Packaged desktop behavior still requires native acceptance with a real .riv file.

Quick Start

npm install
npm start  # Opens the browser DEV viewer at http://localhost:1420; MCP uses isolated port 9278

Browser preview and packaged DEV sessions may share port 9278, but the bridge always routes agent commands to the packaged desktop app while it is connected. The browser remains a fallback only when no desktop RAV peer is present.

Features

Core Viewer

• File Loading: Open button plus drag/drop file loading for .riv files
• Desktop Open With: Double-click / open-with / single-instance handoff for .riv files
• Runtime Selection: Toggle between Canvas and WebGL2 renderers
• Runtime Version Selection: Pick runtime semver (Latest (auto), the latest 4 concrete versions, or Custom) from Settings
• Layout Options: Fit and alignment are surfaced directly in the main toolbar next to playback controls
• Background Color: Color picker with No BG reset for transparent canvas backgrounds
• Explicit Canvas Size: Settings can pin the canvas to a specific width/height in pixels and optionally lock the aspect ratio
• Playback Controls: Play, pause, and reset/restart (reset restarts playback in place with autoplay and restores control values)