Cómo contribuir

¡Gracias por querer mejorar StradaOS! 🚗

Reportar problemas

Usa la plantilla de issues. Lo más útil:

• La versión de StradaOS y el Android real de la pantalla (en Ajustes → Acerca de).
• Fotos de la pantalla.
• El diagnóstico (Ajustes → Sistema → Exportar diagnóstico).

Traducir StradaOS · Translating StradaOS

Español. No hace falta saber programar para traducir la app:

1. Copia app/src/main/assets/i18n/en.txt como xx.txt (código ISO del idioma: tr.txt para turco, fr.txt para francés…).
2. Cada línea es español<TAB>traducción. Traduce solo lo que va después del tabulador y deja la parte en español igual, letra por letra.
3. Respeta los marcadores: {} (ahí va un dato, como un número o un nombre), {z}/{x}/{y}, %s, %d y \n (salto de línea). Las líneas que empiezan con # son comentarios.
4. Abre un pull request con ese archivo. Si quieres, agrega también app/src/main/res/values-xx/strings.xml (copia el de values-en) y el idioma en I18n.java (CODES, NAMES, el Locale en set() y el formato de fecha en datePattern()); si no, lo hago yo.

Las frases que falten salen en español, así que una traducción parcial también sirve. Cuando salgan textos nuevos en una versión, se agregan al final de en.txt: basta con traducir esas líneas.

English. You don't need to code to translate the app:

1. Copy app/src/main/assets/i18n/en.txt to xx.txt (ISO language code: tr.txt for Turkish, fr.txt for French…).
2. Each line is spanish<TAB>translation. Only translate the part after the tab; keep the Spanish part exactly as it is.
3. Keep the placeholders: {} (a value such as a number or a name goes there), {z}/{x}/{y}, %s, %d and \n (line break). Lines starting with # are comments.
4. Open a pull request with that file. Optionally also add app/src/main/res/values-xx/strings.xml (copy values-en) and the language in I18n.java (CODES, NAMES, the Locale in set() and the date format in datePattern()); otherwise I'll do it.

Missing lines fall back to Spanish, so a partial translation helps too. New strings in each release are appended at the end of en.txt: just translate those lines.

Compilar

Requisitos: JDK 17 y el SDK de Android.

./gradlew assembleDebug
# APK en app/build/outputs/apk/debug/

Reglas del código

• Compatibilidad con Android 4.1 (API 16): cualquier API más nueva va detrás de if (Build.VERSION.SDK_INT >= …).
• Java 8 sin lambdas ni java.util.Objects/StandardCharsets (no existen en API 16–18).
• Sin dependencias de Google Play Services, para poder estar en F-Droid.
• La interfaz se dibuja por código en una «mesa» de 1024×600 que se escala (ver Main.place()).

Estructura

app/src/main/java/com/stradaos/launcher/
  Main.java          pantalla de inicio, ajustes, diálogos
  LiveMapView.java   mapa en vivo (teselas OSM, caché, modo oscuro)
  NowPlaying.java    pista en reproducción (Android 4.x + avisos de reproductores y Bluetooth)
  MediaWatcher.java  pista en reproducción en Android 5+ (MediaSession)
  BtBridge.java      consulta directa a la app Bluetooth de fábrica (Autochips/Clinkway)
  NotifArt.java      carátula de Android Auto desde la notificación de Open Headunit
  Weather.java       clima (Open-Meteo)
  Updates.java       avisos de versiones nuevas (GitHub Releases)
  CarPhoto.java      quitar fondo y ajustar la foto del vehículo
  Net.java           HTTPS con TLS 1.2 y certificados actuales en Android 4.x
app/src/hiddenapi/   stub de API oculta de Android 4.x (solo para compilar, no entra al APK)
app/src/legacy/      RcDisplay: única clase que extiende la API oculta (se carga por reflexión)

Publicar una versión (mantenedores)

1. Sube versionCode y versionName en app/build.gradle.
2. Escribe changelogs/X.Y.Z.md y fastlane/metadata/android/*/changelogs/<versionCode>.txt.
3. Haz commit y súbelo a main (o sube una etiqueta vX.Y.Z).
4. GitHub Actions compila y firma el APK, crea el Release y actualiza update.json, el archivo que la app usa para avisar a los usuarios.