Serverpod #

此包是Serverpod的核心部分。有关文档，请访问：https://docs.serverpod.dev。

<h2 class="hash-header" id="what-is-serverpod">什么是Serverpod？ <a href="#what-is-serverpod" class="hash-link">#</a></h2>
<p>Serverpod是一个用Dart语言编写的开源、可扩展的应用服务器，为Flutter社区设计。查看它！</p>
<p><a href="https://serverpod.dev" rel="ugc">Serverpod.dev</a></p>

<h2 class="hash-header" id="using-the-serverpod_cloud_storage_gcp-plugin">使用`serverpod_cloud_storage_gcp`插件 <a href="#using-the-serverpod_cloud_storage_gcp-plugin" class="hash-link">#</a></h2>

<p>在本示例中，我们将展示如何使用`serverpod_cloud_storage_gcp`插件来上传和下载文件到Google Cloud Storage。</p>

<h3 class="hash-header" id="prerequisites">前置条件 <a href="#prerequisites" class="hash-link">#</a></h3>
<ul>
    <li>安装Flutter SDK</li>
    <li>创建并配置一个Google Cloud项目，并启用Google Cloud Storage API</li>
    <li>获取服务账号密钥文件（JSON格式）</li>
</ul>

<h3 class="hash-header" id="add-dependencies">添加依赖项 <a href="#add-dependencies" class="hash-link">#</a></h3>
在`pubspec.yaml`文件中添加以下依赖项：
```yaml
dependencies:
  flutter:
    sdk: flutter
  serverpod_cloud_storage_gcp: ^0.1.0  # 请根据实际情况使用最新版本
```

<h3 class="hash-header" id="initialize-the-plugin">初始化插件 <a href="#initialize-the-plugin" class="hash-link">#</a></h3>
在应用启动时初始化插件，例如在`main.dart`中：
```dart
import 'package:flutter/material.dart';
import 'package:serverpod_cloud_storage_gcp/serverpod_cloud_storage_gcp.dart';

void main() {
  runApp(MyApp());
  // 初始化插件
  ServerpodCloudStorageGcp.init(
    projectId: 'your-project-id',
    credentials: Credentials.fromJsonFile('path/to/your-service-account-file.json'),
  );
}

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter GCP Cloud Storage Demo',
      home: HomePage(),
    );
  }
}
```

<h3 class="hash-header" id="uploading-files">上传文件 <a href="#uploading-files" class="hash-link">#</a></h3>
创建一个方法来上传文件到Google Cloud Storage：
```dart
import 'dart:io';
import 'package:serverpod_cloud_storage_gcp/serverpod_cloud_storage_gcp.dart';

Future<void> uploadFile(String bucketName, String filePath) async {
  try {
    // 创建一个存储客户端
    var storageClient = await ServerpodCloudStorageGcp.createClient();

    // 打开文件
    var file = File(filePath);
    var stream = file.openRead();

    // 上传文件
    await storageClient.upload(bucketName: bucketName, objectName: file.path.split('/').last, stream: stream);

    print('文件上传成功');
  } catch (e) {
    print('文件上传失败: $e');
  }
}
```

<h3 class="hash-header" id="downloading-files">下载文件 <a href="#downloading-files" class="hash-link">#</a></h3>
创建一个方法来从Google Cloud Storage下载文件：
```dart
Future<void> downloadFile(String bucketName, String objectName, String savePath) async {
  try {
    // 创建一个存储客户端
    var storageClient = await ServerpodCloudStorageGcp.createClient();

    // 下载文件
    var response = await storageClient.download(bucketName: bucketName, objectName: objectName);

    // 将响应内容写入文件
    var file = File(savePath);
    await file.writeAsBytes(response.bytes);

    print('文件下载成功');
  } catch (e) {
    print('文件下载失败: $e');
  }
}
```

<h3 class="hash-header" id="example-usage">示例用法 <a href="#example-usage" class="hash-link">#</a></h3>
在你的Flutter应用中调用上述方法：
```dart
void main() async {
  runApp(MyApp());

  // 初始化插件
  ServerpodCloudStorageGcp.init(
    projectId: 'your-project-id',
    credentials: Credentials.fromJsonFile('path/to/your-service-account-file.json'),
  );

  // 上传文件
  await uploadFile('your-bucket-name', '/path/to/your/local/file');

  // 下载文件
  await downloadFile('your-bucket-name', 'remote-file-name', '/path/to/save/downloaded/file');
}