Android APNG Drawable 使用教程

1. 项目目录结构及介绍

apng-drawable 项目是一个为 Android 平台编写的轻量级、快速的 Animated Portable Network Graphics (APNG) 图片解码器库。以下是项目的目录结构及其介绍：

apng-drawable/
├── .github/               # GitHub 工作流和配置文件
├── gradle/                # Gradle 构建脚本
├── sample-app/            # 示例应用程序的源代码
├── libpng_version         # libpng 版本文件
├── download_libpng_and_apply_apng_patch.sh # 下载并应用 libpng 补丁的脚本
├── README.md              # 项目说明文件
├── CODE_OF_CONDUCT.md     # 项目行为准则
├── CONTRIBUTING.md        # 贡献指南
├── LICENSE                # 项目许可文件
└── NOTICE                 # 项目通知文件

• .github/: 包含 GitHub Actions 工作流文件，用于自动化项目的一些任务，如发布和测试。
• gradle/: 包含项目构建的 Gradle 脚本。
• sample-app/: 包含一个示例 Android 应用程序的源代码，展示了如何使用 apng-drawable 库。
• libpng_version: 包含用于下载正确版本的 libpng 的版本号。
• download_libpng_and_apply_apng_patch.sh: 脚本用于下载 libpng 源码并应用 APNG 补丁。
• README.md: 项目的主说明文件，包含了如何使用库的说明。
• CODE_OF_CONDUCT.md: 定义了项目参与者的行为准则。
• CONTRIBUTING.md: 提供了如何为项目贡献的指南。
• LICENSE: 项目使用的 Apache-2.0 许可证文件。
• NOTICE: 包含了项目依赖的第三方库的信息。

2. 项目的启动文件介绍

项目的启动主要是通过编译和运行 sample-app 目录下的 Android 应用程序。这个示例应用程序展示了如何在 Android 应用中使用 apng-drawable 库。

在 sample-app 目录中，关键的启动文件是：

• build.gradle: 这是示例应用程序的构建脚本，定义了项目的依赖、构建类型和任务。
• MainActivity.kt: 这是示例应用程序的主活动文件，负责展示 APNG 图片。

3. 项目的配置文件介绍

项目的配置主要在 gradle 目录下的文件中完成。以下是一些重要的配置文件：

• build.gradle.kts (顶层): 这是项目顶层的构建脚本，定义了所有子项目的通用配置，包括仓库和依赖管理。
• build.gradle (sample-app): 这是特定于 sample-app 的构建脚本，定义了应用程序的依赖和特定配置。
• gradle.properties: 包含了全局的 Gradle 属性设置，如 Gradle 版本和 JVM 参数。

这些配置文件是项目构建和运行的关键，确保了项目依赖的正确加载和编译环境的正确设置。