Sound Classify Ios Startup

初回メッセージの締め

• 確認事項と進め方を提示したあと、最後に必ず「上記で進めていいですか？（YES / NO）」を入れる。
• YES の場合は、以降の手順を AI側で順に実行 する。
• 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 が遅い場合は、初回だけ時間がかかることを伝えて待ってもらう。

判断指針

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