图形学【免费下载链接】skiaSkia is a complete 2D graphic library for drawing Text, Geometries, and Images. See documentation for contribution instructions.项目地址https://gitcode.com/gh_mirrors/ski/skia点击查看免费下载SkQPSkia Quality Program是 Android CTSCompatibility Test Suite兼容性测试套件的重要组成部分它复用 Skia 现成的单元测试与渲染测试在真实 Android 设备上检验 GPU 以及 OpenGL ES / Vulkan 驱动是否符合兼容性要求。本文以仓库中的 tools/skqp/README.md 为主体结合 tools/skqp 目录下的构建脚本、JNI 层与测试源码完整梳理从环境准备、APK 构建、设备运行到报告获取的整条链路并深入解析其测试筛选与执行原理帮助你理解 SkQP 的架构并掌握本地复现与调试方法。SkQP 是什么CTS 与 Skia 测试能力的桥接SkQP 的本质是一个运行在 Android 设备上的测试程序。它把 Skia 仓库中已经存在的两类测试资产带到了 Android 驱动质量验证场景GPU 单元测试Unit Tests来自 Skia 的skiatest测试框架覆盖 GaneshOpenGL / Vulkan 后端与 Graphite 渲染路径例如gles_aarectmodes、vk_hairmodes这类测试渲染/一致性测试GM 与 SkSL 错误测试GMGolden Master渲染测试用于比对渲染输出SkSL 错误测试则用于验证RuntimeShader对非法着色器程序正确报错。在 CTS 中SkQP 以org.skia.skqp为包名的 instrumented test仪器测试APK 形态交付厂商设备必须通过它来证明自己的 GPU 驱动与 Skia 渲染栈的兼容性。官方会发布预构建的 SkQP APK见 skia.org 的 testing/skqp 页面而本文要讲解的是如何从源码自行构建并运行 SkQP——这对于驱动开发、CTS 问题复现和 Skia 开发者调试尤为关键。整体架构Native 测试内核 Java 仪器测试外壳从仓库源码结构看SkQP 采用Java 测试框架驱动 Native 测试内核的双层架构层次关键文件职责Java 测试入口platform_tools/android/apps/skqp/src/main/java/org/skia/skqp/SkQPRunner.java继承 JUnitRunner负责枚举测试、通过 JNI 调用 native 层、汇总失败并落盘JNI 桥接层tools/skqp/src/jni_skqp.cpp暴露nInit/nExecuteUnitTest/nMakeReport三个 JNI 函数管理AssetManager与全局SkQP单例Native 测试核心tools/skqp/src/skqp.h、tools/skqp/src/skqp.cpp初始化 Skia、枚举并执行测试、输出文本报告独立可执行入口tools/skqp/src/skqp_main.cpp非 APK 场景下的命令行入口支持自定义测试匹配规则GPU 上下文工厂tools/skqp/src/skqp_GpuTestProcs.cpp在 GLES / Vulkan 上下文上运行 Ganesh 与 Graphite 测试Native 侧的SkQP类见 tools/skqp/src/skqp.h封装了全部测试执行逻辑init(SkQPAssetManager*, const char* reportDirectory)一次性初始化注册资源管理器并收集待运行测试executeTest(UnitTest)执行单个单元测试返回错误字符串列表空列表即通过makeReport()把全部结果写入报告目录下的unit_tests.txtgetUnitTests()/getSkSLErrorTests()返回排序后的 GPU 单元测试与 SkSL 错误测试列表。其中SkQPAssetManagertools/skqp/src/skqp.h是资源抽象的接口Android 端通过AAssetManager_open读取 APK 内 assets见 tools/skqp/src/jni_skqp.cpp而桌面/命令行端则直接从文件系统读取见 tools/skqp/src/skqp_main.cpp两者各有一套iterateDir实现来按扩展名枚举资源目录。环境准备JDK、depot_tools、NDK 与 SDK构建 SkQP 之前需要先备齐四样工具Java JDK 8、git、python构建脚本与 Android 工具链的基础依赖。Chromium 的 depot_toolsSkia 依赖管理依赖它克隆后加入PATHgit clone https://chromium.googlesource.com/chromium/tools/depot_tools.git export PATH${PWD}/depot_tools:${PATH}Android NDK用于交叉编译 native 库安装后设置ANDROID_NDK_HOME( cd ~; unzip ~/Downloads/android-ndk-*.zip ) ANDROID_NDK_HOME$(ls -d ~/android-ndk-*) # 或指向你实际安装的位置Android SDK命令行工具设置ANDROID_HOME并把platform-tools含adb加入PATHmkdir ~/android-sdk ( cd ~/android-sdk; unzip ~/Downloads/sdk-tools-*.zip ) yes | ~/android-sdk/tools/bin/sdkmanager --licenses export ANDROID_HOME~/android-sdk # 或指向你实际安装的位置 export PATH${PATH}:${ANDROID_HOME}/platform-tools其中yes | sdkmanager --licenses用于自动接受全部 Android 许可协议——构建脚本 tools/skqp/create_apk.py 中的accept_android_license也会做同样的事。获取正确版本的 Skia 源码SkQP 与特定 Android 版本绑定因此应签出对应的 release 分支或标签git clone https://skia.googlesource.com/skia.git cd skia git checkout origin/skqp/dev # 或所需的 release 标签origin/skqp/dev是 SkQP 的持续集成分支在 CTS 发布周期中Google 会同步对应的 release 标签保证测试预期与目标 Android 版本一致。构建 APKmake_universal_apk依赖同步完成后即可构建tools/git-sync-deps tools/skqp/make_universal_apkmake_universal_apk是一个 shell 包装tools/skqp/make_universal_apk实际执行的是 Python 脚本 tools/skqp/make_universal_apk.py。该脚本会为构建所需的resources目录建立符号链接到platform_tools/android/apps/skqp/src/main/assets/resources见 tools/skqp/make_universal_apk.py让测试资源随 APK 一起打包进 assets调用 tools/skqp/create_apk.py 执行 GN 生成、ninja 编译与 APK 打包默认产出包含 armarmeabi-v7a、arm64arm64-v8a、x86、x64x86_64四种 ABI 原生库的 universal APK输出到out/skqp/skqp-universal-debug.apk。架构映射关系在 tools/skqp/create_apk.py 中定义arm→armeabi-v7aarm64→arm64-v8ax86→x86x64→x86_64如需只构建部分架构可把架构名作为参数传入tools/skqp/make_universal_apk arm x86该脚本还支持三个环境变量见 tools/skqp/make_universal_apk.py环境变量作用SKQP_BUILD_DIR指定中间构建产物目录SKQP_OUTPUT_DIR指定最终 APK 的输出目录SKQP_DEBUG设置后以 debug 模式编译 Skia构建带调试信息的 APK另外要求ninja已加入PATH见 tools/skqp/create_apk.py且源码树处于已同步依赖的状态。安装、运行与结果收集构建完成后依次执行adb install -r out/skqp/skqp-universal-debug.apk adb logcat -c adb shell am instrument -w org.skia.skqp第三条命令以-w等待完成模式运行org.skia.skqp的 instrumentation 测试。测试过程中可用如下命令实时监控进度adb logcat TestRunner org.skia.skqp skia *:S日志中会打印设备端测试输出目录形如01-23 15:22:12.688 27158 27173 I org.skia.skqp: output written to /storage/emulated/0/Android/data/org.skia.skqp/files/output这个目录由 platform_tools/android/apps/skqp/src/main/java/org/skia/skqp/SkQPRunner.java 在构造时创建context.getExternalFilesDir(null)下的skqp_report_时间戳并通过Log.i(TAG, ...)输出到 logcat。把结果拉回本机并打开 HTML 报告OUTPUT_LOCATION/storage/emulated/0/Android/data/org.skia.skqp/files/output adb pull $OUTPUT_LOCATION /tmp/ bin/sysopen /tmp/output/skqp_report/report.htmlbin/sysopen是 Skia 仓库自带的跨平台打开工具。拉取下来的skqp_report目录内含 HTML 汇总报告与逐测试结果。仓库还提供了一个全自动脚本 tools/skqp/test_apk.sh一条命令完成安装、运行、拉取报告并打开tools/skqp/test_apk.sh out/skqp/skqp-universal-debug.apk其内部会先调用 tools/skqp/run_apk.sh后者封装了adb install、logcat清理、am instrument执行与结果目录的adb pull见 tools/skqp/run_apk.sh并把 stdout 与 logcat 分别存为$DST/stdout与$DST/logcat。运行单个测试与按前缀筛选SkQP 的测试名遵循backend_testname的命名约定例如gles_aarectmodesGLES 后端的 aarectmodes 测试。使用-e class指定测试类与方法即可只跑单个测试adb shell am instrument -e class org.skia.skqp.SkQPRunner#gles_aarectmodes -w org.skia.skqpGPU 单元测试统一带unitTest_前缀adb shell am instrument -e class org.skia.skqp.SkQPRunner#unitTest_GrSurface -w org.skia.skqp也可以在test_apk.sh中一次指定多个测试见 tools/skqp/test_apk.sh脚本会将其组装成逗号分隔的-e class参数tools/skqp/test_apk.sh skqp-universal-debug.apk vk_hairmodes gles_gammatext gles_aarectmodes注意unitTest_前缀仅用于通过am instrument直接定位某个单元测试在 platform_tools/android/apps/skqp/src/main/java/org/skia/skqp/SkQPRunner.java 中所有 native 单元测试都以UnitTest_形式注册为 JUnit 测试描述而 README 中示例命令的unitTest_GrSurface则是与SkQP::GetUnitTestName返回的测试名拼接后的完整方法名。若你的 APK 构建版本测试名不同可先用完整 instrumentation 运行一次从日志中查看实际可用名称。不打包 APK以命令行可执行文件方式运行在开发调试阶段可以直接把 SkQP 编译成 Linux/Android 上的可执行文件无需经过 JUnit 与 APK 层先按上文步骤 1–3 完成依赖、源码与构建环境准备编译并推送执行ninja -C out/skqp/arm skqp python tools/skqp/run_skqp_exe out/skqp/armrun_skqp_exetools/skqp/run_skqp_exe会依次完成adb push resources与编译产物skqp到设备/data/local/tmp/skqp/在设备上以skqp skqp_assets report运行再把report目录拉回本地临时目录并用bin/sysopen打开report.html。命令行入口 tools/skqp/src/skqp_main.cpp 的用法为skqp ASSET_DIR OUTPUT_DIR [TEST_MATCH_RULES...]其中测试匹配规则支持强大的通配语法见 tools/skqp/src/skqp_main.cpp规则含义~前缀匹配到的测试一律跳过排除^前缀要求从测试名开头匹配$后缀要求匹配到测试名结尾^...$完全匹配无特殊符号子串包含即匹配匹配语义为若列表中存在非~规则则未命中任何规则的测试被跳过若全部规则都以~开头则除显式排除外其余全部运行见 tools/skqp/src/skqp_main.cpp。例如skqp assets report ^gles_ ~gles_test表示只跑gles_开头且排除gles_test的测试。SkSL 错误测试验证 RuntimeShader 的报错行为除了 GPU 单元测试SkQP 还包含一组SkSL 错误测试用于验证 Android 的RuntimeShaderAPI 在编译非法着色器时是否必然抛错。与单元测试定义在源码中不同这些错误测试定义在资源文件里见 tools/skqp/src/skqp.cpp 与 tools/skqp/src/skqp.cppSkQP 从两个目录收集resources/sksl/errors/包含数百个负向用例如ArgumentCountMismatch.rts、ArrayIndexOutOfRange.rts、DivideByZero.rts、大量Ossfuzz*.rts源自 OSS-Fuzz 的回归用例等resources/sksl/runtime_errors/面向 RuntimeShader 运行时的错误用例如IllegalOperators.rts、InvalidShaderMain.rts、LoopStructureErrors.rts等。由于 Android 仅支持 runtime shader而非 fragment shader、color filter 或 blender收集时只取.rts扩展名文件见 tools/skqp/src/skqp.cpp。执行时Java 侧会用new RuntimeShader(shaderText)实例化着色器若未抛出异常则判定测试失败Shader did not generate any errors.捕获到任何异常则视为通过见 platform_tools/android/apps/skqp/src/main/java/org/skia/skqp/SkQPRunner.java。另外SkSL 错误测试通过文件名规则做版本控制例如sExclusionRulesForSkSLTests中.*ES3.*规则在 AGSL 支持 ES3 之前全部禁用见 tools/skqp/src/skqp.cpp。测试筛选机制CtsEnforcement 与设备 API LevelSkQP 并不会在每台设备上运行全部测试——不同 Android 版本的驱动能力差异要求按设备 API level 决定执行方式。这一机制的核心是CtsEnforcementtests/CtsEnforcement.h每个测试都被标记为三种状态之一kSkip跳过kRunWithWorkarounds带驱动兼容性 workaround 运行Skia 会关闭/开启部分正确性修复kRunStrict严格模式运行fDisableDriverCorrectnessWorkarounds true不应用驱动修正见 tools/skqp/src/skqp.cpp。判定逻辑见 tests/CtsEnforcement.cppif (apiLevel fStrictVersion) return RunMode::kRunStrict; else if (apiLevel fWorkaroundsVersion) return RunMode::kRunWithWorkarounds; return RunMode::kSkip;设备 API level 的来源是 Android 系统属性ro.vendor.api_levelvendor API level与 SDK API level 不同在SkQP::init中读取见 tools/skqp/src/skqp.cpp若以SKQP_ENFORCE_ALL_INCLUDED_TESTS宏构建用于 Android 框架侧的全量测试覆盖不参与 CTS 判定则强制使用kNextRelease值见 tools/skqp/src/skqp.cpp。CtsEnforcement::ApiLevel枚举tests/CtsEnforcement.h直接对应 Android vendor API levelkApiLevel_T 33、kApiLevel_U 34自 Android 14-QPR3 起 vendor API level 采用YYYYMM格式kApiLevel_202404、kApiLevel_202504、kApiLevel_202604新测试默认标记kNextRelease并在下一个 Android 版本发布时替换为具体值。收集单元测试时get_unit_tests遍历skiatest::TestRegistry::Range()只保留ctsMode ! kSkip的 GPU 测试并断言非 CPU 测试随后按名称排序见 tools/skqp/src/skqp.cpp。报告格式与结果解读每次运行结束后native 层调用SkQP::makeReport()在报告目录写出unit_tests.txt见 tools/skqp/src/skqp.cpp格式为每个测试一行失败测试附带错误详情test_name PASSED * * * test_name FAILED (N errors) 错误详情... * * *同时SkQP::init还会在报告目录生成grdump.txt——若构建启用了SK_ENABLE_DUMP_GPU它会枚举 native GLES 与 Vulkan 上下文并 dump 设备 GPU 信息见 tools/skqp/src/skqp_GpuTestProcs.cpp便于在 CTS 提交缺陷时附上驱动与设备信息。常见问题与调试建议多设备连接adb devices -l查看设备列表设置ANDROID_SERIAL指定目标设备见 tools/skqp/test_apk.sh。结果目录取不到run_apk.sh从 logcat 中正则提取output written to ...路径见 tools/skqp/run_apk.sh若 logcat 被其他日志淹没可先adb logcat -c清理再运行。无头/CI 环境仓库提供基于 Docker 的 Android 模拟器方案 tools/skqp/docker_run_apk.sh它会构建infra/skqp/docker/android-skqp镜像、以--privileged启动模拟器容器并自动完成安装运行与报告拉取SKQP_ARGS环境变量可向其传递测试筛选参数。只想快速复现某个失败优先用-e class org.skia.skqp.SkQPRunner#test定位单测或用run_skqp_exe走命令行通道配合TEST_MATCH_RULES做精细筛选。小结SkQP 把 Skia 庞大的测试体系转化为 Android CTS 可执行的图形栈质量门禁构建侧由make_universal_apk一键产出四 ABI 的 instrumented APK运行侧由 JNI 桥接SkQPnative 内核结果侧以 logcat 路径 HTML 报告交付。理解其 CtsEnforcement 按 API level 分级执行、SkSL 错误测试的资源文件驱动模式以及unitTest_/-e class的筛选语法无论是厂商做 CTS 认证还是开发者做驱动兼容性调试都能快速定位问题所在。赞分享图形学【免费下载链接】skiaSkia is a complete 2D graphic library for drawing Text, Geometries, and Images. See documentation for contribution instructions.项目地址https://gitcode.com/gh_mirrors/ski/skia点击查看免费下载相关推荐Skia图形库静态分析工具代码质量与安全检查Skia图形库静态分析工具代码质量与安全检查 作为2D图形渲染引擎Skia的代码质量直接影响客户端渲染稳定性与安全性。本文系统梳理Skia内置的静态分析工具图形学Android动画进阶深入理解SVG矢量图形与路径动画Android动画进阶深入理解SVG矢量图形与路径动画 前言 在Android动画开发中SVGScalable Vector Graphics矢量图形扮示例工程移动开发如何构建企业级多模态智能体系统UI-TARS桌面应用架构设计与部署实践如何构建企业级多模态智能体系统UI TARS桌面应用架构设计与部署实践 UI TARS桌面应用作为开源多模态AI代理栈的核心组件通过视觉语言模型 VLM 技人工智能大模型AI Agent桌面应用GUI 自动化浏览器控制MCP 服务MCP Clients上一篇Repomix FAQ 与故障排查实战私有仓库、远程打包、Token 优化与 MCP 工作流下一篇MAX 统一 DFlash 投机解码架构深度解析Gemma4 31B 目标模型与块级草稿模型的融合图实现创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
