Skip to main content

Install the package

flutter pub add flutter_callkit_incoming
After editing pubspec.yaml manually, run:
flutter pub get

Java SDK requirement (Android)

Version 2.5.0 and later require Java SDK 17 or higher for the Android build. Older JDK versions will cause a build failure.
Verify your active Java version:
java -version
If you manage multiple JDK versions, switch to Java 17 before building:
export JAVA_HOME=$(/usr/libexec/java_home -v 17)

Import the library

Add the following import wherever you need to interact with the plugin:
import 'package:flutter_callkit_incoming/flutter_callkit_incoming.dart';
This single import exposes FlutterCallkitIncoming, CallKitParams, AndroidParams, IOSParams, NotificationParams, CallEvent, and the Event enum.

Platform configuration required

Installing the package is not enough on its own — both platforms need additional configuration before the incoming call UI will appear.

Android setup

Add the INTERNET permission, set singleInstance launch mode, and add the ProGuard keep rule.

iOS setup

Add UIBackgroundModes to Info.plist and configure PushKit in AppDelegate.swift.

Build docs developers (and LLMs) love