---
title: Ray
---

# Ray 版本发布说明

## 1.7.x

**新增功能**

- 新增 Map 组件 `maptap` 点击事件
- 新增 `publishDps` 原子接口暴露
- 新增 IPC 相关 API
- 新增 ScrollView `scrollIntoViewOffset` 属性，支持滚动偏移量配置
- 新增 ScrollView `bounces` 属性，支持滚动回弹效果
- 新增 WebView / iframe `injectTTT` 属性
- 新增宠物记录仪相关接口
- 新增图表云能力 `exportStatistics15min` API（5分钟/15分钟级别统计数据）

**问题修复**

- 修复 `publishDps` 同名导出冲突问题
- 修复小程序构建产物中 chunk entry 生成冗余 CSS 文件的问题
- 修复 `app.json` 里多语言 `@i18n` 双引号的兼容问题
- 修复 `build-component` 生成 core-js 导入 JSON polyfill 的问题
- 修复 `textarea` 事件名错误
- 调整宠物 API 增值服务相关参数


## 1.6.x

**新增功能**

- **支持使用基础库内置 ray 运行环境**（无需框架包，接入更轻量）
- 支持页面快照（`snapshot`）
- 支持小程序分包配置
- 新增 AIKit 导出及类型定义
- 新增 AI 宠物（ai pet）系列接口
- 新增 AI 智能体接口
- 新增 IpcKit 及扫地机 `renameHistoryMap` API
- 新增陀螺仪扫地机 API 预埋
- 新增 IpcPlayer `type` 属性
- 新增 `setDeviceAddress` / `getDeviceAddress` 设备地址接口
- 支持 `offNavigationBarBack` 事件注销

**问题修复**

- 修复动态添加组件异常的问题
- 修复 View 和 Swiper 类型定义问题
- 修复 `getCurrentPages` 类型问题
- 修复 ScrollView `hideScrollbar` 属性未生效问题


## 1.5.x

**新增功能**
- 新增激光扫地机相关功能和 API
- 新增 `getLightHighPower` API，用于判断设备是否支持高级能力
- 新增 `getAppAuthorizeSetting` API，用于获取应用授权设置

**问题修复**
- 修复 Zigbee 遥控器 API 返回类型定义问题

**优化调整**
- 优化 `getAnalyticsLogsStatusLog` API，新增返回参数 `dpValues`

## 1.4.x

**新增功能**
- 增加 `openDeviceGWSubSearchConfigure`，打开网关面板配网子设备搜索配网（新版）
- 增加 `openDeviceGWSubHelpList`，打开网关面板配网子设备配网帮助列表（新版）
- 增加 `getRemoteLocalRelation`，用于面板获取配网后分配的 localIds
- 增加 `openOutdoorConfigDeviceHome`，打开配网页面
- 增加 `openDevNetworkCheck`，打开检测设备网络页面
- 增加 `openSmartScene`，打开场景页面
- 增加 `openDevManualAndSmart`，打开一键执行和自动化页面
- 增加 `openHelpAndFeedback`，打开帮助与反馈页面
- 增加 `openMoreService`，打开到更多服务页面
- 增加 `openAppHelpCenter`，打开帮助中心页面
- 增加 `openMessageCenter`，打开消息中心页面
- 增加 `getOutdoorDeviceIcon`，根据设备 ids 获取出行产品图片
- 增加 `reportOutdoorsLocation（设备位置上报）` 云能力 API
- 增加 `map.transformLocation（根据经纬度获取地址）` API
- 增加门锁相关 API
- 添加 `openCreateScene（打开创建场景页面）`、`openEditScene（打开编辑场景页面）`、`openConfigDevice（打开设备配置页面）`、`openGuideScene（打开引导场景页）`
- 增加户外出行跳转骑行导航客户端路由页面
- 增加 `OpenGroupCreate` 函数，用于创建群组
- 增加 `onOpenGroupCreate` 函数，用于创建群组监听
- 增加 `天气服务` 云能力相关 API
- 增加 `生物节律` 云能力相关 API
- 增加 `照明库` 云能力相关 API

**优化调整**
- 更新 MapKit，升级到 MapKit 3.4.13，并新增以下函数：
  - `reverseGeocodeLocation`
  - `coordinateWGS84ToGCJ02`
  - `coordinateGCJ02ToWGS84`
  - `getMapType`
- 更新 `getWeathers` 返回值，增加 `pop` / `qpf` 字段
- 更新 `设备日志` 的云能力相关 API
- 更新 `位置能力` 的云能力相关 API

## 1.3.x

**新增功能**
- `RichText` 映射 `onSelect` 属性
- 添加 `input` 左右侧内容缩进属性
- 添加 `nativeDisabled`

## 1.1.0

**新增功能**
- 增加位置能力相关 API

  ```
  import { map } from '@ray-js/ray'
  const { getLocation, chooseLocation, getMapList, isGeofenceReachLimit, openGeofenceMap, openMapAppLocation, registerGeofence, unregisterGeofence, updateGeofence } = map
  ```

## 1.0.0

**新增功能**
- 增加 Ray 使用插件能力
- `import { initPanelEnvironment, publishDps } from '@ray-js/ray'`
- `publishDps` 兼容基础与高级使用方式，详见文档

## 0.9.x

**新增功能**
- 增加部分 API

  ```
  import { getCurrentVolumeByMode, backToHomeAndOpenPanel, getAccountInfo, getAccountInfoSync, getDeviceListByDevIds, sendMqttMessage } from '@ray-js/ray'
  ```

## 0.8.x

**新增功能**
- 增加部分 API

  ```
  import { MiniWidgetDialog, handleShortcut,isAssociatedShortcut,isSupportedShortcut,connectBluetoothDevice,disconnectBluetoothDevice,onSubDeviceAdded,offSubDeviceAdded,onSubDeviceDpUpdate,offSubDeviceDpUpdate,onSubDeviceInfoUpdate,offSubDeviceInfoUpdate,onSubDeviceRemoved, offSubDeviceRemoved, registerGateWaySubDeviceListener, unregisterGateWaySubDeviceListener } from '@ray-js/ray'
  ```

**优化调整**
- 更新 `movable-view` `movable-area`

## 0.7.x

**优化调整**
- 在编译时进行了一些优化，以提高其性能或效率
- 绑定 `ray-core` 版本，减少安装依赖的心智

## 0.6.x

**新增功能**
- 增加 API `onAppEvent` `offAppEvent` `onAppHide` `offAppHide` `onAppShow` `offAppShow` `onError` `offError` `onThemeChange` `offThemeChange` `onWindowResize` `offWindowResize` `onPageNotFound`
- 增加 `WebView` `NativeVideo` `Map` `Camera` 异层组件
- 聚合包 `@ray-js/ray`
  - 提供 `@ray-js/ray` 作为 `@ray-js/framework`、`@ray-js/ray`、`@ray-js/api` 的聚合包，无需安装这三个包的依赖，只需要安装 `@ray-js/ray` 即可
  - 代码中引用 `api`、`components` 都可以从 `@ray-js/ray` 包中引用：`import { Button, View, Swiper, PageContainer, Input, Slider, Textarea, usePageInstance, getAppInfo } from '@ray-js/ray'`
- 提供 `usePageInstance` `useNativeEffect` `useQuery` `useComponentInstance`
  - `import { usePageInstance, useNativeEffect, useQuery, useComponentInstance } from '@ray-js/ray'`

**优化调整**
- 项目工程优化
  - 删除项目中遗留的 `react-native` 依赖
- 构建优化
  - RJS 构建优化
- 运行时优化
  - `@ray-js/env` 导出 `isTuya`
- 运行性能优化
  - 去除 Ray 框架 `undefined` 数据传递
  - 去除组件中无用的属性默认值
- API 依赖 Kit 升级
  - BaseKit -> 3.0.0
  - BizKit -> 3.0.1
  - DeviceKit -> 3.0.0
  - MiniKit -> 3.0.0
  - BaseKit 中 `getDeviceInfo` 别名为 `getMobileDeviceInfo`

## 0.5.x

**新增功能**
- 微信小程序分包能力

  ```js
  // src/routes.config.ts配置
  export const subpackages = [
    {
      root: 'packageB',
      pages: [
        {
          route: '/a/:uid',
          path: '/pages/a/index',
        },
      ],
    },
    {
      root: 'packageC',
      pages: [
        {
          route: '/c',
          path: '/pages/c/index',
        },
      ],
    },
  ];

  // 使用
  router.push(`/a/${Date.now()}`, {
    subpackage: 'packageB',
  });

  router.replace(`/c`, {
    subpackage: 'packageC',
  });
  ```

**优化调整**
- webpack v4 to v5
- npm 包 scope 由 `@remax` 切换成 `@ray-core`
  - `@remax/{pkgName}` => `@ray-core/{pkgName}`
  - `remax` => `@ray-core/ray`
- 编译性能优化