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'