/Localize-Swift

Swift 2.0 friendly localization and i18n with in-app language switching

Primary LanguagePythonMIT LicenseMIT

Build Status Version Carthage compatible

Localize-Swift

Localize-Swift is a simple framework that improves i18n and localization in Swift iOS apps - providing cleaner syntax and in-app language switching.

Features

  • Keep the Localizable.strings file your app already uses.
  • Allow your users to change the app's language without changing their device language.
  • Use .localized() instead of NSLocalizedString(key,comment) - a more Swifty syntax.
  • Generate your strings with a new genstrings python script that recognises .localized().

Usage

Import Localize at the top of each Swift file that will contain localized text.

If Carthage -

import Localize

If CocoaPods -

import Localize_Swift

Add .localized() following any String object you want translated:

textLabel.text = "Hello World".localized()

To get an array of available localizations:

Localize.availableLanguages()

To change the current language:

Localize.setCurrentLanguage("fr")

To update the UI in the viewcontroller where a language change can take place, observe LCLLanguageChangeNotification :

NSNotificationCenter.defaultCenter().addObserver(self, selector: "setText", name: LCLLanguageChangeNotification, object: nil)

To reset back to the default app language:

Localize.resetCurrentLanaguageToDefault()

genstrings

To support this new i18n syntax, Localize-Swift includes a custom genstrings python script.

Copy the genstrings.py file into your project's root folder and run with

python genstrings.py

This will print the collected strings in the terminal. Select and copy to your default Localizable.strings.

Setting up with Carthage

Carthage is a decentralized dependency manager that automates the process of adding frameworks to your Cocoa application.

You can install Carthage with Homebrew using the following command:

$ brew update
$ brew install carthage

To integrate Localize-Swift into your Xcode project using Carthage, specify it in your Cartfile:

github "marmelroy/Localize-Swift"

Setting up with CocoaPods

source 'https://github.com/CocoaPods/Specs.git'
pod 'Localize-Swift', '~> 0.2'