Skip to content
Skills Library
Programming · Building & coding

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.

Licence
AGPL-3.0
Last repository change
27.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
3
Deprecation

No signals detected. Repository changed on 27.10.2026, without references to retired models or APIs.

Licence

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

Ambiguous use of
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

  1. Problem
  2. Context / Trigger Conditions
  3. Solution
  4. Verification
  5. Example
  6. Notes
  7. References
Original SKILL.md headings · 102 lines, 365 words
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.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.