1. 课程导学与项目总览

欢迎来到《Android相机框架工程案例：扫码相机与文档扫描应用开发》课程。本章作为课程的开篇，将为你勾勒出整个学习路径的全貌。我们将明确课程的核心目标，通过功能演示直观感受最终成果，并深入剖析支撑项目落地的关键技术栈与开发环境要求。

1.1 课程目标：从理论到工程实战

本课程并非简单的API调用指南，而是一个完整的工程化案例教学。通过本课程，你将实现以下目标：

• 掌握CameraX核心开发范式：理解生命周期感知、预览、图像分析等核心用例，并能够灵活组合。
• 集成Google ML Kit实现实时扫码：从条形码扫描API的集成、配置到性能优化，构建高识别率的扫码相机。
• 运用OpenCV进行文档图像处理：实现文档边缘检测、透视变换、图像增强等核心算法，打造专业的文档扫描仪。
• 构建完整的应用架构：学习MVVM架构在相机应用中的实践，管理复杂的相机状态与UI交互。
• 产出可上线的工程代码：最终交付一个功能完备、代码规范、架构清晰的扫码与文档扫描应用。

1.2 项目功能演示：扫码相机与文档扫描

在动手编码之前，我们先通过功能演示来明确项目的最终形态。整个应用将包含两大核心模块：

1.3 技术栈概览：三驾马车驱动应用

本项目的技术栈由三个核心框架构成，它们各司其职，协同工作。下面的SVG架构图清晰地展示了它们之间的关系。

下表对三大框架的核心职责与在本项目中的角色进行了详细对比：

1.4 开发环境要求

为了确保你能够顺利跟随课程进行开发，请提前准备好以下环境。我们推荐使用统一的版本以避免兼容性问题。

• IDE：Android Studio Hedgehog (2023.1.1) 或更高版本。
• 构建工具：Gradle 8.2+，Android Gradle Plugin 8.2+。
• 开发语言：Kotlin 1.9+，课程代码全部使用Kotlin编写。
• 最低SDK版本：API 24 (Android 7.0)。
• 目标SDK版本：API 34 (Android 14)。
• 真机调试：建议准备一台Android 10.0 (API 29) 或以上版本的实体手机，以获得最佳的CameraX与ML Kit体验。模拟器对相机支持有限。

以下是课程中核心依赖库的版本参考，你可以在项目的 build.gradle.kts 文件中进行配置：

// 核心依赖版本参考
val cameraxVersion = "1.3.1"
val mlkitBarcodeVersion = "17.2.0"
val opencvVersion = "4.9.0"

dependencies {
    // CameraX
    implementation("androidx.camera:camera-core:$cameraxVersion")
    implementation("androidx.camera:camera-camera2:$cameraxVersion")
    implementation("androidx.camera:camera-lifecycle:$cameraxVersion")
    implementation("androidx.camera:camera-view:$cameraxVersion")

    // ML Kit Barcode Scanning
    implementation("com.google.mlkit:barcode-scanning:$mlkitBarcodeVersion")

    // OpenCV (推荐使用官方AAR包或通过动态加载方式引入)
    // 具体引入方式将在后续章节详细讲解
}