ID

ivg-design/rive-animation-viewer

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

31 stars 6 forks Качество 66 Тренд 25NOASSERTION

Rive animation desktop viewer (Tauri) с двойной платформой (Mac/PC). Функции демо поколения пакетов для распространения автономных анимационных исполняемых файлов для клиентов. Встроенный MCP-сервер

Обзор

Местный и настольный просмотрщик для файлов .riv с элементами управления временем выполнения, редактированием конфигурации JavaScript, инструментами отладки ViewModelInstance, средствами массовой информации и автономным экспортом, встроенной встроенной боковой панелью MCP и поддержкой автоматического обновления рабочего стола. Для экспорта и записи СМИ см. Экспорт и запись СМИ. История выпуска принадлежит журналу изменений; доказательства валидации хранятся в отчетах. Текущий публичный релиз: 2.5.5 (релиз GitHub). Загрузки macOS и приложения для обновления являются подписанными, нотариально заверенными и сшитыми; полезные нагрузки для обновления сохраняют свои отдельные подписи обновления. Репо имеет явные предохранители для применения, экспорта и оконно-хромных поверхностей: - npm run check:architectureforces file-size and folder-shape budgets - npm run check:depsforces Dependency-cruiser import boundaries - tests/smoke/ui-regressions.smoke.test.

Обзор (машинный перевод)

Локальный и настольный просмотрщик для файлов с управлением временем выполнения, редактированием конфигурации JavaScript, инструментами отладки ViewModelInstance, средствами массовой информации и автономным экспортом, встроенной встроенной коляской MCP и поддержкой автоматического обновления рабочего стола.

Для экспорта и записи СМИ см. Экспорт и запись СМИ. История выпуска принадлежит журналу изменений; доказательства валидации хранятся в отчетах.

##Выпуск

Подготовленный кандидат на релиз: 2.5.9 (родной прием и публикация в ожидании).

  • Текущий публичный релиз: 2.5.8 (релиз GitHub). Загрузки macOS и приложения для обновления являются подписанными, нотариально заверенными и сшитыми; полезные нагрузки для обновления сохраняют свои отдельные подписи обновления.

Регрессионные ворота

Репо имеет явные предохранители для применения, экспорта и оконно-хромных поверхностей:

  • npm run check:architecture обеспечивает исполнение бюджетов размером с файл и формой папки
  • npm run check:deps обеспечивает соблюдение границ импорта для круизеров-иждивенцев tests/smoke/ui-regressions.smoke.test.js защищает общий контракт на прокрутку, пользовательскую структуру оконного хрома, конфигурацию окна Tauri и экспортный контракт на демонстрационный хром
  • 'tests/unit/ui/window-chrome.test.

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального README. Открыть оригинал.

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)
Открыть полный README на GitHub

Установка

This server does not publish a one-line install command.

Open the repository installation guide Новичок в MCP? Начните с руководства на mcpskill.org →