注意事项

除了以下的组件和 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.maxWidthoptions.maxHeight 或者 options.quality 中的任意一个,则会对图片进行处理。options.quality 仅针对 image/jpeg 有效,默认值为 92,范围 0 - 100
    • 若同时提供 options.maxWidthoptions.maxHeight ,则不会自动保持图片的宽高比,直接设置为图片的宽高,若只提供一项则会自动计算另一项,保持宽高比,0 值表示原始分辨率。
    • 由于浏览器安全限制,该 API 有同源策略限制(协议、域名、端口任一不同即视为非同源),在使用之前请确保服务器开启了 CORS,并正确设置了 Access-Control-Allow-OriginAccess-Control-Allow-MethodsAccess-Control-Allow-HeadersAccess-Control-Max-Age 等 HTTP 首部。

未实现的组件

  • 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。