모바일 앱은 기본적으로 언어와 문화 위에서 동작합니다. 기능이 아무리 좋아도 사용자가 읽고, 듣고, 눌렀을 때 편안하지 않으면 곧장 이탈하죠.
현지화(Localization, l10n)는 국제화(Internationalization, i18n)로 준비된 기술적 기반 위에서 언어·문화별 표현을 적용하는 일이며, 이 둘은 함께 설계해야 앱이 글로벌에서 매끄럽게 작동합니다.

팩트만 짚자면, 스토어 전환율과 유지율은 언어 적합성, 날짜/숫자/통화 포맷, 텍스트 길이 대응, 오른쪽→왼쪽(RTL) 레이아웃 지원, 폰트/스크립트 호환성에 크게 좌우됩니다. 그리고 이 모든 요소를 코드로, 빌드로, 테스트로 관리해야 합니다. 🧭

i18n: 코드/리소스를 언어에 의존하지 않도록 구조화하는 작업. 예: 문자열 분리, 포맷터 사용, 레이아웃 미러링 대응, 리소스 로딩 설계, 폰트 폴백 체인.
l10n: 특정 언어·지역에 맞게 번역·형식·이미지·단위를 적용. 예: 한국(ko-KR)과 베트남(vi-VN)의 통화/주소/호칭 차이.

Locale: 언어-스크립트-지역의 조합. 예: zh-Hant-TW, en-GB. 표준은 BCP 47 태그를 따릅니다.
CLDR (Unicode Common Locale Data Repository): 각 로케일의 날짜/숫자/복수형 규칙 등을 담은 사실상 표준 데이터베이스.
ICU (International Components for Unicode): CLDR 기반의 국제화 라이브러리군(문자열, 날짜/숫자 포맷, 메시지 포맷 등).

시장 선택은 사용량, ARPU, 경쟁, 스토어 정책, 번역 비용/ROI를 고려합니다.
언어 우선순위는 영어(en)→스페인어(es)→포르투갈어(pt)→아랍어(ar)→한국어(ko)→일본어(ja)→중국어(zh-Hans/Hant) 등 서비스 성격에 따라 조정합니다.

스크립트가 다른 언어(아랍어, 히브리어, 데바나가리 등)는 폰트/렌더링·RTL·조합문자 검증이 필수입니다.

권장 키 네이밍: screen.section.purpose 패턴. 예: auth.login.title, auth.error.invalid_password.
키는 문맥을 담고, UI 위치와 의도를 반영하면 유지보수에 강합니다.

폴더 구조 예시(플랫폼 불문 개념):

res/
  values/strings.xml                 # 기본(기준) 언어 en 혹은 개발 언어
  values-ko/strings.xml              # 한국어
  values-ja/strings.xml              # 일본어
  values-zh-rCN/strings.xml          # 중국어(간체, 중국)
  values-ar/strings.xml              # 아랍어(RTL)
assets/i18n/
  en.json
  ko.json
  ar.json

폴백(fallback): 정확한 언어-지역이 없을 때 상위 언어로 올라가고, 마지막엔 기준 언어로. 예: pt-BR → pt → en.
이 로직은 앱 첫 실행과, 언어 동적 변경 시 동일하게 적용해야 일관성이 유지됩니다.

OS의 선호 언어 목록을 받아 지원 목록과 매칭합니다. BCP 47 태그를 파싱해 언어-스크립트-지역 우선순위로 매치하며, 완전 일치가 없다면 언어만 일치하는 후보로 폴백합니다.

// 의사 코드
supported = ["en", "en-GB", "ko-KR", "ja", "ar", "pt-BR", "zh-Hans-CN", "zh-Hant-TW"]
requested = ["fr-FR","en-US","zh-CN"] // OS list
match(requested, supported):
  for r in requested:
    if exact in supported: return exact
    if lang in supported: return lang
    if lang-script in supported: return that
  return "en" // default

사용자 선택을 제공할 경우 앱 내부 언어 스위처를 제공하되, 플랫폼 특성상 iOS는 앱 재시작이 필요할 수 있습니다. Android는 AppCompatDelegate.setApplicationLocales(...) 등 최신 API를 사용하면 런타임 전환이 수월합니다.

유니코드 정규화: 동일 문자라도 조합형/분해형이 다를 수 있습니다. 검색/비교/저장 시 NFC 기준으로 정규화하면 충돌을 줄일 수 있습니다.

그래펨 클러스터: 사용자가 인식하는 글자 단위는 코드포인트 한 개가 아닙니다. 이모지 조합(👨‍👩‍👧‍👧), 피부톤, 악센트 등은 여러 코드포인트의 클러스터입니다. 커서 이동, 글자 수 제한, 자르기에서 클러스터 단위를 사용하세요.

BiDi(양방향): 아랍어/히브리어(RTL)와 숫자/라틴 혼합 시 방향 혼란이 생깁니다. LRM/RLM 같은 제어문자를 필요 시 삽입하고, 플랫폼의 LayoutDirection 및 start/end 제약을 사용하세요. 🧱

폰트 폴백: 한 폰트로 전 언어를 커버하기 어렵습니다. iOS/Android 기본 폴백 체인에 의존하되, 커스텀 폰트 적용 시 미지원 글리프를 대비한 폴백 스택을 구성하세요.

직접 문자열을 합치지 말고 플랫폼 포맷터를 사용합니다. 단위, 소수점, 그룹 구분자, 달력 체계(그레고리안 외), 주 시작 요일, 타임존 등은 로케일에 크게 좌우됩니다. 🕒

val locale = Locale.forLanguageTag("ko-KR")
val nf = NumberFormat.getCurrencyInstance(locale)
nf.currency = Currency.getInstance("KRW")
println(nf.format(1234567.89)) // ₩1,234,568

val df = DateFormat.getDateInstance(DateFormat.MEDIUM, locale)
println(df.format(Date()))

let locale = Locale(identifier: "de-DE")
let nf = NumberFormatter()
nf.numberStyle = .decimal
print(nf.string(from: 12345.67)!) // 12.345,67

let cf = NumberFormatter()
cf.numberStyle = .currency
cf.locale = locale
print(cf.string(from: 89.9)!) // 89,90 €

import 'package:intl/intl.dart';
final nf = NumberFormat.compact(locale: 'en_US');
print(nf.format(1200000)); // 1.2M

final df = DateFormat.yMMMMEEEEd('fr_FR');
print(df.format(DateTime.now()));

영어의 단순 복수형도, 러시아어의 복잡한 규칙도, 아랍어의 다수 규칙도 ICU MessageFormat으로 일관 처리 가능합니다.

// ICU MessageFormat 예시
notifications = {count, plural,
  =0 {No new messages}
  one {# new message}
  other {# new messages}
}
invite = {gender, select,
  female {She invited you}
  male {He invited you}
  other {They invited you}
}

앱에서 메시지 포맷 엔진을 사용하면 번역자가 문장 구조를 제어할 수 있어 품질이 올라갑니다. 수동 분기보다 안전합니다.

RTL 언어는 레이아웃을 start/end 기준으로 설계해야 자동 미러링이 작동합니다. 왼쪽/오른쪽 고정 좌표는 피하세요. 아이콘(▶︎)과 화살표는 방향성을 고려해 양방향 아이콘을 쓰거나 RTL 전용 자산을 준비합니다.

Android: resources와 App Bundle

String 리소스: res/values*/strings.xml. 복수형은 <plurals> 사용.

<resources>
  <string name="auth_login_title">Log in</string>
  <plurals name="inbox_unread">
    <item quantity="one">%d unread</item>
    <item quantity="other">%d unread</item>
  </plurals>
</resources>

동적 언어 전환: Android 13+

AppCompatDelegate.setApplicationLocales(LocaleList.forLanguageTags("ko"))

App Bundle: 언어별 스플릿로 패키지 용량을 줄입니다. Play가 사용자 언어만 내려줍니다.

iOS: .strings와 .stringsdict

NSLocalizedString 매크로로 키 추출, .strings 파일에 매핑. 복수형/치환은 .stringsdict로 관리.

// Localizable.strings
"auth.login.title" = "로그인";

// Localizable.stringsdict (excerpt)
<dict>
  <key>inbox.unread</key>
  <dict>
    <key>NSStringLocalizedFormatKey</key>
    <string>%#@items@</string>
    <key>items</key>
    <dict>
      <key>NSStringFormatValueTypeKey</key>
      <string>d</string>
      <key>NSStringPluralRuleType</key>
      <string>plural</string>
      <key>one</key>
      <string>%d개 미읽음</string>
      <key>other</key>
      <string>%d개 미읽음</string>
    </dict>
  </dict>
</dict>

앱 언어: iOS 13+는 앱 단위 언어 변경 지원. 다만 UI 갱신에 재시작이 필요한 경우가 있어 UX로 안내하세요.

Flutter: gen_l10n와 ARB

Flutter는 flutter_localizations + intl + gen_l10n 조합이 표준입니다.

// pubspec.yaml
flutter:
  generate: true
  gen-l10n:
    arb-dir: lib/l10n
    template-arb-file: app_en.arb
    output-localization-file: app_localizations.dart

// lib/l10n/app_en.arb
{
  "@@locale": "en",
  "authLoginTitle": "Log in",
  "inboxUnread": "{count, plural, one{# unread} other{# unread}}",
  "@inboxUnread": { "placeholders": { "count": { "type": "int" } } }
}

복수형/성 선택도 ICU 문법으로 처리되며, 위젯은 Directionality·Localizations 컨텍스트를 사용합니다.

React Native: i18next + FormatJS

포맷은 Intl API 혹은 FormatJS, 번역 관리는 i18next가 조합이 좋습니다.

// i18next init
i18n.use(initReactI18next).init({
  resources: { en: { translation: { "auth.login.title": "Log in" }}, ko: {...} },
  lng: "en",
  fallbackLng: "en",
  interpolation: { escapeValue: false }
});

네이티브 포맷터가 필요한 경우 react-native-localize로 기기 로케일을 읽고, Intl.NumberFormat 사용 범위를 결정하세요.

Unity: Localization Package

Unity의 Localization 패키지는 String Table, Asset Table, Smart Strings(ICU) 지원. 빌드 타겟별 리소스 번들링을 통일적으로 관리할 수 있습니다.

텍스트가 포함된 이미지 대신 벡터 + 런타임 텍스트를 선호하세요. 불가피하면 언어별 자산 폴더를 사용하고, CDN 캐시 키에 로케일을 포함합니다.

자막은 WebVTT/SRT를 사용하고, 오디오 더빙이 필요한 경우 리핑크 시간 테이블을 관리해야 유지보수가 수월합니다.

주소: 국가별 주소 포맷은 다릅니다. Google의 libaddressinput 데이터나 CLDR Address 데이터로 필드 순서/라벨을 동적으로 바꾸세요.

전화: libphonenumber로 국제 포맷/검증을 수행. 국가 선택과 마스크를 자동화합니다.

이름: 성/이름 순서, 중간명, 후치 호칭 등 다양합니다. 하나의 입력란으로 강제하지 말고, 표시 시에도 로케일별 포맷을 고려해야 합니다.

단위: 길이/무게/온도/통화 등은 MeasurementFormatter(iOS)나 ICU 단위 포맷을 사용하세요. 섭씨/화씨 전환은 지역 설정을 따릅니다.

VoiceOver/TalkBack의 읽기 순서, 대체 텍스트, 힌트, 조작 레이블을 번역해야 합니다. 동적 글꼴 크기(다이나믹 타입) 확대 시 레이아웃 넘침이 없는지 점검하세요.

언어 전환 시 스크린리더 언어도 적절히 전환되도록 언어 태그를 제공합니다.

의사현지화(Pseudo‑Localization): 텍스트를 길게 늘리고 악센트를 섞어 UI가 깨지는지 조기에 잡습니다. 예: [!! Ĕẋŧęńďėđ Šţŗīńğ 150% !!] 🧪

// 간단한 의사현지화 함수(영문 대상)
function pseudo(s) {
  const map = {'a':'á','e':'ë','i':'ï','o':'õ','u':'ü','c':'ç','n':'ñ'};
  let out = '';
  for (const ch of s) out += map[ch] || map[ch.toLowerCase()] || ch;
  return `[!! ${out} !!]`;
}

스크린샷 회수: 언어별 자동 스크린샷을 CI에서 뽑아 TMS로 업로드하면 번역 품질 심사(LQA)가 빨라집니다.

TMS(Translation Management System): Phrase, Lokalise, Crowdin 등. 키 동기화, 스크린샷, 용어집, 번역 메모리, QA 규칙(자리표시자/태그 보존) 지원.

CI/CD 파이프라인: 리소스 추출 → TMS 업로드 → 번역/검수 → 다운로드 → 빌드 반영을 자동화합니다.

# 예: GitHub Actions 의사 흐름
- name: Extract i18n
  run: yarn i18n:extract
- name: Push to TMS
  run: npx tms-cli push --format arb --src lib/l10n
- name: Pull translations
  run: npx tms-cli pull --format arb --dest lib/l10n
- name: Build app
  run: flutter build apk --split-per-abi

검증 규칙: 자리표시자 {count}, %@, HTML 태그 보존, RTL 마크 보존을 자동 점검합니다.

스토어 심사 없이 텍스트 수정을 하고 싶다면, 원격 구성(Remote Config)이나 앱 내 리소스 페치를 설계하세요. 보안상 서명/무결성 검증을 포함하고, 버전 범위와 캐시 정책을 정의합니다.

React Native/Flutter는 오버 더 에어 업데이트(예: CodePush, Shorebird 등)를 사용할 수 있으나, 스토어 정책과 충돌하지 않도록 주의하세요.

App Store Connect와 Google Play Console은 언어별 앱 이름, 설명, 스크린샷, 키워드를 지원합니다. 언어별 ASO 키워드를 분리하고, 앱 내 스크린샷 자동화로 각 로케일별 이미지를 생성하세요.

리뷰 응답도 사용자 언어로 하는 것이 신뢰를 높입니다.

개인정보: GDPR/CCPA 등 지역 규제를 반영한 동의 배너/정책 페이지의 번역과 로컬 법적 문구를 유지하세요.

결제: 통화·세금(VAT/GST) 표기, 영수증 언어, 구매 조건 고지의 지역화는 필수입니다.

콘텐츠 제한: 일부 지역의 법·검열·연령 제한 정책은 안내 문구와 신고/차단 프로세스까지 현지화해야 합니다.

지연 로딩: 초기 진입에 꼭 필요한 리소스만 포함하고, 나머지는 언어 선택 이후 비동기 로드하세요.

언어 스플릿: Android App Bundle의 언어 스플릿, iOS의 On-Demand Resources로 설치 크기를 줄입니다.

캐시: JSON/ARB 리소스는 ETag/버전으로 캐시. 메모리 상주 Map은 약한 참조 또는 LRU 캐시로 관리합니다.

문자 잘림/겹침 → 오토레이아웃/Constraint에 우선순위·Content hugging/compression 설정, min/maxLines 조정.

자리표시자 순서 → ICU 메시지로 {name} 명명 치환, iOS %1$@ 서식 인덱스 사용.

잘못된 정렬 → left/right 대신 start/end 사용.

이모지 자르기 → 그래펨 인식 라이브러리 사용(예: grapheme-splitter).

WebView 언어 → Accept-Language 헤더와 document.documentElement.lang 세팅 동기화.

키 미스(hit/miss)를 로깅해 누락된 번역을 조기에 수집하고, 로케일 전환 이벤트에서 세션 잔존율 변화를 추적하세요. 충돌 리포트에 언어/스크립트/지역 태그를 포함하면 특정 언어 전용 버그를 빨리 찾습니다.

고객지원 티켓에서 언어별 오해 유발 문구를 태깅해 텍스트 개선의 우선순위를 잡으세요.

원격 문자열은 HTML/JS 주입 공격 벡터가 될 수 있습니다. 허용 문자/태그 화이트리스트와 자리표시자 검사, 서명된 페이로드, 무결성 해시를 사용하고, 실행 가능한 코드를 절대로 실어 보내지 마세요.

디자인은 멀티랭스(다국어 길이) 프레임을, 개발은 키·포맷터·폴백을, 번역은 맥락·톤앤매너를 책임집니다. 주간 리뷰에서 스크린샷 베이스로 확인하면 오해가 줄어듭니다.

재능 있는 프리랜서 번역가를 찾는다면 커뮤니티나 플랫폼을 적극 활용하세요. 예를 들어 재능넷 같은 곳에서 모바일 앱 전문 번역 파트너를 구하는 팀도 많습니다.

키/리소스: 기준 언어 대비 누락/미사용 키 없음

포맷: 날짜/숫자/통화가 로케일에 맞게 표시

ICU: 복수형/성 선택 정상 동작, 자리표시자 보존

텍스트 길이: 30–200% 길이에서 레이아웃 안정

RTL: 미러링/아이콘/애니메이션 방향 점검

폰트: 폴백 체인으로 □(tofu) 미발생

접근성: 스크린리더/다이나믹 타입 점검

웹뷰: Accept-Language/HTML lang 동기화

스토어: 메타데이터·스크린샷 현지화

분석: 로케일별 전환/이탈 대시보드 구축

문제: “3 new messages from John”을 다국어로 자연스럽게, 그리고 RTL에서 미려하게. 또한 길이 확장에 안전해야 함.

해결:

- 키: inbox.new_messages
- ICU:

{count, plural, =0{No new messages} one{# new message} other{# new messages}} {from, select, other{from {name}}}

결과: 알림 클릭률 7% 증가, 지원 티켓 12% 감소(문맥 오해 개선).

Android RTL 활성화

// AndroidManifest.xml
<application
  android:supportsRtl="true"
  ...>

Android 앱 언어 전환

val appLocales = LocaleList.forLanguageTags("ar")
AppCompatDelegate.setApplicationLocales(appLocales)

iOS 포맷터 예시

let df = DateFormatter()
df.locale = Locale(identifier: "ko-KR")
df.dateStyle = .medium
df.timeStyle = .short

Flutter 방향성

Directionality(textDirection: TextDirection.rtl, child: MyWidget())

현지화는 기술과 공감이 만나는 지점입니다. 도구와 규칙을 신뢰하되, 사용자 문화를 존중하는 마음을 잊지 마세요. 그러면 앱은 자연스럽게 더 많은 이들의 홈 스크린에 정착합니다. 🌟