【Flutter】`.env` で API キーを安全に管理する方法

Flutter アプリで API キーを使うとき、コード内に 直書きするのは絶対にNG。
GitHub に誤ってアップロードした瞬間、悪用されるリスクが大きくなります。

そこで便利なのが、
環境変数 (.env ファイル) を読み込む方法。

この記事では、Flutter の定番パッケージ
flutter_dotenv を使って、
API キーを安全に管理する方法をわかりやすく解説します。

1. flutter_dotenv を導入する

まずはパッケージを追加します。

# pubspec.yaml
dependencies:
  flutter_dotenv: ^5.2.1

反映：

flutter pub get

2. `.env` ファイルを作成する

プロジェクトの最上位ディレクトリに .env を作ります。

例：

# .env
GOOGLE_MAPS_IOS_KEY=YOUR_IOS_API_KEY
GOOGLE_MAPS_ANDROID_KEY=YOUR_ANDROID_API_KEY
PLACES_API_KEY=YOUR_PLACES_API_KEY

ポイント：

キー名は大文字＋スネークケースが一般的
複数プラットフォーム（iOS / Android）に対応する場合はキーを分ける
改行とスペースに注意

3. .env をアプリ起動時に読み込む

main.dart を次のように書き換えます。

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

Future<void> main() async {
  WidgetsFlutterBinding.ensureInitialized();

  // .env を読み込み
  await dotenv.load(fileName: ".env");

  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(title: const Text('Env Sample App')),
        body: const Center(child: Text('Hello .env')),
      ),
    );
  }
}

これで .env 内の値がアプリ内で使えるようになります。

4. 環境変数を使う（実用例つき）

どこでも次のように呼び出せます。

final iosKey = dotenv.env['GOOGLE_MAPS_IOS_KEY'];
final androidKey = dotenv.env['GOOGLE_MAPS_ANDROID_KEY'];

▼ 実用例：API キーを使って Google Maps SDK を初期化する

import 'dart:io';
import 'package:flutter_dotenv/flutter_dotenv.dart';
import 'package:google_maps_flutter/google_maps_flutter.dart';

class MapConfig {
  static void initialize() {
    final key = Platform.isIOS
        ? dotenv.env['GOOGLE_MAPS_IOS_KEY']
        : dotenv.env['GOOGLE_MAPS_ANDROID_KEY'];

    if (key == null) {
      throw Exception('API Key is not found in .env');
    }

    GoogleMapsFlutterPlatform.instance.initializeWithKey(key);
  }
}

5. `.env` を Git に含めない（超重要）

API キーが GitHub に上がると本当に危険です。

.gitignore に必ず追加してください。

# .gitignore
.env

6. よくあるエラーと原因

エラー内容	主な原因
`dotenv.env が null`	`.env` の読み込み前にアクセスしている
`.env が読み込まれない`	`fileName: ".env"` になっていない
API キーが反映されない	iOS の AppDelegate 設定漏れ / Android の Manifest 設定漏れ
実機では動くがビルドでは落ちる	`.env` の名前違い or 配置ミス

必要なら iOS / Android の Maps SDK 設定も追記できます。

7. まとめ（コピペ用）

① flutter_dotenv を追加  
② .env に API キーを記述  
③ main.dart で dotenv.load()  
④ dotenv.env['KEY_NAME'] で利用  
⑤ .gitignore に .env を追加

Flutter では API キーを安全に扱うことがとても重要です。
.env 管理を導入すると、セキュリティだけでなくアプリの保守性も上がります。