MapLibreParticleLab/docs/报告/40-02A_Android粒子Validation测试界面紧凑化_Codex完成报告_v1.md

40-02A Android 粒子 Validation 测试界面紧凑化 Codex 完成报告 v1

结论

代码阶段完成，当前状态为 IMPLEMENTED / WAITING FOR ANDROID UI VALIDATION。

• 实际开始 HEAD：00b3510ddb0ee6439f3a2392dcbd391cd5f2c7e0（docs: record 40-02 implementation）。
• 实际完成实现 HEAD：f4d519ca789c0488d6b9d8259427ac070b15eb63（ui: compact particle validation controls）；本报告作为紧随其后的文档收尾提交。

修改

• ParticleCoreLayerValidationActivity.kt：只将长状态说明替换为单行紧凑状态，显示 mask、运行状态、EAST/NORTH 或 T0/T1 与 mix；所有 action/callback 未改。
• activity_particle_core_layer_validation.xml：底部控制区由 7 行收为 4 行。状态行 36dp，控制行 34dp，padding 从 12dp 降为 4dp；MapView 继续全屏作为底层主观察区。
• styles_particle_validation.xml：集中定义 32dp minimum-height、11sp、零 padding 的紧凑按钮样式。

原布局约为 7 个默认 48dp 按钮行加 12dp padding，容易超过 350dp；新控制区约为 36dp + 4×34dp + 8dp padding，即约 180dp。横屏中额外空间全部回到 MapView/粒子区域。

保留功能

UNIFORM EAST、UNIFORM NORTH、T0 EAST/T1 NORTH、ADVANCE B→C、MIX 0/50/100、ACTIVE、STATIC、DISABLE、ENABLE、GLOBAL、OCEAN A、OCEAN B、DATELINE、WORLD WRAP 均保留原 XML ID 和 Kotlin click binding。

未修改任何粒子 Core、shader、GPU Field、timeMix、Simulation、Trail、Composite、Mask、Camera/transform、ABI 或 Gradle 文件。

检查与验证

• 16 个现有 button ID 与 Kotlin R.id binding 的静态逐项核对：通过。
• git diff --check：通过。
• Java 17 标准 XML parser：通过。
• 按任务限制未运行 Android Gradle、APK、ADB、VM 或实机。

用户手工验收

./gradlew :MapLibreAndroidTestApp:assembleOpenglDebug --console=plain
adb -s 192.168.1.146 install -r platform/android/MapLibreAndroidTestApp/build/outputs/apk/opengl/debug/MapLibreAndroidTestApp-opengl-debug.apk
adb -s 192.168.1.146 shell am start -n org.maplibre.android.testapp/.activity.particle.ParticleCoreLayerValidationActivity

横屏检查 UI-1 至 UI-5：地图明显扩大；控制区缩小且所有 16 项按钮均可见、可点、不重叠、不裁切；逐项点击后确认原 40-02 行为不变。

已知限制：未做 Android 设备布局测量，最终安全区、系统导航栏和实际文字裁切需由用户验收。确认前不能判 CLOSED / PASS。