.XCSTRINGS - Apple Strings Catalog (Strings)

Contenuti tradotti automaticamente dall'inglese con Phrase Language AI.

Estensioni dei file	.xcstrings
Estensione API	strings_catalog
Importa	Sì
Esporta	Sì
Supporto forme plurali	Sì
Supporto descrizione	Sì
Opzioni di formato Queste opzioni possono essere specificate quando un file viene caricato e/o scaricato. A seconda del metodo di caricamento/scaricamento (API, CLI, sincronizzazione Repo, ecc.), possono essere specificate nei parametri di query `Carica`, `Scarica` o nel file di configurazione `phrase.yml`.	convert_placeholder default_extraction_state

Apple Strings Catalog (.xcstrings) è un formato di localizzazione introdotto in Xcode 15. Migliora il modo in cui gli sviluppatori gestiscono le stringhe localizzate supportando formati strutturati per gestire la pluralizzazione, le variazioni specifiche del dispositivo e altro ancora. Questo formato sta diventando l'approccio raccomandato per gestire le localizzazioni nelle applicazioni iOS e macOS.

I campi di metadati commento, statoEstrazione e deveTradurre vengono importati ed esportati nell'ordine richiesto per garantire la compatibilità con Xcode.

Phrase mappa anche gli stati di traduzione di Xcode agli equivalenti Strings più vicini durante l'importazione e li converte nuovamente in valori compatibili con Xcode all'esportazione. Se non si applica alcuna mappatura specifica, tradotto viene utilizzato come valore di esportazione predefinito. Se necessario, usa l'opzione Ignora stato di traduzione all'importazione per saltare la mappatura dello stato.

Esempio di codice

{
  "sourceLanguage": "en",
  "strings": {
    "Sync Warning": {
      "comment": "Sync function unavailable message",
      "localizations": {
        "en": {
          "stringUnit": {
            "state": "translated",
            "value": "Cloud Sync must be enabled to use this feature."
          }
        },
        "fr": {
          "stringUnit": {
            "state": "translated",
            "value": "La synchronisation cloud doit être activée pour utiliser cette fonction."
          }
        }
      }
    },
    "Chosen Collections": {
      "comment": "View title indicating selected photo collections",
      "localizations": {
        "fr": {
          "variations": {
            "plural": {
              "one": {
                "stringUnit": {
                  "state": "translated",
                  "value": "%ld collection sélectionnée"
                }
              },
              "other": {
                "stringUnit": {
                  "state": "translated",
                  "value": "%ld collections sélectionnées"
                }
              }
            }
          }
        },
        "en": {
          "variations": {
            "plural": {
              "one": {
                "stringUnit": {
                  "state": "translated",
                  "value": "%ld Collection Selected"
                }
              },
              "other": {
                "stringUnit": {
                  "state": "translated",
                  "value": "%ld Collections Selected"
                }
              }
            }
          }
        }
      }
    },
    "Settings Hub": {
      "localizations": {
        "es": {
          "stringUnit": {
            "state": "translated",
            "value": "Centro de configuración"
          }
        }
      }
    }
  },
  "version": "1.0"
}

Quando si utilizza il Phrase CLI, le esportazioni dei file seguono la struttura definita nel file di configurazione .phrase.yml. Per garantire che più lingue vengano esportate in un singolo file .XCSTRINGS durante le operazioni di pull:

Specifica solo un obiettivo di file nel file di configurazione CLI.
Usa il parametro locale_ids per elencare tutte le impostazioni locali delle lingue incluse nell'esportazione.

Esempio .phrase.yml configurazione

pull:
  targets:
    - file: ./i18n-test/Localizable.xcstrings
      params:
        locale_id: en # Main language for the download
        locale_ids: # Additional languages to include
          - de
          - es
          - fr 
        file_format: strings_catalog

Variazioni del dispositivo

Apple Strings Catalog supporta le variazioni di dispositivo, che consentono contenuti di traduzione diversi per la stessa chiave a seconda del dispositivo Apple utilizzato.

Per gestire le variazioni del dispositivo in Phrase Strings, vengono creati chiavi separate per ciascun dispositivo utilizzando il separatore |==|. Quando si importano file .XCSTRINGS, il tipo di dispositivo viene aggiunto al nome della chiave di base utilizzando questo separatore.

Esempio

La chiave denominata %lld Prodotto(i) Ordinati per il dispositivo applewatch viene importata come una chiave plurale denominata %lld Prodotto(i) Ordinati|==|device.applewatch in Phrase Strings.

Durante l'esportazione, Phrase Strings rileva la variante del dispositivo utilizzando il separatore e ripristina la sua struttura annidata originale per il formato di localizzazione di Apple.

{
  "sourceLanguage": "en",
  "strings": {
    "%lld Product(s) Ordered": {
      "comment": "Indica il numero di prodotti ordinati, con variazioni specifiche del dispositivo",
      "localizations": {
        "en": {
          "variations": {
            "device": {
              "applewatch": {
                "variations": {
                  "plural": {
                    "one": {
                      "stringUnit": {
                        "state": "translated",
                        "value": "%lld Product ordered (Apple Watch)"
                      }
                    },
                    "other": {
                      "stringUnit": {
                        "state": "translated",
                        "value": "%lld Products ordered (Apple Watch)"
                      }
                    }
                  }
                }
              },
              "ipad": {
                "variations": {
                  "plural": {
                    "one": {
                      "stringUnit": {
                        "state": "translated",
                        "value": "%lld Product ordered (iPad)"
                      }
                    },
                    "other": {
                      "stringUnit": {
                        "state": "translated",
                        "value": "%lld Products ordered (iPad)"
                      }
                    }
                  }
                }
              },
              "iphone": {
                "variations": {
                  "plural": {
                    "one": {
                      "stringUnit": {
                        "state": "translated",
                        "value": "%lld Product ordered (iPhone)"
                      }
                    },
                    "other": {
                      "stringUnit": {
                        "state": "translated",
                        "value": "%lld Products ordered (iPhone)"
                      }
                    }
                  }
                }
              },
              "mac": {
                "variations": {
                  "plural": {
                    "one": {
                      "stringUnit": {
                        "state": "translated",
                        "value": "%lld Product ordered (Mac)"
                      }
                    },
                    "other": {
                      "stringUnit": {
                        "state": "translated",
                        "value": "%lld Products ordered (Mac)"
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "fr": {
          "variations": {
            "plural": {
              "few": {
                "stringUnit": {
                  "state": "translated",
                  "value": "%lld produit(s) commandé(s)"
                }
              },
              "many": {
                "stringUnit": {
                  "state": "translated",
                  "value": "%lld produits commandés"
                }
              },
              "one": {
                "stringUnit": {
                  "state": "translated",
                  "value": "%lld produit commandé"
                }
              }
            }
          }
        }
      }
    }
  }
}

Sostituzioni di stringa

Il Catalogo delle Stringhe Apple supporta le sostituzioni di stringa che forniscono segnaposto flessibili per contenuti dinamici.

Per gestire le sostituzioni di stringa in Phrase Strings, vengono creati chiavi separate utilizzando il separatore |==|. Quando si importano file .XCSTRINGS, la sostituzione viene aggiunta al nome della chiave di base utilizzando questo separatore.

Phrase Strings supporta anche la creazione di stringhe di sostituzione direttamente nel progetto. Quando le strutture di sostituzione vengono create manualmente, deve essere definita una chiave di base e una chiave di sostituzione corrispondente per garantire che il formato annidato corretto venga generato durante l'esportazione.

Le sostituzioni richiedono sempre un formato di denominazione chiave specifico: keyName|==|substitution.[specifier].

Esempio: Importazione di strutture di sostituzione da file .XCSTRINGS esistenti

La chiave denominata birdSightingAlert per la sostituzione BIRDS viene importata come una chiave plurale denominata birdSightingAlert|==|substitution.BIRDS in Phrase Strings.

Durante l'esportazione, Phrase Strings rileva la sostituzione utilizzando il separatore e ripristina la sua struttura annidata originale per il formato di localizzazione di Apple.

"birdSightingAlert": {
  "comment": "Alert message indicating the number of birds spotted",
  "localizations": {
    "en": {
      "stringUnit": {
        "state": "new",
        "value": "You spotted %#@BIRDS@!"
      },
      "substitutions": {
        "BIRDS": {
          "formatSpecifier": "BIRDS",
          "variations": {
            "plural": {
              "one": {
                "stringUnit": {
                  "state": "new",
                  "value": "a bird"
                }
              },
              "other": {
                "stringUnit": {
                  "state": "new",
                  "value": "several birds"
                }
              },
              "zero": {
                "stringUnit": {
                  "state": "new",
                  "value": "no birds"
                }
              }
            }
          }
        }
      }
    }
  }

Esempio: Creazione di stringhe di sostituzione da zero

Chiave di base

Una chiave di base denominata keyName rappresenta la stringa di formato di livello superiore che contiene il segnaposto di sostituzione %#@format@.

Quando esportato, questa chiave viene scritta come la principale stringUnit per l'entrata:
```
"keyName": {
  "localizations": {
    "en": {
      "stringUnit": {
        "state": "translated",
        "value": "%#@format@"
      }
    }
  }
}
```

Chiave di sostituzione

Una stringa di sostituzione è definita come chiave separata utilizzando il formato di denominazione della sostituzione: keyName|==|substitution.li.

Questa chiave contiene il testo di sostituzione, tipicamente con variazioni plurali. Durante l'esportazione, Phrase Strings rileva la sostituzione utilizzando il separatore |==|sostituzione. e ripristina la corrispondente struttura annidata sotto la chiave base:

{
  "sourceLanguage": "en",
  "strings": {
    "keyName": {
      "localizations": {
        "en": {
          "stringUnit": {
            "state": "translated",
            "value": "%#@format@"
          },
          "substitutions": {
            "li": {
              "formatSpecifier": "li",
              "variations": {
                "plural": {
                  "one": {
                    "stringUnit": {
                      "state": "translated",
                      "value": "%@ giorno"
                    }
                  },
                  "other": {
                    "stringUnit": {
                      "state": "translated",
                      "value": "%@ giorni"
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "version": "1.0"
}

Opzioni di formato

Identificatore	convert_placeholder
Tipo	booleano
Caricamento	No
Download	Sì
Predefinito	false
Descrizione	Il segnaposto sarà convertito per soddisfare i requisiti specifici del formato. Esempio: `$s`→`$@`, `%s`→`%@`

Identificatore	default_extraction_state
Tipo	stringa
Caricamento	No
Download	Sì
Predefinito	null
Descrizione	Definisce il valore `extractionState` scritto nelle chiavi nel file esportato quando non è già definito alcun stato di estrazione sulla chiave. Se una chiave contiene già un `extractionState`, il suo valore viene preservato durante l'esportazione. Supportato in: download UI API CLI (via `.phrase.yml` configurazione) e Repo Sync