# Updating a Project

The process of updating a project consists in taking an external source and applying it to the project. The following updates can be performed:

- Update to a new version of the bundle
- Update a language using a bundle
- Update a language using files
- Update a language using a file containing strings
- Update a selected file

Note: after updating the project with any of these methods, iLocalize will set the status of each string to red (indicating an automatic translation). You can use a filter to review all the changes to ensure they are accurate.

## Update to a new version of the bundle

Let's imagine that you have created a project for version 1.0 of a bundle. Now if version 1.1 of the bundle becomes available, iLocalize can update the project to this new version while keeping the translation and layout already done for version 1.0. This scenario usually happens if you are localizing a bundle that a developer has sent to you. To update using a new version of the bundle, follow these steps:

- Choose Project > Update From Bundle...
- Check the button
  Update the project from a new version of the bundle
- Choose or drag the new version of the bundle
- Optionally check the button
  Reset the layout of each...
  if you don't want to keep the layout of the current version. If checked, the layout of all the languages will be reverted to the layout of the base language.
- Click Next. Any problems in the bundle will be displayed if necessary.
- iLocalize will then analyze the new bundle to detect all the changes to do and will display these changes in the next view
- Carefully review the changes that will be made: iLocalize indicates which files are going to be updated, deleted or added to the project.
- Click the Update button to perform the update

## Update a language using a bundle

Let's imagine you have created a project with a specific version of a bundle. If a localizer sends you back a localized version of the bundle in a specific language, iLocalize allows you to update your project to include that language. This scenario usually happens when you are the developer of a bundle and external localizers are translating your bundle in several languages. To update a language using a bundle, follow these steps:

- Make sure the language you are about to update exists in the project. If not, add it using the command Project > Add Language.
- Choose Project > Update From Bundle...
- Check the button
  Update the localized languages of the project from bundle
- Choose or drag the bundle. The list of languages is updated to reflect the languages available in the bundle.
- Click any language you want to update in the project
- Optionally check the button
  Update nib layouts from imported layouts
  to update the layout of the language in the project with the layouts from the bundle. This is useful when the localizers has adjusted the nib files and you want your project to use those.
- Optionally check the button
  Create non-existing localized file from base language
  to create any missing file in the language of the bundle from the base language of the project.
- Click Next to begin the update of the project

Note: it is possible to also drag the bundle into the project window

## Update a language using files

Similar to the previous update options that use a bundle, this option uses a set of files instead of a bundle.

- Choose Project > Update From Files...
- Add the files to use to update the project
- Click Next
- In this view, you can choose to either update the project with a new version of the files or to update the language of the project with these files.
- Click Update to begin the update process.

Note: it is possible to also drag the files into the project window

## Update a language using a file containing strings

iLocalize supports updating a language with a file containing strings. All the formats supported by the glossaries can be imported (see Glossaries). To update using a strings file, do the following:

- Choose Project > Update Strings
- Choose or drag the strings file
- Click next to preview the changes
- A view shows the list of files that are going to be updated
- Click Import to update

Note:

- It is suggested to first export the strings from iLocalize, send it to your localizers, and then update the language with this translated strings file.
- The project console contains the logs describing which files and which strings have been translated

## Update a selected file

It is possible to update a selected file with a strings file. Right-click on the file you want to update and choose the command:

- Update Strings...