Compottie: Compose 多平台Adobe After Effects动画渲染引擎教程

Compottie: Compose 多平台Adobe After Effects动画渲染引擎教程

compottie Compose Multiplatform Lottie animations // port of airbnb/lottie-compose 项目地址: https://gitcode.com/gh_mirrors/co/compottie

Compottie是一个用于多平台Jetpack Compose应用的Adobe After Effects动画（通过Bodymovin导出的Lottie格式）渲染引擎。本教程将指导您了解其主要的目录结构、关键的启动文件以及相关配置。

1. 项目目录结构及介绍

Compottie项目在GitHub上的结构精心组织，便于开发者理解和集成。以下是核心组件及其说明：

• root: 主项目目录。
  • compottie: 核心模块，包含了渲染引擎和Json字符串动画规范。支持两种分支，1.x 使用Skottie和lottie-android作为平台渲染器，而2.x 配备了自研的多平台渲染引擎。
  • compottie-dot: 特殊模块，支持.dotLottie和ZIP动画规格，专为Compottie 2.x 设计，实现更小尺寸的动画文件并支持自动链接资产。
  • compottie-network: 提供网络加载功能，允许从Web加载动画和资源，同样为2.x版本设计，依赖Ktor进行网络请求，并使用Okio进行本地缓存管理。
  • compottie-resources: 集成了Compose官方资源管理功能来处理资产和字体，适用于Compottie 2.x。
  • example: 示例应用，展示了如何在实际项目中集成和使用Compottie。
  • 其他辅助文件如build.gradle.kts, README.md, LICENSE等标准Git仓库文件。

2. 项目的启动文件介绍

在Compottie项目中，虽然“启动”通常指的是应用程序的入口点，但对库项目而言，重要的是示例项目(example)内的MainActivity.kt或相应的启动Activity。这个文件展示了如何初始化Compottie并在UI中展示Lottie动画。它不是Compottie库本身的启动文件，而是用户的应用通过引入Compottie后可能参考的代码模板。

3. 项目的配置文件介绍

主构建配置 (build.gradle.kts)

每个子模块（如compottie, compottie-dot, 等）都有自己的build.gradle.kts文件，定义了模块的依赖、编译配置和版本信息。例如，在根目录的build.gradle.kts，或者各子模块的对应文件中，会看到对于Gradle插件的配置以及依赖声明的逻辑，这是控制项目构建流程的关键。

// 假设在example模块的build.gradle.kts片段
dependencies {
    implementation(project(":compottie"))
    // 这里会添加其他必要的库依赖
}

属性文件和许可证

• gradle.properties: 可能包括项目的构建属性，比如Java版本设置。
• LICENSE: 记录了该项目的授权许可方式，通常是MIT或其他开源许可协议。

请注意，对于具体配置的细节，开发者应直接查看相关文件内注释和设定值，以获取最准确的信息。此外，由于项目是持续更新的，具体版本的依赖和配置可能会有所变化，务必参照最新的源码和文档。

compottie Compose Multiplatform Lottie animations // port of airbnb/lottie-compose 项目地址: https://gitcode.com/gh_mirrors/co/compottie