Flutter iCloud存储同步插件icloud_storage_sync的使用

🌟 简介

iCloud_Storage_Sync简化了iCloud存储集成，为你的Flutter iOS应用带来了强大的云功能：

• 🔄 轻松备份和同步应用数据
• 📱💻 在所有设备上提供一致的用户体验
• 🔒 安全地存储和检索重要信息
• ☁️ 无缝集成到iCloud生态系统中

✨ 功能

🚀 快速开始

1. 🛠️ 安装

在pubspec.yaml中添加以下依赖：

dependencies:
  icloud_storage_sync: ^1.0.0

2. ⚙️ 安装插件

运行以下命令：

flutter pub get

3. 💻 使用

在Dart代码中导入插件：

import 'package:icloud_storage_sync/icloud_storage_sync.dart';

📋 先决条件

在开始之前，请确保你已经具备以下条件：

• ☑️ Apple开发者账户
• ☑️ 应用ID和iCloud容器ID
• ☑️ 启用并分配了iCloud功能
• ☑️ 在Xcode中配置了iCloud功能

查看如何设置iCloud容器和启用功能以获取详细步骤。

🧰 API示例

📥 获取iCloud文件

Future<List<CloudFiles>> getCloudFiles({required String containerId}) async {
  return await icloudSyncPlugin.getCloudFiles(containerId: containerId);
}

📤 上传文件到iCloud

Future<void> upload({
  required String containerId,
  required String filePath,
  String? destinationRelativePath,
  StreamHandler<double>? onProgress,
}) async {
  await icloudSyncPlugin.upload(
    containerId: containerId,
    filePath: filePath,
    destinationRelativePath: destinationRelativePath,
    onProgress: onProgress,
  );
}

🏷️ 重命名iCloud文件

Future<void> rename({
  required String containerId,
  required String relativePath,  
  required String newName,
}) async {
  await icloudSyncPlugin.rename(
    containerId: containerId,
    relativePath: relativePath,
    newName: newName,
  );  
}

🗑️ 删除iCloud文件

Future<void> delete({
  required String containerId,
  required String relativePath,
}) async {
  await icloudSyncPlugin.delete(
    containerId: containerId,
    relativePath: relativePath,
  );
}

🔀 移动iCloud文件

Future<void> move({
  required String containerId,  
  required String fromRelativePath,
  required String toRelativePath,  
}) async {
  await IcloudSyncPlatform.instance.move(
    containerId: containerId,
    fromRelativePath: fromRelativePath,
    toRelativePath: toRelativePath,
  );
}

🛠 如何设置iCloud容器和启用功能

1. 登录Apple开发者账户并选择“证书、ID和简档”。
2. 创建一个App ID（如果需要）和一个iCloud容器ID。
3. 将iCloud容器分配给你的App ID。
4. 在Xcode中启用iCloud功能并选择你的容器。

示例项目

以下是一个简单的示例项目，展示了如何使用icloud_storage_sync插件：

import 'package:flutter/material.dart';
import 'package:get/get.dart';
import 'package:icloud_storage_sync_example/apple_sign.dart';
import 'package:icloud_storage_sync_example/controller/icloud_plugin_controller.dart';

// Entry point of the application
void main() {
  // Ensure that Flutter widgets are initialized
  WidgetsFlutterBinding.ensureInitialized();

  // Initialize the IcloudController using GetX for dependency injection
  Get.lazyPut(() => IcloudController());

  // Run the app
  runApp(const MyApp());
}

// Root widget of the application
class MyApp extends StatefulWidget {
  const MyApp({super.key});

  [@override](/user/override)
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  [@override](/user/override)
  Widget build(BuildContext context) {
    // Use GetMaterialApp for GetX functionality
    return GetMaterialApp(
      // Disable the debug banner
      debugShowCheckedModeBanner: false,

      // Set the app theme
      theme: ThemeData(
          useMaterial3: false,
          appBarTheme: const AppBarTheme(backgroundColor: Colors.green)),

      // Set the initial route to the Apple Sign In screen
      home: const AppleSignInScreen(),
    );
  }
}