‹ Platforms
Flutter troubleshooting
Fix Flutter plugin build and runtime errors by symptom.
| Symptom | Cause | Fix |
|---|---|---|
UnsatisfiedLinkError on an emulator | the engines are arm64-v8a only | run on a physical arm64 phone |
| The app shows a refusal and asks for a secret | no API secret, or a rejected one | enter a valid API secret, or build with --dart-define=BITHUMAN_ |
Manifest merge fails on minSdk | Essence 2 needs minSdk 29 | raise the app to 29 |
pod install fails on iOS or macOS | the deployment target is below iOS 16 or macOS 13 | raise the Podfile platform and the Runner targets |
| The iOS or macOS build cannot find the engines | the bootstrap step was skipped | run scripts/ in the plugin’s folder, then build again |
A macOS link error names llama or onnxruntime | the Homebrew libraries are missing | brew install llama. |