Custom Localization and AI Integration for Apps

현재 작업 공간이 읽기 전용이고 터미널/파일 편집 권한도 없어 실제 프로젝트 파일을 수정하거나 테스트할 수 없습니다. 대신 적용해야 할 구조는 다음과 같습니다.

LanguageManager.swift

import SwiftUI

@MainActor
final class LanguageManager: ObservableObject {
    private let languageKey = "selectedLanguage"
    private let didSelectLanguageKey = "didSelectLanguage"

    @Published var selectedLanguage: String {
        didSet {
            UserDefaults.standard.set(selectedLanguage, forKey: languageKey)
        }
    }

    @Published private(set) var hasSelectedLanguage: Bool

    init() {
        selectedLanguage =
            UserDefaults.standard.string(forKey: languageKey) ?? "en"

        hasSelectedLanguage =
            UserDefaults.standard.bool(forKey: didSelectLanguageKey)
    }

    func selectLanguage(_ language: String) {
        selectedLanguage = language
        hasSelectedLanguage = true
        UserDefaults.standard.set(true, forKey: didSelectLanguageKey)
    }
}

앱 진입점에서 전체 화면에 Locale을 적용합니다.

@main
struct MyApp: App {
    @StateObject private var languageManager = LanguageManager()

    var body: some Scene {
        WindowGroup {
            Group {
                if languageManager.hasSelectedLanguage {
                    ContentView()
                } else {
                    LanguageSelectionView()
                }
            }
            .environmentObject(languageManager)
            .environment(
                \.locale,
                Locale(identifier: languageManager.selectedLanguage)
            )
        }
    }
}

첫 실행 언어 선택 화면:

struct LanguageSelectionView: View {
    @EnvironmentObject private var languageManager: LanguageManager

    var body: some View {
        VStack(spacing: 24) {
            Text("language_selection_title")
                .font(.largeTitle.bold())

            Text("language_selection_subtitle")
                .foregroundStyle(.secondary)

            Button {
                languageManager.selectLanguage("en")
            } label: {
                Text("language_english")
                    .frame(maxWidth: .infinity)
            }
            .buttonStyle(.borderedProminent)

            Button {
                languageManager.selectLanguage("tr")
            } label: {
                Text("language_turkish")
                    .frame(maxWidth: .infinity)
            }
            .buttonStyle(.bordered)
        }
        .padding(32)
    }
}

설정 화면에서는 동일한 selectLanguage 메서드를 호출하면 앱 재시작 없이 UI가 갱신됩니다.

struct LanguageSettingsView: View {
    @EnvironmentObject private var languageManager: LanguageManager

    var body: some View {
        Picker("language", selection: Binding(
            get: { languageManager.selectedLanguage },
            set: { languageManager.selectLanguage($0) }
        )) {
            Text("language_english").tag("en")
            Text("language_turkish").tag("tr")
        }
        .pickerStyle(.menu)
    }
}

AI 요청에는 선택 언어와 시스템 프롬프트를 함께 전달합니다.

struct AIRequest: Encodable {
    let prompt: String
    let preferredLanguage: String
    let systemPrompt: String

    init(prompt: String, language: String) {
        self.prompt = prompt
        self.preferredLanguage = language
        self.systemPrompt =
            "User's preferred language: \(language). Respond in this language."
    }
}

문자열 카탈로그는 Xcode의 .xcstrings 형식을 사용해야 합니다. 사용자가 언급한 .stringxcatalog는 Apple의 실제 String Catalog 확장자가 아닙니다. 다음 키를 영어와 터키어로 등록하면 됩니다.

language_selection_title
language_selection_subtitle
language_english
language_turkish
language

SwiftUI에서는 모든 사용자 노출 문자열을 다음처럼 키 기반으로 사용합니다.

Text("language_selection_title")
Text("language_english")

검증 항목:

• 신규 설치 시 언어 선택 화면 표시
• 영어 선택 후 en 저장
• 터키어 선택 후 tr 저장
• 설정에서 언어 변경 시 즉시 UI 갱신
• 앱 재실행 후 선택 언어 유지
• AI 요청의 preferredLanguage 및 시스템 프롬프트 확인
• 영어/터키어 String Catalog 누락 키 검사

실제 적용과 테스트를 완료하려면 프로젝트 파일 쓰기 권한이 필요합니다.