Flutter 스킬

skills/skills/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…

skills/skills/flutter-building-forms

검증된 Flutter 폼으로, 필드 수준 오류 처리 및 제출 워크플로우를 제공합니다. 상태 저장 위젯(StatefulWidget) 호스팅과 지속적인 GlobalKey<FormState>를 사용하여 리빌드 전반에 걸쳐 폼 상태와 검증을 관리해야 합니다. validator() 콜백이 있는 TextFormField 위젯을 사용하며, 실패 시 오류 문자열을 반환하고 성공 시 null을 반환합니다. 제출 시 _formKey.currentState!.validate()를 호출하여 모든 검증기를 트리거하고 필드 아래에 오류 메시지를 자동으로 표시합니다. 사용자 이름을 보여주는 완전한 코드 예제가 포함되어 있습니다...

skills/skills/flutter-building-layouts

Flutter의 제약 조건 시스템을 마스터하여 반응형이고 오버플로우 없는 레이아웃을 효율적으로 구축합니다. 핵심 원칙: 제약 조건은 아래로 흐르고, 크기는 위로 흐르며, 부모가 위치를 설정합니다. 플렉스 박스나 스크롤 가능 영역에 무제한 제약 조건을 전달하지 마십시오. 선형 레이아웃에는 Row/Column, 공간 분배에는 Expanded/Flexible, 겹치는 요소에는 Stack, 엄격한 제약 조건에는 SizedBox를 사용하십시오. 모바일, 태블릿 등에서 적응형 레이아웃을 위해 LayoutBuilder를 사용한 반응형 크기 조정 또는 조건부 렌더링을 적용하십시오.

skills/skills/flutter-building-plugins

크로스 플랫폼 Flutter 플러그인을 스캐폴딩하고 구현하며, Android, iOS, Windows, 웹을 위한 네이티브 상호 운용을 지원합니다. 표준 플러그인(플랫폼 API용 메서드 채널)과 FFI 플러그인(C/C++ 네이티브 라이브러리)을 모두 지원하며, 플랫폼별 SDK 접근이 필요한지 또는 직접 네이티브 코드 바인딩이 필요한지에 따라 선택할 수 있습니다. 연합 플러그인 아키텍처는 팀 기반 개발을 위해 API를 앱 직면, 플랫폼 인터페이스, 독립적인 플랫폼 구현 패키지로 분할합니다. 단계별 안내를 포함합니다...

skills/skills/flutter-caching

Flutter 앱의 다양한 데이터 유형과 플랫폼에 걸친 포괄적인 캐싱 및 성능 최적화를 제공합니다. 적절한 캐싱 메커니즘(인메모리, 키-값 쌍을 위한 shared_preferences, 관계형 데이터를 위한 SQLite, 대용량 blob을 위한 파일 시스템, 네트워크 이미지를 위한 이미지 캐싱)을 선택하는 결정 로직을 제공합니다. 캐시된 데이터를 먼저 반환한 후 네트워크에서 가져와 업데이트하는 스트림 기반 오프라인 우선 저장소 패턴을 포함합니다. Android FlutterEngine 사전 워밍업 등을 다룹니다.

skills/skills/flutter-caching-data

로컬 데이터 캐싱 및 오프라인 우선 동기화 패턴을 Flutter 앱에 적용합니다. UI 상태를 위한 shared_preferences, 구조화된 데이터를 위한 SQLite/Hive, 바이너리 미디어를 위한 파일 시스템, 탐색을 위한 상태 복원, Android에서의 FlutterEngine 사전 워밍 등 다섯 가지 캐싱 전략을 다룹니다. 스트림을 사용한 읽기(로컬 데이터 반환, 원격 데이터 가져오기, 캐시 업데이트)와 이중 쓰기 전략(온라인 전용 및 백그라운드 동기화를 통한 오프라인 우선)을 통해 오프라인 우선 리포지토리를 구현합니다. 이미지 캐싱을 최적화합니다...

flutter/.agents/skills/flutter-cherry-pick

병합된 PR을 flutter/flutter 저장소의 stable 또는 beta 채널에 공식 체리픽하는 방법. flutter/flutter에 병합된 풀 리퀘스트에만 사용하세요. 오직…

skills/skills/flutter-concurrency

백그라운드 JSON 파싱 및 상태 관리를 통해 버벅임 없는 Flutter UI 렌더링을 제공합니다. 모델 복잡성에 따라 수동 직렬화(dart:convert)와 코드 생성(json_serializable) 중 선택할 수 있는 의사 결정 트리를 제공합니다. 세 가지 동시성 전략을 지원합니다: 소규모 페이로드용 메인 스레드 async/await, 대규모 일회성 연산용 단기 Isolate.run(), 지속적인 양방향 통신용 ReceivePort/SendPort를 사용한 장기 격리. 플랫폼 인식 폴백을 포함합니다:...

skills/skills/flutter-databases

MVVM을 준수하는 Flutter 데이터 레이어로, Repository 패턴, 상태 없는 서비스, 지능형 로컬 캐싱 전략을 포함합니다. 데이터 유형, 크기, 관계형 복잡성에 따라 지속성 기술(shared_preferences, sqflite, drift, hive_ce, isar_community 또는 파일 I/O) 선택을 안내합니다. Repository를 단일 진실 공급원으로 구현하며, DatabaseService와 ApiClient를 비공개 상태 없는 종속성으로 격리합니다. 도메인 모델, SQLite 작업 등에 대한 완전한 코드 예제를 제공합니다.

skills/skills/flutter-embedding-native-views

네이티브 Android, iOS 또는 macOS 뷰와 웹 콘텐츠를 Flutter 애플리케이션에 직접 임베드합니다. 성능과 정확성에 차이가 있는 두 가지 Android 합성 모드(하이브리드 및 텍스처 레이어)를 지원하며, iOS와 macOS는 하이브리드 합성만 사용합니다. Android 및 iOS에서 플랫폼 뷰를 구현하기 위한 단계별 워크플로우와 검증 및 문제 해결 가이드를 제공합니다. 전체 페이지 또는 멀티 뷰(임베디드) 모드를 통해 기존 웹 애플리케이션에 Flutter를 임베드할 수 있으며...

skills/skills/flutter-environment-setup-linux

Linux 환경에서 Flutter 데스크톱 개발을 위한 환경 설정으로, OS 감지 및 툴체인 검증을 수행합니다. Debian/Ubuntu 또는 ChromeOS를 자동으로 감지하고, apt 기반이 아닌 시스템에서는 안내와 함께 중단됩니다. 핵심 의존성(curl, git, unzip, libglu1-mesa)과 Linux 데스크톱 툴체인(clang, cmake, ninja-build, GTK 라이브러리)을 설치합니다. 선택적으로 IDE 설정(VS Code 또는 Android Studio, snap을 통해)을 안내합니다. flutter doctor -v 및 flutter devices를 실행하여 환경을 검증하고, 자동으로 설치합니다...

skills/skills/flutter-environment-setup-macos

macOS Flutter 개발 환경을 자동으로 설정하며, 의존성 검증 및 진단 수정 기능을 제공합니다. Flutter 설치 여부, Xcode 사용 가능 여부, CocoaPods 존재 여부를 확인하고, 필수 구성 요소가 누락된 경우 명확한 안내와 함께 중단됩니다. Xcode 명령줄 도구 구성 및 라이선스 동의 과정을 sudo 명령어와 함께 안내합니다. flutter doctor 검증 루프를 반복 실행하여 Xcode 섹션이 완전히 통과할 때까지 남은 툴체인 문제를 식별하고 해결합니다...

skills/skills/flutter-environment-setup-windows

자동화된 Windows Flutter 개발 환경 설정 및 플랫폼별 툴체인 구성을 제공합니다. Flutter SDK 경로, Visual Studio C++ 툴체인 설치, Windows 데스크톱, Android 또는 두 대상을 위한 플랫폼별 설정을 대화형 프롬프트를 통해 구성합니다. Android가 선택된 경우 Android Studio 설정, 기기/에뮬레이터 구성, USB 드라이버 설치를 처리합니다. 로컬 Windows 앱 패키징 및 배포를 위해 OpenSSL을 사용하여 자체 서명된 MSIX 인증서를 생성합니다...

skills/skills/flutter-fix-layout-issues

Flutter 레이아웃 오류(오버플로우, 무제한 제약 조건)를 Dart 및 Flutter MCP 도구를 사용하여 수정합니다. "RenderFlex overflowed", "Vertical…" 문제를 해결할 때 사용하세요.

skills/skills/flutter-form

유효성 검사가 포함된 폼 구축하기

skills/skills/flutter-handling-concurrency

CPU 집약적인 작업을 백그라운드 아이솔레이트로 오프로드하여 Flutter UI의 응답성을 유지합니다. I/O 바운드 작업을 위한 async/await, 일회성 무거운 계산을 위한 Isolate.run(), 지속적인 백그라운드 워커를 위한 메시지 전달 방식의 Isolate.spawn() 등 세 가지 동시성 패턴을 제공합니다. 작업 유형(I/O 대 CPU 바운드)과 실행 빈도에 따라 비동기 작업과 아이솔레이트 중 선택할 수 있는 결정 매트릭스를 포함합니다. 단계별 작업 체크리스트와 함께 세 가지 완전한 워크플로우를 다룹니다: 표준...

skills/skills/flutter-handling-http-and-json

HTTP 요청 및 JSON 직렬화를 통한 Flutter REST API 통합 및 데이터 파싱. 세 가지 HTTP 메서드(GET, POST, PUT, DELETE)를 다루며, 적절한 상태 코드 검증, HTTPS 강제 적용, Uri.https()를 사용한 안전한 URI 구성을 포함합니다. 간단한 모델에는 수동 fromJson/toJson을, 복잡한 중첩 구조에는 json_serializable을 사용한 코드 생성을 제공하는 두 가지 직렬화 전략을 제공합니다. 대용량 JSON 페이로드 처리 시 UI 지연을 방지하기 위해 compute()를 사용한 백그라운드 파싱을 포함합니다...

skills/skills/flutter-home-screen-widget

iOS 및 Android에서 Flutter 앱을 위한 네이티브 홈 스크린 위젯으로, 크로스 플랫폼 데이터 공유를 지원합니다. App Groups(iOS)과 SharedPreferences(Android)를 통해 Dart와 네이티브 플랫폼 간 데이터 공유를 설정하여 Flutter 앱에서 위젯 업데이트를 가능하게 합니다. 간단한 텍스트 기반 위젯과 네이티브 디스플레이를 위한 정적 이미지로 렌더링된 복잡한 Flutter UI를 지원합니다. Xcode(Widget Extension 타겟, Swift TimelineProvider 포함)와 Android Studio(AppWidgetProvider, XML 포함)에서 네이티브 설정이 필요합니다.

skills/skills/flutter-http-and-json

Flutter 앱을 위한 안전한 HTTP 네트워킹 및 JSON 처리 기능으로, 백그라운드 파싱을 지원합니다. http 패키지를 사용하여 CRUD 작업(GET, POST, PUT, DELETE)을 구현하며, Uri.https()를 통한 안전한 URL 구성과 엄격한 상태 코드 검증을 수행합니다. Dart 3 패턴 매칭과 factory 생성자 및 toJson() 메서드를 활용한 강력한 타입 기반 JSON 직렬화 및 역직렬화를 제공합니다. 16ms를 초과하는 페이로드에서 UI 지연을 방지하기 위해 compute()를 통해 대규모 JSON 파싱을 백그라운드 격리 프로세스로 오프로드합니다...

skills/skills/flutter-implement-json-serialization

Create model classes with `fromJson` and `toJson` methods using `dart:convert`. Use when manually mapping JSON keys to class properties for simple data…

skills/skills/flutter-implementing-navigation-and-routing

명령형 및 선언형 라우팅 패턴을 사용한 Flutter 화면 전환 및 딥 링크. 각 접근 방식을 언제 사용해야 하는지에 대한 지침과 함께 Navigator(명령형, 스택 기반)와 Router(선언형, URL 동기화) 방식을 모두 다룹니다. iOS, Android 및 Web에서 딥 링크를 지원하며, 생성자, 라우트 인수 및 반환 값을 통한 데이터 전달을 포함합니다. 독립적인 하위 네비게이터와 뒤로 가기 버튼 차단을 통해 다단계 흐름(예: 설정 마법사)을 위한 중첩 네비게이션을 구현합니다. 제공...

skills/skills/flutter-improving-accessibility

Flutter 앱을 화면 읽기 프로그램 및 키보드 탐색을 포함한 보조 기술에 맞게 구성합니다. UI 디자인 기본 사항을 다룹니다: 글꼴 크기 조정, 색상 대비(일반 텍스트의 경우 4.5:1, 큰 텍스트의 경우 3:1), 48x48픽셀 최소 터치 대상. Semantics, MergeSemantics 및 ExcludeSemantics 위젯을 사용하여 위젯 트리 구조를 보조 도구에 노출하는 의미론적 주석 패턴을 제공합니다. 성능을 위해 기본적으로 비활성화된 의미론 계층을 활성화하는 웹별 지침을 포함합니다...

skills/skills/flutter-interoperating-with-native-apis

Android, iOS 및 웹에서 Flutter 코드로 기기별 네이티브 API에 접근합니다. FFI를 통한 직접 C/C++ 바인딩, Platform Channels(Pigeon으로 타입 안전성 확보)를 통한 Kotlin/Swift/Objective-C 호출, Platform Views를 통한 네이티브 UI 컴포넌트 임베딩 등 세 가지 통합 접근 방식을 지원합니다. FFI는 dart:ffi를 사용하며 build.dart 훅을 통해 자동 빌드 컴파일을 수행합니다. extern "C" 심볼과 Dart 바인딩 생성을 위한 package:ffigen이 필요합니다. Platform Channels는 비동기 메시징을 제공합니다...

skills/skills/flutter-layout

반응형 Flutter 레이아웃을 위젯 구성, 제약 조건 관리, 화면 크기 적응을 통해 구축합니다. 콘텐츠의 차원, 겹침, 스크롤, 반응형 요구 사항에 따라 적절한 기본 레이아웃 위젯(Row, Column, Stack, ListView, GridView, CustomScrollView)을 선택하기 위한 의사 결정 트리를 제공합니다. Flutter의 핵심 제약 시스템(제약 조건은 아래로 흐르고, 크기는 위로 전달되며, 부모가 위치를 설정)을 적용하며, 특정 치수를 강제하는 ConstrainedBox 패턴을 포함합니다. 구현합니다...

skills/skills/flutter-localization

Flutter 앱이 여러 언어와 로케일을 지원하도록 적절한 i18n 설정을 구성합니다. 의존성 주입(flutter_localizations, intl), 코드 생성 설정(l10n.yaml), 플레이스홀더, 복수형, 지역 변형을 지원하는 .arb 번역 파일 생성을 관리합니다. 루트 위젯 델리게이트(MaterialApp, CupertinoApp 또는 WidgetsApp)를 구성하고 명시적인 Localizations 래핑이 필요한 TextField 및 CupertinoTabBar와 같은 격리된 위젯을 처리합니다. 지원...

skills/skills/flutter-localizing-apps

ARB 파일과 코드 생성을 사용한 Flutter 앱의 다국어 지원. flutter_localizations 및 intl을 사용하여 pubspec.yaml을 구성하고, l10n.yaml 파일을 정의하여 gen-l10n 코드 생성기를 활성화합니다. 지역화된 문자열은 Application Resource Bundle(.arb) JSON 파일에 저장하며, 템플릿 파일은 모든 키를 정의하고 로케일별 파일이 번역을 제공합니다. MaterialApp 또는 CupertinoApp에 AppLocalizations.delegate 및 플랫폼별 델리게이트를 추가하여 지역화를 통합합니다...

skills/skills/flutter-managing-state

Flutter에서 StatefulWidget, MVVM 및 Provider를 사용하여 일시적 상태와 앱 수준 상태를 관리합니다. 일시적 상태(단일 위젯, setState()로 관리)와 앱 상태(위젯 간 공유, MVVM 및 provider 패키지로 관리)를 구분합니다. 단일 진실 공급원을 사용한 단방향 데이터 흐름을 구현합니다: 모델이 데이터를 처리하고, ViewModel이 ChangeNotifier를 통해 UI 상태를 관리하며, View가 상태를 소비하고 표시합니다. MVVM 구현을 위한 순차적 워크플로우를 제공합니다: Repository 정의, 생성...

skills/skills/flutter-native-interop

크로스 플랫폼 네이티브 상호 운용성으로 Android, iOS 및 Web에서 Flutter 앱을 지원합니다. 최적의 통합 전략을 선택하기 위한 결정 로직을 제공합니다: C/C++ 코드용 FFI, OS별 API용 Platform Channels, 네이티브 UI 컴포넌트용 Platform Views, 웹용 JS Interop. 네이티브 툴체인 컴파일 및 Dart 바인딩과 함께 빌드 훅(Flutter 3.38+)을 사용하는 최신 FFI 아키텍처를 구현합니다. 완전한 Kotlin 및 Swift를 포함한 비동기 Platform Channels(MethodChannel)을 지원합니다...

skills/skills/flutter-performance

Flutter 앱에서 체계적인 프로파일링과 목표 지향적 최적화를 통해 성능 병목 현상을 식별하고 제거합니다. UI 스레드, 래스터(GPU) 스레드 또는 둘 모두에서 발생하는 지연을 진단하기 위한 의사 결정 트리를 제공하며, 각각에 대한 구체적인 수정 사항을 포함합니다. traceAction과 TimelineSummary를 사용하여 성능 기준을 설정하고 프레임 예산을 측정하는 통합 테스트 템플릿을 포함합니다. UI 최적화(상태 지역화, const 생성자, StringBuffer 사용)와 래스터 최적화(Opacity 대체...)를 다룹니다.

skills/skills/flutter-platform-views

Android, iOS, macOS 및 웹 플랫폼에서 Flutter 앱에 네이티브 뷰와 웹 콘텐츠를 임베드합니다. Android 하이브리드 컴포지션(네이티브 정확도) 및 텍스처 레이어(Flutter 성능), iOS/macOS 하이브리드 컴포지션, 웹 전체 페이지 또는 임베디드 멀티뷰 모드를 지원합니다. 팩토리 등록 패턴과 함께 완전한 Dart 및 네이티브 코드 템플릿(Android용 Kotlin, iOS/macOS용 Swift, 웹용 JavaScript)을 제공합니다. 대상 플랫폼과 임베딩 방식을 결정하기 위해 사전에 의사 결정 트리가 필요합니다...