注意事项
除了以下的组件和 API,其余组件的用法都可以参照 QRN 的文档。
关于路由
注意 ⚠️ :QRN-Web 仅支持 Ext 的路由调用,如果业务线需要使用 QRN-Web,路由方案 只能 使用 Ext 的路由。
关于大客户端提供的一些 API
注意 ⚠️ :QRN-Web 没有内置大客户端所提供的一些公共 API(比如 ucAPI),如果业务线需要用到,请参考进阶配置在配置文件中添加 API 的脚本地址。
关于静态资源
注意 ⚠️ :由于 QRN 用到的静态资源(比如图片、字体)都是直接引入本地图片的,虽然直接引入的图片在打包的时候会自动打包到产物输出目录里,但是为了更快的资源加载速度,建议所有静态资源都使用 URL 引入(比如公司的 CDN),否则所有相关资源都会打包到 qzz 服务器上。
与 QRN 不一致的 API
由于平台限制,有些 API 的参数或者参数形式与 QRN 可能会有一些出入,有出入的 API 会记录在此。
FileUploader.uploadFile
- 由于浏览器不支持本地文件 URI,因此
FileUploader.uploadFile(uri, options, callback, errorCallback)
中的uri
参数实际只支持File
或者Blob
类型。 options.fileType
不是必填项,若未填会自动从uri
Blob 对象中的type
属性获取。- 若文件类型是
image/jpeg
或者image/png
,且提供了options.maxWidth
、options.maxHeight
或者options.quality
中的任意一个,则会对图片进行处理。options.quality
仅针对image/jpeg
有效,默认值为92
,范围0 - 100
。 - 若同时提供
options.maxWidth
和options.maxHeight
,则不会自动保持图片的宽高比,直接设置为图片的宽高,若只提供一项则会自动计算另一项,保持宽高比,0
值表示原始分辨率。 - 由于浏览器安全限制,该 API 有同源策略限制(协议、域名、端口任一不同即视为非同源),在使用之前请确保服务器开启了 CORS,并正确设置了
Access-Control-Allow-Origin
,Access-Control-Allow-Methods
,Access-Control-Allow-Headers
及Access-Control-Max-Age
等 HTTP 首部。
- 由于浏览器不支持本地文件 URI,因此
未实现的组件
- DrawerLayoutAndroid
- KeyboardAvoidingView
- MapView
- Navigator
- NavigatorIOS
- SnapshotViewIOS
- ToolbarAndroid
- TouchableNativeFeedback
未实现的 API
- AdSupportIOS
- BackAndroid
- DatePickerAndroid
- ImageEditor
- ImagePickerIOS
- ImageStore
- InteractionManager
- LayoutAnimation
- PermissionsAndroid
- PushNotificationIOS
- Settings
- StatusBarIOS
- Systrace
空实现的 API
- Keyboard
技术支持
如果在使用过程中遇到任何问题都可以 QTalk 联系 xinben.zhu。