Files
kadence/android/fetch-glyph-sdk.sh
timka123andClaude Opus 5 a7148b69c6 android: the real client — backend, notifications, Live Update, Glyph
The app module was a design gallery: tokens, type and a dial, with no backend,
no notification and nothing driving the rear matrix. This is the rest of it.

**One engine, three views.** `TimerEngine` lives on the Application, not in a
ViewModel, because the Compose screen, the foreground service's notification
and the Glyph must show the *same* second. Two engines polling the same backend
drift apart within seconds and the user sees a notification disagreeing with
the dial. It polls, ticks from a monotonic anchor, and puts every reply through
`:core`'s `reconcile`.

`pomodoro.state()` does not finish an interval whose time is up — it reports
`remaining_seconds = 0` and waits for a client to call `complete`. The tick
loop does, behind the same re-entry guard `desktop/controller.py` uses, since
without one a 1 Hz tick at zero fires `complete` every second until the reply
lands.

**Notifications.** Two channels, because the running interval must be silent
and its *end* must not; one channel cannot be both, and a user who silences a
buzzing countdown has silenced the only part that mattered. The ongoing one is
an Android 16 Live Update: promotion needs `setOngoing` + `setRequestPromotedOngoing`
+ a `ProgressStyle`, and missing any one renders it as an ordinary notification
with no error and no log. Its segments come from `:core`'s `dialTickCount`, so
the status bar, the dial and the Glyph ring agree on what one tick is worth.

**Glyph.** `GlyphMatrixManager.init()` binds `com.nothing.thirdparty/.GlyphService`
and *discards* the boolean `bindService` returns — so on Android 11+ a missing
`<queries>` entry makes the package invisible, the bind silently fail, and the
matrix stay dark with no exception, no log and `onServiceConnected` never
arriving. That was the whole of "the glyph does not work". The manifest now
declares it and `MatrixGlyphDisplay` checks visibility itself rather than
leaving the next person with the same dead end.

The SDK's licence forbids redistribution (clause 2.1(c)), so the .aar stays
git-ignored and `fetch-glyph-sdk.sh` downloads it. Without it a second source
set compiles a no-op display: the app builds, installs and runs with an inert
rear panel, which is also the correct behaviour on any phone that is not a
Nothing.

Verified on the device (Phone (3), Android 16), debug and release: onboarding
against kadence.timka.su, the Live Update with `shortCriticalText` and a 600s
progress track, the matrix accepting 625-dot frames, tasks opening in the Jira
app, and R8 leaving the DTOs decodable. 225 tests, none needing a device.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-10-19 16:05:13 +03:00

43 lines
1.4 KiB
Bash
Executable File

#!/usr/bin/env bash
# Fetch Nothing's Glyph Matrix SDK into app/libs/.
#
# The .aar is not on Maven and its licence (clause 2.1(c)) forbids
# redistribution, so it cannot be committed — hence this script and the
# .gitignore entry. Without it the build still works: `app/build.gradle.kts`
# compiles the no-op display instead and the rear matrix is simply inert.
#
# ./fetch-glyph-sdk.sh # or: make glyph-sdk
set -euo pipefail
HERE=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
DEST="$HERE/app/libs/glyph-matrix-sdk-2.0.aar"
KIT=https://github.com/Nothing-Developer-Programme/GlyphMatrix-Developer-Kit
RAW="$KIT/raw/main/glyph-matrix-sdk-2.0.aar"
if [[ -f $DEST && ${1:-} != --force ]]; then
echo "already present: $DEST"
echo "(pass --force to re-download)"
exit 0
fi
mkdir -p "$(dirname "$DEST")"
echo "downloading the Glyph Matrix SDK from $KIT"
tmp=$(mktemp)
trap 'rm -f "$tmp"' EXIT
curl -fsSL -o "$tmp" "$RAW"
# An .aar is a zip holding classes.jar; a redirect to an HTML error page is not.
if ! unzip -l "$tmp" 2>/dev/null | grep -q classes.jar; then
echo "error: what came back is not an .aar. Download it by hand from" >&2
echo " $KIT" >&2
echo "and put it at $DEST" >&2
exit 1
fi
mv "$tmp" "$DEST"
trap - EXIT
echo "installed $DEST ($(du -h "$DEST" | cut -f1))"
echo
echo "Licence: Nothing's Glyph SDK EULA — see $KIT/blob/main/LICENSE.md."
echo "It is not redistributable, which is why this file is git-ignored."