Setup — Better I18N

本页内容

Create a project
Add the Swift Package
Initialize in your App entry point
Use translations in views
Add language switching

Create a project #

Sign in at dash.better-i18n.com and create a new project. Note your project identifier (e.g. my-org/my-app) — you'll use it in the SDK config.

Add your translation keys and at least one target language before proceeding.

Add the Swift Package #

In Xcode, go to File → Add Package Dependencies and enter the repository URL:

Code

https://github.com/better-i18n/swift

Dependency Rule: Up to Next Major Version, from: "0.1.0"

When prompted to choose products, add:

BetterI18n — core SDK, required for all targets
BetterI18nUI — SwiftUI bindings (I18nProvider, I18nStore), add to your app target

Initialize in your App entry point #

Wrap your root view with I18nProvider. It creates an I18nStore via @StateObject and automatically calls load() on appear — no manual setup needed.

MyApp.swift

import SwiftUI
import BetterI18n
import BetterI18nUI

@main
struct MyApp: App {
    var body: some Scene {
        WindowGroup {
            I18nProvider(core: BetterI18n(config: I18nConfig(
                projectId: "my-org/my-app",
                defaultLocale: "en"
            ))) {
                ContentView()
            }
        }
    }
}

Use translations in views #

Access the store via @EnvironmentObject and call i18n.t() to translate keys. Interpolation uses a dictionary of named variables.

ContentView.swift

import SwiftUI
import BetterI18nUI

struct ContentView: View {
    @EnvironmentObject var i18n: I18nStore

    var body: some View {
        VStack(spacing: 16) {
            if !i18n.isLoaded {
                ProgressView()
            } else {
                Text(i18n.t("home.welcome"))
                    .font(.largeTitle)

                Text(i18n.t("home.greeting", ["name": "Osman"]))
                    .foregroundStyle(.secondary)
            }
        }
    }
}

Add language switching #

Call setLocale() to change the active language. It saves the preference to storage and fetches translations for the new locale in the background.

SettingsView.swift

import SwiftUI
import BetterI18nUI

struct SettingsView: View {
    @EnvironmentObject var i18n: I18nStore

    var body: some View {
        List {
            Section("Language") {
                Button("English") {
                    Task { await i18n.setLocale("en") }
                }
                Button("Türkçe") {
                    Task { await i18n.setLocale("tr") }
                }
                Button("Deutsch") {
                    Task { await i18n.setLocale("de") }
                }
            }
        }
    }
}

API Reference — Complete API docs for I18nConfig, I18nStore, BetterI18n, and Translator.
Widget Extension — Bridge translations from an Expo app to a WidgetKit extension.