feat!: add support for Swift Package Manager (SPM)

[mrehan27]

Summary

This PR adds support for Swift Package Manager (SPM).

Changes

Includes previously approved/merged PRs:

• chore: rename amiapp_flutter to flutter_sample_spm #325
• chore: add flutter_sample_cocoapods app with symlinked shared code #326
• ci: update workflows and docs for sample app builds #327
• chore: restructure iOS plugin for SPM support #322
• chore: migrate sample app to use spm #329
• chore: modules optional with flags #331
• chore: remove pods from spm sample #332
• chore: common permission handler for sample apps #333

---

Note

Medium Risk
Moderate risk because it rewires CI build/release workflows and introduces a new SPM-based iOS build path; failures would primarily impact automation and sample app packaging rather than the core plugin runtime.

Overview
Adds two new sample apps under apps/—flutter_sample_spm (primary, SPM-based iOS) and flutter_sample_cocoapods (secondary)—and removes the old apps/amiapp_flutter project.

Updates GitHub Actions to build/test these apps via a parameterized reusable-build-sample-apps.yml, run dependency installs across apps/flutter_sample_*, and adjust PR commenting/release workflows to treat SPM as the primary distributable while using the CocoaPods app mainly for compatibility verification.

Improves automation/docs: auto-update workflow now syncs ios/customer_io/Package.swift with pubspec.yaml native iOS version, adds SPM-related ignores, and excludes apps/scripts/** from Dart analysis.

^{Reviewed by Cursor Bugbot for commit dfa4c27. Bugbot is set up for automated code reviews on this repo. Configure here.}

[github-actions]

Sample app builds 📱

Below you will find the list of the latest versions of the sample apps. It's recommended to always download the latest builds of the sample apps to accurately test the pull request.

---

• flutter_sample_spm: 330.8.0 (29597271)

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, have a team admin enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit dfa4c27. Configure here.}