{"id":58676,"date":"2023-12-25T09:40:25","date_gmt":"2023-12-25T08:40:25","guid":{"rendered":"https:\/\/ar3dp.de\/docs\/programmieren\/xamarin-forms-basis-applikation-app-template\/lokalisierung\/"},"modified":"2023-12-25T09:40:25","modified_gmt":"2023-12-25T08:40:25","slug":"lokalisierung","status":"publish","type":"docs","link":"https:\/\/ar3dp.de\/en\/docs\/programmieren\/xamarin-forms-basis-applikation-app-template\/lokalisierung\/","title":{"rendered":"Localization"},"content":{"rendered":"

Our app template already offers integrated localization, i.e. the user is automatically shown the language that is set on their device (if there is a language file for it). If the language is unknown, the English language pack will be loaded automatically.<\/p>\n\n\n\n

Use localized content<\/h2>\n\n\n\n

To access localized content in the app, you can do the following.<\/p>\n\n\n\n

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

To get access to the localization, you have to include the following namespace.<\/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 files you can access the translations as follows.<\/p>\n\n\n\n
Text="{x:Static localization:Strings.ButtonClose}"<\/pre><\/div>\n\n\n\n
Add new language<\/h2>\n\n\n\n
To add a new language, follow the steps below.<\/p>\n\n\n\n
Create a new language file (resource file)<\/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
Set language file to public<\/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
Insert translation<\/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
Caution!<\/strong> The Name column must not be changed! This value serves as a key.<\/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
The most common flags are already available here. If your language is missing here, you can simply add the missing flag here or contact us and we will update the template accordingly.<\/p>\n\n\n\n
Danger!<\/span><\/p>\n\n\n\n
If you add a new image or flag here, please note the necessary build settings for the other files.<\/p>\n<\/div>\n<\/div>\n\n\n\n
Register language<\/h3>\n\n\n\n
Abschlie\u00dfend muss die Sprache im LocalizationManager<\/strong> hinzugef\u00fcgt werden. Dies muss in der “App.xaml.cs<\/strong>” Datei erledigt werden. Im Constructor findet Ihr folgenden Abschnitt.<\/p>\n\n\n\n
\/\/ Available languages\nLocalizationManager.Instance.SetLanguages(new List<LocalizationInfo>()\n{\n    \/\/https:\/\/www.fincher.org\/Utilities\/CountryLanguageList.shtml\n    new LocalizationInfo("English", "English", LocalizationManager.Instance.GetImageUri("en-US"), "Andreas", "en-US", 100, true),\n    new LocalizationInfo("German", "Deutsch",   LocalizationManager.Instance.GetImageUri("de-DE"), "Andreas", "de-DE", 100, true),\n});<\/pre><\/div>\n\n\n\n
Simply copy one of the entries here and adjust it for the desired language.<\/p>\n\n\n\n
Set and check language<\/h3>\n\n\n\n
Now everything should be adjusted and you can check the function or the new language. To do this, create and start the app and visit the language settings.<\/p>\n\n\n
\n
\"\"<\/figure>\n<\/div>\n\n\n
To change the language, simply click on the desired language in the list and restart the app. The app should then appear in the desired language.<\/p>","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":58608,"menu_order":3,"comment_status":"open","ping_status":"closed","template":"","meta":{"_featured":false,"_is_vendor_doc":"0","footnotes":""},"doc_tag":[],"class_list":["post-58676","docs","type-docs","status-publish","hentry"],"comment_count":0,"_links":{"self":[{"href":"https:\/\/ar3dp.de\/en\/wp-json\/wp\/v2\/docs\/58676","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=58676"}],"version-history":[{"count":1,"href":"https:\/\/ar3dp.de\/en\/wp-json\/wp\/v2\/docs\/58676\/revisions"}],"predecessor-version":[{"id":58678,"href":"https:\/\/ar3dp.de\/en\/wp-json\/wp\/v2\/docs\/58676\/revisions\/58678"}],"up":[{"embeddable":true,"href":"https:\/\/ar3dp.de\/en\/wp-json\/wp\/v2\/docs\/58608"}],"next":[{"title":"Firebase","link":"https:\/\/ar3dp.de\/en\/docs\/programmieren\/xamarin-forms-basis-applikation-app-template\/firebase\/","href":"https:\/\/ar3dp.de\/en\/wp-json\/wp\/v2\/docs\/58684"}],"prev":[{"title":"Navigation","link":"https:\/\/ar3dp.de\/en\/docs\/programmieren\/xamarin-forms-basis-applikation-app-template\/navigation\/","href":"https:\/\/ar3dp.de\/en\/wp-json\/wp\/v2\/docs\/58673"}],"wp:attachment":[{"href":"https:\/\/ar3dp.de\/en\/wp-json\/wp\/v2\/media?parent=58676"}],"wp:term":[{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/ar3dp.de\/en\/wp-json\/wp\/v2\/doc_tag?post=58676"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}