패키지, 저장소 및 앱 카테고리 검색

패키지 상세v2.0.2

flutter_config

Flutter의 Dart 코드와 iOS 및 Android의 네이티브 코드에 환경 변수를 노출하는 플러그인입니다. Flutter 앱에 12팩터 사랑을 가져옵니다

AndroidiOS
30일 다운로드
2.7천
좋아요
211
Pub 점수
140

패키지 설치

flutter pub add flutter_config

패키지 개요

공개 정보를 바탕으로 생성한 선택 가이드입니다.

flutter_config는 Android 및 iOS의 Dart 및 네이티브 코드에서 환경 변수에 원활하게 액세스할 수 있도록 해주는 Flutter 플러그인입니다. 개발, 스테이징, 프로덕션과 같은 다양한 환경에서 보안성과 유연성을 높이기 위해 구성 정보를 외부에서 관리할 수 있게 함으로써 12팩터 앱 원칙을 Flutter에 도입합니다. 이 패키지는 플랫폼별 파일(예: iOS의 info.plist, Android의 build.gradle)에서 설정을 읽어 Dart 상수로 노출시킵니다. 이를 통해 민감한 값을 하드코딩하는 것을 방지하고 배포 워크플로우를 간소화할 수 있습니다.

사용 사례

  • 환경별로 API 엔드포인트 관리
  • API 키를 안전하게 저장하기
  • 개발/스테이징/프로덕션 구성 간 전환
  • 환경에 따라 앱 동작 맞춤 설정
  • 구성을 통해 기능 플래그 활성화
  • 네이티브 코드와 구성 공유

주요 기능

  • Android 및 iOS 플랫폼을 지원합니다
  • 네이티브 프로젝트 파일에서 구성 정보를 읽음
  • Dart 및 네이티브 코드로 변수 노출
  • 12가지 요소 앱 방법론을 따릅니다
  • pub add를 통한 간편한 통합
  • 런타임 오버헤드 없음

적합한 대상

  • 여러 환경을 사용하는 개발자
  • 보안 구성 관리를 필요로 하는 팀
  • 구성에 네이티브 코드 액세스가 필요한 앱
  • 12가지 요인 원칙을 따르는 프로젝트
  • 환경별 설정을 갖춘 CI/CD 파이프라인
  • 동적 기능 전환 기능을 가진 앱

고려 사항

  • 앱이 시작되기 전에 구성 설정을 해야 합니다
  • 민감한 데이터는 버전 관리에 커밋해서는 안 됩니다
  • 네이티브 프로젝트에서 수동 설정이 필요합니다
  • 런타임 구성 변경에 적합하지 않습니다
  • 빌드 시 정적 값에 제한됨
  • 팀 온보딩을 위한 적절한 문서가 필요합니다

원본 README

연결된 소스 저장소의 README 원문 스냅샷입니다. 최신 내용은 저장소에서 확인하세요.

Config Variables for your Flutter apps

Plugin that exposes environment variables to your Dart code in Flutter as well as to your native code in iOS and Android.

Inspired by react-native-config

Basic Usage

Create a new file .env in the root of your Flutter app:

API_URL=https://myapi.com
FABRIC_ID=abcdefgh

load all environment varibles in main.dart

import 'package:flutter_config/flutter_config.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized(); // Required by FlutterConfig
  await FlutterConfig.loadEnvVariables();

  runApp(MyApp());
}

Now you can access your environment varibles anywhere in your app.

import 'package:flutter_config/flutter_config.dart';

FlutterConfig.get('FABRIC_ID') // returns 'abcdefgh'

Keep in mind this module doesn't obfuscate or encrypt secrets for packaging, so do not store sensitive keys in .env. It's basically impossible to prevent users from reverse engineering mobile app secrets, so design your app (and APIs) with that in mind.


Load Environment Varibles in Swift

First import the plugin

import flutter_config

Then you can use the .env Variable, replace ENV_API_KEY with yours.

flutter_config.FlutterConfigPlugin.env(for: "ENV_API_KEY")

Getting Started

Install the latest version of the plugin

Refer to Android Setup Guide for initial setup and advanced options

No additional setup is required for iOS, however, for advanced usage refer to the iOS Setup Guide

Testing

Whenever you need to use FlutterConfig in your tests, simply use the method loadValueForTesting

import 'package:flutter_config/flutter_config.dart';

void main() {
  FlutterConfig.loadValueForTesting({'BASE_URL': 'https://www.mockurl.com'});
  
  test('mock http client test', () {
    final client = HttpClient(
      baseUrl: FlutterConfig.get('BASE_URL')
    );
  });
}

카테고리

소스 저장소

이 패키지를 사용하는 프로젝트