Localizzazione

L'integrazione fornisce traduzioni per tutti i nomi di entità e stati generati tramite il sistema standard di traduzione di Home Assistant, memorizzati in custom_components/dreame_vacuum/translations/*.json. Questi file servono anche come dizionario di base che le interfacce utente a valle usano per i propri testi dell'interfaccia.

Correzione o Miglioramento delle Traduzioni

Se viene identificato un errore di battitura o una traduzione errata, oppure se è necessario il supporto per una nuova lingua, i contributi vanno a questo repository.

Generalizzazione delle Traduzioni

L'app ufficiale utilizza frequentemente terminologie diverse per parametri identici attraverso varie generazioni di dispositivi. Le traduzioni devono utilizzare nomi logici e generalizzati piuttosto che copiare rigidamente la dizione esatta dell'App. Questo previene conflitti di traduzione in cui una correzione pensata per una specifica generazione viene successivamente sovrascritta da utenti con generazioni di dispositivi differenti.

Il processo di aggiornamento prevede i seguenti passaggi:

1. Fork del Repository: Fare il fork del Repository di integrazione Dreame Vacuum Home Assistant su GitHub.
2. Trova il File di Traduzione: Navigare nel direttorio custom_components/dreame_vacuum/translations/ del repository forkato per individuare il file di traduzione corrispondente al codice della lingua, come de.json o it.json.
3. Effettua le Modifiche: Aggiornare il testo errato. Il blocco config gestisce il testo del flusso di configurazione e delle opzioni. Il blocco entity gestisce i nomi delle entità, le opzioni di selezione e i loro stati.
4. Invia una Pull Request: Aprendo una Pull Request sul branch dev. Dopo che la Pull Request viene revisionata e unita in una nuova release, Home Assistant acquisisce automaticamente le traduzioni aggiornate.

Traduzioni del Frontend

Le chiavi di traduzione specifiche del frontend e le etichette delle azioni condivise sono mantenute all'interno del entity_component blocco dei file di lingua. Per informazioni dettagliate su come le traduzioni del frontend sono strutturate e utilizzate dai componenti UI downstream, fare riferimento al Documentazione delle traduzioni della scheda Dreame Vacuum.