Search packages, repositories and app categories

ducafecatFlutter ecosystem guide
Package detailsv0.10.0

device_calendar_plus_platform_interface

Platform interface for device_calendar_plus plugin.

AndroidiOSLinuxmacOSWebWindows
pub.dev API documentation Source code
30-day downloads
35.3K
Likes
1
Pub points
150

Install package

flutter pub add device_calendar_plus_platform_interface

Package Overview

Package selection guidance compiled from public package information, community data, and project usage.

The device_calendar_plus_platform_interface package provides a platform-agnostic interface for the device_calendar_plus plugin, enabling consistent access to device calendars across Android, iOS, Linux, macOS, Web, and Windows. It abstracts native calendar operations, allowing developers to interact with calendar data without writing platform-specific code. This interface is designed to support future extensions and ensure compatibility with various operating systems. It serves as a foundational layer for plugins that manage calendar events and permissions.

Use cases

  • Cross-platform calendar integration
  • Unified calendar API for multiple platforms
  • Developing calendar-aware applications
  • Extending device_calendar_plus functionality
  • Building plugins with shared calendar logic

Key features

  • Platform-independent calendar access
  • Support for Android, iOS, Linux, macOS, Web, and Windows
  • Modular design for easy extension
  • Standardized event and calendar management
  • Facilitates plugin development and maintenance

Suitable for

  • Developers building multi-platform apps
  • Teams requiring consistent calendar behavior
  • Plugin authors extending calendar features
  • Applications needing calendar event management
  • Projects using device_calendar_plus

Considerations

  • Requires implementation on each platform
  • Dependent on device_calendar_plus for full functionality
  • May require additional setup for web and desktop platforms
  • Limited to calendar operations defined by the interface
  • Not intended for direct use in end-user applications

Original README

Original README snapshot from the linked source repository. Visit the repository for the latest content.

device_calendar_plus

A modern, federated Flutter plugin for reading and writing device calendar events on Android and iOS.

Note: This is the developer/contributor documentation. For plugin usage and API documentation, see the device_calendar_plus package README.

🏗️ Architecture

This is a federated plugin following Flutter's federated plugin architecture:

device_calendar_plus/
├── packages/
│   ├── device_calendar_plus/              # Main package (public API)
│   ├── device_calendar_plus_platform_interface/  # Platform interface
│   ├── device_calendar_plus_android/      # Android implementation
│   └── device_calendar_plus_ios/          # iOS implementation
└── example/                                # Example app & integration tests
Package Structure

  • device_calendar_plus: The main package that app developers depend on. Contains the public Dart API and exports platform interface types.

  • device_calendar_plus_platform_interface: Defines the interface that platform implementations must follow. Contains method signatures and data contracts.

  • device_calendar_plus_android: Android-specific implementation using Kotlin and the Android Calendar Provider API.

  • device_calendar_plus_ios: iOS-specific implementation using Swift and EventKit.

  • example/: Example app demonstrating plugin usage, also contains integration tests.

🚀 Getting Started

Prerequisites
  • Flutter SDK (latest stable)
  • For iOS development: Xcode 15+
  • For Android development: Android Studio with Android SDK 24+

Optional (but recommended):

  • Very Good CLI: dart pub global activate very_good_cli - Makes running tests faster with optimized configuration
Setup
  1. Clone the repository:
git clone https://github.com/yourusername/device_calendar_plus.git
cd device_calendar_plus
  1. Install dependencies:
flutter pub get

This project uses Dart workspaces, so a single flutter pub get at the root will install dependencies for all packages.

🧪 Testing

Unit Tests

Run all unit tests across all packages using Very Good CLI (recommended):

very_good test --recursive

This will run tests in all /packages/*/test/ directories with optimized configuration.

Integration Tests

Integration tests are located in example/integration_test/ and test the plugin against real platform APIs.

Running on a Device/Emulator

From the example directory:

cd example
./run_integration_tests.sh <device-id>

Get the device ID from:

flutter devices
Platform-Specific Notes

iOS:

  • Requires a simulator or physical device
  • Calendar permissions will be requested during tests
  • Tests create temporary calendars that are cleaned up

Android:

  • Requires an emulator or physical device with API 24+
  • Calendar permissions will be requested during tests
  • Tests create temporary calendars that are cleaned up

🤝 Contributing

This project is closed to outside pull requests. Bug reports and feature requests are welcome - please open an issue. See CONTRIBUTING.md for the design philosophy and conventions.

📄 License

MIT © 2025 Bullet

See LICENSE for details.

Maintained by Bullet — a cross-platform task + notes + calendar app built with Flutter.

Categories

CalendarDevice Utilities

Dependencies

Dependency list 1 items

  • plugin_platform_interface^2.1.0

Source repository

Projects using this package

No data available yet.

Rankings

Trending packages#78