Cambiar el idioma de Driver App
El selector de idioma de Profile puede cambiar el idioma que usa Driver App en la instalación actual. La selección actualiza el estado local de la aplicación y puede volver a cargar el diccionario de traducción utilizado en pantallas y solicitudes posteriores.
Disponibilidad
Abre Profile y busca la fila del idioma actual. El selector aparece cuando termina de cargarse la lista de idiomas habilitados y contiene más de un idioma.
Si el proyecto tiene cero o un idioma habilitado, el selector permanece oculto. Que falte la etiqueta actual o la bandera también puede indicar que aún no se ha resuelto el idioma guardado o predeterminado, o que ese idioma no tiene una correspondencia de bandera de país.
Antes de comenzar
Seleccionar un idioma puede escribir en el almacenamiento local, cambiar el idioma que mantiene el cliente de API e iniciar una lectura del diccionario de traducción. El modal del selector se cierra inmediatamente después de llamar al controlador, antes de saber si terminaron esas operaciones.
En el código revisado, este flujo no guarda una preferencia de idioma en el registro de usuario Driver. No consideres la selección de una instalación como configuración para toda la cuenta o todos los dispositivos.
Completar la tarea
- Abre Profile.
- Selecciona la fila que muestra el idioma y bandera actuales.
- Revisa las opciones de idioma habilitadas.
- Selecciona el idioma que quieras usar.
- Espera a que termine cualquier estado de carga y se actualicen las etiquetas cercanas.
- Sal de Profile y vuelve a abrirlo para confirmar que el idioma seleccionado siga activo en esta instalación.
Seleccionar el idioma que ya está activo puede cerrar el modal sin escribir de nuevo en el almacenamiento ni actualizar las traducciones.
Verificar el resultado
Estas observaciones tienen significados distintos:
| Observación | Qué muestra | Qué no demuestra |
|---|---|---|
| Se cierra el modal de selección | Se llamó al controlador de la opción | Que hayan terminado el almacenamiento local, la actualización del cliente de API o las traducciones. |
| Cambia la etiqueta del idioma actual | Cambió el estado del idioma en memoria | Que se haya cargado el diccionario completo o que la opción persista después de reiniciar. |
| Cambia el texto cercano | Se está mostrando un diccionario de traducción o texto alternativo | Que estén traducidas todas las pantallas o se hayan completado los datos del proveedor. |
| El idioma sigue activo al volver a abrir Profile | El estado actual de la aplicación conserva la selección | Que se haya guardado de forma persistente en el dispositivo después de reiniciar o en toda la cuenta. |
| Al reiniciar aparece ese idioma | La resolución actual eligió ese idioma según una correspondencia local o predeterminada disponible | El origen del almacenamiento, persistencia duradera, preferencia del servidor ni sincronización con otro dispositivo. |
Si se mezclan idiomas, aparecen claves de traducción o se revierte el cambio, no alternes repetidamente los idiomas. Vuelve a abrir Profile una vez e informa el idioma seleccionado y la pantalla afectada.
Estados y variaciones
| Estado | Qué aparece | Siguiente paso seguro |
|---|---|---|
| Se carga la lista de idiomas | El selector permanece oculto | Espera a que termine antes de concluir que solo hay un idioma. |
| Hay más de un idioma habilitado | Aparecen la fila del idioma actual y el modal de opciones | Elige una sola opción deliberadamente. |
| Hay cero o un idioma | El selector permanece oculto | Usa el idioma configurado; no se muestran otras opciones. |
| No hay idioma guardado | El proveedor intenta usar el predeterminado del proyecto | Espera a que se resuelva la etiqueta del idioma actual o predeterminado. |
| Se encontró un idioma guardado | El proveedor usa el idioma guardado y actualiza el estado del cliente de API | Es posible que aún esté pendiente la actualización de traducciones. |
| El idioma guardado o predeterminado no está en la lista | Puede que no se resuelva la etiqueta actual | No supongas que se aplicó correctamente un idioma predeterminado; informa el problema de configuración. |
| Se selecciona el mismo idioma | Se cierra el modal; el proveedor puede no hacer nada | No se produjo un nuevo resultado de persistencia o traducción. |
| Se selecciona otro idioma | Pueden comenzar la escritura local, el cambio del cliente de API y la carga de traducciones | Espera y verifica cada capa por separado. |
| Se cancela el modal | El modal se cierra sin seleccionar una opción | No se solicitó cambiar el idioma. |
| Se cancela la solicitud de la lista al desmontar la pantalla | El selector desaparece o la página se cierra durante la carga | No se ha confirmado que se haya cargado la lista completa. |
| Error al leer las traducciones | Puede aparecer texto alternativo, claves o contenido en varios idiomas | Vuelve a abrirlo una vez; no afirmes que el proveedor tuvo éxito. |
| Idioma con escritura de derecha a izquierda | Los metadatos de dirección pueden cambiar la presentación posterior | No implica certificación completa de derecha a izquierda ni equivalencia entre plataformas. |
Efectos y límites
La selección de idioma involucra responsables separados:
- el selector carga los idiomas habilitados;
- el almacenamiento local intenta conservar la selección;
- el cliente de API cambia el idioma que adjunta a solicitudes posteriores;
- el proveedor de idioma obtiene un diccionario de traducción de Driver App; y
- cada pantalla muestra texto del diccionario o un texto alternativo/clave si falta una traducción.
Estas capas no forman una sola transacción. Que se cierre el modal, cambie una bandera o aparezca una etiqueta traducida no demuestra persistencia completa ni que se haya traducido todo el contenido.
Solución de problemas
- Si no aparece el selector, espera a que termine de cargar Profile y confirma que el proyecto tenga más de un idioma habilitado.
- Si el idioma actual está en blanco, sal de Profile y vuelve a abrirlo una vez; puede que aún se esté resolviendo el idioma guardado o predeterminado.
- Si después de reiniciar la aplicación se revierte el idioma, informa un problema de persistencia local; no supongas que el servidor cambió la cuenta.
- Si algunas etiquetas siguen en otro idioma, anota el nombre de la pantalla y el texto de la etiqueta sin exponer datos de la cuenta.
- Si un idioma de derecha a izquierda tiene problemas de diseño, informa la pantalla y la plataforma en vez de alternar repetidamente los idiomas.
Guías relacionadas: Perfil · Sesiones · Navegar por Driver App