119 lines
2.4 KiB
Markdown
119 lines
2.4 KiB
Markdown
# STEP-000 环境初始化完成报告 v1
|
||
|
||
## 结论
|
||
|
||
MapLibreParticleLab Linux / Android 主开发环境已完成建立，可以进入粒子系统开发阶段。
|
||
|
||
## 主开发环境
|
||
|
||
- Ubuntu 24.04 LTS
|
||
- x86_64
|
||
- 4 CPU 线程
|
||
- 约 8 GB RAM
|
||
- 默认编译并行度：3
|
||
|
||
## Git
|
||
|
||
- 正式开发分支：`particle/main`
|
||
- `upstream`：MapLibre 官方 GitHub
|
||
- `origin`：用户 Gitea
|
||
- `upstream` 只用于读取官方更新
|
||
- `git rerere` 用于长期 Fork 冲突复用
|
||
|
||
## MapLibre 基线
|
||
|
||
- Android：`android-v13.4.1`
|
||
- iOS：`ios-v6.28.0`
|
||
- Android/iOS 使用共同 MapLibre Native core 基线
|
||
- 实际 commit 以根目录 `PARTICLE_BASELINE.md` 为准
|
||
|
||
## Linux Native 验证
|
||
|
||
已通过：
|
||
|
||
- CMake `linux-opengl` configure
|
||
- Linux OpenGL backend
|
||
- `mbgl-render`
|
||
- `mbgl-render-test-runner`
|
||
|
||
## Android OpenGL
|
||
|
||
已成功生成：
|
||
|
||
`platform/android/MapLibreAndroid/build/outputs/aar/MapLibreAndroid-opengl-debug.aar`
|
||
|
||
包含：
|
||
|
||
- `arm64-v8a/libmaplibre.so`
|
||
- `armeabi-v7a/libmaplibre.so`
|
||
- `x86/libmaplibre.so`
|
||
- `x86_64/libmaplibre.so`
|
||
|
||
结论：PASS。
|
||
|
||
## Android Vulkan
|
||
|
||
已成功生成：
|
||
|
||
`platform/android/MapLibreAndroid/build/outputs/aar/MapLibreAndroid-vulkan-debug.aar`
|
||
|
||
包含：
|
||
|
||
- arm64-v8a
|
||
- armeabi-v7a
|
||
- x86
|
||
- x86_64
|
||
|
||
四种 ABI 的 `libmaplibre.so`。
|
||
|
||
Debug AAR 同时包含对应的 Khronos Vulkan Validation Layer。
|
||
|
||
结论：PASS。
|
||
|
||
## Android SDK
|
||
|
||
已确认：
|
||
|
||
- `ANDROID_HOME=/root/Android/Sdk`
|
||
- Android Platform Tools 可用
|
||
- NDK `28.2.13676358` 可用
|
||
- `platform/android/local.properties` 已配置
|
||
- `render-test/android/local.properties` 已配置
|
||
|
||
## 已修正的问题
|
||
|
||
### Linux preset 构建目录
|
||
|
||
实际 CMake preset 输出：
|
||
|
||
`build-linux-opengl`
|
||
|
||
构建工具已统一使用该目录，不再错误引用 `build`。
|
||
|
||
### Android SDK 定位
|
||
|
||
Gradle 工程同时使用 `ANDROID_HOME` 和本机 `local.properties`，避免新 shell 或 Codex 环境找不到 SDK。
|
||
|
||
## Codex 开发规范
|
||
|
||
已建立：
|
||
|
||
- `AGENTS.md`
|
||
- 中文构建规范
|
||
- 中文 Codex 协作规范
|
||
- Step 阶段记录规范
|
||
- 文档目录与命名规范
|
||
- Git/upstream 同步规范
|
||
- 粒子总体架构原则
|
||
- `docs/报告/` 固定完成报告目录
|
||
|
||
## STEP-000 状态
|
||
|
||
**完成并冻结。**
|
||
|
||
下一阶段：
|
||
|
||
**STEP-001：MapLibre Native 粒子接入点只读调查。**
|
||
|
||
STEP-001 暂不实现正式 RasterParticleLayer，先调查 Style / Source / Tile / RenderLayer / gfx / Shader / OpenGL / Vulkan / Metal 的最小接入点。
|