跳到主要内容

本地项目升级 icp 到相应版本的接口更新以及需要手动做的相应修改

环境要求​

  • Node.js 20.18.1 以上版本（你可以运行 node -v 来查看版本号）.
    • 如果你有其他项目必须要用更低版本的 Node.js，可以使用 nvm 来管理多个 Node 版本。
  • Yarn 1.22.22 以上版本（你可以运行 yarn -v 来查看版本号）。
    • 推荐使用 Yarn，其实用 npm 也可以 🧐。
注意

此文档已停止更新。最新文档请去 CHANGELOG 查看

备注

对本地项目框架源码的更新（例如 Template 和 MobileTemplate）如果没有特殊需求，可以使用 create-icp-app 重新生成一个全新的网站结构文件。

2.0.7​

1.0.0-alpha.325​

  • react-router-dom 升级到 6.26.2

1.0.0-alpha.322​

  • antd 更新到了 5.20.2

1.0.0-alpha.320​

  • yarn pre-dev 命令去掉了，改成了 yarn start:code 和 yarn build:code，如果有使用 code generator 过后生成的代码运行项目需求的，需要手动修改项目 package.json 文件，可以直接从 create-icp-app 生成的项目里 copy 该命令。

1.0.0-alpha.318​

1.0.0-alpha.317​

  • Select 组件 componentProps.mode 属性被 deprecated，Select 不支持 ant design 特殊的 mode: tags，多选功能使用 componentProps.multiple: true 替代

1.0.0-alpha.316​

  • 明确登录方式时不显示选择登录方式。 涉及文件变动：
    • src/components/PageRouter/Login/Login.js

1.0.0-alpha.312​

  • 升级 prettier 到 3.2.5

1.0.0-alpha.309​

  • process.env.PUBLIC_PATH 为 deprecated，取而代之请使用 window.ICP_PUBLIC_PATH。 增加构建参数 --no-dynamic-public-path，表示不需要动态 publicPath 将使用 appConfig 的 baseUrl。 开发模式不使用动态 publicPath，publicPath 仍然是/icp-ui/和/ui/ 涉及文件变动：
    • public/index.html
    • src/services/auth.js
    • src/store/features/authSlice.js
    • src/index.js
    • src/public-path.js
    • package.json
  • window.__bot_conf__.user_idle_time 废弃。取而代之使用应用级 appConfig.userIdleTime 或用户级 userProfile.userIdleTime。 涉及文件改动：
    • src/services/auth.js
  • 修复用户呆滞自动登出。 涉及文件改动：
    • src/services/auth.js
    • src/store/features/authSlice.js

1.0.0-alpha.307​

  • 所有的组件 ref 暴露都统一为 ref.node 表示渲染的根节点 dom。
  • TableElement 暴露的 ref 接口有修改。ref.api 改为 ref.gridApi。
  • EChartElement 暴露的 ref 接口改有修改。ref 之前为 echart 实例，现在 ref.chart 才是 echart 实例。

1.0.0-alpha.304​

  • restApi.js 增加对报错信息的翻译

1.0.0-alpha.299​

  • IcpApp 移除了 loginAddress 和 page401Redirect。固定使用 ${process.env.PUBLIC_PATH}login 作为登录页地址。涉及文件改动为：
    • src/App.js
    • src/hooks/useAuthingState.js
    • src/components/PageRouter/AuthWrapper.js

1.0.0-alpha.288​

  • Cascader 和 TreeSelect 的 dataResponseKeyPath 默认设置为 results，与其余组件保持统一。如果遇到这两个组件没有用表单数据源出错的情况自行修改 dataResponseKeyPath 值。

1.0.0-alpha.287​

  • restApi.js 增加 config 参数 skipResponseInterceptors: bool 跳过错误处理如报错提示和 401 登出
  • package.json 增加 script import, 执行 npm run import 用于导入 project-seed-data.json 到本地

1.0.0-alpha.272​

  • MainNav.js 菜单支持打开 Modal

1.0.0-alpha.266​

  • auth.js 修复 iframe 不监听用户 idle 状态

1.0.0-alpha.264​

  • restApi.js 中 message 导入方式更改 import { message } from '@icp/settings';，为了使 message 能使用上下文

1.0.0-alpha.253​

  • Login.js 中 url 参数 from 增加同源检查，外部地址不跳转

1.0.0-alpha-243​

1.0.0-alpha-240​

  • index.html 文件中 html 标签删除了 lang 属性

1.0.0-alpha-239​

1.0.0-alpha-238​

1.0.0-alpha-233​

1.0.0-alpha-224​

1.0.0-alpha-221​

  • auth.js logout 方法调整了 clearToken 位置，使 accessToken 能传入 logout api 接口

1.0.0-alpha-210​

1.0.0-alpha-195​

1.0.0-alpha-176​

  • 重构了 Template2，如果没有特意更改过项目的 Template2 文件夹下的东西，可以全量复制 packages/create-icp-app/template/src/components/Templates/Template2 替换项目的相应文件夹，同时记的删除项目的 App.css 文件里的如下代码 
    #root,
    .app {
      height: 100%;
    }
  • 去掉了 body css height: 100%，有需求的自己在项目里加回来。
  • 如果要更新 Template2，需要同时在 app.config.json 里加入 sidebar 配置: 
    {
      "sidebar": {
        "appearance": "dark",
        "collapsible": true
      }
    }

1.0.0-alpha-175​

1.0.0-alpha-173​

  • react-router-dom 6.12.1 在 production 模式下挂了，降级到 6.12.0。

1.0.0-alpha-172​

1.0.0-alpha-171​