Localize-Swift Documentation

Add the following to your Podfile to install Localize-Swift using CocoaPods.

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

Localize-Swift includes a custom genstrings.swift script that recognizes the .localized() syntax.

1. Copy genstrings.swift into your project's root folder.
2. Run the script from the terminal:

   ./genstrings.swift

3. The script will print collected strings to the terminal. Copy these into your Localizable.strings file.

Note: You can exclude specific directories or files by editing the script directly.

First, ensure Carthage is installed via Homebrew. Then, add the repository to your Cartfile.

$ brew update
$ brew install carthage

github "marmelroy/Localize-Swift"

Swift Package Manager is the preferred method for installing Localize-Swift.

Using Xcode UI:

1. Go to File > Swift Packages > Add Package Dependency.
2. Enter https://github.com/marmelroy/Localize-Swift.git.
3. Set the version rule to Up to Next Major starting from 3.2.0.
4. Add the Localize-Swift library to your app target.

Using Package.swift: Add the dependency directly to your Package.swift file.

dependencies: [
    .package(url: "https://github.com/marmelroy/Localize-Swift.git", .upToNextMajor(from: "3.2.0"))
]

After importing the library, you can use the .localized() method on any String object to retrieve its translated value from your Localizable.strings file.

import Localize_Swift

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

Use the Localize class to query available languages, change the current language, or reset to the system default.

• Localize.availableLanguages(): Returns an array of available localizations.
• Localize.setCurrentLanguage("code"): Changes the app's language to the specified code (e.g., "fr").
• Localize.resetCurrentLanguageToDefault(): Resets the language to the device's default language.

To update your UI when the user changes the app language, observe the LCLLanguageChangeNotification via NotificationCenter.

NotificationCenter.default.addObserver(
    self, 
    selector: #selector(setText), 
    name: NSNotification.Name(LCLLanguageChangeNotification), 
    object: nil
)