mirror of
https://github.com/bitwarden/mobile.git
synced 2024-08-19 22:03:36 +02:00
2.6 KiB
2.6 KiB
Code contributions are welcome! Please commit any pull requests against the master
branch.
Internationalization (i18n)
If you are interested in helping translate the bitwarden mobile app into another language, please follow these steps when creating your pull request:
- Create a new resource file under
/src/App/Resources
by copy/pasting the master English file,AppResources.resx
. - Rename your
AppResources.resx
copy to include the proper .NET culture code for your language (typically the two letter code, ex.sv
). You can find a list of culture codes here: http://timtrott.co.uk/culture-codes/. For example, if I want to create a new translation for Swedish, I will rename myAppResources.resx
copy toAppResources.sv.resx
. - Open the
AppResources.XX.resx
file for your newly created language and start translating the<value>
tags for each<data>
element. The<data>
and<comment>
properties should not be translated and remain in English. - Repeat the same process for the store
COPY.md
andCAPTIONS.md
files in/store/apple
and/store/google
by creating a new folder for your language in each. Do not copy over theassets
andscreenshots
folders to your new language. We will update these based on your translations provided inCAPTIONS.md
. Finally, do not translate the titles in the markdown files (ex.# Name
and# Screenshot 1
). These are only for reference. - If you have a Xamarin development environment setup, test your translations to make sure they look correct in the app on iOS and Android. Sometimes the UI can break due to translations taking up more space than the original UI was built for. If possible, use a shorter or abbreviated version of the word/sentence to accomedate the available space. If you are unable to accomedate the avaialable space for a particular translation, just let us know in your pull request comments. If you are unable to test your translations, just let us know in your pull request comments so that we can check it for you.
- Be sure to watch for future changes
to the
/src/App/Resources/AppResources.resx
file so that your translation will stay up to date.
You can find an example of a proper translation pull request here: https://github.com/bitwarden/mobile/pull/22/files
You can read more about localizing a Xamarin.Forms app here: https://developer.xamarin.com/guides/xamarin-forms/advanced/localization/
TIP: If you have Visual Studio installed, it provides a nice tabular UI for editing resx
XML files.