ffmpeg-kit-macos-codesign-crash

name	ffmpeg-kit-macos-codesign-crash
description	Fix Flutter macOS app crash at launch due to FFmpeg Kit library loading failure. Use when: (1) macOS app builds successfully but crashes immediately on launch, (2) Crash log shows "Library not loaded: libfontconfig.1.dylib" or similar homebrew library, (3) Error mentions "code signature not valid for use in process" with "different Team IDs", (4) Using ffmpeg_kit_flutter_new (Full GPL variant). The Full GPL variant has external dependencies on homebrew libraries that fail macOS code signing. Switch to ffmpeg_kit_flutter_new_min.
author	Claude Code
version	1.0.0
date	"2025-01-25T00:00:00.000Z"

FFmpeg Kit macOS Code Signing Crash

Problem

Flutter macOS app builds successfully but crashes immediately at launch with a library loading failure. The crash is caused by FFmpeg Kit's Full GPL variant having runtime dependencies on homebrew-installed libraries (like fontconfig) that fail macOS code signature validation.

Context / Trigger Conditions

• Platform: macOS only (iOS and Android are not affected)
• Package: Using ffmpeg_kit_flutter_new (Full GPL variant)
• Symptom: App builds successfully but crashes on launch