Flutter实现Google Calendar事件增删改及实时同步功能可行性咨询

可以通过Flutter实现Google Calendar的事件创建、更新、删除及实时同步，且完全支持Android和iOS平台。你提到的Syncfusion Flutter Calendar仅作为日历视图展示组件，无法直接对接Google Calendar的后端API，需要借助Google官方提供的工具包来完成数据交互。

核心依赖包 #

推荐使用以下两个官方维护的包来实现功能：

• googleapis：提供Google Calendar API的调用封装
• google_sign_in：处理Google账号的OAuth授权流程

实现步骤 #

1. 配置Google Cloud项目 #

• 登录Google Cloud控制台，创建新项目并启用Google Calendar API
• 创建OAuth 2.0客户端ID，分别配置Android和iOS的包名、签名SHA-1（Android）、Bundle ID（iOS）等信息
• 下载生成的配置文件，Android端将google-services.json放入android/app目录；iOS端将GoogleService-Info.plist放入Runner目录

2. 集成依赖 #

在pubspec.yaml中添加依赖：

dependencies:
  googleapis: ^12.0.0
  google_sign_in: ^6.2.1

执行flutter pub get完成依赖安装

3. 实现用户授权 #

先完成Google账号登录并获取API访问凭证，再创建Calendar API客户端：

import 'package:googleapis/calendar/v3.dart';
import 'package:google_sign_in/google_sign_in.dart';
import 'package:http/http.dart' as http;

// 自定义授权客户端，处理请求头
class GoogleAuthClient extends http.BaseClient {
  final String _accessToken;
  final http.Client _client = http.Client();

  GoogleAuthClient(this._accessToken);

  @override
  Future<http.StreamedResponse> send(http.BaseRequest request) {
    request.headers['Authorization'] = 'Bearer $_accessToken';
    return _client.send(request);
  }
}

// 初始化Google登录实例，申请Calendar权限
final GoogleSignIn _googleSignIn = GoogleSignIn(
  scopes: [CalendarApi.calendarScope],
);

// 获取Calendar API客户端
Future<CalendarApi> getCalendarClient() async {
  final GoogleSignInAccount? account = await _googleSignIn.signIn();
  final GoogleSignInAuthentication auth = await account!.authentication;
  return CalendarApi(GoogleAuthClient(auth.accessToken!));
}

4. 具体功能实现 #

所有操作直接调用Google Calendar API，变更会实时同步到云端。

创建事件

// 向指定日历创建事件，返回事件ID
Future<String> createCalendarEvent(CalendarApi client, String calendarId, Event event) async {
  final createdEvent = await client.events.insert(event, calendarId);
  return createdEvent.id!;
}

// 示例事件对象
Event buildSampleEvent() {
  return Event(
    summary: '团队同步会议',
    description: '讨论Q3项目里程碑',
    start: EventDateTime(
      dateTime: DateTime.now().add(Duration(hours: 1)),
      timeZone: 'Asia/Shanghai',
    ),
    end: EventDateTime(
      dateTime: DateTime.now().add(Duration(hours: 2)),
      timeZone: 'Asia/Shanghai',
    ),
  );
}

更新事件

// 通过事件ID更新指定日历中的事件
Future<void> updateCalendarEvent(CalendarApi client, String calendarId, String eventId, Event updatedEvent) async {
  await client.events.update(updatedEvent, calendarId, eventId);
}

删除事件

// 通过事件ID删除指定日历中的事件
Future<void> deleteCalendarEvent(CalendarApi client, String calendarId, String eventId) async {
  await client.events.delete(calendarId, eventId);
}

5. 平台适配细节 #

Android

• 在AndroidManifest.xml中添加网络权限：

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

• 确保OAuth客户端ID配置的包名和签名SHA-1与项目实际信息一致

iOS

• 在Info.plist中添加Google登录支持的URL Scheme：

  <key>CFBundleURLTypes</key>
  <array>
    <dict>
      <key>CFBundleTypeRole</key>
      <string>Editor</string>
      <key>CFBundleURLSchemes</key>
      <array>
        <string>com.googleusercontent.apps.你的客户端ID</string>
      </array>
    </dict>
  </array>
  

• 添加LSApplicationQueriesSchemes以支持Google登录跳转：

  <key>LSApplicationQueriesSchemes</key>
  <array>
    <string>googlechrome</string>
    <string>googlechrome-url</string>
  </array>
  

内容的提问来源于stack exchange，提问作者Nijat Namazzade