@canva/asset

中文文档
2.4.0发布于 2026/11/03SEE LICENSE IN LICENSE.md FILETypeScriptESM + CJS零依赖近 30 天下载 10.9万

Canva 开发者 SDK 用于 Canva 内部应用的资产管理库

中文使用文档
文档目录8 节
  1. 目录
  2. 导言
  3. 安装
  4. 使用量
  5. API 参考
  6. 相关软件包
  7. 捐款
  8. 许可证

@ canva/ 资产

一个Canva开发者SDK软件包,用于Canva内部构建应用软件. 规定了资产处理方法.

目录

导言

@canva/asset 是 npm 建设软件包 canva 内部的应用程序 与 Canva 开发者 SDK 。 它提供了处理资产的方法,例如图像和视频文件。 例如,包输出 a upload 将资产上传到用户媒体库的方法.

说明: 要与 Canva 开发者 SDK 一同起来运行, 请检查 快速启动指南。 。 。 .

安装

npm install @canva/asset

使用量

  1. 导入方法或命名空间 @canva/asset 软件包 :

    import { upload } from '@canva/asset';
    
  2. 调用方法, 在所需的参数中传递( 如果有):

    await upload({
      type: 'IMAGE',
      id: 'uniqueIdGoesHere',
      mimeType: 'image/jpeg',
      url: 'https://www.canva.dev/example-assets/image-import/image.jpg',
      thumbnailUrl: 'https://www.canva.dev/example-assets/image-import/thumbnail.jpg',
    });
    

API 参考

Canva内部的App是用以下 Canva 开发者 SDK 包构建的 :

  • @canva/app-ui-kit - 基于反应的组件库,用于创建模仿Canva外观和感觉的应用程序.
  • @canva/asset - 提供处理资产的方法,例如图像和录像文件.
  • @canva/design - 提供与用户设计互动的方法,例如创建要素.
  • @canva/error - 提供 CanvaError 处理错误的课.
  • @canva/platform - 提供实用方法,例如打开外部链接的方法.
  • @canva/user - 提供获取用户数据和认证用户的方法.

捐款

我们正在积极开发这个一揽子计划,但目前不接受第三方的捐款. 如果您想要求修改或添加软件包,请通过 Canva 开发者社区。 。 。 .

许可证

见 LICENSE.md 文档.

版本与发布记录

@canva/asset 共发布 40 个版本,首次发布于 2023/11/17;过去 12 个月发布了 5 个版本。

版本发布日期距今
2.4.0latest2026/11/036 天前
2.3.2-beta.0betapreview2026/10/1327 天前
2.3.12026/09/221 个月前
2.3.02025/12/2210 个月前
2.2.22025/12/1010 个月前
2.2.12025/07/081.3 年前

关于 @canva/asset 的常见问题

@canva/asset 是什么?

Canva 开发者 SDK 用于 Canva 内部应用的资产管理库

如何安装 @canva/asset?

在项目目录运行 npm install @canva/asset,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:@canva/error(^2.0.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@canva/asset 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@canva/asset 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@canva/asset 可以商用吗?

@canva/asset 使用 SEE LICENSE IN LICENSE.md FILE 许可。许可条款写在包内的独立文件中,请阅读该文件确认可否商用。以上为概括,不构成法律意见,请以许可原文为准。

@canva/asset 的下载量有多少?

根据 npm 官方下载统计,@canva/asset 在 2026/10/09 – 2026/11/07 这 30 天内被下载 109,012 次,日均约 3,634 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@canva/asset 还在维护吗?

最新版本 2.4.0 发布于 2026/11/03(6 天前);至今共发布 40 个版本,其中过去 12 个月发布了 5 个;首次发布于 2023/11/17。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。