diff --git a/docs/报告/30_01_AndroidTestApp版本标识_Codex完成报告_v1.md b/docs/报告/30_01_AndroidTestApp版本标识_Codex完成报告_v1.md new file mode 100644 index 000000000..78250afb0 --- /dev/null +++ b/docs/报告/30_01_AndroidTestApp版本标识_Codex完成报告_v1.md @@ -0,0 +1,62 @@ +# 30-01 Android Test App 版本标识 Codex 完成报告 v1 + +日期：2026-08-29 + +执行结论：`WAITING_MANUAL_VALIDATION` + +## 1. 目标 + +在 Android Test App 主菜单列表顶部显示当前运行 APK 的版本与构建身份，使人工验证时能够直接确认设备上安装的是哪个 APK。 + +## 2. 基线与范围 + +- 分支：`particle/main`。 +- 开始 HEAD：`c9c7a8aac6b72461b4d1b4dc6985da9d8fcc6146`。 +- 开始时工作区无修改。 +- 本轮只修改 Android Test App 菜单 UI，不修改 Core renderer、正式粒子实现、GPU、Mask、Vulkan 或 iOS。 +- 按 30-01 指令书不创建或修改 Step。 + +## 3. 实现 + +`FeatureOverviewActivity` 在主菜单顶部显示： + +```text +APK () · / · Git +``` + +数据全部来自 APK 构建产物自身： + +- Test App `BuildConfig.VERSION_NAME`； +- Test App `BuildConfig.VERSION_CODE`； +- Test App `BuildConfig.FLAVOR`； +- Test App `BuildConfig.BUILD_TYPE`； +- MapLibre Android `BuildConfig.GIT_REVISION` 的前 10 位。 + +版本信息没有写死；不同 renderer、build type 或 Git 提交构建出的 APK 会显示对应身份。 + +## 4. 修改文件 + +- `platform/android/MapLibreAndroidTestApp/src/main/java/org/maplibre/android/testapp/activity/FeatureOverviewActivity.kt` +- `platform/android/MapLibreAndroidTestApp/src/main/res/layout/activity_feature_overview.xml` +- `platform/android/MapLibreAndroidTestApp/src/main/res/values/strings.xml` +- `粒子开发记录.md` +- 本完成报告。 + +## 5. 检查 + +- `git diff --check`：PASS。 +- 两个修改 XML 使用 Python 标准库只读解析：PASS。 +- Android/Gradle/Native 编译：未执行；用户明确要求 Codex 不编译。 +- 设备显示结果：等待用户重新手工构建、安装后确认。 + +## 6. Git + +- commit message：`testapp: show APK build identity in menu`。 +- 本次 commit hash：因报告与实现同一提交，为避免自引用，在 Codex 最终回复中记录。 +- push：提交后在 Codex 最终回复中记录。 +- 目标远端：`origin/particle/main`。 + +## 7. 未完成 + +- 尚无用户手工 Android 构建与设备截图，因此不能宣称运行显示 PASS。 +- 30-01 Core RenderLayer 的修复后实机验证仍为 `WAITING_MANUAL_VALIDATION`。 diff --git a/platform/android/MapLibreAndroidTestApp/src/main/java/org/maplibre/android/testapp/activity/FeatureOverviewActivity.kt b/platform/android/MapLibreAndroidTestApp/src/main/java/org/maplibre/android/testapp/activity/FeatureOverviewActivity.kt index 1a008eaf7..57c8fc35b 100644 --- a/platform/android/MapLibreAndroidTestApp/src/main/java/org/maplibre/android/testapp/activity/FeatureOverviewActivity.kt +++ b/platform/android/MapLibreAndroidTestApp/src/main/java/org/maplibre/android/testapp/activity/FeatureOverviewActivity.kt @@ -8,6 +8,7 @@ import android.content.res.Resources.NotFoundException import android.os.Bundle import android.view.Menu import android.view.View +import android.widget.TextView import androidx.annotation.StringRes import androidx.appcompat.app.AppCompatActivity import androidx.appcompat.widget.SearchView @@ -18,6 +19,8 @@ import androidx.recyclerview.widget.RecyclerView.SimpleOnItemTouchListener import kotlinx.coroutines.Dispatchers import kotlinx.coroutines.launch import kotlinx.coroutines.withContext +import org.maplibre.android.BuildConfig as MapLibreBuildConfig +import org.maplibre.android.testapp.BuildConfig import org.maplibre.android.testapp.R import org.maplibre.android.testapp.adapter.FeatureAdapter import org.maplibre.android.testapp.adapter.FeatureSectionAdapter @@ -43,6 +46,14 @@ class FeatureOverviewActivity : AppCompatActivity() { override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) setContentView(R.layout.activity_feature_overview) + findViewById(R.id.apkVersionView).text = getString( + R.string.apk_version_format, + BuildConfig.VERSION_NAME, + BuildConfig.VERSION_CODE, + BuildConfig.FLAVOR, + BuildConfig.BUILD_TYPE, + MapLibreBuildConfig.GIT_REVISION.take(GIT_REVISION_LENGTH) + ) recyclerView = findViewById(R.id.recyclerView) as RecyclerView recyclerView.layoutManager = LinearLayoutManager(this) recyclerView.addOnItemTouchListener(SimpleOnItemTouchListener()) @@ -218,5 +229,6 @@ class FeatureOverviewActivity : AppCompatActivity() { companion object { private const val KEY_STATE_FEATURES = "featureList" + private const val GIT_REVISION_LENGTH = 10 } } diff --git a/platform/android/MapLibreAndroidTestApp/src/main/res/layout/activity_feature_overview.xml b/platform/android/MapLibreAndroidTestApp/src/main/res/layout/activity_feature_overview.xml index c016a1043..cc19f0d4f 100644 --- a/platform/android/MapLibreAndroidTestApp/src/main/res/layout/activity_feature_overview.xml +++ b/platform/android/MapLibreAndroidTestApp/src/main/res/layout/activity_feature_overview.xml @@ -5,10 +5,21 @@ android:layout_height="match_parent" android:orientation="vertical"> + + diff --git a/platform/android/MapLibreAndroidTestApp/src/main/res/values/strings.xml b/platform/android/MapLibreAndroidTestApp/src/main/res/values/strings.xml index 11d5fd69b..0ca6a3645 100644 --- a/platform/android/MapLibreAndroidTestApp/src/main/res/values/strings.xml +++ b/platform/android/MapLibreAndroidTestApp/src/main/res/values/strings.xml @@ -8,6 +8,7 @@ World Tour Benchmark Writes out avg. fps and 1% fps after world tour with .flyTo() Search + APK %1$s (%2$d) · %3$s/%4$s · Git %5$s Data Sources ACTIVE STATIC diff --git a/粒子开发记录.md b/粒子开发记录.md index 4ee492466..55b03c8ad 100644 --- a/粒子开发记录.md +++ b/粒子开发记录.md @@ -54,3 +54,11 @@ - Linux OpenGL 对应目标对象编译通过；C++ 格式和 `git diff --check` 通过。 - 未运行 Android/Gradle/npm/ADB，等待用户在新提交上重新手工编译和实机运行。 - 当前结论仍为 `WAITING_MANUAL_VALIDATION`；未扩大到粒子、GPU ping-pong、Trail、Mask、Vulkan 或 iOS。 + +## 2026-08-29 — 30-01 Android Test App APK 版本标识 + +- 在 Test App 主菜单列表顶部增加当前 APK 构建身份显示。 +- 显示 `versionName/versionCode`、renderer flavor、build type 和构建时 Git revision 前 10 位，均来自 BuildConfig，不写死版本。 +- 版本条用于人工验证时区分旧 APK 与当前源码构建，避免只凭安装时间或文件名判断。 +- `git diff --check` 与 Android XML 标准库解析通过；按用户要求未执行任何编译。 +- 等待用户手工构建、安装后确认设备端显示。