MAT v4.0 Manual Upgrade

Thank you for installing v4.0. This article describes how to manually update your MAT v3.x projects so you can use them with v4.0.

If you have a project that is currently enabled with MAT v3.x, you will need to perform some manual modification before you can open and use the project with v4.0 testing.
  1. Ensure you have a current backup copy or it is safely in source control
  2. Open the Solution using a machine with MAT 3.1 
  3. Select the project and click Tools -> Disable Multilingual App Toolkit
  4. Save the XLF files from the project to a temporary location
  5. Delete all the XLF files from the project. 
    Note: If the project type uses resx files (such as WinForms or WPF), they will be deleted when you delete the XLF files - this is expected.  The translation are in the saved XLF files and will be imported later in this process.
  6. Build to ensure everything is working without the translation support.
Of course, it is not always possible to disable MAT using the steps above because MAT v3.1 was already uninstalled and replaced with v4.0.  If this is case, here are the direction to remove MAT's configuration from the project file manually.
  1. Ensure you have a current backup copy or it is safely in source control
  2. Load the Solution in Visual Studio
  3. Clear the message about the project being disabled.
  4. Right-Click on the project and select Edit
  5. Search for: Label="MultilingualAppToolkit"
  6. Delete the Multilingual App Toolkit created <PropertyGroup> and it's contents
  7. Search again for: Label="MultilingualAppToolkit"
  8. Delete the Multilingual App Toolkit created <import> element
  9. Save and Reload the project
  10. Save the XLF files from the project to a temporary location
  11. Delete all the XLF files from the project
    Note: If the project type uses resx files (such as WinForms or WPF), they will be deleted when you delete the XLF files - this is expected. The translation are in the saved XLF files and will be imported later in this process.
  12. Build to ensure everything is working without the translation support.
Now that the v3.x configuration is removed from your project, you can re-enable using v4.0 via the Tools->Multilingual App Toolkit->Enable menu.  (If you are unfamiliar with using the toolkit, please read MAT v4.0 Getting Started guide for quick walk-through)

Once you have enabled the project with v4.0, you have the option of recycling the translation from your v3.x project's XLF files.  Here are the steps to import with recycling:
  1. Load the Solution in Visual Studio
  2. Ensure the project is enabled with v4.0
  3. Right-Click the desired project and select Multilingual App Toolkit -> Add translation languages...
  4. Reselect the languages previous enabled on the project.
  5. Right click on the added MultilingualResources folder (or specific languages XLF files) and select Multilingual App Toolkit -> Import / recycling translations...
  6. Click the Add button and select the v3.1 XLF files copy to the temporary location.
  7. Important: Check the 'Enable resource recycling' box at the bottom of the dialog box.
  8. Click the Import button
  9. Build the project to test your using your imported translations
This will import your v3.1 project translations into your v4.0 project's new XLF file.

Have fun and be sure to submit your feedback on the (MAT User Voice) site!

Cameron

Feedback and Knowledge Base