fn_registry/dev/issues/0154-matrix-client-android-scaffold.md at 437409641ca6a595e8b1507d50c3d3c43cf600e6

Files

T

egutierrez a3f75d61ec chore: avance acumulado de sesiones previas (reorg dev/issues + ajustes)

Reorganizacion de dev/issues en subcarpetas (completed/, cpp/, gamedev/,
kanban/, trading/, imagegen/, matrix/) y cambios acumulados en cmd/fn/pyrunner,
.claude/commands y settings. Trabajo de otro LLM/sesion, commiteado a peticion
del usuario para desbloquear el working tree. Excluido logs/ardour_mcp_server.log (ruido).

2026-06-30 14:43:51 +02:00

3.4 KiB

Raw Blame History

id, title, status, priority, created, related_flows, related_issues, dependencies, tags

title

status

priority

created

related_flows

related_issues

dependencies

Objetivo

Crear projects/element_agents/apps/matrix_client_android/ con init_kotlin_app (pipeline ya existente del registry). Configurar Compose + Material 3 + tema propio. Implementar login MAS OIDC via Chrome Custom Tabs. Tokens persistidos en EncryptedSharedPreferences. Resultado: APK debug que abre Custom Tab al MAS, retorna con token y muestra perfil del usuario.

Tareas

./fn run init_kotlin_app matrix_client_android — usa pipeline existente del registry (ver issues completados 0073-0078).
Sub-repo Gitea: git init -b master + crear dataforge/matrix_client_android + push inicial. Antes de salir del worktree (ver apps_subrepo.md).
app.md con frontmatter:
- lang: kotlin, framework: jetpack-compose, dir_path: projects/element_agents/apps/matrix_client_android.
- tags: [matrix, android, kotlin, compose].
- uses_functions: [] (irlo rellenando issue a issue).
build.gradle.kts:
- compileSdk = 34, minSdk = 28, targetSdk = 34.
- Compose BOM 2024.x.
- matrix-rust-sdk Kotlin bindings (org.matrix.rustcomponents:sdk-android:0.x).
- androidx.security:security-crypto para EncryptedSharedPreferences.
- androidx.browser:browser para Chrome Custom Tabs.
Login MAS:
- LoginActivity con boton "Sign in with Matrix".
- Generar PKCE code_verifier + state.
- Abrir Chrome Custom Tab a <mas_url>/oauth/authorize?....
- MainActivity con intent-filter para matrix-client-android://callback redirect.
- Intercambiar code -> access_token + refresh_token.
- Guardar en EncryptedSharedPreferences (SecurityCryptoUserPrefs).
HomeScreen Compose con Text("Hola @<userId>") + boton Logout.
Tema Material 3 propio (paleta accent acorde a flow 0010 cliente PC para coherencia).
Test instrumented: LoginInstrumentedTest que mocka MAS y verifica flow callback -> token saved.

Funciones del registry a crear

matrix_client_kotlin_infra — facade sobre matrix-rust-sdk (init, login, sync, logout).
mas_oidc_kotlin_infra — Chrome Custom Tabs + PKCE + callback handler.
encrypted_prefs_kotlin_core — wrapper EncryptedSharedPreferences (idempotente, generic put/get).
LoginScreen_kotlin_ui — Compose screen Material 3.
HomeScreen_kotlin_ui — Compose screen perfil + logout.

Acceptance

./gradlew assembleDebug produce APK valido.
APK instala en Android 9+ y arranca.
Login: boton -> Custom Tab MAS -> consent -> callback -> perfil visible.
Token persiste entre re-aperturas (no re-login si vigente).
app.md con frontmatter completo + 5 uses_functions.
Sub-repo dataforge/matrix_client_android con commit inicial.
Test instrumented LoginInstrumentedTest pasa en emulator API 31.

Notas

Chrome Custom Tabs > WebView para OAuth (security: comparte cookies con browser principal del user, mejor UX).
Refresh token: implementar refresh proactivo 5min antes de expiry (corutina + WorkManager periodic).
Gotcha conocido (ver issue 0074): local.properties con sdk.dir obligatorio en setup nuevo. El scaffolder lo crea.
Gotcha (issue 0075): Material 3 sin AppCompat — usar MaterialTheme directamente, no Theme.AppCompat.*.

3.4 KiB Raw Blame History