Skip to content

Installation Guide.md

Paraccoli edited this page Jun 22, 2025 · 1 revision

📦 MoneyG Finance App - インストールガイド

プラットフォーム別インストール手順の完全ガイド


🎯 インストールガイドについて

このガイドでは、MoneyG Finance Appを各プラットフォームにインストールする方法を詳しく説明します。初めてインストールする方から、技術的な知識をお持ちの方まで、安全で確実なインストールができるよう段階的に解説しています。

📋 対応プラットフォーム

  • 🤖 Android: APKファイル、Google Play Store(予定)
  • 🍎 iOS: App Store(未定)
  • 🌐 Web: ブラウザ版(未定)
  • 💻 Desktop: Windows、macOS、Linux(未定)

🔒 インストール前の注意事項

  • 📱 端末要件: 対応OS・RAM・ストレージ容量の確認
  • 🛡️ セキュリティ: 公式リリースページからのダウンロードを推奨
  • 🔄 バックアップ: 既存データがある場合は事前にバックアップ
  • 🌐 ネットワーク: ダウンロード時の安定したインターネット接続

🤖 Android インストール

システム要件

最小要件

OS: Android 5.0 (API Level 21) 以降
RAM: 2GB以上
ストレージ: 100MB以上の空き容量
CPU: ARMv7またはARM64アーキテクチャ

推奨要件

OS: Android 7.0 (API Level 24) 以降
RAM: 4GB以上
ストレージ: 500MB以上の空き容量
CPU: ARM64-v8a(64bit)
解像度: 1080x1920以上

インストール方法1: APKファイル(推奨)

Step 1: APKファイルのダウンロード

  1. 公式リリースページにアクセス

    URL: https://github.com/paraccoli/flutter_finance_app/releases
    
  2. 最新バージョンを選択

    最新版: v1.3.0
    ファイル名: MoneyG-Finance-v1.3.0-android.apk
    ファイルサイズ: 約27MB
    
  3. ダウンロードの実行

    - ブラウザでダウンロードリンクをタップ
    - ダウンロード完了まで待機
    - ファイルの整合性を確認(任意)
    

Step 2: セキュリティ設定の変更

  1. 不明なソースからのインストールを許可

    Android 8.0以降:
    設定 → アプリと通知 → 特別なアプリアクセス → 不明なアプリのインストール
    → Chrome(またはダウンロードアプリ)→ この提供元のアプリを許可
    
    Android 7.1以前:
    設定 → セキュリティ → 不明なソース → チェックを入れる
    
  2. セキュリティ警告の確認

    ⚠️ 警告内容:
    「不明なアプリのインストールによりデバイスやデータが損害を受ける可能性があります」
    
    ✅ 対応:
    - 公式GitHubからのダウンロードであることを確認
    - ウイルススキャンの実行(推奨)
    - 「OK」または「許可」をタップ
    

Step 3: APKファイルのインストール

  1. ファイルマネージャーから実行

    方法1: 通知からインストール
    - ダウンロード完了通知をタップ
    - 「インストール」をタップ
    
    方法2: ファイルアプリから実行
    - ファイルアプリを開く
    - Download フォルダを開く
    - MoneyG-Finance-v1.3.0-updated.apk をタップ
    
  2. インストール権限の確認

    要求される権限:
    ✓ ストレージ: データの保存・読み込み
    ✓ ファイルアクセス: バックアップ・エクスポート
    ✓ ネットワーク: アップデート確認(任意)
    
    すべて「許可」を選択してください
    
  3. インストール完了の確認

    成功メッセージ: 「アプリがインストールされました」
    - 「開く」をタップしてアプリを起動
    - または「完了」をタップして後で起動
    

Step 4: 初回起動とセットアップ

  1. アプリの起動

    - ホーム画面またはアプリドロワーからアイコンをタップ
    - スプラッシュ画面の表示確認
    - 初期設定画面の表示
    
  2. 初期設定の実行

    設定項目:
    1. 言語選択(日本語/英語)
    2. 通貨設定(JPY推奨)
    3. テーマ選択
    4. プライバシー設定の確認
    5. バックアップ設定(任意)
    

トラブルシューティング

インストールエラーの対処

エラー1: 「アプリはインストールされませんでした」
原因: 不明なソースが無効
解決: 
1. 設定 → セキュリティ → 不明なソース → 有効
2. アプリごとの設定で Chrome/ファイルマネージャーを許可
エラー2: 「パッケージが無効です」
原因: APKファイルの破損または互換性問題
解決:
1. APKファイルを再ダウンロード
2. ダウンロード元の確認(公式GitHubか)
3. 端末のアーキテクチャ確認(arm64-v8a推奨)
エラー3: 「容量不足」
原因: ストレージ容量不足
解決:
1. 不要なファイル・アプリを削除
2. キャッシュのクリア
3. 最低100MB以上の空き容量確保

起動に失敗する場合

問題: アプリがクラッシュする
診断手順:
1. 端末を再起動
2. 他のアプリを終了してメモリ確保
3. アプリのキャッシュクリア
4. 最新版への更新確認

詳細: Troubleshooting.md を参照

🔄 アップデート方法

Android APK版

手動アップデート

1. 新バージョンのリリース確認
   - GitHub Releases ページをチェック
   - アプリ内通知の確認

2. 新しいAPKのダウンロード
   - 最新版APKをダウンロード
   - 既存アプリの上にインストール

3. データの引き継ぎ
   - 既存データは自動的に保持
   - 設定・テーマも引き継がれる

自動アップデート通知

設定 → アプリ更新 → 自動確認
- 新バージョンの通知受信
- WiFi接続時の自動ダウンロード(任意)
- インストール前の確認ダイアログ

ストア版(予定)

Google Play Store / App Store:
- 自動更新の設定
- 手動での更新確認
- アップデート履歴の確認

🔐 セキュリティ・認証

APKファイルの検証

SHA256ハッシュ確認

公式APKのハッシュ値:
MoneyG-Finance-v1.3.0-android.apk
SHA256: [リリースページで確認]

検証方法 (Android):
1. ハッシュ確認アプリをインストール
2. ダウンロードしたAPKのハッシュを計算
3. 公式ハッシュ値と比較

デジタル署名確認

署名者: MoneyG Finance Development Team
証明書: Google Play App Signing
有効期限: 2030年まで

確認方法:
設定 → アプリ → MoneyG Finance → 詳細情報 → 証明書情報

ウイルススキャン

推奨スキャン方法:
1. Google Play Protect での自動スキャン
2. サードパーティ製ウイルス対策アプリ
3. オンラインスキャンサービス(VirusTotal等)

安全性の確認:
- 公式GitHubからのダウンロード
- デジタル署名の有効性
- ウイルススキャン結果

📋 インストール後の確認

動作確認チェックリスト

基本機能

✓ アプリの正常起動
✓ 初期設定画面の表示
✓ データ入力テスト
✓ 画面遷移の確認
✓ 設定項目の確認

権限設定

✓ ストレージアクセス権限
✓ ファイル読み書き権限
✓ 通知権限(任意)
✓ ネットワークアクセス権限(任意)

パフォーマンス

✓ 起動時間: 3秒以内
✓ 画面切り替え: スムーズな動作
✓ データ保存: 即座に反映
✓ メモリ使用量: 100MB以下(通常時)

問題が発生した場合

🔧 トラブルシューティング:
1. Troubleshooting.md を参照
2. FAQ.md で類似問題を検索
3. GitHub Issues で報告

📞 サポート:
- GitHub Discussions でコミュニティに質問
- 問題報告時は環境情報を含める
- スクリーンショットの添付(推奨)

🗑️ アンインストール方法

Android

通常のアンインストール

方法1: 設定アプリから
1. 設定 → アプリ → MoneyG Finance
2. 「アンインストール」をタップ
3. 確認ダイアログで「OK」

方法2: ホーム画面から
1. アプリアイコンを長押し
2. 「アンインストール」を選択
3. 確認ダイアログで「OK」

データの完全削除

⚠️ 注意: データは完全に削除されます

事前準備:
1. 重要なデータのバックアップ
2. CSVエクスポートの実行
3. カスタムテーマの保存

削除手順:
1. 通常のアンインストール実行
2. ファイルマネージャーで残存ファイル確認
3. /Android/data/com.example.moneyg_finance/ の削除
4. /Download/MoneyG/ フォルダの確認・削除

iOS(予定)

1. ホーム画面でアプリアイコンを長押し
2. 「Appを削除」を選択
3. 「削除」で確認
4. iCloudからの削除も選択(任意)

📚 関連リソース

公式ドキュメント

外部リンク

コミュニティ


📄 変更履歴

v1.3.0(2025年6月22日)

✨ 新機能:
- カスタムテーマ作成機能
- テーマ管理システム
- 高度なエクスポート機能

🔧 改善:
- パフォーマンス最適化
- UI/UX改善
- セキュリティ強化

📱 対応:
- Android 14対応
- 新しいアーキテクチャ対応

v1.2.0(2025年5月15日)

✨ 新機能:
- 予算管理機能
- グラフ・チャート表示
- CSVエクスポート機能

🐛 修正:
- データ保存の安定性向上
- メモリリーク修正

📝 最終更新: 2025年6月22日
📄 ドキュメントバージョン: v1.3.0
👥 編集者: @paraccoli


📦 ヒント: インストールに関する質問や問題がある場合は、GitHub Discussionsでお気軽にお尋ねください!

Clone this wiki locally