Add Breaking Change for macOS Entitlement Requirement

[vicajilau]

Pull Request: Add Breaking Change for macOS Entitlement Requirement

Description

This pull request introduces a breaking change for macOS users of the flutter_file_picker package.

Breaking Change

Starting from version 8.3.0, the pickFiles() method now requires the entitlement com.apple.security.files.user-selected.read-only on macOS. If this entitlement is not present, the method will return null and the file picker will not open, potentially leading to confusion among developers upgrading from previous versions where this entitlement was not required.

Justification

• This change was introduced silently in version 8.3.0 without clear documentation, which can cause issues for developers who may not be aware of the requirement.
• To ensure a smooth transition and proper functionality of the file picker on macOS, it is crucial to document this change as breaking in the changelog and update the API documentation accordingly.

Changes Made

• Updated the CHANGELOG.md to include the breaking change notice.
• Recommended that users add the entitlement to both DebugProfile.entitlements and Release.entitlements to restore the expected functionality.

Related Issue

• Reference to issue: [macOS] pickFiles always returns null after updating to 8.3.0 #1706

Additional Notes

• Future updates should include a warning or error message when the entitlement is missing to improve user experience.

[navaronbracke]

This was added on the Wiki: https://github.com/miguelpruivo/flutter_file_picker/wiki/Setup#macos

Maybe add a See also: https://github.com/miguelpruivo/flutter_file_picker/wiki/Setup#macos instead of pointing to the linked PR ?

[vicajilau]

Makes sense! I didn't see it. On its way

[navaronbracke]

@vicajilau Apologies, but due to the other change that just landed, this is now in the wrong place.

Can you put it at the bottom of

## 8.2.0
### Desktop (macOS)
- Reimplement macOS file picker using method channels ...

[vicajilau]

@navaronbracke Fixed 💪

[vicajilau]

Resolved @navaronbracke 🚀

[navaronbracke]

@vicajilau Apologies, but due to the other change that just landed, this is now in the wrong place.

Can you put it at the bottom of

## 8.2.0
### Desktop (macOS)
- Reimplement macOS file picker using method channels ...

[navaronbracke]

@vicajilau I adjusted the changelog note a little, so that it is in bold in the markdown