- Java 93%
- Shell 7%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
Co-Authored-By: Claude Opus 5.5 <[email protected]> Claude-Session: https://claude.ai/code/session_0159QZZAZjsoXK8JScZsSeDy |
||
| .forgejo/workflows | ||
| app/src/main | ||
| .gitignore | ||
| build | ||
| build.sh | ||
| README.md | ||
| sign | ||
| VERSION | ||
倒數日 (daycount)
Android 桌面小工具:倒數到指定日期,外圈進度每「N 天」轉一圈。
- 圈內文字的單位:天、週、月、年、工作天(週一~五)、週末日(週六日)。都是「明天起算到目標日(含)」; 週/月/年用一位小數、無條件捨去(7 個月 15 天 →「7.5 個月」,整數不帶 .0,不到 0.1 顯示「< 0.1」)。過了目標日數字前面加 +(「+10 天」「+6.7 個月」)。國定假日沒有扣掉。 單位只影響文字,外圈一律以天計算
- 每個小工具各自設定:名稱、目標日期、外圈一圈的天數、樣式(圓環/圓點/刻度/長條)、 進度方向(剩餘逐日減少/經過逐日填滿)、顏色(含 Android 12+ 系統色)、背景(自動/深色/淺色/透明/彩色)
- 超過一圈時畫成同心圓:最外圈是目前不滿一圈的部分,往內每圈是一個整圈(越內越細)。 實線最多 3 圈(圓直徑 < 48dp 時 1 圈、< 90dp 時 2 圈),放不下時最內側加一圈虛線
- 過了目標日自動變成「N 天前」正數
- 點一下小工具可以再修改;可任意調整大小,寬的時候改成左圈右文字
- 另有「倒數日 1×1」:小尺寸時是一行名稱+天數和進度(長條樣式則是名稱、數字+細長條)
- 午夜後自動更新(不喚醒手機的 alarm),改時間/時區、重開機也會更新
純 Java + Android framework,沒有任何第三方依賴,minSdk 26、targetSdk 36。
安裝與更新
從 releases 頁面 下載 APK,或用 Obtainium 自動更新:
- Obtainium 點 Add app,輸入
https://git.1li.tw/simbafs/daycount - Override source 選 Forgejo (Codeberg)(repo 不在 codeberg.org)
- 點 Add,再安裝
之後 Obtainium 會檢查 releases、提示新版本。每個 release 只有一個 APK,不需要過濾。
release 用 daycount key 簽章(SHA-256 7c9216e1…a698f81304);手機上若裝的是 debug 版,要先解除安裝一次。
Build
不用 Gradle,直接用 SDK 工具(aapt2 → javac → d8 → zipalign),全部在
git.1li.tw/1li/android-ci:v3 container 裡跑,host 不需要裝 Android 相關的東西:
./build # dist/daycount-<ver>-unsigned.apk
./build --debug # 另外產生用本機 debug.jks(第一次自動建立、不進 git)簽的 dist/daycount-<ver>-debug.apk,方便直接裝來測試
未簽章的 APK 不能安裝。正式簽章(需要在真的終端機裡跑,apksigner 會互動式問密碼):
./sign path/to/release.jks [key-alias] [password-file] # dist/daycount-<ver>.apk
keystore(和密碼檔)先複製到 $XDG_RUNTIME_DIR 的 tmpfs,再唯讀掛進 container,用完刪掉;
所以放在 FUSE(gocryptfs 等)裡也能用。沒給密碼檔就互動式詢問。密碼不會出現在指令列或環境變數。
本專案用的是 ~/Vaults/recovery/pinentry-remote-release.jks 裡的 daycount alias
(憑證 SHA-256 7c9216e1…8f81304)。
release 簽的 APK 和 debug 簽的簽名不同,從 debug 版換過去要先解除安裝一次。
版本號在 VERSION(CI 用 tag 覆蓋);versionCode 由版本號推算:1.2.3 → 10203。
安裝到手機測試
docker run --rm -it --network host -v "$PWD:/workspace" git.1li.tw/1li/android-ci:v3 \
sh -c 'adb connect <ip>:<port> && adb install -r dist/daycount-0.8.0-debug.apk'
CI / Release
.forgejo/workflows/release.yml,job 跑在 git.1li.tw/1li/android-ci:v3 container 裡:
| 觸發 | 做什麼 |
|---|---|
| push 任何 branch | ./build.sh(確認能編譯) |
push tag vX.Y.Z |
以 X.Y.Z 為版本編譯、簽章,發佈 Forgejo release(APK + checksums.txt) |
需要的 repo secrets:
| secret | 內容 |
|---|---|
ANDROID_KEYSTORE_BASE64 |
base64 -w0 ~/Vaults/recovery/daycount-release.jks(只含 daycount 這把 key) |
ANDROID_KEYSTORE_PASSWORD |
同 pinentry-remote-release.pass |
ANDROID_KEY_ALIAS |
daycount(keystore 只有一把 key 時可省略) |
發版:
echo 1.0.0 > VERSION && git commit -am "Release 1.0.0" && git tag v1.0.0 && git push origin main v1.0.0