3.1 KiB

Raw Blame History

セキュリティセットアップガイド

このドキュメントは、開発環境でAPIキーを安全に管理するための手順を説明します。

🔐 初回セットアップ（必須）

Step 1: 新しいAPIキーを発行

Google AI Studio にアクセス
重要: 既存のキー AIzaSy... が表示されている場合は、必ず無効化してください
新しいAPIキーを発行（「Create API Key」ボタン）
発行されたキーをクリップボードにコピー

Step 2: ローカル設定ファイルを作成

# プロジェクトルートで実行
cd c:\Users\maita\posimai-project\ponshu_room_lite

# テンプレートをコピー
cp lib/secrets.local.dart.example lib/secrets.local.dart

Step 3: APIキーを設定

lib/secrets.local.dart をエディタで開き、以下のように編集:

class SecretsLocal {
  /// あなたのGemini APIキーをここに設定してください
  static const String geminiApiKey = 'AIzaSy...YOUR_NEW_KEY_HERE';

  /// ローカル開発時のAI Proxy URL（オプション）
  static const String aiProxyBaseUrl = 'http://100.76.7.3:8080';
}

注意: lib/secrets.local.dart は .gitignore に含まれているため、Gitにコミットされません。

🚀 アプリの起動

開発時（ローカル設定を使用）

flutter run

lib/secrets.local.dart が存在すれば、自動的にそこからAPIキーを読み込みます。

リリースビルド時（環境変数を使用）

flutter build apk --dart-define=GEMINI_API_KEY=AIzaSy...YOUR_KEY

✅ セキュリティチェックリスト

Step 1: 古いAPIキー（AIzaSyARuYSPqMLXz51hYnWN4gkL9vA4lA-CMmQ）を無効化
Step 2: lib/secrets.local.dart を作成し、新しいAPIキーを設定
Step 3: lib/secrets.local.dart がGitにコミットされていないことを確認
```
git status | grep secrets.local.dart
# 何も表示されなければOK
```
Step 4: アプリが正常に起動することを確認
```
flutter run
```

🔍 トラブルシューティング

エラー: `Gemini API Key is missing`

原因: APIキーが設定されていません

解決方法:

lib/secrets.local.dart が存在するか確認
ファイル内の geminiApiKey が空文字列でないか確認
アプリを再起動

エラー: `AI解析エラー(Direct): API key not valid`

原因: APIキーが無効です