开发环境配置：Android Studio 工程、CMakeLists 与 build.gradle 依赖、API 级别要求

本章完成《Surface 与 MediaCodec 边界实操指南》所需的开发环境搭建。核心目标：创建 Android Studio 工程，集成 CMakeLists 编译原生代码，在 build.gradle 中配置 MediaCodec/Surface 相关依赖，并设定最低 API 级别以保证接口可用。以下步骤适用于 Android Studio Arctic Fox 及更高版本。

4.1 工程结构与编译链总览

下图展示 Android 项目各模块、依赖及编译链的关系。灰色虚线框代表可选模块，实线框为必选。箭头标识依赖流向。

4.2 创建工程与配置 CMakeLists

在 Android Studio 中通过 New Project → Native C++ 模板创建。模板会自动生成 CMakeLists.txt 和 native-lib.cpp。以下为适应 MediaCodec/Surface 操作的标准化 CMakeLists.txt 示例：

cmake_minimum_required(VERSION 3.18.1)
project("media-surface-bridge")

# 设置 C++ 标准为 C++17，启用 exceptions / rtti
set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)
set(CMAKE_CXX_EXTENSIONS OFF)

# 添加 native 库
add_library(
    native-media
    SHARED
    native-lib.cpp
    # 后续可添加更多 .cpp 文件
)

# 链接系统库（mediandk 提供 AMediaCodec API）
target_link_libraries(
    native-media
    android
    mediandk           # 必须！用于 AMediaCodec、AMediaFormat
    log                # 可选，用于 __android_log_print
    jnigraphics        # 可选，用于直接操作 Bitmap 像素
)

4.3 build.gradle 依赖与 API 级别要求

Module 级 build.gradle 需配置 externalNativeBuild 以及最低/目标 SDK 版本。以下为关键片段：

android {
    compileSdk 34          // 使用最新的 API 定义
    ndkVersion "25.2.9519653"  // 建议 NDK r25 及以上

    defaultConfig {
        minSdk 21          // MediaCodec 自 API 16 提供，但 Surface 输入需 API 21+
        targetSdk 34
        externalNativeBuild {
            cmake {
                cppFlags "-std=c++17 -O2"
                // 指定 ABI 过滤，避免不必要的构建
                abiFilters "arm64-v8a", "x86_64"
            }
        }
    }

    buildTypes {
        release {
            minifyEnabled true
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
        }
    }

    externalNativeBuild {
        cmake {
            path "CMakeLists.txt"
            version "3.22.1"   // 与 local.properties 或 SDK Manager 安装版本匹配
        }
    }
}

dependencies {
    // 无需额外第三方库——MediaCodec / Surface 均为平台 API
    implementation 'androidx.appcompat:appcompat:1.6.1'
    implementation 'androidx.constraintlayout:constraintlayout:2.1.4'
}

4.4 API 级别关键对照表

不同 MediaCodec 与 Surface 操作所需的最低 API 级别如下，配置时须保证 minSdk 不低于对应值：

4.5 调试验证与常见错误修正

配置完成后执行 Build → Make Project。若遇到以下问题，按表格排查：