Skip to content

lokalise/lokalise-ios-framework

Repository files navigation

Lokalise iOS SDK

Lokalise lets you manage keys and translations of your app, game, or website – either on your own or with a team of collaborators. Built for developers, Lokalise offers neat features including inline suggestions, project chat, export webhooks, and an API, so you can easily integrate with the workflow of your project.

Features

  • Over-the-air (OTA) localization
  • Instant UI language switching
  • Test localizations (using prerelease bundles)
  • NSBundle swizzling for transparent integration
  • XIB and storyboard localization

Requirements

  • Xcode 15+
  • iOS 12.0+

Setup

Swift Package Manager

To install using Swift Package Manager:

a. Add through File -> Swift Packages -> Add Package Dependency... action in Xcode. Use https://github.com/lokalise/lokalise-ios-framework.git repository URL and the Version: Up to Next Minor starting with 1.0.2 option.

b. Add this line to dependencies section of your Package.swift:

.package(name: "Lokalise", url: "https://github.com/lokalise/lokalise-ios-framework.git", .upToNextMinor(from: "1.0.2"))

CocoaPods

To install using CocoaPods:

  1. Add these line to your Podfile
use_frameworks!
pod 'Lokalise', '~> 1.0.2'

Carthage

To install using Carthage:

  1. Add this line to your Cartfile
binary "https://raw.githubusercontent.com/lokalise/lokalise-ios-framework/master/LokaliseCarthage.json" ~> 1.0.2
  1. Link c++ (libc++.tbd) and z (libz.tbd) libraries to your targets.

Manual (.xcframework)

To install .xcframework manualy:

  1. Download Lokalise.xcframework from this repository and add it to your project.

  2. Add it to your targets (embed and link).

Getting started

Read documentation page for detailed integration guide.

Support

Please contact us through our live support chat for support and bug reports. It is available at every page on lokalise.com.