反应迁移指南

导 言

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

密钥改进 ReactSDK

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

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

关键考量

云化事件包@cloudinary/react从frontend-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为正则图像标签源

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

产生URL为:

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

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

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