-
Notifications
You must be signed in to change notification settings - Fork 2
Troubleshooting.md
Paraccoli edited this page Jun 22, 2025
·
1 revision
技術的問題の診断・解決ガイド
このトラブルシューティングガイドは、MoneyG Finance Appで発生する可能性のある技術的問題の診断と解決方法を提供します。段階的なアプローチで問題を特定し、効果的な解決策を見つけることができます。
- 🚀 起動・インストール: アプリの起動やインストールに関する問題
- 💾 データ関連: データベース、バックアップ、同期の問題
- 🎨 UI・表示: 画面表示、テーマ、レイアウトの問題
- ⚡ パフォーマンス: 動作速度、メモリ、応答性の問題
- 🔒 セキュリティ: 認証、ロック、権限に関する問題
- 📤 エクスポート・共有: データ出力、ファイル操作の問題
- 症状の特定: 具体的な問題の把握
- 環境確認: 端末・OS・アプリバージョンの確認
- 基本対処: 簡単な解決策の試行
- 詳細診断: ログ確認・詳細調査
- 高度な対処: 再インストール・設定リセット
- アプリアイコンをタップしても何も起こらない
- スプラッシュ画面で止まる
- 起動後すぐにクラッシュする
✓ 端末の再起動を実行
✓ 他のアプリを終了してメモリを確保
✓ ストレージ容量を確認（最低1GB必要）
✓ 端末の日時設定を確認
設定 → アプリ → MoneyG Finance App → 詳細情報
- バージョン情報の確認
- 最終更新日の確認
- 権限設定の確認
Android:
設定 → アプリ → MoneyG Finance App → ストレージ → キャッシュを削除
iOS:
設定 → 一般 → iPhoneストレージ → MoneyG Finance → Appを取り除く
-
強制終了と再起動
Android: 最近のアプリから MoneyG Finance を上にスワイプ iOS: ホームボタン2回押し → アプリを上にスワイプ -
メモリ解放
- 不要なアプリを終了 - ブラウザのタブを閉じる - バックグラウンドアプリの制限 -
ストレージ確認
必要容量: 100MB以上の空き容量 確認方法: 設定 → ストレージ → 使用可能容量
- APKファイルがインストールされない
- 「不明なソース」エラーが表示される
- 「パッケージが無効」エラーが発生する
1. 設定 → セキュリティ → 不明なソースからのアプリ → 有効
2. 設定 → アプリ → Chrome/ファイルマネージャー → インストール許可 → 有効
3. 開発者オプション → USBデバッグ → 有効（必要に応じて）
✓ ファイルサイズ: 25-30MB
✓ ファイル名: MoneyG-Finance-v1.3.0.apk
✓ ダウンロード元: 公式GitHubリリースページ
✓ チェックサム: SHA256ハッシュの確認
最小要件:
- Android 5.0 (API Level 21) 以降
- RAM: 2GB以上
- アーキテクチャ: arm64-v8a または armeabi-v7a
- OpenGL ES: 2.0以降
- 入力したデータが見つからない
- 取引記録が表示されない
- データベースエラーが発生する
1. 最新の取引一覧を確認
2. フィルター設定（日付・カテゴリ）をリセット
3. 別の画面から同じデータを検索
4. 設定 → データ統計で総件数を確認
設定 → データ管理 → データベース診断
- テーブル構造の確認
- インデックスの整合性
- 外部キー制約の検証
-
アプリ再起動
- アプリを完全に終了 - 5秒待機 - アプリを再起動 -
データ同期
設定 → データ管理 → 手動同期実行 - ローカルデータの確認 - 一時ファイルの整理 -
権限確認
設定 → アプリ → MoneyG Finance → 権限 - ストレージ: 許可 - ファイルアクセス: 許可
必要条件:
- 空き容量: データサイズの2倍以上
- 書き込み権限: 外部ストレージアクセス
- ファイル形式: .db, .csv, .json
1. 設定 → データ管理 → バックアップ作成
2. 保存場所を選択（内部/外部ストレージ）
3. ファイル形式を選択
4. 暗号化オプションの設定
5. バックアップの実行と検証
対応ファイル:
- .db: SQLiteデータベース（推奨）
- .csv: カンマ区切りテキスト
- .json: JSON形式エクスポート
1. バックアップファイルの選択
2. ファイル形式の自動検出
3. データの事前検証
4. 復元オプションの選択（上書き/統合）
5. 復元の実行と確認
- テーマ変更後も古いデザインのまま
- 一部の要素だけ色が変わらない
- カスタムテーマの設定が反映されない
設定 → テーマ → キャッシュクリア
- UIキャッシュの削除
- スタイルシートの再読み込み
- カスタムCSS設定のリセット
1. 設定 → テーマ → デフォルト選択
2. アプリを完全に終了
3. アプリを再起動
4. 希望のテーマを再選択
円グラフ: 最低2つ以上のカテゴリデータ
棒グラフ: 最低1つ以上のデータ
折れ線グラフ: 最低2つ以上の時系列データ
1. 期間設定の確認
2. データフィルターの解除
3. グラフタイプの変更
4. データ量の制限確認
設定 → システム情報 → パフォーマンス診断
- CPU使用率の確認
- メモリ使用量の測定
- ストレージI/O速度
- バッテリー消費量
設定 → データ管理 → データベース最適化
- インデックスの再構築
- 古いデータのアーカイブ
- 一時ファイルの削除
設定 → 表示設定 → パフォーマンス優先
- アニメーション: 無効または最小限
- エフェクト: 無効
- 画質: 標準
症状:
- アプリが突然終了
- 「メモリ不足」エラーメッセージ
- 動作が極端に遅い
即座の対処:
1. 他のアプリを全て終了
2. 端末を再起動
3. MoneyG Financeを再起動
設定 → パフォーマンス → メモリ管理
- 自動メモリクリア: 有効
- 低メモリモード: 有効
- キャッシュサイズ制限: 50MB以下
確認項目:
✓ 端末の指紋認証が有効
✓ 指紋センサーの清掃
✓ 登録済み指紋の動作確認
対処方法:
設定 → セキュリティ → 指紋認証
- 指紋の再登録
- 複数指紋の登録
- フォールバック認証の設定
設定 → セキュリティ → 顔認証
- 明るい環境での再登録
- 複数角度での顔登録
- メガネあり/なしの両方登録
PINを忘れた場合:
1. 生体認証でアクセス（設定済みの場合）
2. セキュリティ質問での本人確認
3. 最終手段: データバックアップ後の初期化
エラー: "暗号化キーが見つかりません"
対処方法:
1. アプリの完全終了・再起動
2. 端末の再起動
3. 設定 → セキュリティ → 暗号化キー再生成
Android権限確認:
設定 → アプリ → MoneyG Finance → 権限
- ストレージ: 許可
- ファイルアクセス: 許可
- メディアとファイル: 許可
保存先ディレクトリ:
- デフォルト: /Download/MoneyG/
- カスタム: 設定 → エクスポート → 保存先変更
推奨設定:
- 1回のエクスポート: 10,000件以下
- 期間分割: 年単位または月単位
- ファイル形式: CSV（軽量）、JSON（詳細）
高度な設定:
設定 → エクスポート → 詳細設定
- ストリーミングエクスポート: 有効
- チャンクサイズ: 1000件
- 圧縮: 有効
確認項目:
1. デフォルトメールアプリの設定
2. メールアカウントの有効性
3. ファイルサイズ制限（通常25MB以下）
対処方法:
- ファイルを分割してエクスポート
- 圧縮オプションを有効にする
- クラウドストレージ経由での共有
Google Drive接続エラー:
1. Googleアカウントログイン状態確認
2. 設定 → アカウント → Google → 同期確認
3. 設定 → クラウド連携 → 再認証実行
設定 → システム → ビルド番号を7回タップ
→ 開発者オプションが有効化
設定 → 開発者オプション → USBデバッグ → 有効
設定 → システム → ログビューア
- エラーレベル: ERROR, WARN, INFO
- フィルタ: MoneyG, Flutter, SQLite
- 期間: 24時間、7日間、30日間
# ADBを使用
adb logcat | grep -E "(MoneyG|Flutter|ERROR)"
adb logcat -s MoneyG:V Flutter:V設定 → 開発者オプション → データベースブラウザ
- テーブル一覧の表示
- SQL クエリの実行
- データの直接編集（高度な設定）
📱 デバイス情報:
- 機種: [例: Samsung Galaxy S21]
- OS: [例: Android 12]
- RAM: [例: 8GB]
- ストレージ空き容量: [例: 15GB]
📲 アプリ情報:
- バージョン: [例: v1.3.0]
- インストール方法: [APK/Store]
- インストール日: [例: 2025年6月1日]
- 最終更新日: [例: 2025年6月15日]
🐛 問題の説明:
- 発生タイミング: [いつから/どの操作で]
- 頻度: [毎回/時々/初回のみ]
- 再現手順: [1.○○ → 2.○○ → 3.○○]
- エラーメッセージ: [正確な文言]
- 期待動作: [本来どうなるべきか]
- 実際の動作: [現在どうなっているか]
設定 → システム → 診断レポート生成
含まれる情報:
- システム情報
- エラーログ（過去7日間）
- パフォーマンス統計
- 設定状況
- データベース統計
URL: https://github.com/paraccoli/flutter_finance_app/issues
報告内容:
1. 問題の概要（タイトル）
2. 詳細な説明
3. 再現手順
4. 期待される動作
5. 実際の動作
6. 環境情報
7. スクリーンショット（あれば）
GitHub Discussions:
https://github.com/paraccoli/flutter_finance_app/discussions
内容:
- 一般的な質問
- 使用方法の相談
- 機能要望の議論
推奨作業:
✓ アプリのアップデート確認
✓ バックアップの作成
✓ ストレージ容量の確認
✓ パフォーマンス統計の確認
詳細チェック:
✓ 全機能の動作確認
✓ データの整合性チェック
✓ セキュリティ設定の見直し
✓ 古いデータのアーカイブ
設定 → パフォーマンス:
- 自動最適化: 有効
- キャッシュサイズ: 100MB
- アニメーション: 標準
- バックグラウンド更新: 有効
設定 → セキュリティ:
- アプリロック: PIN + 生体認証
- 自動ロック: 5分
- データ暗号化: 有効
- バックアップ暗号化: 有効
- FAQ: よくある質問と回答
- ユーザーガイド: 基本的な使用方法
- 開発環境セットアップ: 開発者向け情報
- API リファレンス: 技術仕様
- GitHubリポジトリ: ソースコードとIssues
- リリースページ: 最新版ダウンロード
- プライバシーポリシー: データ保護方針
- Discussions: コミュニティサポート
- Contributing Guide: 貢献ガイド
📝 最終更新: 2025年6月22日
📄 ドキュメントバージョン: v1.3.0
👥 編集者: @paraccoli
🔧 注意: 問題が解決しない場合や、より詳細なサポートが必要な場合は、GitHub Issuesまでお気軽にお問い合わせください。