No description
  • Java 93%
  • Shell 7%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
SimbaFs f3c0eaff09
All checks were successful
build-and-release / build (push) Successful in 5s
build-and-release / release (push) Successful in 4s
Release 1.1.0
Co-Authored-By: Claude Opus 5.5 <[email protected]>
Claude-Session: https://claude.ai/code/session_0159QZZAZjsoXK8JScZsSeDy
2026-11-15 21:38:03 +08:00
.forgejo/workflows Add Forgejo build and release workflow 2026-11-15 21:30:28 +08:00
app/src/main Show an optional second unit when the widget has room 2026-11-15 21:38:03 +08:00
.gitignore Add countdown home-screen widget app 2026-11-15 19:48:13 +08:00
build Add countdown home-screen widget app 2026-11-15 19:48:13 +08:00
build.sh Add Forgejo build and release workflow 2026-11-15 21:30:28 +08:00
README.md Document installing and updating with Obtainium 2026-11-15 21:32:26 +08:00
sign Add ./sign for release signing 2026-11-15 21:30:28 +08:00
VERSION Release 1.1.0 2026-11-15 21:38:03 +08:00

倒數日 (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 自動更新:

  1. Obtainium 點 Add app,輸入 https://git.1li.tw/simbafs/daycount
  2. Override source 選 Forgejo (Codeberg)(repo 不在 codeberg.org)
  3. 點 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