Flutter日历添加插件add_2_calendar_new的使用

简介

add_2_calendar_new 是一个非常简单的Flutter插件，用于将事件添加到各个平台（Android、iOS）的默认日历应用中。该插件源自 add_2_calendar_new 包。

安装

1. 在您的 pubspec.yaml 文件中添加依赖：

dependencies:
  add_2_calendar_new: ^1.0.1

2. Android 集成

• 权限：默认情况下，该插件不需要任何特殊权限来添加日历事件。但如果您希望在不启动日历应用程序的情况下添加事件，则需要在 AndroidManifest.xml 中添加日历权限：

<uses-permission android:name="android.permission.WRITE_CALENDAR" />
<uses-permission android:name="android.permission.READ_CALENDAR" />

• API 30 及以上：从 API 30 开始，Android 要求在 AndroidManifest.xml 中配置包可见性：

<queries>
  <intent>
    <action android:name="android.intent.action.INSERT" />
    <data android:mimeType="vnd.android.cursor.item/event" />
  </intent>
</queries>

3. iOS 集成

为了使此插件在 iOS 10+ 上正常工作，请确保在 info.plist 文件中添加以下内容：

<key>NSCalendarsUsageDescription</key>
<string>我们需要访问您的日历来添加活动</string>

如果需要支持位置自动补全功能，建议同时添加以下权限：

<key>NSContactsUsageDescription</key>
<string>我们需要访问您的联系人以提供位置自动补全</string>

使用示例

以下是完整的示例代码，展示了如何使用 add_2_calendar_new 插件将事件添加到日历中：

import 'package:flutter/material.dart';
import 'package:add_2_calendar_new/add_2_calendar_new.dart';

void main() => runApp(MyApp());

class MyApp extends StatelessWidget {
  final GlobalKey<ScaffoldMessengerState> scaffoldMessengerKey = GlobalKey<ScaffoldMessengerState>();

  Event buildEvent({Recurrence? recurrence}) {
    return Event(
      title: '测试活动',
      description: '这是一个示例描述',
      location: 'Flutter 应用程序',
      startDate: DateTime.now(),
      endDate: DateTime.now().add(Duration(minutes: 30)),
      allDay: false,
      iosParams: IOSParams(
        reminder: Duration(minutes: 40),
        url: "http://example.com",
      ),
      androidParams: AndroidParams(
        emailInvites: ["test@example.com"],
      ),
      recurrence: recurrence,
    );
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      scaffoldMessengerKey: scaffoldMessengerKey,
      home: Scaffold(
        appBar: AppBar(
          title: const Text('添加事件到日历示例'),
        ),
        body: ListView(
          children: [
            ListTile(
              title: Text('添加普通事件'),
              trailing: Icon(Icons.calendar_today),
              onTap: () {
                Add2Calendar.addEvent2Cal(buildEvent());
              },
            ),
            Divider(),
            ListTile(
              title: const Text('添加每周重复事件'),
              subtitle: const Text("每周重复，持续60天"),
              trailing: Icon(Icons.calendar_today),
              onTap: () {
                Add2Calendar.addEvent2Cal(buildEvent(
                  recurrence: Recurrence(
                    frequency: Frequency.weekly,
                    endDate: DateTime.now().add(Duration(days: 60)),
                  ),
                ));
              },
            ),
            Divider(),
            ListTile(
              title: const Text('添加每两个月重复6次的事件'),
              subtitle: const Text("每两个月重复6次，总共一年"),
              trailing: Icon(Icons.calendar_today),
              onTap: () {
                Add2Calendar.addEvent2Cal(buildEvent(
                  recurrence: Recurrence(
                    frequency: Frequency.monthly,
                    interval: 2,
                    occurrences: 6,
                  ),
                ));
              },
            ),
            Divider(),
            ListTile(
              title: const Text('添加每年重复10年的事件 (仅限Android)'),
              subtitle: const Text("RRULE: 每年重复，持续10年"),
              trailing: Icon(Icons.calendar_today),
              onTap: () {
                Add2Calendar.addEvent2Cal(buildEvent(
                  recurrence: Recurrence(
                    frequency: Frequency.yearly,
                    rRule: 'FREQ=YEARLY;COUNT=10;WKST=SU',
                  ),
                ));
              },
            ),
            Divider(),
          ],
        ),
      ),
    );
  }
}

注意事项

1. 日期时间格式：请参考 DateTime 文档 以确保日期时间格式正确。
2. iOS语言支持：默认情况下，iOS 的保存事件界面会显示为英文。如需支持其他语言，请在 info.plist 中添加相应的语言设置：

<key>CFBundleLocalizations</key>
<array>
  <string>en</string>
  <string>es</string>
  <string>ja</string>
</array>

通过上述步骤和示例代码，您可以轻松地将事件添加到用户的日历中，并根据需要设置重复规则和其他参数。