{"id":58003,"date":"2023-01-29T09:04:37","date_gmt":"2023-01-29T08:04:37","guid":{"rendered":"https:\/\/ar3dp.de\/docs\/programmieren\/net-maui-basis-applikation-app-template\/lokalisierung\/"},"modified":"2023-01-29T09:04:37","modified_gmt":"2023-01-29T08:04:37","slug":"lokalisierung","status":"publish","type":"docs","link":"https:\/\/ar3dp.de\/en\/docs\/programmieren\/net-maui-basis-applikation-app-template\/lokalisierung\/","title":{"rendered":"Localization"},"content":{"rendered":"\n

Unsere App-Vorlage bietet bereits eine integrierte Lokalisierung, sprich dem Nutzer wird automatisch die Sprache angezeigt, welche auf seinem Ger\u00e4t eingestellt ist (sofern es daf\u00fcr eine Sprachdatei gibt). Sollte die Sprache unbekannt sein, dann wird automatisch das englische Sprachpaket geladen.<\/p>\n\n\n\n

Lokalisierte Inhalte verwenden<\/h2>\n\n\n\n

Um auf lokalisierte Inhalte in der App zuzugreifen, k\u00f6nnt Ihr wie folgt vorgehen.<\/p>\n\n\n\n

Namespace<\/h3>\n\n\n\n

Um Zugriff auf die Lokalisierung zu erhalten, m\u00fcsst Ihr folgenden Namespace einbinden.<\/p>\n\n\n\n

using AppBasement.Resources.Localization;<\/pre><\/div>\n\n\n\n
xmlns:localization="clr-namespace:AppBasement.Resources.Localization"<\/pre><\/div>\n\n\n\n
C#<\/h3>\n\n\n\n
In Klassen k\u00f6nnt Ihr \u00fcber das “Strings”-Objekt auf die \u00dcbersetzung zugreifen.<\/p>\n\n\n\n
await Shell.Current.DisplayAlert(\n    Strings.DialogActionNotAvailableInDemoModeHeadline,\n    Strings.DialogActionNotAvailableInDemoModeContent,\n    Strings.Close\n    );<\/pre><\/div>\n\n\n\n
XAML<\/h3>\n\n\n\n
In XAML Dateien k\u00f6nnt Ihr wie folgt auf die \u00dcbersetzungen zugreifen.<\/p>\n\n\n\n
Text="{x:Static localization:Strings.ButtonClose}"<\/pre><\/div>\n\n\n\n
Neue Sprache hinzuf\u00fcgen<\/h2>\n\n\n\n
Um eine neue Sprache hinzuzuf\u00fcgen, sind folgende Schritte zu beachten.<\/p>\n\n\n\n
Neue Sprachdatei anlegen (Ressourcen-Datei)<\/h3>\n\n\n\n
\n
\n
\"Projektmappen-Explorer\"<\/figure>\n<\/div>\n\n\n\n
\n
Im Projektmappen-Explorer w\u00e4hlt Ihr den Ordner “Localization” mit der rechten Maustaste an und f\u00fcgt anschlie\u00dfend \u00fcber den Men\u00fcpunkt “Hinzuf\u00fcgen => Neues Element” ein neues Ressourcendatei (resx) <\/strong>hinzu.<\/p>\n<\/div>\n<\/div>\n\n\n\n
Die Dateivorlage findet Ihr am schnellsten, wenn Ihr “res” in der Suchleiste oben rechts angebt.<\/p>\n\n\n
\n
\"\"<\/figure>\n<\/div>\n\n\n
Benennt die Datei “Strings.xx-XX.resx”, wobei “xx-XX” f\u00fcr die gew\u00fcnschte Sprache steht, im Beispiel hier “de-DE” f\u00fcr Deutsch. Eine \u00dcbersicht aller L\u00e4ndercodes findet Ihr, unter anderem, hier<\/a>.<\/p>\n\n\n\n
Sprachdatei auf \u00f6ffentlich stellen<\/h3>\n\n\n\n
Nach dem Hinzuf\u00fcgen der Sprachdatei wird diese in der Regel automatisch ge\u00f6ffnet. Falls nicht, die neue Datei im “Localization<\/span>“-Ordner doppelklicken. Bei Zugriffsmodifier <\/span>den Wert auf “public<\/span>” setzen. Andernfalls ist der Inhalt nicht zugreifbar.<\/p>\n\n\n
\n
\"\"<\/figure>\n<\/div>\n\n\n
\u00dcbersetzung einf\u00fcgen<\/h3>\n\n\n\n
Nun kopiert den Inhalt aus der originalen “Strings.resx”-Datei und \u00fcbersetzt die Spalte “Wert” in die gew\u00fcnschte Sprache.<\/p>\n\n\n\n
Achtung!<\/strong> Die Spalte Name darf nicht ge\u00e4ndert werden! Dieser Wert dient als Schl\u00fcssel.<\/span><\/div>\n\n\n\n
Flagge einf\u00fcgen<\/h3>\n\n\n\n
\n
\n
\"\"<\/figure>\n<\/div><\/div>\n\n\n\n
\n
In den Spracheinstellungen werden zu den jeweiligen Sprachen auch die Flaggen angezeigt. Diese werden im “Resourcen<\/strong>“-Ordner “Images\/Flags” verwaltet.<\/p>\n\n\n\n
Die g\u00e4ngigsten Flaggen sind hier bereits verf\u00fcgbar. Sollte hier Ihre Sprache fehlen, dann k\u00f6nnen Sie hier einfach die fehlende Flagge mit hinzuf\u00fcgen oder uns kontaktieren und wir aktualisieren das Template dementsprechend.<\/p>\n\n\n\n
Achtung!<\/span><\/p>\n\n\n\n
Sollten Sie hier ein neues Bild bzw. Flagge hinzuf\u00fcgen, beachten Sie bitte die n\u00f6tigen Build-Einstellungen der anderen Dateien.<\/p>\n<\/div>\n<\/div>\n\n\n\n
Sprache registrieren<\/h3>\n\n\n\n
Abschlie\u00dfend muss die Sprache im LocalizationManager<\/strong> hinzugef\u00fcgt werden. Dies muss in der “AppHostBuilderExtension.cs” Datei erledigt werden. In der ConfigureApp<\/code> Methode findet Ihr folgenden Abschnitt.<\/p>\n\n\n\n
\/\/ Available languages\n                .ConfigureLocalizationManager([\n                    \/\/https:\/\/www.fincher.org\/Utilities\/CountryLanguageList.shtml\n                    new("English", "English", LocalizationManager.GetImageUri("", "en-US"), "Andreas", "en-US", 100, true),\n                    new("German", "Deutsch", LocalizationManager.GetImageUri("", "de-DE"), "Andreas", "de-DE", 100, true),\n                ], "")<\/pre><\/div>\n\n\n\n
Kopiert hier einfach einen der Eintr\u00e4ge und passt diesen f\u00fcr die gew\u00fcnschte Sprache an.<\/p>\n\n\n\n
Sprache einstellen und \u00fcberpr\u00fcfen<\/h3>\n\n\n\n
Nun sollte alles soweit angepasst werden und Ihr k\u00f6nnt die Funktion bzw. die neue Sprache \u00fcberpr\u00fcfen. Erstellt und startet dazu die App und besucht die Spracheinstellungen.<\/p>\n\n\n
\n
\"\"<\/figure>\n<\/div>\n\n\n
Zum Wechseln der Sprache einfach auf die gew\u00fcnschte Sprache in der Liste Klicken und die App neu starten. Anschlie\u00dfend sollte die App in der gew\u00fcnschten Sprache erscheinen.<\/p>\n","protected":false},"excerpt":{"rendered":"
Unsere App-Vorlage bietet bereits eine integrierte Lokalisierung, sprich dem Nutzer wird automatisch die Sprache angezeigt, welche auf seinem Ger\u00e4t eingestellt ist (sofern es daf\u00fcr eine Sprachdatei gibt). Sollte die Sprache unbekannt sein, dann wird automatisch das englische Sprachpaket geladen. Lokalisierte Inhalte verwenden Um auf lokalisierte Inhalte in der App zuzugreifen, k\u00f6nnt Ihr wie folgt vorgehen….<\/p>","protected":false},"author":1,"featured_media":0,"parent":57992,"menu_order":4,"comment_status":"open","ping_status":"closed","template":"","meta":{"_featured":false,"_is_vendor_doc":"0","footnotes":""},"doc_tag":[],"class_list":["post-58003","docs","type-docs","status-publish","hentry"],"comment_count":0,"_links":{"self":[{"href":"https:\/\/ar3dp.de\/en\/wp-json\/wp\/v2\/docs\/58003","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/ar3dp.de\/en\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/ar3dp.de\/en\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/ar3dp.de\/en\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/ar3dp.de\/en\/wp-json\/wp\/v2\/comments?post=58003"}],"version-history":[{"count":1,"href":"https:\/\/ar3dp.de\/en\/wp-json\/wp\/v2\/docs\/58003\/revisions"}],"predecessor-version":[{"id":58959,"href":"https:\/\/ar3dp.de\/en\/wp-json\/wp\/v2\/docs\/58003\/revisions\/58959"}],"up":[{"embeddable":true,"href":"https:\/\/ar3dp.de\/en\/wp-json\/wp\/v2\/docs\/57992"}],"next":[{"title":"ViewModels","link":"https:\/\/ar3dp.de\/en\/docs\/programmieren\/net-maui-basis-applikation-app-template\/viewmodels\/","href":"https:\/\/ar3dp.de\/en\/wp-json\/wp\/v2\/docs\/57995"}],"prev":[{"title":"Navigation","link":"https:\/\/ar3dp.de\/en\/docs\/programmieren\/net-maui-basis-applikation-app-template\/navigation\/","href":"https:\/\/ar3dp.de\/en\/wp-json\/wp\/v2\/docs\/58136"}],"wp:attachment":[{"href":"https:\/\/ar3dp.de\/en\/wp-json\/wp\/v2\/media?parent=58003"}],"wp:term":[{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/ar3dp.de\/en\/wp-json\/wp\/v2\/doc_tag?post=58003"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}