Skip to main content

Tool for automatic search and localization of .strings files

Project description

XCodeLocalize

Requirments

Python3.9+

Installation

Using pip:

pip3 install xcodelocalize 

Аlso available installations via poetry or .whl file from github releases

Usage

Prepare your xcode project

  1. Create Localizable.strings file and fill it with strings you want to localize.

    /* optional description */
    "[key]" = "[string]";
    
    /* Example: */
    "welcome text" = "Welcome to XCodelocalize";
    
  2. Go to the project settings, add the desired languages.

  3. Create localization (.strings) files for all selected languages.

There is a nice tutorial about ios app localization by kodeco (the new raywenderlich.com)

Localize

cd to project root folder and run

xcodelocalize [OPTIONS]

or

python3 -m xcodelocalize [OPTIONS]

Options

  • --base-language: code of the language from which all strings will be translated. [default: 'en']

  • --override / --no-override: a boolean value that indicates whether strings that already exist in the file will be translated. Retranslate if override, skip if no-override. [default: no-override]

  • --format-base / --no-format-base: sort base file strings by key. [default: no-format-base]

  • --file: Names of the strings files to be translated. Multiple files can be specified. If not specified, all files will be translated. [default: None]

    Example:

    xcodelocalize --file InfoPlist
    xcodelocalize --file InfoPlist --file MainStoryboard --file Localizable 
    
  • --key: Keys of the strings to be translated. Multiple keys can be specified. If not specified, all keys will be translated. [default: None]

  • --language: Language codes of the strings files to be translated. Multiple language codes can be specified. If not specified, all files will be translated. [default: None]

  • --log-level: One from [progress|errors|group|string]. [default: group]

  • --help: Show info

Features:

  • The tool looks for .strings files in the current directory recursively, grouping and translating fully automatically. You can even run it in the root directory and localize all your projects at once.

  • Regular .strings, Info.plist, storyboards and intentdefinition files are supported.

  • Formated strings with %@ are supported.

  • Multiline strings are supported.

  • Comments are supported and will be copied to all files. Comments must not contain substrings in localizable strings format with comment, such as /*[comment]*/ "[key]" = "[value]";.

Automation

You can go to Target -> Build Phases -> New Run Script Phase in your xcode project and paste xcodelocalize there. It will localize necessary strings during build and your localization files will always be up to date.


Bonus

Nice swift extension that allows you to do this

"welcome text".localized // will return "Welcome to XCodelocalize"
extension String {
    var localized: String {
        NSLocalizedString(self, tableName: nil, bundle: .main, value: self, comment: "")
    }
    
    func localized(_ arguments: String...) -> String {
        String(format: self.localized, locale: Locale.current, arguments: arguments)
    }
}

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

xcodelocalize-1.0.3.tar.gz (5.9 kB view details)

Uploaded Source

Built Distribution

xcodelocalize-1.0.3-py3-none-any.whl (7.6 kB view details)

Uploaded Python 3

File details

Details for the file xcodelocalize-1.0.3.tar.gz.

File metadata

  • Download URL: xcodelocalize-1.0.3.tar.gz
  • Upload date:
  • Size: 5.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.11.4

File hashes

Hashes for xcodelocalize-1.0.3.tar.gz
Algorithm Hash digest
SHA256 0bc106d2d40ecbf83e6560b9e654ea7edbde1e679042f34037937c2a443dc99f
MD5 789c7016f11a68ceb3ff3edb1a84fefa
BLAKE2b-256 3f4780e3ea28d86d76eb95d61a29d2e4432b3a0aa5c06b0f174301b1140b6715

See more details on using hashes here.

File details

Details for the file xcodelocalize-1.0.3-py3-none-any.whl.

File metadata

File hashes

Hashes for xcodelocalize-1.0.3-py3-none-any.whl
Algorithm Hash digest
SHA256 c750f332fb4e167f536e78a4618c9f9fc2d4fedf089ce46bcace65c85caba942
MD5 1a230cecfd64d37b6dc1f4b21341f403
BLAKE2b-256 56a118ef297c5040a9aa99bd32be7cbc02712379ddd75cbb8244025c9adce4ab

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page