ee732e03a3
- 將購物車與取貨碼改為統一的帶圓角 CardView 容器設計，使用 surface 背景與黑色圖示文字。 - 修正陰影裁切問題，移除外層容器的 clipChildren 限制。 - 購物車新增右上角紅色 Badge 顯示當前選取的商品總數，並與 CartViewModel 動態綁定。 - 調整懸浮按鈕位置，使其與底部機台資訊列保持 24dp 的合適間距。 - 新增 Google Material Icons: package_24 與 shopping_cart_24。 - 同步更新相關的 Agent 發版規則文件，移除廢棄的多維度 flavor 定義。
4.4 KiB
4.4 KiB
| trigger |
|---|
| always_on |
TaiwanStar 專案版號與發版規範
本規範定義了本專案（販賣機機台 App）的版號命名、自動化計算、實體機台 OTA 更新原則，以確保後續開發與發版時版本管理高度穩定。
1. 雙版號動態計算機制 (Double Versioning Scheme)
本專案採用三段式版號變數進行自動化計算，所有配置皆於 app/build.gradle 頂部定義。
Important
開發人員與 AI 助手在修改版號時，嚴禁直接寫死
versionCode或versionName，必須透過修改 Gradle 頂部的變數來進行。
verMajor(螢幕大小)：代表實體機台的螢幕吋數（例如10代表 10 吋螢幕）。verMinor(次版號)：代表新增商業功能、硬體支援，但向下相容（例如8）。verPatch(修補版號)：代表 Bug 修復、小優化（例如5）。
計算公式：
versionCode=verMajor * 10000 + verMinor * 100 + verPatchversionName="${verMajor}_0${verMinor}_${verPatch}_R"
2. 公司官方命名規範對照
依據公司標準規範，實體機台發佈之 APK 與版本名稱需嚴格符合以下欄位對照：
來源 _ 安卓號 _ 主板號 _ 機器系列 _ 螢幕大小 _ 次版號 _ 修補版號 _ 環境
S _ 12 _ XY _ U _ 10 _ 08 _ 8 _ R
欄位解析：
S(來源 / Source)：代表程式碼與專案來源（非螢幕尺寸）。12(安卓號)：Android 系統主版本號。XY(主板號)：主板型號規格。U(機器系列 / 機型規格)：例如代表 U 系列機型。10(螢幕大小)：對應 Gradle 中的verMajor。08(次版號)：對應 Gradle 中的verMinor（格式化為雙位數）。8(修補版號)：對應 Gradle 中的verPatch。R(環境)：環境代碼，例如R代表 Release 生產環境。
3. 實體機台 OTA 自動更新鐵律
因為本 App 部署於實體販賣機，更新主要透過後台進行遠端自動下載覆蓋安裝 (OTA)。
Caution
每次釋出任何新版 APK 至生產環境，
versionCode必須嚴格大於前一次發佈的數值！
- 若
versionCode相同，即便versionName不同（例如從10_08_2_R改為10_08_5_R），機台下載後也會因INSTALL_FAILED_ALREADY_EXISTS錯誤而拒絕覆蓋安裝，導致遠端自動升級完全失效。
4. 單維度硬體規格 (Hardware Flavor) 與 APK 命名規範
本專案原本採用雙維度，但目前客戶專案（購買流程）已收斂為執行期 shopping_mode（雲端 B014 下發）動態決定，因此不再使用 flavor 分家。
目前僅保留單一維度 hardware，專門處理底層硬體規格差異。
4.1 硬體維度定義 (flavorDimensions)
本專案於 app/build.gradle 中定義了唯一的 Flavor 維度 hardware：
S12XYU(10 吋預設硬體)：代表S(來源) +12(安卓號) +XY(主板號) +U(機器系列/機型規格)。S9XYU(21.5 吋硬體)：代表中國醫現場使用的 Android 9 / 21.5 吋硬體規格。
4.2 Flavor 驗證與編譯指令選擇
修改後，必須編譯對應硬體規格的 Gradle variant，不可只用通用 assembleDebug：
- 10 吋一般機台版 (含晟崴、通用等)：
./gradlew :app:assembleS12XYUDebug --no-daemon - 21.5 吋中國醫等大螢幕機台版：
./gradlew :app:assembleS9XYUDebug --no-daemon
4.3 實體機台 APK 命名鐵律
為了符合實體機台 OTA 平台發佈規範，打包輸出的 APK 檔名必須遵循以下格式：
app-[格式化硬體規格]-[版本號]-[BuildType].apk
- 格式化規則：
S12XYU會在 Gradle 打包時被自動展開格式化為S_12_XY_U。 - 輸出檔名範例：
app-S_12_XY_U-10_08_8_R-release.apkapp-S_9_XY_U-21_08_8_R-release.apk
- 注意：此檔名轉換規則已完全由
app/build.gradle頂部 Gradle 變數與applicationVariants.all自動連動生成，嚴禁手動修改輸出檔名。
5. Git 發版配合流程
- 自
develop拉出release/10.8.5發版分支。 - 遞增
app/build.gradle中的verPatch變數並 Commit。 - 測試無誤後，合併回
main與develop。 - 必須在
main合併節點打上 Git Tag，格式為v[Major].[Minor].[Patch]（例如v10.8.5），以便日後追溯特定現場機台的版本程式碼。