[SwiftBeam #19] "전 세계 어디서든 편리하게" - l10n과 arb 파일로 글로벌 서비스 준비

SwiftBeam Series #19

"언어의 장벽을 넘어"
글로벌 서비스로 가는 길

Flutter 다국어 지원(l10n) 완벽 가이드

🌐 🌎 🇰🇷 🇺🇸

개발자가 만든 도구가 한국에서만 쓰이는 것보다 전 세계 사람들에게 도움이 된다면 그보다 뿌듯한 일은 없을 것입니다. 특히 SwiftBeam처럼 보편적인 '파일 전송' 기능을 가진 앱은 글로벌 시장에서의 가능성이 무궁무진하죠. 하지만 앱을 해외에 출시하기 위해서는 단순히 코드만 잘 짜는 것을 넘어 '현지화(Localization, l10n)'라는 중요한 과정을 거쳐야 합니다. 오늘은 Flutter에서 제공하는 강력한 다국어 지원 시스템을 활용해 SwiftBeam을 글로벌 서비스로 탈바꿈시킨 과정을 공유합니다.

1. 하드코딩된 문자열은 '부채'입니다

개발 초기에는 마음이 급해 Text('파일 전송 중...')와 같이 화면에 보일 문구를 코드 안에 직접 적어 넣곤 합니다. 하지만 이렇게 하드코딩된 문자열이 수백 개 쌓이고 나면, 나중에 영어 버전을 만들 때 모든 소스 코드를 뒤져서 수정해야 하는 끔찍한 상황이 발생합니다.

SwiftBeam은 초기부터 '문자열 자산화' 전략을 세웠습니다. 앱 내의 모든 텍스트를 소스 코드와 분리하여 별도의 리소스 파일로 관리하는 것이죠. 이렇게 하면 개발자는 로직에만 집중할 수 있고, 번역 작업은 코드 수정 없이 파일만 교체하는 방식으로 효율적으로 진행될 수 있습니다.

2. ARB 파일: 다국어 데이터의 표준

Flutter에서 다국어를 관리하는 표준 형식은 .arb(Application Resource Bundle)입니다. JSON과 유사한 형태를 띠고 있어 읽고 쓰기 매우 편리하죠. SwiftBeam 프로젝트의 lib/l10n 폴더 안에는 다음과 같은 파일들이 자리 잡고 있습니다.

• app_ko.arb: "send": "보내기", "receive": "받기"
• app_en.arb: "send": "Send", "receive": "Receive"

단순히 단어만 바꾸는 것이 아닙니다. ARB 파일은 '플레이스홀더' 기능을 지원하여, "sendingProgress": "{fileName}을 전송 중입니다..."와 같이 변수가 포함된 문장도 우아하게 처리할 수 있습니다. 각 언어의 문법 구조에 맞게 변수의 위치를 조절할 수 있다는 점이 이 방식의 가장 큰 장점입니다.

3. 코드 생성(Code Generation)으로 안전하게

단순히 텍스트 파일을 읽어오는 것이라면 오타가 났을 때 앱이 죽는 등 위험 요소가 많습니다. Flutter는 flutter gen-l10n 도구를 통해 ARB 파일을 강력한 타입(Type-safe)을 가진 Dart 클래스로 자동 변환해 줍니다.

Text(AppLocalizations.of(context)!.sendButton)

위와 같이 코드를 작성하면, 개발 환경에서 오타를 즉시 잡아줄 뿐만 아니라 현재 사용자의 스마트폰 설정 언어에 맞춰 적절한 텍스트를 마법처럼 골라 보여줍니다. 한국어 유저에게는 "보내기", 미국 유저에게는 "Send"가 자동으로 나타나는 것이죠.

4. 번역 그 이상의 가치: 문화적 맥락(Localization)

진정한 현지화는 단어의 직역을 넘어 문화적 맥락을 고려해야 합니다. SwiftBeam을 현지화하며 고민했던 몇 가지 디테일들입니다.

• 📏 텍스트 길이의 변화: 한글로 두 글자인 "받기"가 영어로는 "Receive"로 길어지면서 버튼 레이아웃이 깨지는 경우가 있습니다. 이를 위해 유동적인 레이아웃 설계를 도입했습니다.
• 📅 날짜 및 숫자 형식: 한국은 '2026. 06. 13' 형식을 쓰지만, 미국은 'Jun 13, 2026' 형식을 선호합니다. intl 패키지를 활용해 날짜 형식까지 완벽하게 현지화했습니다.
• 🖋️ 폰트의 조화: 한글 전용 폰트가 영어에서는 어색해 보일 수 있습니다. 다국어를 모두 포용할 수 있는 Pretendard와 같은 범용 폰트를 선택하여 디자인의 일관성을 유지했습니다.

5. 전 세계 유저와 소통할 준비가 되셨나요?

현지화는 귀찮은 작업처럼 보일 수 있지만, 앱의 수명을 연장하고 수억 명의 잠재 고객을 확보하는 가장 가성비 좋은 투자입니다. SwiftBeam은 이제 한국어와 영어를 완벽히 지원하며 글로벌 유저들을 맞이할 준비를 마쳤습니다.

글로벌 서비스를 준비했다면, 이제는 서비스의 지속 가능성을 고민해야 할 때입니다. 1인 개발자가 프로젝트를 계속 유지하려면 최소한의 수익 모델이 필요하죠. 다음 편에서는 사용자 경험을 해치지 않으면서 수익을 창출하는 'AdMob 광고 적용 전략'에 대해 이야기해 보겠습니다.

다음 편 예고: [SwiftBeam #20] "지속 가능한 개발을 위해" - 최소한의 수익 모델, AdMob 광고 적용기

글로벌 시장을 목표로 세심하게 설계된 Team M2Y의 다양한 앱들을 만나보세요!
전 세계 사용자의 일상을 바꾸는 저희의 다른 프로젝트들도 아래 링크에서 확인하실 수 있습니다.

Team M2Y 글로벌 제품군 구경하기 →

TAGS: 다국어지원, l10n, ARB파일, Flutter, 플러터, 현지화, Localization, 글로벌서비스, 앱개발, SwiftBeam, 기술블로그, 개발일지