iOS - Lingo.dev CLI

iOS란 무엇인가요?

iOS는 iPhone과 iPad 기기를 구동하는 Apple의 모바일 운영 체제입니다.

Lingo.dev CLI란 무엇인가요?

Lingo.dev는 AI 기반 번역 플랫폼입니다. Lingo.dev CLI는 소스 파일을 읽고, 번역 가능한 콘텐츠를 대규모 언어 모델로 전송하며, 번역된 파일을 프로젝트에 다시 작성합니다.

이 가이드에 대하여

이 가이드는 iOS 앱에서 Lingo.dev CLI를 설정하는 방법을 설명합니다. Xcode에서 문자열 카탈로그를 생성하고, 번역 파이프라인을 구성하며, iOS 시뮬레이터에서 결과를 테스트하는 방법을 배우게 됩니다.

1단계. 문자열 카탈로그 생성하기

Xcode에서 프로젝트를 엽니다.
File > New > File from Template로 이동합니다.
템플릿 옵션에서 String Catalog를 선택합니다.
Next를 클릭합니다.
Create를 클릭합니다.

기본적으로 문자열 카탈로그 파일의 이름은 Localizable.xcstrings입니다.

2단계. 현지화 가능한 문자열 생성하기

문자열 카탈로그 파일을 엽니다.
소스 로케일(예: English)을 선택합니다.
+ 아이콘을 클릭하여 새 문자열을 추가합니다.
"welcome"과 같은 키를 입력합니다.
"Hello, world"와 같은 값을 입력합니다.

3단계. CLI 구성하기

Xcode 프로젝트의 루트에 i18n.json 파일을 생성합니다:

{
  "$schema": "https://lingo.dev/schema/i18n.json",
  "version": 1.8,
  "locale": {
    "source": "en",
    "targets": ["es"]
  },
  "buckets": {
    "xcode-xcstrings": {
      "include": ["Localizable.xcstrings"]
    }
  }
}

이 파일은 다음을 정의합니다:

Lingo.dev CLI가 번역해야 하는 문자열 카탈로그 파일
번역할 언어 간의 관계

이 경우, 구성은 문자열 카탈로그를 영어에서 스페인어로 번역합니다.

자세한 내용은 i18n.json 구성을 참조하세요.

4단계. 콘텐츠 번역하기

Lingo.dev 계정에 가입하세요.
CLI를 통해 Lingo.dev에 로그인하세요:
```
npx lingo.dev@latest login
```
번역 파이프라인을 실행하세요:
```
npx lingo.dev@latest run
```
CLI는 Localizable.xcstrings 파일을 번역된 콘텐츠로 업데이트하고 번역된 내용을 추적하기 위한 i18n.lock 파일을 생성합니다(불필요한 재번역을 방지하기 위함).

5단계. 번역 사용하기

Swift 코드에서 키를 사용하여 현지화된 문자열을 참조하세요:

Text("welcome")

6단계. 번역 미리보기

Product > Scheme > Edit Scheme으로 이동하세요.
나타나는 대화 상자에서 Run을 선택하세요.
Options 탭으로 전환하세요.
App Language 드롭다운에서 테스트할 언어를 선택하세요.
Close를 클릭하세요.
시뮬레이터를 통해 앱을 실행하세요.