xcmultilingual
Command line tool for Swift localizations: It parses localization files in the project and generate swift file including functions with neat complementations!
RubyGems: xcmultilingual
CANGELOG
See CANGELOG for update information.
Recent breaking changes
-
0.3.0 Getting localized value now from
valuecomputed property. It wasstring()function.
Installation
Add this line to your application's Gemfile:
gem 'xcmultilingual'And then execute:
$ bundle
Or install it yourself as:
$ gem install xcmultilingual
Usage
1. Install xcmultilingual instructed above.
This is command line tool distributed with RubyGems.org.
2. Create empty swift file in top level of project tree.
Named as Multilingual.swift in this example. xcmultilingual parses same and lower directries' .bundle and .lproj.
.
├── DemoApp
│ ├── AppDelegate.swift
│ ├── Base.lproj
│ ├── Images.xcassets
│ ├── Info.plist
│ ├── Loalizations
│ ├── Multilingual.swift3. Execute update command with destination file path
$ xcmultingual update ./DemoApp/Multilingual.swiftAnd then convenient functions will be generated in destination swift file.
Example:
import Foundation
struct Multilingual {
class ClassForBundle {}
enum Animal: String {
case CAT = "CAT"
case DOG = "DOG"
case BEAR = "BEAR"
case DEER = "DEER"
case SQUIRREL = "SQUIRREL"
case ELEPHANT = "ELEPHANT"
case GIRAFFE = "GIRAFFE"
case TIGER = "TIGER"
case LION = "LION"
case RABBIT = "RABBIT"
case RHINOCEROS = "RHINOCEROS"
case GORILLA = "GORILLA"
case MONKEY = "MONKEY"
var value: String {
return NSLocalizedString(rawValue, tableName: Animal.name, bundle: NSBundle(forClass: ClassForBundle.self), value: rawValue, comment: "")
}
static let name = "Animal"
static var keys: [String] {
return ["CAT", "DOG", "BEAR", "DEER", "SQUIRREL", "ELEPHANT", "GIRAFFE", "TIGER", "LION", "RABBIT", "RHINOCEROS", "GORILLA", "MONKEY"]
}
static var localizations: [String] {
return Animal.keys.map { Animal(rawValue: $0)!.value }
}
}
enum Localizable: String {
case HELLO = "HELLO"
case GOODMORNING = "GOODMORNING"
case GOODEVENING = "GOODEVENING"
var value: String {
return NSLocalizedString(rawValue, tableName: Localizable.name, bundle: NSBundle(forClass: ClassForBundle.self), value: rawValue, comment: "")
}
static let name = "Localizable"
static var keys: [String] {
return ["HELLO", "GOODMORNING", "GOODEVENING"]
}
static var localizations: [String] {
return Localizable.keys.map { Localizable(rawValue: $0)!.value }
}
}
enum SampleSample: String {
case SAMPLE = "SAMPLE"
var value: String {
return NSLocalizedString(rawValue, tableName: SampleSample.name, bundle: NSBundle(path: NSBundle(forClass: Multilingual.ClassForBundle.self).resourcePath!.stringByAppendingPathComponent("sample.bundle"))!, value: rawValue, comment: "")
}
static let name = "Sample"
static var keys: [String] {
return ["SAMPLE"]
}
static var localizations: [String] {
return SampleSample.keys.map { SampleSample(rawValue: $0)!.value }
}
}
}4. Use with complementations!!
And now, you can access your localization string with pretty good complementations.
For example, when write: Multilingual, complementations are below:
Multilingual.Localizable
Multilingual.AnimalAnd then, select Multilingual.Animal, complementations are blow:
Multilingual.Animal.CAT
Multilingual.Animal.DOG
Multilingual.Animal.BEAR
Multilingual.Animal.DEERAwesome!
And print localized string is:
Multilingual.Animal.DOG.valueEasy!
Commands
update: Update swift file. DESTINATION is required.
options:
-
-nameor-n: Change Localization struct name. Default is Multilingual. -
-templateor-t: Use custom template for generating swift file. You can copy original and change where you want! -
--verbose: Output execution logs
help: Write update after help and show update options' help.
If you want to use LOC for top level struct name. xcmultilingual update ./DemoApp/Multilingual.swift -n LOC and then you can write like LOC.Animal.DOG.value
Swift functions
Multilingual is swift struct. Localization tables are represented as enum in this struct.
Each enum has value instance computed property and Table name, keys and localizations static computed properties.
Example:
When you want to use Animal table's DOG key localization.
Multilingual.Animal.DOG.value // DogWhen you want to show every localizations in test.
Multilingual.Animal.localizations() // ["Cat", "Dog", "Bear", "Dear"]Contributing
Bug reports and pull requests are welcome on GitHub at https://github.com/morizotter/xcmultilingual. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.
License
The gem is available as open source under the terms of the MIT License.