63 lines
2.5 KiB
Markdown
63 lines
2.5 KiB
Markdown
# Pageta für Android
|
|
|
|
Native Android-App (Kotlin, Jetpack Compose) für [Pageta](https://pageta.com),
|
|
die Lese-App des Vereins [mana](https://mana.how): Lese-Liste, Reader mit
|
|
Markierungen, Teilen-Ziel („Senden an Pageta") und ein Widget mit den
|
|
ungelesenen Artikeln.
|
|
|
|
- Lizenz: [AGPL-3.0-or-later](LICENSE) — siehe [`COPYRIGHT`](COPYRIGHT)
|
|
- Web-App und Server: [git.mana.how/offen/pageta](https://git.mana.how/offen/pageta)
|
|
- iOS/macOS: [git.mana.how/offen/pageta-native](https://git.mana.how/offen/pageta-native)
|
|
|
|
Die Lese-Liste ist local-first und event-sourced (Room + `ev.mana:event-sync`),
|
|
dieselben Ereignisse wie in der Web-App, verschlüsselt synchronisiert.
|
|
|
|
```
|
|
app/src/main/java/ev/mana/pageta/android/
|
|
ui/screens/ Lese-Liste, Reader, Markierungen, Einstellungen, Onboarding
|
|
data/ Repository + HTTP (Textextraktion über die Pageta-API)
|
|
widget/ Glance-Widget „Ungelesen"
|
|
```
|
|
|
|
`applicationId` `ev.mana.pageta`, minSdk 24, targetSdk 36. Die App ist noch
|
|
in keinem Store.
|
|
|
|
## Bauen — und die ehrliche Grenze
|
|
|
|
```bash
|
|
./gradlew :app:assembleDebug
|
|
```
|
|
|
|
Die App bezieht `ev.mana:*` (Kern, Tokens, UI, Widget, Event-Sync) aus
|
|
`mavenLocal()`. Die sechs Bibliotheken liegen offen unter
|
|
[git.mana.how/offen](https://git.mana.how/offen) (Apache-2.0) — vorher einmal
|
|
in dieser Reihenfolge veröffentlichen, dazu ein Android-SDK (`sdk.dir` in
|
|
`local.properties` oder `ANDROID_HOME`):
|
|
|
|
```bash
|
|
for r in mana-kotlin-core mana-kotlin-tokens mana-kotlin-event-sync \
|
|
mana-kotlin-widget mana-kotlin-event-sync-room mana-kotlin-ui; do
|
|
git clone https://git.mana.how/offen/$r.git && (cd $r && ./gradlew publishToMavenLocal)
|
|
done
|
|
```
|
|
|
|
Zur Laufzeit braucht die App die mana-Plattform (Anmeldung, Sync).
|
|
|
|
## Für Mitlesende
|
|
|
|
Dieses Repo gehört zum Ökosystem von [mana](https://mana.how) und liegt
|
|
offen, damit andere es lesen, einordnen und als Grundlage nutzen können —
|
|
das spart Arbeit, egal ob ein Mensch oder ein Modell davorsitzt.
|
|
|
|
**Was du erwarten darfst:** den Code so, wie er tatsächlich in Gebrauch ist,
|
|
unter AGPL-3.0-or-later. Keine Attrappe, kein zurechtgeschnittener Auszug —
|
|
samt seiner Geschichte.
|
|
|
|
**Was du nicht erwarten darfst:** Support, Antwortzeiten, Zusagen zur
|
|
Abwärtskompatibilität oder die Übernahme von Änderungswünschen. Fehlermeldungen
|
|
sind willkommen (am schnellsten über den Feedback-Knopf auf pageta.com), eine
|
|
Antwort ist nicht zugesagt.
|
|
|
|
**Fork ist ausdrücklich erlaubt** und oft der schnellere Weg als zu warten.
|
|
Wer die App verändert und als Dienst anbietet, legt seine Änderungen offen —
|
|
das verlangt die AGPL (§13).
|