ZoomImage 开源项目使用手册

1. 项目目录结构及介绍

ZoomImage 是一个专为 Kotlin 多平台编写的图片手势缩放查看库，适用于 Android 视图以及 Compose 多平台环境。下面是该仓库的主要目录结构概述：

zoomimage/
├── build.gradle.kts         # 构建脚本
├── settings.gradle.kts     # 设置文件，指定项目结构
├── idea/                    # IntelliJ IDEA 相关配置文件夹
├── run/                     # 运行相关脚本
├── gradle.properties        # Gradle 属性配置
├── gradlew*                 # Gradle 启动脚本（跨平台）
├── gradlew.bat              # Windows 平台Gradle启动脚本
├── src                      # 源代码目录
│   ├── main                 # 主入口源码
│   │   ├── kotlin           # Kotlin源代码
│   │   └── resources        # 资源文件
│   ├── androidMain          # Android特有源码
│   ├── iosMain              # iOS特有源码
│   ...                      # 其他平台特定的源码目录
├── docs                     # 文档资料
├── samples                  # 示例应用代码
├── .gitignore               # Git忽略文件配置
├── LICENSE.txt              # 许可证文件
├── README.md                # 项目主读我文件
├── README_zh.md             # 中文版项目说明文件
└── ...                      # 其余辅助工具或配置文件

每个模块内部包含了实现特定功能的Kotlin源代码以及必要的资源文件。samples目录提供了不同场景下的使用示例。

2. 项目的启动文件介绍

ZoomImage作为一个库项目，并没有直接可执行的“启动文件”。它的使用主要是通过将其作为依赖添加到你的项目中来实现。例如，在一个Kotlin多平台或者Android项目中，你将通过在你的构建文件(build.gradle.kts)中添加对应的依赖项来“启动”对ZoomImage库的使用。比如，使用Coil图片加载器的Compose版本添加方式：

dependencies {
    implementation("io.github.panpf.zoomimage:zoomimage-compose-coil:$LAST_VERSION")
}

这里的$LAST_VERSION应替换为ZoomImage的最新版本号，具体版本可在项目的README.md或Maven Central上查找。

3. 项目的配置文件介绍

• build.gradle.kts: 主构建配置文件，定义了项目的依赖关系、插件、编译选项等。

• settings.gradle.kts: 定义了项目的结构，如果项目含有子模块，则会在该文件中声明它们。

• gradle.properties: 包含了Gradle构建的一些全局属性，如版本号、仓库地址等默认设置。

• .gitignore: 列出了Git应该忽略的文件或文件夹，以避免不必要的文件被版本控制。

对于配置方面，重要的是要正确设置依赖关系，确保使用的ZoomImage版本与你的开发环境兼容，并且遵循任何特别的构建指令，这些信息通常在项目的README.md文件中有详细说明。

注意

实际的配置细节可能会根据版本更新而变化，建议参考项目最新的README.md文件获取最准确的引导和配置指示。