On-device location track, with debug controls - #552
Merged
Conversation
|
✅ OpenCodeReview: Review partially complete: 0 finding(s); 7 of 10 selected item(s) failed. |
lowrt
approved these changes
Aug 25, 2026
whes1015
force-pushed
the
location/track-store
branch
from
August 25, 2026 09:13
dbc583e to
b1a25e0
Compare
whes1015
changed the title
whes1015
force-pushed
the
location/track-store
branch
2 times, most recently
from
August 25, 2026 16:37
3eacf1a to
b72a02e
Compare
whes1015
changed the title
Platform: ios New(zh-Hant): 背景移動時會將位置記錄在裝置本機，最多佔用 50 MB，超過時自動刪除最舊的紀錄 New(en-US): record the device's movement to on-device storage while in the background, capped at 50 MB with the oldest fixes dropped first
Platform: android New(zh-Hant): 背景移動時會將位置記錄在裝置本機，最多佔用 50 MB，超過時自動刪除最舊的紀錄 New(en-US): record the device's movement to on-device storage while in the background, capped at 50 MB with the oldest fixes dropped first
The native stores own every write, so this side opens the file read-only and does nothing but decode: one owner for the format, one for the 50 MB budget. Measured at 14.19 bytes a fix, which is 3.7 million of them. New(zh-Hant): 儲存空間頁面新增「位置紀錄」項目，可以看到本機移動紀錄佔用多少空間 New(en-US): add a Location track slice to the storage screen, showing what the on-device movement history costs
New(zh-Hant): 錯誤回報討論串區分「開發人員」與「工作人員」徽章，官方回覆一眼可辨 New(en-US): bug threads now distinguish a developer badge from a staff badge, so official replies stand out at a glance
New(zh-Hant): 錯誤回報的工作人員名單新增三位成員 New(en-US): three more members join the bug-tracker staff list
New(zh-Hant): 錯誤回報的工作人員名單新增一位成員 New(en-US): one more member joins the bug-tracker staff list
New(zh-Hant): 除錯資訊新增位置軌跡的紀錄筆數與佔用空間 New(en-US): Debug info shows how many fixes the location track holds and what it costs on disk
New(zh-Hant): 除錯資訊新增清除位置軌跡的按鈕，刪除後空間立即歸還 New(en-US): Debug info gains a button that clears the recorded location track and returns the space it held
New(zh-Hant): 開發者的話改為說明目前回報量與修復進度的現況，並引導至更新日誌、已回報的錯誤與支持頁 New(en-US): the developer note now explains the report backlog, points to the changelog and bug tracker for progress, and invites support
Fix(zh-Hant): 伺服器狀態頁的 5xx 錯誤率改為最多三位數字（如 0.02、30.2、123），不再出現 100.00% 這類長度 Fix(en-US): the 5xx error rate now renders with at most three digits (0.02, 30.2, 123) instead of two forced decimals
Fix(zh-Hant): 解除雷達、衛星、定量降水與風場圖層的縮放上限（相機上限 11→16），放大不再模糊 Fix(en-US): lift the source and camera zoom ceilings on radar, satellite, qpesums and wind layers so deep pinch no longer looks blurry
Fix(zh-Hant): 依三地取磚變異的重測結果修正圖層上限——雷達上修至 z11，地形還原 z12（z13 起為全平佔位磚） Fix(en-US): correct layer caps per a three-location re-probe — radar rises to z11, terrain returns to z12 where flat placeholders begin
Fix(zh-Hant): 雷達與定量降水圖層在 z5 以下不再發出必失敗的請求（實測發布下限），來源同步帶入 minzoom Fix(en-US): radar and qpesums sources now carry their measured z5 floor as the source minzoom, so sub-floor zooms stop firing requests that can only 404
Fix(zh-Hant): 點推播通知會開啟對應的畫面，不再一律停在首頁 Fix(en-US): tapping a push notification now opens the screen it is about New(zh-Hant): 點地震報告通知會直接開啟那一筆報告 New(en-US): tapping an earthquake report notification opens that report New(zh-Hant): 點公告通知會開啟公告網站 New(en-US): tapping an announcement notification opens the announcement site
Fix(zh-Hant): 已回報錯誤列表不再是空的 Fix(en-US): the reported-bug list is no longer empty Optimization(zh-Hant): 標籤改用正式中文顯示，同一則問題在列表和內頁標示一致 Optimization(en-US): tags read in proper Chinese and match between the list and the thread
Optimization(zh-Hant): 已回報錯誤卡片的回覆數與時間之間加了分隔點，時間右側補上箭頭 Optimization(en-US): the reported-bug card separates its reply count from its time, and marks itself as tappable
Fix(zh-Hant): 開啟已撤回的地震報告時會回到列表並說明原因，不再停在無法重試的錯誤畫面 Fix(en-US): opening a withdrawn earthquake report returns to the list and says why, instead of a retry that cannot work
Optimization(zh-Hant): 風場粒子改成短促的筆觸，不再拖出長流線 Optimization(en-US): wind particles draw as short dashes instead of long streaks
Optimization(zh-Hant): 防災地圖放大時少抓一層重複的圖磚，標記出現得更快 Optimization(en-US): the disaster map fetches one less redundant tile level and drops its markers sooner
Fix(zh-Hant): 雷達與 QPESUMS 在縮小的地圖上不再空白，放大時也更清晰 Fix(en-US): radar and QPESUMS no longer go blank on a zoomed-out map, and sharpen further in Optimization(zh-Hant): 風場圖層少抓一層看不出差別的圖磚 Optimization(en-US): the wind layer stops fetching a tile level that looked identical
Fix(zh-Hant): 首頁雷達底圖與颱風天氣底圖不再向伺服器要沒有發布的圖磚 Fix(en-US): the home radar backdrop and the typhoon weather underlay stop requesting tile levels the server never publishes
Optimization(zh-Hant): 地圖放大時少抓幾層看不出差別的底圖與地形圖磚，捲動更順 Optimization(en-US): zooming in fetches fewer redundant basemap and terrain tiles, so the map pans more smoothly
Fix(zh-Hant): 已回報錯誤在沒有內容時說明是還沒有回報，不再顯示通用的「沒有資料」 Fix(en-US): the reported-bugs list says there are no reports yet instead of a generic "no data"
whes1015
force-pushed
the
location/track-store
branch
from
August 27, 2026 22:07
b72a02e to
2b5d664
Compare
Optimization(zh-Hant): 地震速報的震度與 P/S 抵達推估用更少的運算得出同樣的數字 Optimization(en-US): the earthquake alert's intensity and P/S arrival estimates reach the same numbers with less arithmetic
Optimization(zh-Hant): 卡片上的雨珠不再每秒產生數萬個暫時物件，下雨時捲動更順 Optimization(en-US): the raindrops on the card stop churning tens of thousands of short-lived objects a second, so scrolling stays smooth in rain
Optimization(zh-Hant): 天空的雲層每幀少做大量重複工作，裝置更不容易發熱 Optimization(en-US): the sky's cloud deck repeats far less work each frame, so the device runs cooler
Optimization(zh-Hant): 地震速報上色不再每次重建全臺鄉鎮座標表 Optimization(en-US): the alert's ground tint stops rebuilding the whole township centroid table each time
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
這個 PR 做了什麼
背景移動時把位置記錄在裝置本機的壓縮資料庫（原生寫、Dart 只讀），除錯頁可看筆數與清除；另含錯誤回報討論串的工作人員身分區分。
相關 issue
怎麼驗
背景定位（安全關鍵，額外說明）
記錄點刻意放在回報閘門之前——iOS 在
shouldReport之前，Android 在一分鐘節流之前。節流的存在是為了替伺服器省下 429，本機軌跡沒有伺服器要省，而丟掉一筆作業系統費力送來的定位，會在歷史裡留下一個和它自己毫無關係的洞。回報路徑不能被這件事拖垮：兩邊的
record()都吞掉所有例外且不記錄。iOS 走自己的 serial queue，Android 是@Synchronized並在catch (_: Throwable)裡靜默返回。磁碟滿了、資料庫壞了、檔案被保護類別擋住——任何一種都只會讓這一筆軌跡消失，不會讓那一次的位置回報失敗。驗法：授權背景定位後帶著裝置移動，回到 App 看「設定 → 儲存空間 → 位置紀錄」的筆數與位元組是否增長；同時確認位置回報本身仍然正常（伺服器端收得到）。把裝置磁碟塞滿再移動一次，回報應該照常，只有軌跡停止增長。
除錯頁（更多 → 版本號點十下 → Debug info）
Location區塊多一列Track fixes，筆數與位元組並列——比值就是壓縮有沒有在運作，筆數漲而檔案不漲（或反過來）是差值鏈出錯的第一個徵兆。沒有紀錄的裝置整列不出現。Maintenance多一顆紅色的 Clear location track，有確認對話框，措辭寫明不可復原：和它上面的清除快取不同，軌跡沒有任何地方可以重新下載。刪除走原生，不是 Dart 刪檔。 兩邊的 store 都把 database handle 快取整個 process 生命週期，從 Dart unlink 檔案只會讓原生繼續往一個已死的 inode 寫——下次讀取時列會全部回來，空間永遠不歸還，而且沒有任何地方會報錯。所以走既有的
com.exptech.dpip/background_locationchannel 加一個clearTrack，兩邊都在刪除真的跑完之後才回覆，因為呼叫端一返回就會重讀筆數。PRAGMA incremental_vacuum之所以能把空間還回去，是因為auto_vacuum=INCREMENTAL設在建表之前。驗法：記錄幾筆之後看
Track fixes，按下清除，確認筆數歸零、Storage區塊的 Location track 位元組同步縮小，然後再移動一次確認還會繼續記錄。錯誤回報討論串
工作人員與一般回報者在討論串上以徽章區分。
資料格式
各自獨立的
location_track.db，不併進dpip.db——那個檔案屬於 Dart 的sqlite_async，它跨 isolate 維持 WAL 連線池並自行遷移 schema，多一個跨行程寫入者只會製造麻煩。每列存的是與前一列的差值，不是絕對值。SQLite 本來就用一到兩個位元組存小整數、四到六個存大的，所以寫差值等於白拿記錄格式自己的壓縮——沒有私有 blob 要編碼，解碼也只是加法。每 64 列一個絕對值錨點，靠
rowid % 64 == 0認出來，不花任何一個欄位。刪除以整個錨點群組為單位：差值列離開它所依附的錨點就沒有意義，從中間抽掉一列會讓後面每一個位置都平移，而且沒有任何跡象。實測 14.19 bytes 一筆，50 MB 約 370 萬筆。significant-change 一天送幾十到低百筆。
Dart 端
唯讀，這是整個設計。定位在 App 沒有執行時抵達，所以寫入歸原生；超額刪除也歸原生，因為一個由兩邊各自執行的容量上限，等於兩邊都沒有執行。
測過的裝置
LocationTrackStore.clear、Android dex 的clearTrack）檢查清單
tool/check/commits.sh origin/main..HEAD通過—— commit 訊息就是更新日誌，格式見 commit.md
mise exec -- flutter analyze與mise exec -- flutter test通過AppLocalizations，沒有寫死AppSpacing/AppRadius/AppMotion，深色模式看過，文字對比度可接受