From 942261aa4230c76cb1ed6d52df7b23979ea471fe Mon Sep 17 00:00:00 2001 From: Liang-Ting Date: Thu, 1 Oct 2026 15:01:01 +0800 Subject: [PATCH] release: prepare v1.5.2 (versionName 1.5.2, new release notes) The v1.5.1 release workflow failed before publishing and Play already serves 1.5.1 as versionCode 10, so the build that carries per-model detection (#10) ships as v1.5.2 and the existing v1.5.1 tag is left alone. - app and glass-hud: versionName 1.5.1 -> 1.5.2 (versionCode stays 11 / 8) - doc/RELEASE_NOTES_v1.5.2.md: new, bilingual, covers 1.5.0 through 1.5.2 since this is the first GitHub Release since v1.4.0 - doc/RELEASE_NOTES_v1.5.1.md: restored to what Play's 1.5.1 (versionCode 10) shipped, undoing the versionCode 11 edits from the earlier bump Co-Authored-By: Claude Sonnet 5.5 --- app/build.gradle.kts | 2 +- doc/RELEASE_NOTES_v1.5.1.md | 14 +--- doc/RELEASE_NOTES_v1.5.2.md | 155 ++++++++++++++++++++++++++++++++++++ glass-hud/build.gradle.kts | 2 +- 4 files changed, 160 insertions(+), 13 deletions(-) create mode 100644 doc/RELEASE_NOTES_v1.5.2.md diff --git a/app/build.gradle.kts b/app/build.gradle.kts index 81c51a9..edefd20 100644 --- a/app/build.gradle.kts +++ b/app/build.gradle.kts @@ -419,7 +419,7 @@ android { minSdk = 28 targetSdk = 36 versionCode = 11 - versionName = "1.5.1" + versionName = "1.5.2" testInstrumentationRunner = "androidx.test.runner.AndroidJUnitRunner" vectorDrawables { diff --git a/doc/RELEASE_NOTES_v1.5.1.md b/doc/RELEASE_NOTES_v1.5.1.md index 6eafb48..156900e 100644 --- a/doc/RELEASE_NOTES_v1.5.1.md +++ b/doc/RELEASE_NOTES_v1.5.1.md @@ -1,18 +1,11 @@ # v1.5.1 — Play Console fixes, full translations | Play Console 修正、翻譯補齊 -Phone app `com.m365bleapp` versionCode 11, glasses app `com.m365hud.glass` -versionCode 8. Both report versionName 1.5.1. +Phone app `com.m365bleapp` versionCode 10, glasses app `com.m365hud.glass` +versionCode 7. Both report versionName 1.5.1. -Play already serves an earlier 1.5.1 build as versionCode 10, which was cut -before the per-model addressing work (#10) landed on `main`. This build -supersedes it, so the versionCode moves up while the versionName stays 1.5.1. - -手機端 `com.m365bleapp` versionCode 11，眼鏡端 `com.m365hud.glass` versionCode 8， +手機端 `com.m365bleapp` versionCode 10，眼鏡端 `com.m365hud.glass` versionCode 7， versionName 皆為 1.5.1。 -Play 上已有 versionCode 10 的 1.5.1 版本，該版本是在 per-model addressing（#10） -合併進 `main` 之前建置的。本版取代它，因此 versionCode 遞增、versionName 維持 1.5.1。 - --- ## Play Console issues addressed | 已處理的 Play Console 問題 @@ -36,7 +29,6 @@ Play 上已有 versionCode 10 的 1.5.1 版本，該版本是在 per-model addre - Motor lock buttons no longer break in Russian / Ukrainian. | 修正俄文／烏克蘭文的馬達鎖定按鈕版面。 - Demo Ride switch in Settings reflects its state. | 設定中的模擬騎乘開關會正確顯示狀態。 - Refreshed store screenshots for 11 languages and a promo video. | 更新 11 種語言商店截圖與宣傳影片。 -- Scooters are now recognised by the model code in their BLE advertisement, with the advertised name as a fallback; the GATT characteristic lookup scans every discovered service. Covered by unit tests only, not yet verified on a scooter. | 改以藍牙廣播中的型號代碼辨識滑板車（廣播名稱作為備援）；GATT 特徵查找會掃描所有已探索的服務。僅有單元測試涵蓋，尚未在實機驗證。 ## Play "What's new" text | Play「最新異動」文字 diff --git a/doc/RELEASE_NOTES_v1.5.2.md b/doc/RELEASE_NOTES_v1.5.2.md new file mode 100644 index 0000000..4c3fcb0 --- /dev/null +++ b/doc/RELEASE_NOTES_v1.5.2.md @@ -0,0 +1,155 @@ +# v1.5.2 — Per-model scooter detection, Play Console fixes, full translations | 依型號辨識滑板車、Play Console 修正、翻譯補齊 + +Phone app `com.m365bleapp` versionCode 11, glasses app `com.m365hud.glass` +versionCode 8. Both report versionName 1.5.2. + +手機端 `com.m365bleapp` versionCode 11，眼鏡端 `com.m365hud.glass` versionCode 8， +versionName 皆為 1.5.2。 + +This is the first GitHub Release since v1.4.0 and it includes everything from +1.5.0 and 1.5.1: + +- **1.5.0** has no GitHub Release. Its notes are in + `doc/RELEASE_NOTES_v1.5.0.md`. +- **1.5.1** (versionCode 10) went to Google Play only. The `v1.5.1` tag exists, + but its release workflow failed before publishing, so there is no GitHub + Release for it. Its notes are in `doc/RELEASE_NOTES_v1.5.1.md`. +- **1.5.2** adds per-model scooter detection on top of 1.5.1. + +這是 v1.4.0 之後的第一個 GitHub Release，內容包含 1.5.0 與 1.5.1 的全部變更： + +- **1.5.0** 沒有 GitHub Release，說明見 `doc/RELEASE_NOTES_v1.5.0.md`。 +- **1.5.1**（versionCode 10）僅發佈於 Google Play。`v1.5.1` tag 雖然存在，但其發布 + 流程在發布前失敗，所以沒有對應的 GitHub Release，說明見 `doc/RELEASE_NOTES_v1.5.1.md`。 +- **1.5.2** 在 1.5.1 之上新增依型號辨識滑板車。 + +--- + +## ⚠️ Experimental — not verified on a scooter | 實驗性 — 未經實車驗證 + +The model detection added in this release is covered by unit tests only and has +not been verified on a scooter. Support for Ninebot-family scooters rests on +static reverse engineering, and the register layouts for those families are not +established (see `doc/MODEL_SUPPORT.md`). Controls are capability-gated per +model and demo data is marked `DEMO`. Do not rely on any reading or command as +correct until it is verified on your scooter. + +本版新增的型號辨識僅有單元測試涵蓋，尚未在實車上驗證。對 Ninebot 系列滑板車的支援 +建立在靜態逆向分析上，這些車系的暫存器配置尚未確立（見 `doc/MODEL_SUPPORT.md`）。 +控制項依車型能力顯示，示範資料標記為 `DEMO`。在你的滑板車上驗證之前，切勿把任何讀數 +或命令當成正確。 + +--- + +## Downloads | 檔案下載 + +| File 檔案 | Format 格式 | Description | 說明 | +| :--- | :---: | :--- | :--- | +| **M365-Rokid-HUD-phone-v1.5.2.apk** | APK | Phone app — M365 BLE client + Rokid gateway (sideload) | 手機端 — M365 BLE 客戶端 + Rokid 閘道（側載安裝） | +| **M365-Rokid-HUD-glasses-v1.5.2.apk** | APK | Glasses app — Rokid AR HUD display (sideload) | 眼鏡端 — Rokid AR HUD 顯示（側載安裝） | +| **M365-Rokid-HUD-phone-v1.5.2.aab** | AAB | Phone app — Google Play publishing bundle | 手機端 — Google Play 發佈用 App Bundle | +| **M365-Rokid-HUD-glasses-v1.5.2.aab** | AAB | Glasses app — Google Play publishing bundle | 眼鏡端 — Google Play 發佈用 App Bundle | +| **SHA256SUMS.txt** | Checksums | SHA256 hashes for all release artifacts | 所有產物的 SHA256 校驗值 | + +Verify downloads | 下載校驗： +```bash +sha256sum -c SHA256SUMS.txt +``` + +Signed with the same release key as v1.4.0 (`SHA256 7C:A3:A3:F7:…`), so existing +installs update by sideload without uninstalling. +以與 v1.4.0 相同的 release key 簽章（`SHA256 7C:A3:A3:F7:…`），既有安裝可直接側載 +升級，無需先解除安裝。 + +--- + +## Highlights | 重點更新 + +### 1. New in 1.5.2: per-model scooter detection | 1.5.2 新增：依型號辨識滑板車 +- Scooters are now recognised by the model code in their BLE advertisement + (manufacturer data, company id `0x424E`). The advertised name stays as a + fallback and is reported as unverified. Only codes this project can name are + mapped; an unknown code falls back instead of being forced onto the nearest + model. +- The GATT characteristic lookup now scans every discovered service instead of + only the expected one, so a device that exposes the same characteristics under + a different service no longer fails silently. The expected service is tried + first, so existing devices behave as before. +- Per-model board addressing in the Rust core, documented in + `doc/MODEL_SUPPORT.md`. The Xiaomi profiles keep the addresses the code + already used. +- 現在會依 BLE 廣播中的型號代碼（廠商自訂資料，company id `0x424E`）辨識滑板車； + 廣播名稱僅作為備援，並標示為未驗證。只對應本專案能確認的代碼，未知代碼會走備援 + 流程，不會被硬套到最接近的車型。 +- GATT 特徵查找現在會掃描所有已探索的服務，而非只找預期的服務，因此將相同特徵放在 + 其他服務下的裝置不再無聲失敗。預期的服務會優先嘗試，既有裝置行為不變。 +- Rust 核心新增依車型的板子位址，記錄於 `doc/MODEL_SUPPORT.md`。小米車型沿用程式 + 原本使用的位址。 + +### 2. From 1.5.1: Play Console fixes | 來自 1.5.1：Play Console 修正 +- Narrowed R8 keep rules: phone DEX 22.5 MB → 2.5 MB, with the large majority of + classes now renamed (96% phone, 99% glasses in this build). This clears the + Play "DEX optimization 13%" warning. +- Edge-to-edge is set up by the app itself and no longer uses the deprecated + `LAYOUT_IN_DISPLAY_CUTOUT_MODE_SHORT_EDGES`. +- 收窄 R8 keep 規則：手機端 DEX 22.5 MB → 2.5 MB，絕大多數類別已混淆（本版手機端 + 96%、眼鏡端 99%），解決 Play「DEX 最佳化 13%」警告。 +- 無邊框顯示改由 app 自行處理，不再使用已淘汰的 + `LAYOUT_IN_DISPLAY_CUTOUT_MODE_SHORT_EDGES`。 + +### 3. From 1.5.1: translations and layout | 來自 1.5.1：翻譯與版面 +- All 10 translations completed (58–72 missing strings each). +- Arabic now lays out right-to-left. +- Motor lock buttons no longer break in Russian / Ukrainian. +- Demo Ride switch in Settings reflects its state. +- Refreshed store screenshots for 11 languages and a promo video. +- 補齊 10 種語言翻譯（每種缺 58–72 條）。 +- 阿拉伯文改為由右至左版面。 +- 修正俄文／烏克蘭文的馬達鎖定按鈕版面。 +- 設定中的模擬騎乘開關會正確顯示狀態。 +- 更新 11 種語言商店截圖與宣傳影片。 + +### 4. Build and release pipeline | 建置與發布流程 +- Release builds no longer compile Rokid CXR-M credentials into the app, and the + release workflow scans every artifact for them before publishing. +- Fixed the release workflow aborting on the scan's "nothing configured" result, + which is the normal state in CI. +- Both modules report versionName 1.5.2. +- 發布版不再把 Rokid CXR-M 憑證編進 app，發布流程會在上架前掃描每個產物。 +- 修正發布流程在掃描回傳「未設定憑證」（CI 的正常狀態）時中止的問題。 +- 兩個模組的 versionName 皆為 1.5.2。 + +--- + +## Play "What's new" text | Play「最新異動」文字 + +en-US: + +``` +• Recognises scooters by their model code +• Fully translated into all 11 supported languages +• Arabic now displays right-to-left +• Smaller, faster app (optimized release build) +• Better display on Android 15 edge-to-edge screens +``` + +zh-TW: + +``` +• 依型號代碼辨識滑板車 +• 11 種語言翻譯全數補齊 +• 阿拉伯文改為由右至左顯示 +• 安裝檔更小、執行更有效率 +• 改善 Android 15 無邊框畫面的顯示 +``` + +## Build | 建置 + +Upload the matching `mapping-*.txt` to Play Console for readable crash reports. +`libninebot_ffi.so` must be present for all four ABIs with 16 KB `PT_LOAD` +alignment, and `scripts/verify-bundle-secrets.sh` should report no Rokid +credential in either bundle. + +請一併上傳對應的 `mapping-*.txt` 至 Play Console，以取得可讀的當機報告。四種 ABI 都必須 +含有 16 KB 對齊的 `libninebot_ffi.so`，且 `scripts/verify-bundle-secrets.sh` 應顯示兩個 +bundle 內都沒有 Rokid 憑證。 diff --git a/glass-hud/build.gradle.kts b/glass-hud/build.gradle.kts index e7e2121..6d7d1a0 100644 --- a/glass-hud/build.gradle.kts +++ b/glass-hud/build.gradle.kts @@ -32,7 +32,7 @@ android { // report the same versionName. versionCode must strictly increase for // sideloaded updates to install over an existing build. versionCode = 8 - versionName = "1.5.1" + versionName = "1.5.2" testInstrumentationRunner = "androidx.test.runner.AndroidJUnitRunner" vectorDrawables {