@cloudinary/url-gen

中文文档
1.22.0发布于 2025/08/26MITESM + CJS近 30 天下载 106.7万

你被邀请来影响我们的新SDK 点击这里查看 github 讨论 =========================

中文使用文档
文档目录20 节
  1. 关于
  2. 其他文件
  3. 目录
  4. 关键特性
  5. 版本支持
  6. 记着!
  7. 安装
  8. 使用您最喜欢的软件包管理器( yarn, npm) 安装
  9. 使用量
  10. 设置
  11. 资产转化和优化
  12. 生成图像和视频 URL
  13. 文件上传
  14. 转接
  15. 用 Jest 进行测试
  16. 捐款
  17. 获得帮助
  18. 关于云层
  19. 额外资源
  20. 许可证

你被邀请来影响我们的新SDK
点击这里查看 github 讨论

云层 URL - Gen SDK

Build Status

关于

Cloudinary URL-Gen SDK允许您快速而轻松地将您的应用程序与Cloudinary集成. 努力地优化和改造你的云资产.

此 SDK 也可以与 流行前端框架。 。 。 .

其他文件

这个Readme提供了基本的安装和使用信息. 关于完整的文件,见 URL- Gen SDK 指南 编辑 URL- Gen 参考。 。 。 .

注:在使用url-gen库时,将安装一个额外的转换-构建器-sdk库作为依赖. 这个库处理URL的变换生成部分,因此所有变换动作都从这个库导入. 因此,您可以从@cloudinary/url-gen(如文档所示)导入所有变换,也可以直接从变换-构建器-sdk库导入,例如:

import {scale} from '@cloudinary/transformation-builder-sdk/actions/resize';

您可以在 转换构建器参考。 。 。 .

目录

关键特性

版本支持

记着!

这个SDK是跨平台的,但只有Node.js版本值得一提

SDK 版本节点.js 14节点.js 16
1.x 运算五、结 论五、结 论

安装

使用您最喜欢的软件包管理器( yarn, npm) 安装

npm install @cloudinary/url-gen
yarn add @cloudinary/url-gen 

使用量

设置

// Import the Cloudinary class
import {Cloudinary} from '@cloudinary/url-gen';

// Create your instance
const cld = new Cloudinary({
  cloud: {
    cloudName: 'demo'
  },
  url: {
    secure: true // force https, set to false to force http
  }
});

资产转化和优化

// Create a new instance if you haven't (see above for the details)
const cld = new Cloudinary({/*...*/})

// Let's create a new image
const myImage = cld.image('sample');

// Import the resize transformation and apply it to myImage
import {Resize} from '@cloudinary/url-gen/actions/resize';

// Resize the image to 100x100
myImage.resize(Resize.scale().width(100).height(100));

// When we're done, we can apply all our changes and create a URL.
const myURL = myImage.toURL();

// https://res.cloudinary.com/demo/image/upload/c_scale,w_100,h_100/sample
console.log(myURL);

生成图像和视频 URL

库支持图像和视频上的转换. 请按以下规定使用适当的方法:

- Use `cld.image()` to generate image URLs and transformations
- Use `cld.video()` to generate video URLs and transformations

两者 image() 财务报告和审定财务报表 video() 允许您使用的方法 toURL() 生成最终的已转换的资产 URL.

文件上传

此 SDK 不提供文件上传功能, 但是有 从客户端上传的几种方法。 。 。 .

转接

@cloudinary/url-gen 以未传送的 ES6 代码运出. @cloudinary/url-gen 围绕捆绑的大小优化, 因此我们不转录我们的分布式模块, 我们让浏览器决定支持什么, 以及应用什么转写, 给你,用户.

用 Jest 进行测试

如前所言,我们在航运 @cloudinary/url-gen 有了ES6代码, 因为这提供了巨大的震动树的潜力. 测试时还需要一些调整.

开玩笑的 配置,你需要添加这些行 让贝贝尔转录我们的代码.

{
  "transform": {
    "node_modules/@cloudinary/url-gen": "babel-jest",
    "node_modules/@cloudinary/transformation-builder-sdk": "babel-jest"
  },
  "transformIgnorePatterns": ["/node_modules/(?!(@cloudinary/url-gen|@cloudinary/transformation-builder-sdk))"]
}

确保安装 bayl- jest : npm install babel-jest

你还需要确保你有一个 babel.config.js 文档(而非 .babelrc),以及该 它的配置是适当的 转接码,

例如数字 :

module.exports = {
  "presets": [
    "@babel/preset-env"
  ]
};

捐款

  • 克隆此寄存器
  • 创建叉
  • 做你的改变
  • 本地测试 npm run test
  • 本地构建项目 npm run build
  • 按您的更改
  • 等待维护者的检讨

获得帮助

如果遇到问题或有问题,可以:

在此可找到额外资源:

关于云层

Cloudinary是一个强大的媒体API,用于网站和移动应用,Cloudinary使开发者能够高效地管理,转换,优化,并通过多个CDN传送图像和视频. 观众最终会享受到回应性和个人化的视觉媒体体验.

额外资源

许可证

根据麻省理工学院的许可被释放.

版本与发布记录

@cloudinary/url-gen 共发布 42 个版本,首次发布于 2021/09/01;过去 12 个月发布了 0 个版本。

版本发布日期距今
1.22.0latest2025/08/261.2 年前
1.21.02024/09/102 年前
1.20.02024/07/312 年前
1.19.02024/03/042 年前
1.18.02024/02/262 年前
1.17.02024/02/232 年前

其他发布通道:beta → 1.0.0-beta.5。

关于 @cloudinary/url-gen 的常见问题

@cloudinary/url-gen 是什么?

你被邀请来影响我们的新SDK 点击这里查看 github 讨论 =========================

如何安装 @cloudinary/url-gen?

在项目目录运行 npm install @cloudinary/url-gen,或使用 pnpm add / yarn add / bun add。

@cloudinary/url-gen 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/cloudinary__url-gen 是否存在。

@cloudinary/url-gen 支持 ESM 还是 CommonJS?

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

@cloudinary/url-gen 可以商用吗?

@cloudinary/url-gen 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@cloudinary/url-gen 的下载量有多少?

根据 npm 官方下载统计,@cloudinary/url-gen 在 2026/10/10 – 2026/11/08 这 30 天内被下载 1,067,193 次,日均约 35,573 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@cloudinary/url-gen 还在维护吗?

最新版本 1.22.0 发布于 2025/08/26(1.2 年前);至今共发布 42 个版本,其中过去 12 个月发布了 0 个;首次发布于 2021/09/01。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。