flutter-macos-duplicate-camera-plugin
/flutter-macos-duplicate-camera-plugin
Fix Flutter macOS build failure caused by duplicate camera plugins. Use when: (1) macOS build fails with "Ambiguous use of 'CameraMacosPlugin.register(with:)'" error, (2) Both camera_macos and camera_macos_plus are in pubspec.yaml, (3) Build worked before adding a new camera package. The plugins define the same class name causing Swift registration conflicts.
- Author
- divinevideo ↗
- Repository
- divine-mobile ↗
- Licence
- AGPL-3.0
- Last repository change
- 27.10.2026
Assessment and security
- Files in this package
- 1
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 3
No signals detected. Repository changed on 27.10.2026, without references to retired models or APIs.
AGPL-3.0, copyleft: przeróbki udostępniane innym muszą mieć tę samą licencję.
What it does and when to use it
Fix Flutter macOS build failure caused by duplicate camera plugins. Use when: (1) macOS build fails with "Ambiguous use of 'CameraMacosPlugin.register(with:)'" error, (2) Both camera_macos and camera_macos_plus are in pubspec.yaml, (3) Build worked before adding a new camera package. The plugins define the same class name causing Swift registration conflicts.
Triggers from the description
Original author description
Fix Flutter macOS build failure caused by duplicate camera plugins. Use when: (1) macOS build fails with "Ambiguous use of 'CameraMacosPlugin.register(with:)'" error, (2) Both camera_macos and camera_macos_plus are in pubspec.yaml, (3) Build worked before adding a new camera package. The plugins define the same class name causing Swift registration conflicts.
How it works
- Problem
- Context / Trigger Conditions
- Solution
- Verification
- Example
- Notes
- References
SKILL.md preview
---
name: flutter-macos-duplicate-camera-plugin
description: |
Fix Flutter macOS build failure caused by duplicate camera plugins. Use when: (1) macOS build
fails with "Ambiguous use of 'CameraMacosPlugin.register(with:)'" error, (2) Both camera_macos
and camera_macos_plus are in pubspec.yaml, (3) Build worked before adding a new camera package.
The plugins define the same class name causing Swift registration conflicts.
author: Claude Code
version: 1.0.0
date: 2025-01-28
---
# Flutter macOS Duplicate Camera Plugin Fix
## Problem
Flutter macOS builds fail when both `camera_macos` and `camera_macos_plus` packages are present
in pubspec.yaml. Both packages define the same `CameraMacosPlugin` class, causing Swift
registration ambiguity.
## Context / Trigger Conditions
**Error message:**
```
Ambiguous use of 'CameraMacosPlugin.register(with:)'
```
**Symptoms:**
- macOS build fails during Swift compilation
- iOS build may still succeed (different plugin implementations)
- Error occurs in the generated plugin registration code
- May be accompanied by Xcode build system crashes or "stat cache file not found" errors
**Common scenarios:**
- Project has `camera_macos` for basic camera support
- Added `camera_macos_plus` for additional features
- Transitive dependency pulled in duplicate plugin
- Copied pubspec.yaml from another project with different camera requirements
## Solution
1. **Identify the duplicates** - Check pubspec.yaml for both packages:
```yaml
# Look for these:
camera_macos: ^0.0.9
camera_macos_plus: ^0.0.3
```
2. **Choose one to keep** - `camera_macos_plus` is generally preferred as it's a
more feature-complete fork of `camera_macos`
3. **Remove the duplicate** from pubspec.yaml:
```yaml
# Keep only one:
camera_macos_plus: ^0.0.3 # macOS camera support
```
4. **Clean thoroughly** - The Xcode build system may be in a corrupted state:
```bash
flutter clean
rm -rf build/
rm -rf macos/Pods/
rm -f macos/Podfile.lock
rm -rf ~/Library/Developer/Xcode/DerivedData/Runner-*
flutter pub get
```
5. **Rebuild:**
```bash
flutter build macos
```
## Verification
After the fix:
- `flutter build macos` completes successfully
- No "Ambiguous use" errors in build output
- The macOS app launches and camera functionality works
## Example
**Before (broken):**
```yaml
dependencies:
camera_macos_plus: ^0.0.3
divine_camera:
path: packages/divine_camera
camera_macos: ^0.0.9 # DUPLICATE - causes conflict
```
**After (fixed):**
```yaml
dependencies:
camera_macos_plus: ^0.0.3 # macOS camera support (replaces camera_macos)
divine_camera:
path: packages/divine_camera
# camera_macos removed
```
## Notes
- `camera_macos_plus` is a community fork with additional features
- If you specifically need `camera_macos` instead, remove `camera_macos_plus`
- Check transitive dependencies with `flutter pub deps` if duplicates reappear
- The Xcode build system can get into corrupted states after this error;
thorough cleaning (including DerivedData) may be required
- This is specific to macOS - iOS uses different camera plugin implementations
## References
- [camera_macos_plus on pub.dev](https://pub.dev/packages/camera_macos_plus)
- [camera_macos on pub.dev](https://pub.dev/packages/camera_macos)
- [Flutter macOS plugin registration](https://docs.flutter.dev/packages-and-plugins/developing-packages#macos)
Versions
The database has no other skills named flutter-macos-duplicate-camera-plugin.
Identical content appears in 1 other GitHub folders. We show one copy with the highest score.
Database snapshot: 13.11.2026 · package version e557f2a6543a (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 100flutter-macos-permission-handler-camera-failure
Fix silent camera/microphone failure on Flutter macOS when using permission_handler plugin. Use when: (1) Camera screen shows placeholder but no error on macOS, (2) CameraPermissionError state is emitted but cause is unclear, (3) permission_handler checkCameraStatus() or… - 100flutter-setting-up-on-macos
Sets up a macOS environment for Flutter development. Use when configuring a macOS machine to run, build, or deploy Flutter applications for iOS or macOS. - 100flutter-spm
Use when migrating iOS and macOS Flutter plugin dependencies from CocoaPods to Swift Package Manager (SPM). - 100build-licenseseat-swift
Use if integrating the LicenseSeat Swift SDK into a macOS/Swift app — activation, validation, seats. - 100flutter-macos-tcc-responsible-process-camera-denial
Fix black camera/microphone preview in Flutter macOS apps launched via `flutter run` from a terminal emulator (cmux, iTerm, Terminal.app, VS Code integrated terminal, Cursor, etc.). Use when: (1) camera plugin reports initialized but preview is black with no frames, (2) logs… - 100flutter-setup-localization
Add `flutter_localizations` and `intl` dependencies, enable "generate true" in `pubspec.yaml`, and create an `l10n.yaml` configuration file. Use when initializing localization support for a new Flutter project.