Main menu

The Loco importer supports XLIFF, plus various Xcode string formats.

XLIFF

The recommended workflow is to export template .xliff files from Xcode using "Export Localizations" (from the Product menu). Then import them into Loco, and work on the translations.

You can either upload the XLIFF files via the Loco UI, or use the Import API, as follows:

curl -u <your_key>: --data-binary @en.xcloc/Localized\ Contents/en.xliff \
 'https://localise.biz/api/import/xliff'

For a detailed XLIFF example, see the Xcode section of Importing XLIFF files into Loco.

See the export guide once you're ready to download your translations for importing back into Xcode.

String Catalogs

Xcode manages String Catalogs via .xcstrings files in the project's Localizations directory. Although it's not recommended to update these files outside of Xcode, you can still use them to get data into Loco.

String Catalogs are multi-language files, so it's quick to import all your existing translations from a string table as follows:

curl -u <your_key>: --data-binary @MyProject/Localizations/Localizable.xcstrings \
 'https://localise.biz/api/import/xcstrings?locale=auto'

Please note that Loco can't yet import device variations, or plural substitutions introduced in Xcode 15. We're working on this.

Strings and Stringsdict

Loco treats files with extensions .strings and .stringsdict as Xcode resources. Strings are imported as simple key/value pairs. Stringsdict files are imported as plurals, or other string variations.

The importer will automatically detect binary formats if your files have been compiled by the Xcode builder.

curl -u <your_key>: --data-binary @Example.app/en.lproj/Localizable.strings \
 'https://localise.biz/api/import/strings?locale=en'

Property lists

Apple property lists can be imported. Both the XML and Binary property list formats are supported as generic key/value pairs for adding translations to your project. Use the .plist or .bplist extensions accordingly, and note that a file in your build directory may be binary despite its file extension:

curl -u <your_key>: --data-binary @Example.app/Info.plist \
 'https://localise.biz/api/import/bplist?locale=en'

See also

Last updated by