TheAnachronism/tt-rss-viewer
1
0
Fork 0
Code Issues Pull requests Projects Releases 5 Packages Wiki Activity Actions

App identity and versioning #52

New issue
Closed
opened 2026-08-03 22:43:02 +00:00 by TheAnachronism · 1 comment
TheAnachronism commented 2026-08-03 22:43:02 +00:00
Owner
Copy link

Part of #41

Question

For sideload-to-friends 1.0 beta: keep applicationId/namespace dev.anachronis.tt_rss_viewer? What display name? How should app versionName/versionCode relate to git tags and Forgejo releases?

Part of #41 ## Question For sideload-to-friends 1.0 beta: keep applicationId/namespace dev.anachronis.tt_rss_viewer? What display name? How should app versionName/versionCode relate to git tags and Forgejo releases?
TheAnachronism commented 2026-08-04 19:11:31 +00:00
Author
Owner
Copy link

Resolution

App identity and versioning for sideload-to-friends 1.0 beta (criteria only — implement later):

Must

  1. Package id: change Android applicationId and namespace from dev.anachronis.tt_rss_viewer to dev.theanachronism.ttrssviewer before beta. Friends who installed builds on the old id must uninstall/reinstall once (no in-place update across package ids).
  2. Display name: keep launcher label tt-rss Viewer (android:label).
  3. versionName: from the release tag’s semver portion via CI --build-name (checked-in pubspec.yaml version is not the friends-facing truth for tagged builds). Channel prefix (alpha/* vs beta/*, etc.) stays owned by Release channel for beta.
  4. versionCode: UTC epoch seconds via CI --build-number (current alpha pattern) so later tagged builds can update in place when the signing identity also matches.
  5. APK filename stem: keep tt-rss-viewer-… (e.g. tt-rss-viewer-<channel>-<semver>.apk); channel string owned by the release-channel ticket.

Why

Friends need a stable package id + predictable version progression for updates. Changing to dev.theanachronism.ttrssviewer now avoids shipping beta on the anachronis-shaped id you don’t want long-term. Tag→versionName + epoch versionCode already match the working alpha packaging pattern; signing continuity remains Signing and update trust.

## Resolution **App identity and versioning** for sideload-to-friends **1.0 beta** (criteria only — implement later): ### Must 1. **Package id:** change Android `applicationId` and `namespace` from `dev.anachronis.tt_rss_viewer` to **`dev.theanachronism.ttrssviewer`** before beta. Friends who installed builds on the old id must uninstall/reinstall once (no in-place update across package ids). 2. **Display name:** keep launcher label **`tt-rss Viewer`** (`android:label`). 3. **versionName:** from the release tag’s **semver** portion via CI `--build-name` (checked-in `pubspec.yaml` version is not the friends-facing truth for tagged builds). Channel prefix (`alpha/*` vs `beta/*`, etc.) stays owned by [Release channel for beta](https://git.anachronis.dev/TheAnachronism/tt-rss-viewer/issues/57). 4. **versionCode:** **UTC epoch seconds** via CI `--build-number` (current alpha pattern) so later tagged builds can update in place when the signing identity also matches. 5. **APK filename stem:** keep **`tt-rss-viewer-…`** (e.g. `tt-rss-viewer-<channel>-<semver>.apk`); channel string owned by the release-channel ticket. ### Why Friends need a stable package id + predictable version progression for updates. Changing to `dev.theanachronism.ttrssviewer` now avoids shipping beta on the anachronis-shaped id you don’t want long-term. Tag→versionName + epoch versionCode already match the working alpha packaging pattern; signing continuity remains [Signing and update trust](https://git.anachronis.dev/TheAnachronism/tt-rss-viewer/issues/54).
Sign in to join this conversation.
No Branch/Tag specified
Branches Tags
master
beta/0.0.4
beta/0.0.3
beta/0.0.2
beta/0.0.1
alpha/0.0.2
Labels
Clear labels   
needs-info
Waiting on reporter for more information

  
needs-triage
Maintainer needs to evaluate this issue

  
ready-for-agent
Fully specified, ready for an AFK agent

  
ready-for-human
Requires human implementation

  
wayfinder:grilling
HITL grilling/decision ticket

  
wayfinder:map
Wayfinder effort map

  
wayfinder:prototype
HITL prototype ticket

  
wayfinder:research
AFK research ticket

  
wayfinder:task
Unblocking manual task ticket

  
wontfix
Will not be actioned

No labels
needs-info
needs-triage
ready-for-agent
ready-for-human
wayfinder:grilling
wayfinder:map
wayfinder:prototype
wayfinder:research
wayfinder:task
wontfix
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
TheAnachronism
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
TheAnachronism/tt-rss-viewer#52
No description provided.