rescodegen

A command line tool for creating Swift and Objective-C code from singular Localizable.strings and plural Localizable.stringsdict.

Installation

$ sudo gem install rescodegen

Usage

Generate Code

$ rescodegen -i Localizable.strings

Options

Option	Value	Required	Default	Description
-i	relative/path/to/Localizable.strings	✔️		The input file(s). Must be .strings or .stringsdict format. You may specify more than 1 file.
-l	swift or objc	❌	swift	The language of the generated code.
-o	relative/path/to/output/directory	❌	.	Where to save generated files.
-p	e.g. SH	❌		An optional prefix to apply to Objective-C types.

Example

Localizable.strings

...
/* Error message to display when uploading an image fails. */
"Uploader.ErrorAlert.Message" = "The upload failed.";
...

Localizable.stringsdict

...
    <key>Uploader.ProgressLabel.Text</key>
	<dict>
		<key>NSStringLocalizedFormatKey</key>
		<string>Uploading %#@images@.</string>
		<key>images</key>
		<dict>
			<key>NSStringFormatSpecTypeKey</key>
			<string>NSStringPluralRuleType</string>
			<key>NSStringFormatValueTypeKey</key>
            <string>d</string>
            <key>one</key>
            <string>one image</string>
			<key>other</key>
			<string>%d images</string>
		</dict>
	</dict>
...

Generate Code

$ rescodegen -i Localizable.strings -i Localizable.stringsdict
$ rescodegen -i Localizable.strings -i Localizable.stringsdict -l objc

Xcode

Drag the generated files into Xcode and add them to your target.

Swift

Access localized singular strings:
Strings.Singular.uploader_errorAlert_message.localizedString => "The upload failed."
Access localized plural strings:
Strings.Plural.uploader_progressLabel_text.localizedString(1) => "Uploading one image."

Objective-C

Access localized singular strings:
LocalizedSingularString(SingularString_uploader_errorAlert_message) => "The upload failed."
Access localized plural strings:
LocalizedPluralString(PluralString_uploader_progressLabel_text, 2) => "Uploading 2 images."

Encoding

rescodegen currently only supports UTF-8 encoding.