77 lines
2.3 KiB
Markdown
77 lines
2.3 KiB
Markdown
|
# デバッグ手順
|
|||
|
|
|
|||
|
|
## エラーが発生した場合
|
|||
|
|
|
|||
|
|
### 1. フィルタリングされたログを取得
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
# Gemini APIのエラーのみ表示
|
|||
|
|
flutter logs | findstr /i "gemini api error"
|
|||
|
|
|
|||
|
|
# または、すべてのエラーを表示
|
|||
|
|
flutter logs | findstr /i "error exception"
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 2. 詳細ログを取得
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
# Flutter Inspectorを有効化してログを詳細表示
|
|||
|
|
flutter run --verbose > debug_log.txt 2>&1
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 3. APIキーの確認
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
# secrets.local.dart の内容を確認（APIキーは表示されません）
|
|||
|
|
type lib\secrets.local.dart | findstr /i "geminiApiKey"
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 4. キャッシュのクリア
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
# Hiveキャッシュをクリア（アプリ内の開発者メニューから）
|
|||
|
|
# または、アプリをアンインストールして再インストール
|
|||
|
|
flutter clean
|
|||
|
|
flutter pub get
|
|||
|
|
flutter run
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## よくあるエラーと解決策
|
|||
|
|
|
|||
|
|
### Error 1: "API key not valid"
|
|||
|
|
**原因**: APIキーが無効、または設定されていない
|
|||
|
|
**解決策**:
|
|||
|
|
1. Google AI Studioで新しいキーを発行
|
|||
|
|
2. lib/secrets.local.dart に正しく設定されているか確認
|
|||
|
|
3. `flutter run` を再実行
|
|||
|
|
|
|||
|
|
### Error 2: "Rate limit exceeded"
|
|||
|
|
**原因**: 1日の制限（20回）に達した
|
|||
|
|
**解決策**:
|
|||
|
|
1. 開発者メニューでキャッシュサイズを確認
|
|||
|
|
2. 同じ画像を再度選択（キャッシュヒットするはず）
|
|||
|
|
3. 明日まで待つ、またはOllama統合を実装
|
|||
|
|
|
|||
|
|
### Error 3: "Empty response from Gemini"
|
|||
|
|
**原因**: Gemini APIが応答を返さなかった
|
|||
|
|
**解決策**:
|
|||
|
|
1. ネットワーク接続を確認
|
|||
|
|
2. 画像サイズを確認（圧縮後100KB前後が推奨）
|
|||
|
|
3. 再試行ボタンをタップ
|
|||
|
|
|
|||
|
|
### Error 4: "Lost connection to device"
|
|||
|
|
**原因**: USBケーブルの物理的な切断、またはデバイスのスリープ
|
|||
|
|
**解決策**:
|
|||
|
|
1. USBケーブルを再接続
|
|||
|
|
2. デバイスのスリープ設定を「なし」に変更
|
|||
|
|
3. `flutter devices` でデバイスが認識されているか確認
|
|||
|
|
4. `flutter run` を再実行
|
|||
|
|
|
|||
|
|
## 問題が解決しない場合
|
|||
|
|
|
|||
|
|
以下の情報を提供してください：
|
|||
|
|
1. `flutter doctor -v` の出力
|
|||
|
|
2. `flutter logs` の最後の100行
|
|||
|
|
3. エラーメッセージのスクリーンショット
|
|||
|
|
4. 実行した操作の詳細（どの画面で、何をした時にエラーが出たか）
|