币游国际平台

反应迁移指南

最新更新日期:Oct-31-2023

导 言

云化反动SDK设计提供简单化和增强开发者经验本指南解释如何从cloudinary-react库(遗留SDK)最新ReactSDK@cloudinary/reactfrontend-frameworks库加@cloudinary/url-gens-url-gen库里

密钥改进 ReactSDK

  • 新建基于动作语法设计,使建楼交付URL和变换更加逻辑化和可发现性
    • 编译归定交付URL时,每个动作(包括任何动作)修饰词表示不同的构件(除以 '/'),例如:/c_scale,w_400/f_auto/q_auto/,而不是/c_scale,f_auto,q_auto,w_400/.
  • 新建自填列表选项和参数并仅确保支持选项和参数可并用
  • 小包大小-你只需要导入想用的东西

移位前要知道的事情@cloudinary/react+

基于动作语法s-url-gen库内@cloudinary/url-gen)可能导致URL组成不同于由cloudinary-react库里

例举 :

  • URL生成云反射库
    https://res.www.agrosoland.com/demo/image/upload/c_scale,f_auto,q_auto,w_400/sample.jpg
  • URL生成js-url-gen库
    https://res.www.agrosoland.com/demo/image/upload/c_scale,w_400/f_auto/q_auto/sample.jpg


即使是交付媒体文件外观和行为完全相同,对 URLs的修改也可能产生下列影响:

  • 可见一次性增量变换计数
  • 可见新衍生资产存储用量一次性增加
  • URL使用加载变换参数时,你可以看到一次性加载使用量增加
  • CDN缓存可能需要用新衍生资产热
  • if严格变换允许您的产品环境(控制台安全页设置中),你需要允许新变换
  • 需要变换生成热切举长视频例子,你需要通过最新的SDK重生这些视频热切参数解析显式方法论

减少所有上述作用,我们建议使用createCloudinaryLegacyURL方法变换URLs, 特别是如果应用提供大数变换资产保持变换结构, URLs保持原样 。

上头createCloudinaryLegacyURL函数只支持变换和配置参数帮助迁移HTML标签、响应性、占位符、透明视频或jQuery功能

所有新变换URL添加应用时, 我们建议使用SDK最新版本提供的新基于动作语法

全文档使用@cloudinary/react+@cloudinary/url-genReact应用中包见反动SDK指南.

关键考量

云化事件包@cloudinary/reactfrontend-frameworks库使用云化avaScriptSDK高山市@cloudinary/url-gen提供云形变换优化功能正因如此,最新 ReactSDK与cloudinary-react库架构使用取决于您当前对React库的使用

可使用cloudinary-react,@cloudinary/react@cloudinary/url-gen同时应用中包,所以,尽管由于捆绑大小增加,长期不推荐,但从整合入手可以启动@cloudinary/react@cloudinary/url-gen输入应用并缓慢逐片迁移功能,直到你能够删除全部cloudinary-react功能性

安装

安装所需包使用NPR打包管理器

移动云实例配置

使用遗留 ReactSDK,你可能正在配置云名和其他配置参数CloudinaryContext.类似设置a中的参数云化实例提供@cloudinary/url-gen库内配置设置一次, 而不是为每个图像或视频设置

例举设置云化Name安全性CloudinaryContext元素 :

相似设置云化Name安全性云化实例 :

移动资产实例配置

也可以设置配置参数图像显示视频播放遗留 ReactSDK元素相似于为每个资产实例设置参数

例举设置云化Name图像显示元素 :

相似设置云化Name云化图:

注解
使用 云性实例配置免增配置参数

移动交付URLs

上头图像显示组件集cloudinary-react替换为高级图像组件集@cloudinary/react.

遗留 ReactSDK中指定变换参数图像显示组件中,最新SDK说明@cloudinary/url-gen云化图对象传递高级图像组件.

举个例子图像显示构件配置变换参数包括

无易迁移路径图像显示构件对高级图像可使用下列进程作为中间步骤创建URL,并用作正则图像标签源码

  1. 转换图像显示JSON组件XML转成JSON转换器可帮助此转换,或如果有大数URL转换,你可能想使用脚本上例变换

  2. 传递JSONcreateCloudinaryLegacyURL函数包含@cloudinary/url-gen库返回交付URL包括变换配置参数,例如云名函数调用中应包含此功能,因为这只是帮助者函数构建交付URL:

  3. URL为正则图像标签源

注意
有大数资产时推荐使用 createCloudinaryLegacyURL方法论使用新SDK变换语法替换现有变换时,可发现URL生成方式稍有不同看吧 移位前要知道的事情@cloudinary/react+,这些修改对变换URL的影响

面向所有新云式交付URL,你应开始使用@cloudinary/url-gen语法创建云化图可使用高级图像反应组件 :

产生URL为:

变换演技

移动高级图像组件和响应功能

高级图像组件懒加载,图像占位符图像无障碍性和)响应图像设置遗留 ReactSDK提供插件最新回想SDK

移送URL使用高级图像组件,您可使用插件如下:

注解
示例显示所有四种插件使用,但您只需输入并具体说明需要的插件即可使用一个或任何组合

相关题目

反馈发送

评分本页 :