Sound Classify Ios Startup

初回メッセージの締め

• 確認事項と進め方を提示したあと、最後に必ず「上記で進めていいですか？（YES / NO）」を入れる。
• YES を得るまでは破壊的・時間のかかるコマンド（flutter clean, pod install, fvm install 等）は実行しない。
• YES なら以降の手順を Bash ツールで順に実行する。NO なら懸念点の解消を優先する。

よくある失敗と対処

JIT クラッシュ（実機 / debug）

症状:

• mprotect failed または Unable to flip between RX and RW memory protection
• 実機の debug でのみ起きる

対処:

• Developer Mode が ON か確認。
• それでも失敗する場合:
  • まず Flutter を 3.41.1+ に更新。
  • まだ落ちるなら --profile / --release で JIT 起因か切り分け:
    • flutter run --profile -d <device-id>
    • flutter run --release -d <device-id>

LaunchServicesDataMismatch（アプリが起動しない）

症状:

• LaunchServices GUID and sequence number do not match expected values

対処:

• 端末からアプリ削除（ユーザー操作）。
• 再ビルド手順は破壊的なので、実行前に一言添えてから流す:
  • flutter clean
  • rm -rf ios/Pods ios/Podfile.lock
  • flutter pub get
  • cd ios && pod install && cd ..
  • flutter run -d <device-id>
• それでも失敗なら端末再起動を案内。

Flutterインストール方針（FVM優先）

• リポジトリは 3.41.1 固定なので、FVMを常に優先。
• fvm install が遅い場合は、初回だけ時間がかかることを伝えて待ってもらう（Bash の timeout を延長するか run_in_background を使う）。

判断指針

• 必ず実機での確認を促す。
• iOS/Xcode が新しいなら 3.41.1+ を前提にする。
• 3.41.1 でも失敗する場合は、iOS/Xcode の版数とログを確認し、profile/releaseで切り分けを案内する。
• iOS/Xcode の版数確認は 最初ではなく失敗時にだけ 行う。
• 推奨は iOS 26 以降、Xcode 26 以降。