Rive iOS

用于 Rive 的 iOS/macOS 运行时库，同时支持 UIKit、AppKit 和 SwiftUI。

该库通过 Swift Package Manager 和 Cocoapods 分发。

• ⭐ Rive 概述
• 🚀 入门指南 & API 文档
• 🔍 支持的设备
• 📚 示例
• 🏃 迁移指南
• 👨‍💻 贡献
• ❓ 问题

Rive 是一款实时交互式设计和动画工具，可帮助团队创建和运行可在任何地方使用的交互式动画。 设计师和开发者使用我们的协作编辑器来创建可响应不同状态和用户输入的动态图形。 我们轻量级的开源运行时库使他们能够将动画加载到应用程序、游戏和网站中。

🏡 主页

📘 Rive 文档

🛠 Rive 论坛

要开始使用 Rive iOS，请查看以下资源

• Rive iOS 入门指南

更多信息请参考 Rive 帮助文档的运行时部分

• 动画播放
• 布局
• 状态机
• Rive 文本
• Rive 事件
• 加载资源

目前，此运行时库支持的最低 iOS 版本为 14.0+。 支持的设备包括 iPhone、iPad 和 Mac Catalyst。 macOS 支持的目标版本为 13.1。

查看 Example-iOS/ 文件夹，其中包含使用 Rive iOS/macOS 运行时的示例应用程序。

在 XCode 中打开项目，并确保选择的 scheme/target 设置为 Preview/Preview (macOS)。 这些 scheme 使用托管的 Rive 包依赖项。 其他 target 用于本地开发，需要额外的配置和设置。 有关切换 scheme 的说明，请参阅 自定义项目的构建 scheme，有关更多信息，请参阅 CONTRIBUTING.md。

该示例展示了通过 UIKit 和 SwiftUI 示例使用高级 RiveViewModel API 的多种方法，包括

• 通过 URL 或 bundle 中的资源设置 Rive 文件
• 设置布局和循环模式选项
• 在一个组件上显示单个或多个动画/画板
• 通过输入设置和操作状态机
• ...等等!

要获得有关在运行时或其他工具中使用 Rive 的更多示例和资源，请查看 awesome-rive 代码仓库。

正在使用旧版本的运行时，需要了解如何升级到最新版本吗？ 请查看我们帮助中心中的以下迁移指南，这些指南可帮助您完成版本升级；包括重大更改！

迁移指南

我们欢迎贡献！ 查看我们的 贡献文档，以获取有关如何本地运行此项目、示例等的更多详细信息。

在使用运行时时遇到问题，或者想提出功能/API 建议以帮助您更好地进行开发？ 在我们的 问题 选项卡中记录问题！ 您还可以在那里浏览旧的问题和讨论主题，以查看可能对常见问题有效的解决方案。