feat: release version 3.1.0 with native SPM support, Android Telecom service, and various bug fixes and improvements

Author: hiennguyen92

CHANGELOG.md

@@ -1,5 +1,22 @@
-## 3.0.1
-* Add optional `onError` completion handler to `showCallkitIncoming` for iOS. Allows the host application to handle errors returned by reportNewIncomingCall, providing visibility into failures caused by system-level restrictions (e.g., Do Not Disturb mode) or invalid configurations.
+## 3.1.0
+* Add native **Swift Package Manager (SPM)** support for iOS with auto-linked `CryptoSwift` dependency.
+* Add explicit Objective-C compatible overload `showCallkitIncoming(_:fromPushKit:)` in `SwiftFlutterCallkitIncomingPlugin` to fix compilation issues in native Objective-C runner.
+* Conform `AppDelegate` in example project to `CallkitIncomingAppDelegate` by implementing the missing `providerDidReset()` method.
+* Update environment constraints in `pubspec.yaml` to require Dart SDK `>=3.0.0` and Flutter `>=3.10.0`.
+* Add optional `onError` completion handler to `showCallkitIncoming` for iOS, thank @nukeolay https://github.com/hiennguyen92/flutter_callkit_incoming/pull/803
+* Implement self-managed Telecom ConnectionService on Android, thank @kennss https://github.com/hiennguyen92/flutter_callkit_incoming/pull/809
+* Add Background Message Handler and Enhanced Android Foreground Service Support, thank @fedehsq https://github.com/hiennguyen92/flutter_callkit_incoming/pull/800
+* Fix Android duplicated notification on call connected event, thank @skutimechanic https://github.com/hiennguyen92/flutter_callkit_incoming/pull/764
+* Refactor and improve type safety, thank @AAkira https://github.com/hiennguyen92/flutter_callkit_incoming/pull/772
+* Implement volume key handling to mute incoming call sound on key press, thank @jawad1257 https://github.com/hiennguyen92/flutter_callkit_incoming/pull/781
+* Fix ongoing ringtone and vibrations on the action call connected, thank @skutimechanic https://github.com/hiennguyen92/flutter_callkit_incoming/pull/783
+* Add custom color option for accept and decline buttons for Android, thank @baldarama https://github.com/hiennguyen92/flutter_callkit_incoming/pull/790
+* Fix Android ringtone/vibration stopping on auto lock, thank @phildupuis https://github.com/hiennguyen92/flutter_callkit_incoming/pull/792
+* Dynamically update CXProvider configuration for subsequent calls on iOS, thank @MS-Rex https://github.com/hiennguyen92/flutter_callkit_incoming/pull/805
+* Fix Android showCallkitIncoming silently dropping calls when host process is kept alive, thank @sherzodkamoldinov https://github.com/hiennguyen92/flutter_callkit_incoming/pull/808
+* Refactor notification and sound management: Updated incoming notification, thank @AbdurahmanAlmehdi https://github.com/hiennguyen92/flutter_callkit_incoming/pull/812
+* Fix iOS outgoing call actionCallAccept emitting default/empty Data instead of original call params, thank @mechtech-mind https://github.com/hiennguyen92/flutter_callkit_incoming/pull/813
+* Fix and handle null intent.action in TransparentActivity, thank @AlexBacich https://github.com/hiennguyen92/flutter_callkit_incoming/pull/814
 
 ## 3.0.0
 * Using Plugin DSL for Android, thank @AAkira https://github.com/hiennguyen92/flutter_callkit_incoming/pull/743

README.md

@@ -26,18 +26,31 @@ Our top sponsors are shown below!
   <img src="https://cdn.buymeacoffee.com/buttons/default-orange.png" alt="Buy Me A Coffee" height="41" width="174">
 </a>
 
+## 📌 Table of Contents
+- [⭐ Features](#-features)
+- [🚀 Installation](#-installation)
+  - [1. Install Packages](#1-install-packages)
+  - [2. Configure Project](#2-configure-project)
+    - [Android Configuration](#android)
+    - [iOS Configuration](#ios)
+    - [Swift Package Manager (SPM) Support](#swift-package-manager-spm-support-flutter-324)
+  - [3. Usage](#3-usage)
+- [📋 Properties](#-properties)
+- [📱 Pushkit Setup](#-pushkit---received-voip-and-wake-app-from-terminated-state-ios-only)
+- [🎯 Demo](#-demo)
+
 ## ⭐ Features
 
 - Show an incoming call
 - Start an outgoing call
 - Custom UI Android/Callkit for iOS
 - Example using Pushkit/VoIP for iOS
 
-## ⚠️ iOS: ONLY WORKING ON REAL DEVICE
-
-**Please make sure setup/using [PUSHKIT](https://github.com/hiennguyen92/flutter_callkit_incoming/blob/master/PUSHKIT.md) FOR VOIP**
-
-> **Note:** Please do not use on simulator (Callkit framework not working on simulator)
+> [!WARNING]
+> ### iOS: ONLY WORKING ON REAL DEVICE
+> **Please make sure setup/using [PUSHKIT](https://github.com/hiennguyen92/flutter_callkit_incoming/blob/master/PUSHKIT.md) FOR VOIP**
+>
+> *Note:* Please do not use on simulator (Callkit framework is not fully supported on simulator for incoming VoIP calls).
 
 ## 🚀 Installation
 
@@ -94,6 +107,17 @@ The following rule needs to be added in the `proguard-rules.pro` to avoid obfusc
 </array>
 ```
 
+#### Swift Package Manager (SPM) Support (Flutter 3.24+)
+
+This plugin natively supports Swift Package Manager (SPM). To configure your project to build using SPM instead of CocoaPods, run:
+
+```bash
+flutter config --enable-swift-package-manager
+```
+
+> [!IMPORTANT]
+> Swift Package Manager is highly recommended for modern Flutter projects as CocoaPods is in maintenance mode and will become read-only in December 2026.
+
 ### 3. Usage
 
 #### Import
@@ -666,7 +690,8 @@ Please check [PUSHKIT.md](https://github.com/hiennguyen92/flutter_callkit_incomi
 
 ## 📋 Todo
 
-- [ ] Run background
+- [X] Run background / background execution support (implemented via self-managed Telecom service & didActivate background replay cache)
+- [X] Swift Package Manager (SPM) support
 - [ ] Simplify the setup process
 - [X] Custom notification for iOS (Missing notification)
 - [X] Keep notification when calling

pubspec.yaml

@@ -1,6 +1,6 @@
 name: flutter_callkit_incoming
 description: Flutter Callkit Incoming to show callkit screen in your Flutter app.
-version: 3.0.1
+version: 3.1.0
 homepage: https://github.com/hiennguyen92/flutter_callkit_incoming
 repository: https://github.com/hiennguyen92/flutter_callkit_incoming
 issue_tracker: https://github.com/hiennguyen92/flutter_callkit_incoming/issues