Community코딩 & 개발github.com

flutter/flutter-localizing-apps

다국어 및 지역을 지원하도록 Flutter 앱을 구성합니다. 국제 시장과 다양한 사용자 로케일을 위해 애플리케이션을 준비할 때 사용됩니다.

flutter-localizing-apps란 무엇인가요?

이 스킬은 Flutter 애플리케이션에 다국어 및 지역화 지원을 추가하는 방법을 안내합니다. 국제 시장을 대상으로 앱을 준비할 때 필수적이며, Flutter의 내장 지역화 시스템과 패키지를 활용하여 문자열 번역, 날짜/숫자 형식 지역화, 언어 전환 등을 설정하는 방법을 설명합니다. 주로 Flutter 프레임워크를 기반으로 하며, `flutter_localizations` 패키지와 `intl` 패키지를 사용하여 지역화를 구현합니다. 사용자는 SKILL.md 문서를 통해 ARB 파일 생성, 지역화 위젯 설정, 언어 감지 및 전환 로직을 단계별로 배울 수 있습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/flutter/skills/tree/main/skills/flutter-localizing-apps

Installed? Explore more 코딩 & 개발 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

flutter-localizing-apps은(는) 무엇을 하나요?

다국어 및 지역을 지원하도록 Flutter 앱을 구성합니다. 국제 시장과 다양한 사용자 로케일을 위해 애플리케이션을 준비할 때 사용됩니다.

주요 기능

  • 여러 언어로 앱 텍스트 번역 지원
  • 날짜, 시간, 숫자 형식의 지역화
  • 언어에 따른 텍스트 방향 지원
  • 사용자 로케일 자동 감지 및 전환

필요한 패키지

pubspec.yaml에 다음 패키지를 추가합니다:

dependencies:
  flutter:
    sdk: flutter
  flutter_localizations:
    sdk: flutter
  intl: ^0.19.0

설정 방법

  1. pubspec.yaml에 패키지 추가
  2. ARB 파일 생성 (예: lib/l10n/app_ko.arb, lib/l10n/app_en.arb)
  3. MaterialApp에서 지역화 설정
import 'package:flutter_localizations/flutter_localizations.dart';
import 'package:intl/intl.dart';

MaterialApp(
  localizationsDelegates: [
    GlobalMaterialLocalizations.delegate,
    GlobalWidgetsLocalizations.delegate,
    GlobalCupertinoLocalizations.delegate,
  ],
  supportedLocales: [
    const Locale('en'), // 영어
    const Locale('ko'), // 한국어
  ],
  localeResolutionCallback: (locale, supportedLocales) {
    // 사용자의 로케일을 감지하고 가장 적합한 지원 로케일을 반환합니다.
  },
  // ...
)

사용 예시

Text('hello').tr() // 간단한 번역 호출

또는 intl 패키지의 Intl.message()을 사용합니다.

참고 자료

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

flutter/flutter-accessibility

Configure your Flutter app to support assistive technologies like Screen Readers

flutter/flutter-accessibility-audit

Triggers an accessibility scan through the widget_inspector and automatically adds Semantics widgets or missing labels to the source code.

flutter/flutter-adding-home-screen-widgets

Adds home screen widgets to a Flutter app for Android and iOS. Use when providing glanceable app information or quick actions on the device home screen.

flutter/flutter-add-integration-test

Configures Flutter Driver for app interaction and converts MCP actions into permanent integration tests. Use when adding integration testing to a project, exploring UI components via MCP, or automating user flows with the integration_test package.

flutter/flutter-add-widget-preview

Adds interactive widget previews to the project using the previews.dart system. Use when creating new UI components or updating existing screens to ensure consistent design and interactive testing.

flutter/flutter-add-widget-test

Implement a component-level test using `WidgetTester` to verify UI rendering and user interactions (tapping, scrolling, entering text). Use when validating that a specific widget displays correct data and responds to events as expected.

flutter/flutter-animating-apps

Implements animated effects, transitions, and motion in a Flutter app. Use when adding visual feedback, shared element transitions, or physics-based animations.

flutter/flutter-animation

Add animated effects to your Flutter app

flutter/flutter-apply-architecture-best-practices

Architects a Flutter application using the recommended layered approach (UI, Logic, Data). Use when structuring a new project or refactoring for scalability.

flutter/flutter-app-size

Measure and reduce the size of the Flutter app bundle, APK, or IPA

flutter/flutter-architecting-apps

Architects a Flutter application using the recommended layered approach (UI, Logic, Data). Use when structuring a new project or refactoring for scalability.

flutter/flutter-architecture

Use the Flutter team's recommended app architecture

flutter/flutter-building-forms

Builds Flutter forms with validation and user input handling. Use when creating login screens, data entry forms, or any multi-field user input.

flutter/flutter-building-layouts

Builds Flutter layouts using the constraint system and layout widgets. Use when creating or refining the UI structure of a Flutter application.

flutter/flutter-building-plugins

Builds Flutter plugins that provide native interop for other apps to use. Use when creating reusable packages that bridge Flutter with platform-specific functionality.

flutter/flutter-build-responsive-layout

Use `LayoutBuilder`, `MediaQuery`, or `Expanded/Flexible` to create a layout that adapts to different screen sizes. Use when you need the UI to look good on both mobile and tablet/desktop form factors.

flutter/flutter-caching

Cache data in a Flutter app

flutter/flutter-caching-data

Implements caching strategies for Flutter apps to improve performance and offline support. Use when retaining app data locally to reduce network requests or speed up startup.

flutter/flutter-concurrency

Execute long-running tasks in a background thread in Flutter

flutter/flutter-databases

Work with databases in a Flutter app

관련 스킬