一、环境配置步骤

1. 创建端云一体化工程 12 在DevEco Studio中选择云开发模板（如“Cloud DB”或“Cloud Functions”），根据向导创建包含云侧和端侧模块的工程12。

2. 开通云存储服务 在AppGallery Connect控制台：

   • 进入项目 → 选择您的应用 → 在“Serverless”菜单中开通云存储服务。
   • 创建存储实例（默认生成名为agc-cloudstorage的桶）。

3. 配置云函数权限 在云函数代码中需声明云存储权限：

   // cloudfunctions/your-function/package.json
   {
     "dependencies": {
       "@agconnect/storage-server": "^1.0.0"  // 必须添加此依赖
     }
   }
   

二、云函数操作云存储代码示例

以下代码展示在云函数中接收端侧上传的图片文件，并保存至云存储（直接引用检索信息中的核心逻辑）：

// 云函数代码（cloudfunctions/your-function/index.js）
import cloud from '@agconnect/cloud-server';
import storage from '@agconnect/storage-server';

export default async function (event) {
  // 1. 获取端侧上传的文件数据（需按检索信息要求解析body）
  let body = event.body ? JSON.parse(event.body) : event;
  const { fileName, fileData } = body; // fileData为Base64编码的图片数据

  // 2. 初始化云存储
  const storageInstance = storage.storage();
  const storagePath = `images/${fileName}`; // 存储路径

  // 3. 将Base64转为Buffer并上传
  try {
    const buffer = Buffer.from(fileData, 'base64');
    await storageInstance.uploadFile({
      path: storagePath,
      buffer,
      mimeType: 'image/jpeg' // 根据实际类型修改
    });

    // 4. 返回文件访问URL
    const downloadURL = await storageInstance.getDownloadUrl({
      path: storagePath
    });

    return {
      code: 0,
      url: downloadURL
    };
  } catch (error) {
    return { code: 500, message: "Upload failed: " + error.message };
  }
}

三、关键注意事项（来自检索信息）

1. 端侧文件预处理 端侧上传前需将图片复制到应用缓存目录（参考检索信息要求）：

   // 端侧代码示例
   import fs from '@ohos.file.fs';
   import cloudStorage from '@agconnect/cloudstorage';
   
   async function uploadImage() {
     const cacheDir = globalThis.context.cacheDir; // 获取缓存路径
     const localPath = `${cacheDir}/test.jpg`;     // 格式：internal://cache/test.jpg
     // ...（将图片复制到localPath后再调用云函数）
   }
   

2. 用户认证强制要求 必须在端侧登录认证（否则云存储会拒绝操作）：

   import auth from '@agconnect/auth';
   
   async function signIn() {
     await auth.getCurrentUser().signIn(); // 未登录用户需先调用此方法
   }
   

3. 本地调试限制

   • 仅支持真机调试（不支持模拟器）
   • 云函数本地运行时需在通知栏确认Cloud Functions loaded successfully状态2
   • 本地调用地址格式：http://localhost:端口号（端口号在DevEco Studio控制台查看）