Localizza app iOS con l’AI

Cos’è la localizzazione iOS?

La localizzazione iOS consiste nel rendere la tua app iOS disponibile a un pubblico multilingue e nell’adattarla alle sfumature culturali e tematiche.

La localizzazione in Xcode riguarda specificamente la configurazione delle risorse per ogni lingua supportata.

Il processo di localizzazione dell’app iOS prevede tre passaggi principali:

1. Preparazione, o internazionalizzazione (spesso abbreviata i18n), della tua app iOS
2. Traduzione dei testi rivolti all’utente
3. Importazione delle traduzioni e test

L’internazionalizzazione iOS è una parte essenziale della localizzazione, perché consente alla tua app iOS di supportare contenuti multilingue.

Internazionalizzazione della tua app iOS

L’internazionalizzazione iOS consiste nell’adattare il tuo codice per garantire che le stringhe siano tradotte e formattate correttamente. Questo ti aiuta a evitare di riprogettare i layout o riscrivere il codice in seguito.

Fortunatamente, con i cataloghi di stringhe, il processo è molto più semplice di quanto non fosse prima.

Passaggio 1: rendere il testo localizzabile

Nei flussi di lavoro legacy, era necessario racchiudere le stringhe della tua app in un modo che Xcode e gli strumenti di traduzione comprendessero.

Ma con SwiftUI, non devi fare nulla: qualsiasi stringa hard-coded che inserisci in un Text, Label, Button, ecc. di SwiftUI, è automaticamente localizzabile.

Devi rendere manualmente il testo localizzabile solo quando:

• Hai testo al di fuori di SwiftUI, come messaggi di errore, testo ViewModel, stringhe di convalida del login. In questi casi, usa String(localized:).

• Ti rivolgi a dispositivi con versioni precedenti che non supportano le API di localizzazione correnti, come iOS 16 o versioni precedenti. In questo caso, racchiudi tutto il testo rivolto all’utente in NSLocalizedString().

Passaggio 2: aggiunta di commenti per il contesto

I commenti sono utili quando si traducono stringhe con metodi sia manuali che automatici. Usa comment: all’interno del tuo Text ().

Text("Select an item", comment: “The label of a drop down menu to allow users to navigate.”)

Passaggio 3: creazione di un catalogo di stringhe

Ora, aggiungiamo un catalogo di stringhe al tuo progetto iOS.

1. Fai clic con il pulsante destro del mouse sul tuo progetto e seleziona Nuovo file da modello.

2. Cerca Catalogo di stringhe e aggiungilo. Il nome predefinito sarà Localizable.xcstrings. Non è necessario modificarlo.

3. Popola il tuo catalogo di stringhe con il tuo testo. Vai su Prodotto → Compila. Xcode si occupa del resto. Puoi rivedere il testo in seguito facendo clic sul tuo file .xcstrings e poi vai su Editor → Assistente dal menu.

Passaggio 4: aggiunta di varianti per plurale o per dispositivo

Alcune stringhe necessitano di versioni diverse a seconda del contesto, come le forme plurali in lingue diverse o il testo che cambia in base al dispositivo. Queste variazioni aiutano a garantire che il tuo testo risulti naturale e appropriato tra lingue, dispositivi e contesti.

Puoi gestire entrambi nel catalogo di stringhe.

Pluralizzazione

Per i plurali, inizia localizzando una stringa che dipende da un valore numerico, come:

Text("\(count) items")

Vai al catalogo di stringhe e fai clic con il pulsante destro del mouse nella visualizzazione chiave. Scegli Varia per plurale. Xcode aggiunge automaticamente tutte le categorie plurali richieste per quella lingua. Riempi il testo per ogni forma plurale e il sistema sceglierà quella giusta in fase di runtime.

Ecco un esempio di file .xcstrings con variazioni plurali:

{
  "version": "1.0",
  "sourceLanguage": "en",
  "strings": {
  "items_count": {
  "comment": "Number of items - English only supports 'one' and 'other'"
  "extractionState": "manual",
  "localizations": {
  "en": {
  "variations": {
  "plural": {
  "one": {
  "stringUnit": {
  "state": "translated",
  "value": "%lld item"
  }
  },
  "other": {
  "stringUnit": {
  "state": "translated",
  "value": "%lld items"
  }
  }
  }
  }
  }
  }
  },
  "messages_count": {
  "comment": "Number of messages"
  "extractionState": "manual",
  "localizations": {
  "en": {
  "variations": {
  "plural": {
  "one": {
  "stringUnit": {
  "state": "translated",
  "value": "You have %lld new message"
  }
  },
  "other": {
  "stringUnit": {
  "state": "translated",
  "value": "You have %lld new messages"
  }
  }
  }
  }
  }
  }
  }
  }
}

{
  "version": "1.0",
  "sourceLanguage": "en",
  "strings": {
    "items_count": {
      "comment": "Number of items - English only supports 'one' and 'other'",
      "extractionState": "manual",
      "localizations": {
        "en": {
          "variations": {
            "plural": {
              "one": {
                "stringUnit": {
                  "state": "translated",
                  "value": "%lld item"
                }
              },
              "other": {
                "stringUnit": {
                  "state": "translated",
                  "value": "%lld items"
                }
              }
            }
          }
        }
      }
    },
    "messages_count": {
      "comment": "Number of messages",
      "extractionState": "manual",
      "localizations": {
        "en": {
          "variations": {
            "plural": {
              "one": {
                "stringUnit": {
                  "state": "translated",
                  "value": "You have %lld new message"
                }
              },
              "other": {
                "stringUnit": {
                  "state": "translated",
                  "value": "You have %lld new messages"
                }
              }
            }
          }
        }
      }
    }
  }
}

Variazioni del dispositivo

Per il testo specifico del dispositivo, come “Tap” su iOS rispetto a “Click” su macOS, fai clic tenendo premuto il tasto Control sulla stessa chiave e scegli Varia per dispositivo.

Aggiungi i dispositivi che desideri personalizzare e inserisci il messaggio appropriato per ciascuno. Quando l’app viene eseguita, visualizza la versione che corrisponde al dispositivo corrente.

Passaggio 5: aggiunta di lingue

Ecco un modo semplice per aggiungere (e rimuovere) lingue:

1. Seleziona il tuo file di progetto e quindi visualizza la scheda Info nel pannello di destra.
2. Nella sezione Localizzazioni, fai clic sul segno più (+) in basso a sinistra.
3. Aggiungi le lingue in cui desideri visualizzare la tua app iOS.

Tutti i file di lingua e le traduzioni verranno aggiunti allo stesso file .xcstrings.

(Facoltativo) Passaggio 6: esporta il tuo file xcstrings

Sebbene un’API o l’integrazione Git con uno strumento di localizzazione software sia il modo più veloce per ottenere traduzioni, potresti voler inviare i file manualmente. In questo caso, prendi il file .xcstrings dalla tua cartella iOS.

Quando lo ricarichi dopo che PTC ha terminato la traduzione, PTC sostituirà l’originale.