The best way to get familiar with the toolkit is to watch the video on MAT with Windows Phone. This video covers the steps for enabling a project, adding languages, and testing the result. The video can be found at http://aka.ms/matphone
For this getting started guide, we'll use a Xamarin project on GitHub called TodoL10nResx. This project uses Xamarin Forms and supports iOS, Android, and Windows Phone.
The Multilingual App Toolkit steps are as follows:
- Install Windows 8 or greater.
- Install Visual Studio 2013 Update 2 or greater.
- Install v4.0 from the Visual Studio Gallery
- Download and open the TodoL10nResx project from GitHub.
- Select the TodoL10nResx (Portable) project in the solution explorer
- Expand the project and remove the RESX files that contain a target language in the name. For example (Resources.de.resx, etc). Note: Do not remove Resources.resx
- With the TodoL10nResx (Portable) project selected, click on the Tools -> Multilingual App Toolkit -> Enable menu.
- Right-Click the TodoL10nResx (Portable) project and select 'Add Translation Languages'
- Select your languages and click OK (I'll use Ja-JP for this article)
- Right-Click the resulting Resources.ja-JP.xlf file and select 'Generate Machine Translations'
- Make the iOS, Android, or Windows Phone project the startup project
- Run your app with the emulator set to Japanese
Things that you might hit:
- Ensure the NuGet restore is enabled (Or install them yourself)
- Ensure your Xamarin is up to date
- Ensure you are running Visual Studio Update 2+
- Ensure the Resources.resx file was not deleted during step #6