← Blog

React Native 앱 영어·일본어 해외 출시기 — 한국어 화면을 그대로 지킨 데일리베이비 다국어 작업

JunGyu Kim · · 14분 읽기React NativeExpoi18n사이드프로젝트
목차

1. 영어권과 일본부터, EU·영국은 나중에

지난 출시 회고에서 다음 계획의 맨 앞에 다국어 지원을 올려 두었습니다. 시리즈 마지막 글에서는 한국어를 코드에 박아 넣은 것을 아쉬운 점으로 꼽기도 했습니다. 이번에 그 숙제를 풀었습니다. 2026년 10월 29일에 해외 출시 계획서를 쓰고, 10월 31일 2.14.0으로 영어·일본어판을 출시했습니다. 11월 2일에는 잠금화면 위젯을 다듬은 2.14.1이 App Store의 한국·미국·일본 스토어에 올라왔습니다.

출발점은 좋지 않았습니다. 다국어 구조가 없었고, 앱 소스 571개 파일 중 550개에 한국어가 직접 들어 있었습니다. 중복을 뺀 화면 문구는 약 5,300개, 단위는 ml·kg·cm·°C 고정이었습니다.

출시 국가는 영어권인 미국·캐나다·호주·뉴질랜드·싱가포르와 일본으로 정했습니다. EU와 영국은 뺐습니다. 아기의 건강 기록과 임신 정보는 GDPR에서 특별 범주의 데이터라 명시적 동의, 처리 근거, 역외 이전 절차를 따로 갖춰야 하기 때문입니다. 대신 미국 주 법(워싱턴주 My Health My Data Act 등)에 대비해, 해외판에서는 기록 종류나 임신 여부처럼 건강을 짐작할 수 있는 이용 정보까지 분석 도구로 보내지 않게 했습니다.

원칙은 하나였습니다. 한국 사용자가 보는 화면과 데이터, 서버 동작은 바꾸지 않는다. 아래의 결정은 거의 다 이 원칙에서 나왔습니다.

2. 해외판에 남긴 기능, 숨긴 기능

나라마다 다른 의료·행정 일정은 다른 나라에서는 틀린 정보가 됩니다. 그래서 어느 나라에서나 같은 뜻을 가지는 기능만 해외판에 남겼고, 이것을 임시 범위가 아니라 해외판의 범위로 정했습니다.

기능해외판이유
수유·수면·기저귀 기록, 원탭 기록, 되돌리기제공앱의 핵심
위젯·잠금화면·Siri·Android 빠른 설정제공네이티브 문구까지 번역
가족 공유, 야간 모드, 원형 일과표, 주간 통계제공나라와 무관
성장곡선제공WHO 국제 기준, lb·in 표시
임신 주차 정보, 태동 세기, 진통 타이머, AI 하루 요약제공번역, 요약은 그 언어로
예방접종 일정숨김질병관리청 일정 기준
영유아검진숨김한국 제도
산전검진 일정 안내숨김(검진 기록은 제공)검사 이름·시기가 나라마다 다름
위험 신호 안내숨김119 버튼, 응급 번호가 나라마다 다름
다른 육아 앱 기록 가져오기숨김국내 앱 연동
커뮤니티숨김한국어 사용자 공간, 해외 운영·신고 인력 필요

숨기는 방법은 단순합니다. 시장 값이 해외(GLOBAL)이면 메뉴와 홈 카드, 알림 예약을 끄고, 화면 주소로 바로 들어와도 홈으로 보냅니다. 화면 컴포넌트 안에서 바로 return하면 아래의 훅 호출이 Hooks 규칙에 걸리므로, 검사만 하는 얇은 컴포넌트를 앞에 두었습니다.

// app/(app)/vaccinations.tsx
export default function VaccinationsRoute() {
  if (isGlobalMarket()) return <Redirect href={HOME_HREF} />;
  return <VaccinationsRouteBody />;
}

한국판에서 같은 호출이 한국 일정을 그대로 돌려주는지도 테스트합니다. 아래는 같은 장면의 한국어·영어·일본어 스토어 스크린샷입니다. 한국어판 하단 탭은 홈·캘린더·커뮤니티·통계 네 개, 영어·일본어판은 커뮤니티가 빠진 세 개입니다. 영어판은 미국 단위라 같은 분유 기록이 5.7 oz로 보입니다.

같은 장면의 한국어·영어·일본어 스토어 스크린샷. 한국어판은 분유 170ml와 하단 탭 네 개, 영어판은 Formula 5.7 oz와 하단 탭 세 개, 일본어판은 ミルク 170ml와 하단 탭 세 개

왼쪽부터 한국어·영어·일본어 스토어 스크린샷입니다.

3. 한국어 원문을 번역 키로 — 회귀 테스트가 정한 구조

보통은 feeding.start 같은 키를 만들고 언어마다 값을 채웁니다. 저는 한국어 원문을 그대로 키로 썼습니다. 함수 이름이 tr인 것은 앱 곳곳에서 이미 t = useTheme()을 쓰고 있어서입니다.

// lib/i18n.ts
/** 화면 문구 번역. ko면 원문 그대로(자리표시만 채움). */
export function tr(ko: string, params?: Params): string {
  if (lang === "ko") return withUnits(fill(ko, params));
  const hit = TABLES[lang][ko] ?? (lang === "en" ? undefined : TABLES.en[ko]);
  return englishOne(localizeClock(withUnits(fill(hit ?? ko, params && translateParams(params)))));
}
 
// lib/i18nEn.ts (생성 파일)
  "수유 시작": "Start feeding",
  "오늘 {0}회": "{0} today",
 
// lib/i18nJa.ts (생성 파일)
  "수유 시작": "授乳開始",
  "오늘 {0}회": "今日 {0}回",

한국어 세션은 원문을 그대로 돌려주고 자리표시만 채웁니다. 5,300개 문구에 새 이름을 붙일 필요가 없고, 한국어 화면은 글자 하나 바뀌지 않습니다. 일본어 번역이 없으면 영어로, 영어도 없으면 원문으로 떨어집니다.

이 선택을 밀어붙인 것은 테스트였습니다. 시작할 때 회귀 테스트가 3,228개였고, 상당수가 한국어 문구를 글자 그대로 비교했습니다. 원문을 돌려주는 구조라면 이 테스트들은 손대지 않아도 통과합니다. 처음에는 변환 스크립트로 문구를 tr()로 감싸 나갔는데, 유틸·상수·로직 모듈까지 감싸자 출시 동작을 소스째 고정해 둔 동결 테스트들이 깨졌습니다. 그런 파일 34개는 변환을 되돌리고, 문구가 알림이나 화면으로 나가는 경계에서 번역하게 했습니다.

화면 소스의 한국어 JSX도 그대로 두었습니다. 대신 babel의 jsxImportSource를 자체 JSX 런타임으로 돌려, 화면이 그려지는 순간 글자 자식과 accessibilityLabel·placeholder 같은 속성을 번역합니다.

// lib/i18nJsxRuntime.ts
export function translateProps(props: Props): Props {
  if (!props || (getLang() === "ko" && !isUsUnits())) return props;
  // ... 글자 자식과 라벨 속성을 trx()·trChildren()으로 번역
}
 
export const jsx: JsxFn = (type, props, key) => base.jsx(type, translateProps(props), key);

['오늘 ', 3, '회']처럼 쪼개진 자식은 오늘 {0}회라는 문장 하나로 찾습니다. 테스트에는 한국어 세션처럼 동작하는 대역 모듈을 한 줄로 등록했고, 영어·일본어 동작은 새 테스트로 더했습니다. 매 단계 전체 회귀를 돌렸고, 11월 2일 공지 수정 때 회귀 테스트는 3,296개였습니다.

대가도 있습니다. 한국어 문구를 고치면 키가 바뀌어 번역이 떨어져 나갑니다. 그래서 해외판에 보일 수 있는 한국어마다 번역이 있는지 검사하는 테스트를 두어, 누락이 스토어 심사가 아니라 테스트에서 걸리게 했습니다. 번역표는 화면 문구 3,756개를 다 채웠고, 지금은 언어마다 4,005개 항목입니다. 그래도 표가 찼다고 화면이 맞는 것은 아니었습니다. 조각을 이어 붙인 문장이 'Mia을(를) 함께 보는 가족'처럼 나오거나, 한국판의 이름 네 글자 규칙 때문에 'James'가 'Jame'으로 잘린 것은 영어·일본어 실제 화면을 찍어 보고서야 찾았습니다. 호칭 없는 가족의 이름표가 영어에서 '가 Family'로 나온 것은 런타임 번역의 빈틈이었습니다. 이름은 'Family'로 바뀌었지만 동그라미 안 첫 글자는 그 전에 원문 '가족'에서 잘라 냈기 때문입니다(2.14.1에서 수정).

4. 영어 폰을 쓰는 기존 사용자는 한국어 그대로: 시장 판정

언어(ko·en·ja)와 시장(KR·GLOBAL)은 따로 둡니다. 언어는 번역을, 시장은 기능 범위를 정합니다. 둘 다 루트 레이아웃이 그려지기 전에 한 번 정하고, 설정에서 언어를 바꾸면 저장한 뒤 앱을 다시 시작합니다.

가장 조심한 사람은 영어로 된 아이폰을 쓰면서 한국어판을 써 온 사용자입니다. 기기 언어만 보면 이분들은 업데이트 다음 날 갑자기 영어 화면을 보게 됩니다. 그래서 2.14.0 이전부터 쓰던 설치는 기기 언어와 상관없이 한국어·한국판으로 고정했습니다.

// lib/i18n.ts
export function resolveLocale(deviceLocale: string | null | undefined, existingInstall: boolean): { lang: Lang; market: Market } {
  if (existingInstall) return { lang: "ko", market: "KR" };
  const base = String(deviceLocale || "").replace("_", "-").split("-")[0].toLowerCase();
  const next: Lang = base === "ko" ? "ko" : base === "ja" ? "ja" : "en";
  return { lang: next, market: marketOf(next) };
}
 
export function isExistingInstall(values: readonly (string | null)[]): boolean {
  // ... 저장소에서 계정과 아기 목록을 읽는 부분 생략
  return !!state(user)?.user || (Array.isArray(babies) && babies.length > 0);
}

이 판정은 이틀 동안 두 번 고쳤습니다. 첫 버전은 앱 설정 저장값이 있으면 기존 설치로 봤는데, 첫 실행에서도 저장소들이 언어가 정해지기 전에 기본값을 먼저 써 버려 해외의 새 설치까지 한국판으로 고정됐습니다. 같은 날 영어 시뮬레이터로 화면을 돌려 보다가 찾았고, 기준을 '로그인한 계정이나 등록한 아기'로 바꿨습니다. 다음 날에는 지역을 보지 않기로 했습니다. 처음에는 기기 지역이 한국이어도 한국판이었지만, 지금 새 설치는 휴대폰 언어만 봅니다. 한국에서 영어 휴대폰에 새로 설치하면 영어판, 미국에서 한국어 휴대폰에 설치하면 한국판입니다. 설정에서 한국어를 고르면 시장도 따라와 숨겼던 기능이 돌아옵니다. 테스트에도 '2.14 이전 설치는 절대 뒤집히지 않는다'는 줄이 있습니다.

5. 저장은 ml·kg·°C, 보여 줄 때만 oz·lb·°F

단위는 저장 형식을 바꾸지 않았습니다. 기록과 DB, 가족의 다른 기기는 모두 미터법 그대로이고 보이는 값과 입력만 바꿉니다. 한 아기의 기록을 단위 설정이 다른 가족 기기들이 함께 읽으니, 저장 단위는 하나여야 했습니다. 한국판은 늘 미터법이고, 해외판 새 설치는 기기 지역이 미국(그리고 라이베리아·미얀마)일 때만 oz·lb·in·°F로 시작하며 설정에서 바꿀 수 있습니다.

// lib/units.ts
/** 저장 값(미터법) → 보이는 값. metric이면 그대로 */
export function toDisplay(unit: MetricUnit, metric: number, decimals: number = DISPLAY_DECIMALS[unit]): number {
  if (system !== "us" || !Number.isFinite(metric)) return metric;
  const value = unit === "ml" ? metric / ML_PER_OZ : unit === "kg" ? metric / KG_PER_LB : unit === "cm" ? metric / CM_PER_IN : (metric * 9) / 5 + 32;
  return round(value, decimals);
}
 
/** 입력한 값(보이는 단위) → 저장 값(미터법). ml은 정수, kg 2자리, cm 1자리, °C 1자리(저장 형식 그대로) */
export function fromDisplay(unit: MetricUnit, shown: number): number {
  if (system !== "us" || !Number.isFinite(shown)) return shown;
  if (unit === "ml") return Math.round(shown * ML_PER_OZ);
  if (unit === "kg") return round(shown * KG_PER_LB, 2);
  if (unit === "cm") return round(shown * CM_PER_IN, 1);
  return round(((shown - 32) * 5) / 9, 1);
}

입력값은 원래 저장 형식의 정밀도로 넣습니다. 120ml는 4.1 oz로 보이고, 4 oz를 입력하면 118ml로 저장됩니다. 118ml를 oz로 바꿨다가 되돌려도 118ml가 나오는지는 테스트로 확인합니다.

문장 속 단위는 완성된 문장에서 '120ml'나 '10~400ml' 같은 덩어리를 찾아 바꿉니다. 다만 숫자와 단위가 서로 다른 요소로 그려지는 칸은 이 방식으로 건드리지 않습니다. 숫자만 바뀌고 단위가 ml로 남으면 틀린 기록이 되기 때문입니다. 그런 칸은 통계의 수유량 칸, 성장곡선과 임신 체중 그래프 눈금처럼 하나씩 찾아 고쳤습니다. 입력은 수유 기록 시트에서 1oz와 0.1oz 단위로, 성장·체온·임신 체중·출생 측정은 lb·in·°F로 받아 미터법으로 저장합니다. 앞의 영어 스크린샷의 5.7 oz는 170ml를 29.5735로 나눠 소수 한 자리로 반올림한 값입니다.

6. 앱 밖의 문구: 서버 푸시, 2.14.1의 잠금화면 위젯과 언어별 공지

앱 밖의 문구도 있었습니다. iOS 위젯·잠금화면·Live Activity 문구는 앱과 같은 번역표에서 Swift 번역표를 생성하고, Android 위젯과 진행 중 알림은 앱에서 번역해 넘깁니다. 추적 허용 팝업이나 빠른 설정 버튼 이름처럼 OS가 그리는 문구는 언어별 리소스로 나눴습니다.

공지 푸시는 서버가 보냅니다. 푸시 토큰을 등록할 때 영어·일본어 기기만 언어 값을 함께 보내고, 한국어 기기와 이전 버전 앱은 지금처럼 보내지 않습니다(값이 없으면 한국어). 서버는 일본어 번역이 없으면 영어로 보내고, 번역이 아예 없으면 한국어 공지가 해외 휴대폰에 가지 않도록 보내지 않습니다. 공지 푸시의 밤 시간(20:00~08:00)도 한국 시간이 아니라 기기마다 그 기기의 시간대로 판단하게 바꿨습니다.

11월 1일에 만든 2.14.1의 중심은 잠금화면 빠른 기록입니다. iOS 잠금화면 위젯 [수유]·[수면]·[기저귀]에 마지막 기록 뒤 지난 시간이 '3:10 전'처럼, 자는 중이면 '0:42 쿨쿨'처럼 보이고, 진행 중일 때 누르면 그 기록을 끝냅니다. Android 빠른 설정 버튼에도 같은 글자가 붙습니다. 큰 'h:mm' 숫자 뒤에 짧은 낱말 하나를 붙이는 시안을 고른 것은 영어('3:10 ago')와 일본어('3:10前')에서도 무너지지 않기 때문이었습니다.

출시 날에는 공지가 문제였습니다. 잠금화면 위젯 안내 공지를 언어마다 한 줄씩 따로 올리면, 공지를 언어로 거르지 않는 2.14.0·2.14.1 앱에서는 모든 사용자가 세 공지를 다 봅니다. 그래서 공지 하나에 언어별 번역을 함께 담고, 앱이 자기 언어의 번역만 골라 보여 주게 했습니다. 일본어 번역이 없으면 영어 번역을 쓰고, 둘 다 없으면 해외판에서는 그 공지를 보여 주지 않습니다.

한국어 앱은 출시 그대로이고, 해외판은 자기 언어 번역이 있는 공지만 보여 줍니다. 서버 푸시와 같은 규칙입니다. 덕분에 해외에서 숨긴 커뮤니티의 '커뮤니티가 오픈되었어요!' 공지가 해외 새 사용자 홈에 한국어로 뜨던 것도 빠지게 됐습니다. 기존 공지에 번역을 덧붙이기만 하는 방식이라 이전 앱은 그대로 동작하고, 앱 수정은 2.14.1 OTA로 냈습니다. OTA는 같은 런타임 버전에만 닿아서 2.14.0 사용자는 스토어에서 2.14.1로 올려야 이 동작을 받습니다.

7. 1인 개발자가 다국어 출시 전에 정할 것

해 보고 나서 정리한 체크리스트입니다.

  • 기존 사용자의 화면을 지킬 장치. 번역 키를 무엇으로 할지, 기존 설치를 무엇으로 알아볼지가 여기에 달려 있습니다.
  • 나라마다 뜻이 달라지는 기능 목록. 의료·행정 일정, 응급 번호, 국내 서비스 연동, 운영 인력이 드는 커뮤니티. 숨길 때는 메뉴뿐 아니라 홈 카드, 알림, 화면 주소까지 막아야 합니다.
  • 저장 단위는 하나로. 변환은 표시와 입력에서만 하고, 숫자와 단위가 따로 그려지는 칸을 목록으로 만들어 둡니다.
  • 앱 밖 문구 목록. 서버 푸시, 앱 안 공지, 위젯, OS 권한 팝업, 스토어 글, 개인정보처리방침도 번역 대상입니다.
  • 누락은 테스트로, 어색함은 실제 화면으로. 표가 다 찼는지는 테스트가 알려 주지만, 뜻이 틀린 번역은 언어별 화면을 찍어 봐야 보입니다.
  • 법이 다른 지역은 미루기. 건강 정보를 다룬다면 나라마다 개인정보 요건이 다릅니다.

남은 일도 적어 둡니다. 영어·일본어 문구는 1차 번역을 실제 화면에서 고쳐 가며 다듬은 상태라 원어민 검수가 남아 있습니다. 일본어는 어색한 번역이 바로 티 나는 시장이라 이것이 가장 큰 숙제입니다. EU와 영국도 아직 열지 않았습니다.

돌아보면 가장 오래 고민한 것은 번역이 아니라 이미 쓰고 있는 사람들의 화면이었습니다. 데일리베이비의 기능과 스토어 링크는 앱 소개 페이지에, 처음 기획과 기술 스택 이야기는 시리즈 1편에 있습니다.

광고

관련 글