AegiNext-Lokalisierung
Finden Sie den aktuellen AegiNext-Checkout und lesen Sie zuerst den tatsächlichen Consumer- und zugehörigen Code. Lösen Sie Repository-Pfade relativ zu diesem Checkout auf; betten Sie keine Entwickler-Pfade ein. Der gemeinsame Einstiegspunkt ist src/AegiNext.Desktop/I18n/, mit dem Namespace AegiNext.Desktop.I18n. Erweitern Sie dieses bestehende System für neuen UI-Text.
Kontext für die Änderung auswählen
| Änderung | Zuerst lesen |
|---|---|
| Text, Sprachpakete, fehlende Einträge oder Sprachabgleich | I18n/Languages/*.json, I18n/Localization.cs, I18n/LocalizationCatalog.cs, I18n/LanguagePackReader.cs |
| Statische Beschriftungen, QuickInfos oder Barrierefreiheitsnamen | Consumer-AXAML, I18n/LocExtension.cs, I18n/XamlNamespace.cs, Controls/Common/IconText.cs |
| Dynamischer Zustand, Menüs, Dock oder Fenstertitel | Besitzendes ViewModel/Controller, Workspace/WorkbenchSession.cs, Windowing/WorkbenchWindowRegistry.cs |
| Erstanzeige, Sprachauswahl oder Einstellungen | App.axaml.cs, Views/MainWindow.axaml.cs, Workspace/WorkbenchStartupPreferences.cs, Settings/Appearance/AppearanceSettingsViewModel.cs |
| Build- oder Veröffentlichungsressourcen | AegiNext.Desktop.csproj, scripts/publish/AegiNext.Publish.psm1, docs/en/publishing.md |
Produktionspfade ohne vollständiges Präfix befinden sich unter src/AegiNext.Desktop/; Skripte und Dokumentation werden vom Checkout-Stammverzeichnis aus aufgelöst. Siehe docs/en/composable-workspace.md für die Arbeitsbereichslokalisierung. Lesen Sie references/verification.md, wenn eine Überprüfung erforderlich ist; gewöhnliche Textbearbeitungen erfordern nicht das Laden jeder Implementierung.
Sprachpakete und Schlüssel
Bearbeiten Sie Quellpakete in I18n/Languages/, nicht in kopierten Ausgaben. Halten Sie die Schlüsselsätze der integrierten en-US.json und zh-CN.json gleich und fügen Sie für neue Schlüssel beide Übersetzungen hinzu. Pakete von Drittanbietern können Einträge auslassen und Fallback verwenden. Beachten Sie besitzende Präfixe wie Workbench, Settings, Preview, Layout, Log, WorkflowLog und WindowChromeProbe. Halten Sie semantisch unterschiedliche Schlüssel wie Workbench.Export und Settings.Export getrennt.
{
"LanguageName": "English",
"LanguageID": "en-US",
"Strings": {
"Workbench.Cancel": "Cancel"
}
}
Dies veranschaulicht das Schema, nicht ein Ersatz für integrierte Pakete. Speichern Sie UTF-8 ohne BOM. LanguageName muss nicht leer sein, LanguageID ein gültiger Kulturbezeichner, und jeder nicht leere Strings-Schlüssel muss auf einen String abbilden. system ist als Auswahlwert reserviert. Lehnen Sie doppelte Root-Felder und Textschlüssel ab. Sprach-IDs werden normalisiert und groß-/kleinbuchstabenunabhängig verglichen; Textschlüssel sind groß-/kleinschreibungssensitiv. Beachten Sie Positionsargumentindizes und Formatsemantik in Übersetzungen.
Beim Start werden nur *.json-Dateien der ersten Ebene gescannt und deren interne IDs verwendet. Fehlerhafte optionale Pakete erzeugen Dateidiagnosen und werden ausgeschlossen; jede Gruppe mit doppelten IDs wird ausgeschlossen. Der Start schlägt ohne ein gültiges eindeutiges en-US-Paket fehl. Verstecken Sie Ressourcenfehler nicht mit doppelten C#-Texttabellen. Ressourcenänderungen erfordern einen Neustart; dieses System hat kein Hot Reload.
Untertitelinhalt, benutzerdefinierte Voreinstellungsnamen, Pfade, Skriptsyntax, serialisierte IDs und Encoderidentitäten behalten ihre geschäftliche Bedeutung. Enum-zu-Schlüssel-Zuordnungen gehören zum Feature, z. B. Editing/AnimationPropertyLocalization.cs, anstatt den allgemeinen Dienst zu erweitern.
Dienst- und Präferenzverträge
- Rufen Sie
Initialize(directory)einmal im UI-Thread vor dem Laden von AXAML auf, unter Verwendung vonPath.Combine(AppContext.BaseDirectory, "i18n"). Es erfasst die ursprüngliche System-UI-Kultur; initialisieren Sie nicht pro Steuerelement/Fenster. Get(key)liest unveränderliche Snapshots von jedem Thread: aktuelle Sprache, dannen-US, dann den Rohschlüssel. Ergebnisse hängen nicht von derCurrentUICulturedes Aufrufers ab; asynchrone Wiedergabe-Callbacks verwenden denselben Dienst.Format(key, params object[] arguments)verwendetCurrentCulturefür die Zahlenformatierung. Sprachänderungen aktualisieren die UI-Kultur, ohne die etablierte Zahlen-Eingabekultur zu ändern.SetLanguage(lang)wird im UI-Thread ausgeführt und akzeptiert installierte IDs odersystem. Unbekannte IDs lösen eine Ausnahme aus, ohne die Sprache zu ändern; unveränderte Auswahl/wirksamer Zustand benachrichtigt nicht erneut.SelectedLanguageIDist die angeforderte Auswahl;CurrentLanguageIDist das aufgelöste Paket. Die Systemzuordnung verwendet die ursprünglich erfasste Kultur: exakte ID, Eltern, gleichsprachige Kandidaten, dann Englisch. Chinesisch/Englisch bevorzugenzh-CN/en-US; andere Kandidaten sortieren nach ID.KnownLanguagesliefertLanguageName-Beschriftungen undLanguageID-Auswahl sowie eine lokalisierte Systemoption. Stellen Sie keine festen englischen/chinesischen Indizes oder eine Präferenz-Whitelist wieder her.- Der Dienst speichert keine Einstellungen. Wenden Sie die gleiche geladene Starteinstellung vor dem MainWindow-AXAML an und übergeben Sie diesen Speicher/Snapshot an die Sitzung. Wenn ein gespeichertes Paket vorübergehend nicht verfügbar ist, zeigen Sie Englisch an, während Sie die gespeicherte ID und andere Einstellungen beibehalten.
- Nach einem direkten
SetLanguagedarf das Speichern einer nicht verwandten Design-/Lautstärkeeinstellung die Sprache nicht zurücksetzen. Wenden Sie eine neue Auswahl nur an, wenn sich die Spracheinstellung selbst ändert.
Loc für statischen Text verwenden
Der standardmäßige Avalonia-XML-Namespace registriert LocExtension über XmlnsDefinition, daher verwenden Sie {Loc Key=...} ohne Präfix:
<TextBlock Text="{Loc Key=Workbench.Codec}" />
<Button Content="{Loc Key=Workbench.Cancel}" />
<Expander Header="{Loc Key=Settings.Advanced}" />
<Button ToolTip.Tip="{Loc Key=Workbench.Save}">
<common:IconText Text="{Loc Key=Workbench.Save}" IconKey="Save" />
</Button>
Das letzte Beispiel benötigt xmlns:common="using:AegiNext.Desktop.Controls.Common". Verwenden Sie IconText-Typografie und -Größe wieder; IconKey identifiziert das Symbol unabhängig von übersetzten Schlüsseln/Werten. Migrieren Sie Text, Inhalt, Header, QuickInfos und Barrierefreiheitsnamen nach Bedarf; bewahren Sie Geschäftsbindungen für dynamischen Inhalt.
Loc gibt eine beobachtbare Bindung zurück, liefert sofort Text beim Abonnieren und aktualisiert bei Sprachänderungen. Bewahren Sie den DataContext. Erfassen Sie keine Zielsteuerelemente, durchsuchen Sie keine Bäume, führen Sie keine Übersetzungs-Tags wieder ein oder ersetzen Sie Live-Bindungen durch einmalige Get-Zuweisungen.
Dynamischer Text und Abonnementlebensdauer
Wiedergabe/Pause, Stummschaltung, Tastenkombinationsaufzeichnung und Exportzustände bleiben an ihre besitzenden ViewModels gebunden, die Get/Format aufrufen. Speichern Sie semantische Schlüssel, Enums und Formatargumente anstelle nur der zuletzt übersetzten Zeichenfolge. Verwenden Sie zentralisierte LanguageChanged-Handler in Sitzungen, Layouts, Registries und Einstellungen; vermeiden Sie doppelte Abonnements.
Für programmgesteuerte Steuerelemente behalten und geben Sie das beobachtbare Bindungshandle frei:
var binding = button.Bind(
ContentControl.ContentProperty,
Localization.Observe("Workbench.Cancel").ToBinding());
Observe ist derzeit intern in Desktop. Geben Sie Handles/Ereignisse bei Closed/Dispose frei und entsorgen Sie zuerst eine ersetzte Zustandsbindung. Anbieter erfassen nur notwendige Geschäftswerte, wie in Views/TrackStyleChangeDialog.cs. Unterscheiden Sie vorübergehendes Abtrennen von festen Panels von der endgültigen Entsorgung, sodass das Wiederanfügen weiterhin Updates erhält.
Sprachaktualisierung ändert nur die Darstellung: keine geschäftlichen Commits, Projekterstellung, Rückgängig oder verworfene Entwürfe. Aktualisieren Sie Auswahllisten unter Beibehaltung stabiler IDs, tatsächlicher Auswahl und ungültiger Roheingabe; ignorieren Sie die automatische Framework-Auswahl als Benutzerbearbeitung. Verwenden Sie die verbrauchenden Styles/Effects ChoicesRefreshing/ChoicesRefreshed-Wächter bei Bedarf wieder.
Überprüfen und ausliefern
Folgen Sie den betroffenen Gruppen in Verifikation, überprüfen Sie kompiliertes AXAML, Live-Switching, Geschäftszustand und Release-Verhalten. Überprüfen Sie rohes JSON auf Schlüsselvollständigkeit; Get-Fallback kann nicht beweisen, dass Übersetzungen existieren. Build-/Lade-/Veröffentlichungsänderungen erfordern tatsächliche Ausgabe-i18n-Verzeichnisse, Pakethashes und Start von einem anderen Arbeitsverzeichnis. macOS-Pakete verwenden AegiNext.app/Contents/MacOS/i18n/.
Melden Sie tatsächliche Builds/Analysen, bestandene/fehlgeschlagene/übersprungene Tests, Ressourcenprüfungen und native Akzeptanz. Zählen Sie Schlüssel/Tests aus aktuellen Beweisen, nicht aus historischen Summen. Trennen Sie Headless-Ergebnisse von Schaltflächen-/Symbol-, Langtext- und Plattformmenü-Darstellung. Bewahren Sie den Umfang und nicht verwandte Arbeiten; die Verwendung dieser Fähigkeit autorisiert keine Commits oder Abhängigkeitsupgrades.