Flutter云端辅助插件cloud_helper的使用

Flutter云端辅助插件cloud_helper的使用

插件用于Flutter中上传、删除和修改iCloud中的记录。

前置条件

为了使用此插件，需要完成以下设置：

1. Apple开发者账户
2. 创建App ID和iCloud容器ID
3. 在App ID中启用iCloud功能并分配iCloud容器ID
4. 在Xcode中启用iCloud功能

详细步骤请参见如何设置iCloud容器并启用功能部分。

API 使用

获取实例

final cloudHelper = await CloudHelper.create('iCloudContainerId');

从iCloud获取文件

final fileList = await cloudHelper.getAllRecords(type: 'recordType');

将文件上传到iCloud

await cloudHelper.addRecord(
    data: 'recordData',
    id: 'recordId',
    type: 'recordType',
);

从iCloud删除文件

await cloudHelper.deleteRecord(id: recordId);

修改文件

await cloudHelper.editRecord(
    id: 'recordId',
    data: 'newData',
);

如何设置iCloud容器并启用功能

1. 登录您的Apple开发者账户，并选择左侧导航栏中的“证书、标识符与配置文件”。
2. 在“证书、标识符与配置文件”页面中，选择“标识符”，创建一个App ID（如果尚未创建），并创建一个iCloud容器ID。
3. 点击您的App ID。在功能部分，选择“iCloud”，并将第2步创建的iCloud容器分配给此App ID。
4. 打开您的项目在Xcode中。如果尚未设置，请将您的App ID作为“捆绑包标识符”。点击’+ 功能’按钮，选择iCloud，然后在服务部分勾选’CloudKit’并选择您的iCloud容器。

示例代码

import 'package:cloud_helper/cloud_helper_method_channel.dart';
import 'package:flutter/material.dart';

void main() {
  runApp(const MyApp());
}

class MyApp extends StatefulWidget {
  const MyApp({Key? key}) : super(key: key);

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

class _MyAppState extends State<MyApp> {
  static const _containerId = 'iCloud.com.cloud.example';

  final _idController = TextEditingController();
  final _nameController = TextEditingController();
  final _phraseController = TextEditingController();
  CloudHelper? cloudHelper;
  String? data;

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('插件示例应用'),
        ),
        body: Column(
          children: [
            TextFormField(
              controller: _idController,
            ),
            TextFormField(
              controller: _nameController,
            ),
            TextFormField(
              controller: _phraseController,
            ),
            ElevatedButton(
              onPressed: () async {
                cloudHelper ??= await CloudHelper.create(_containerId);
                try {
                  await cloudHelper?.addRecord(
                    data: {
                      'phrase': _phraseController.text,
                      'name': _nameController.text,
                    },
                    id: _idController.text,
                    type: 'Seed',
                  );
                } catch (err) {
                  print(err);
                  // 错误保存记录&lt;CKRecordID: 0x131ef0840; recordName=test, zoneID=_defaultZone:__defaultOwner__&gt;到服务器: 记录已存在
                }
              },
              child: const Text('上传'),
            ),
            ElevatedButton(
              onPressed: () async {
                cloudHelper ??= await CloudHelper.create(_containerId);
                try {
                  final a = await cloudHelper?.getAllRecords(
                    type: 'Seed',
                  );
                  setState(() {
                    data = a?.join('\n');
                  });
                } catch (err) {
                  print(err);
                }
              },
              child: const Text('获取'),
            ),
            ElevatedButton(
              onPressed: () async {
                cloudHelper ??= await CloudHelper.create(_containerId);
                cloudHelper
                    ?.deleteRecord(
                      id: _idController.text,
                    )
                    .then((value) => setState(() {
                          data = null;
                        }));
              },
              child: const Text('删除'),
            ),
            ElevatedButton(
              onPressed: () async {
                cloudHelper ??= await CloudHelper.create(_containerId);
                try {
                  await cloudHelper?.editRecord(
                    id: _idController.text,
                    data: {
                      'phrase': _phraseController.text,
                      'name': _nameController.text,
                    },
                  );
                } catch (err) {
                  print(err);
                }
              },
              child: const Text('编辑'),
            ),
            Text(data ?? ''),
          ],
        ),
      ),
    );
  }
}