[Flutter] flutter_dotenv 패키지 사용법

Flutter에서 환경 변수를 관리하기 위해 flutter_dotenv 패키지를 사용한다! .env 파일을 로드하여 애플리케이션에서 환경 변수를 사용할 수 있도록 도와준다,

특히 API 키나 민감한 설정 값을 코드에 직접 하드코딩하지 않고 안전하게 관리할 때 유용하다.

 

---

1. flutter_dotenv 패키지 추가

먼저, pubspec.yaml 파일에 flutter_dotenv 패키지를 추가해야 한다.

dependencies:
  flutter:
    sdk: flutter
  flutter_dotenv: ^5.1.0

이후 아래 명령어를 실행하여 패키지를 설치한다.

flutter pub get

---

2. .env 파일 생성

프로젝트 루트 디렉터리에 .env 파일을 생성하고, 환경 변수를 정의한다.

API_KEY=your_api_key_here
BASE_URL=https://api.example.com

 

.env 파일은 Git에 커밋되지 않도록 .gitignore에 추가하는 것이 좋다! (필수)

.env

---

3. .env 파일을 pubspec.yaml에 등록

Flutter에서는 .env 파일을 assets 디렉터리에 포함해야 정상적으로 로드할 수 있다.

이를 위해 pubspec.yaml 파일에 아래 내용을 추가한다.

flutter:
  assets:
    - .env

 

이 부분을 누락하면 flutter_dotenv가 .env 파일을 찾지 못하기 때문에, 반드시 추가해야 한다.

---

4. .env 파일 로드 및 사용

main.dart에서 dotenv.load()를 호출하여 .env 파일을 로드한다.

import 'package:flutter/material.dart';
import 'package:flutter_dotenv/flutter_dotenv.dart';

void main() async {
  // 환경 변수 파일 로드
  await dotenv.load();

  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(title: Text("Flutter Dotenv Example")),
        body: Center(
          child: Text("API Key: ${dotenv.env['API_KEY']}"),
        ),
      ),
    );
  }
}

 

dotenv.env['변수명']을 사용하여 .env 파일에 정의한 값을 가져올 수 있다.