iceworks 3.0 发布 - 基于物料的一站式可视化源码研发工作台 🚀

[chenbin92]

2019 年 7 月 30 日，iceworks 3.0 正式版本发布！

主要更新

• CLI 使用链路：无需下载，一步开启全新研发体验；
• 升级产品结构：「项目管理」、「工程管理」、「物料市场」三大板块助力源码链路研发；
• 全新用户界面：多主题和多语言，满足开发者的个性化诉求；
• 可定制化工作台：任何前端项目，无论何种工程工具或项目规范，都可在 iceworks 中集成！

安装

在 iceworks 3.0 中， 我们提供了本地 CLI 的使用链路，安装 npm 的 iceworks 包，即可开始体验！

$ npm install iceworks -g # 或者 cnpm install iceworks -g
$ iceworks -V

启动

在命令行中执行以下命令，即可启用本地 Web 版本的 iceworks！

$ iceworks # open in browser： http://localhost:8000/

简介

升级产品结构

在现有的 iceworks 2.0 版本基础上划分 「项目管理」、「工程管理」、「物料市场」三个核心版块，覆盖前端项目的生成、开发到发布的完整生命周期，提供一站式的源码研发管理。

项目管理

• 覆盖项目研发的全流程，十多种面板定制使用，配置专属的 iceworks 界面；
• 基于物料的轻松拖拽，即可创建页面；
• 丰富多样的项目信息面板，为研发保驾护航：页面信息，路由信息，OSS 发布管理等；
• 新增 「路由」和「导航」的管理能力，告别复杂的代码配置。

工程管理

• 可视化设置项目的工程配置，告别对复杂的工程体系的理解；
• 一键启动调试服务、构建服务、代码检测等；

物料市场

• 官方提供的海量高质量物料，丰富的垂直领域模板和区块；
• 基于目标一键快速创建项目，开启项目开发；
• 支持自定义物料接入，不断提高代码复用性。

全新用户界面

• 支持多主题：提供「深色」和「浅色」两套主题，根据之前的用户调研，更多的用户更偏爱深色主题，这一功能在 iceworks 3.0 中得到了支持；
• 支持多语言：就是偏爱英文，我们满足你；
• 更大的项目面板，更清晰友好的用户体验！

可定制化工作台

为满足高级开发者的定制化诉求，iceworks 通过 adapter 的机制，支持开发者实现定制工作台的能力。

Adapter 本质上是某一类前端项目的最佳实践的抽象，通过 adapter 机制可以接入 iceworks 进行可视化的项目工程管理，定制专有的前端工作台。

更多关于定制工作台的介绍将会在未来释出。

项目升级到 3.0

iceworks 之前的项目如需升级到 iceworks 3.0，只需要按需配置对应的 adapter 即可。

对于旧项目，要升级到 3.0 请在 package.json 中增加如下配置

{
  "iceworks": {
    "type": "react", 
    "adapter": "adapter-react-v1", // 或者 adapter-react-v2
  }
}

上面的 adapter-react 后面的版本号选择 v1 还是 v2 可以根据下面来判断：

项目根目录是否存在 ice.config.js 文件：

• 如果存在，则使用 adapter-react-v2
• 否则使用 adapter-react-v1

注意：使用 iceworks 3.0 创建的新项目，adapter版本为 adapter-react-v3。

体验 & 反馈群

[alvinhui]

升级到 3.0 的迁移方式可以直接把内容贴过来吗？（内容也不多哈）

[chenbin92]

升级到 3.0 的迁移方式可以直接把内容贴过来吗？（内容也不多哈）

done

[chenbin92]

问题汇总

P0 主链路问题，P1 正式版前必须修复，P2 部分可以放到后续迭代版本

P0

@alvinhui

• iceworks electron 版本
• 启动时进入页面报错 Message [object object] iceworks 刷新报错提示 #2386
• [项目]项目列表错乱 https://img.alicdn.com/tfs/TB1bXnWbQxz61VjSZFtXXaDSVXa-1756-1516.png

@chenbin92

• 沒安装依赖点击 dev iceworks-server 会退出
• 项目面板设置样式错乱 https://img.alicdn.com/tfs/TB1FsVSXUD1gK0jSZFGXXbd3FXa-1358-1580.png

P1

@alvinhui

• 选择文件夹的地方需要过滤 . 文件
• 推荐模板背景色优化 https://img.alicdn.com/tfs/TB14dw1XxD1gK0jSZFyXXciOVXa-1072-501.png
• iceworks 3.0 项目管理文档（目录结构结构在确认下）

@imsobear

• iceworks 3.0 文档 Review和上线 [WIP][iceworks] 3.0 docs #2247

@chenbin92

• 透出 Vue 物料源作为官方推荐物料源
• 执行命令后默认自动用浏览器打开页面
• 底部切换主题的文案写反了
• 点击运行服务和安装依赖一直显示 start iceworks... iceworks 启动调试服务优化 #2402
• 工程面板需要增加「安装依赖」操作 feat: dependency check before starting a task #2421
• iceworks-cli 对 iceworks-server 的依赖动态化，启动时检测依赖版本是否有更新，参考 def-core 的做法 [iceworks] dynamic install for iceworks-server #2441
• midway 换成 midway-mirror，解决 tnpm 无法安装 iceworks 的问题 [iceworks] use midway mirror package #2437
• iceworks 3.0 新版官网介绍页更新 https://img.alicdn.com/tfs/TB1bURLeQ9E3KVjSZFGXXc19XXa-1915-4338.png
• socket 链接错误：https://user-images.githubusercontent.com/3995814/61096899-b6745f00-a48b-11e9-86d9-010f7ea57eb6.png

P2

@chenbin92

• 异步数据流未输入
  • 安装依赖输出日志感觉像卡死了，建议：
    • 持续输出日志，现在感觉不像 websocket，并且日志量很少感觉像加了 --silent
    • 安装前打印出执行的命令 xnpm install 之类的，node 版本之类的也可以输出下
  • 工程面板点击运行也有这个问题，看不到持续的日志输出，像卡住了一样
• ice 仓库英文文档
• [优化] server 启动时间有点长：考虑多输出一些日志或者优化启动速度
• 安装依赖 production 问题不会安装 devDeps
• 物料源数据缓存问题
• 主题文案切换
• server 端 log 沒打出来
• 启动服务输出 cli 和 server 版本

@ClarkXia

• 设置里加一个自定义源的能力
• 启动服务快捷入口改成链接跳转直接启动
• 安装依赖日志格式化问题：https://user-images.githubusercontent.com/3995814/60956209-e8bf7880-a334-11e9-8fd2-6bf783e6dec0.png
• 停止项目调试服务后，会报错： iceworks 3.0 发布 - 基于物料的一站式可视化源码研发工作台 🚀 #2369 (comment)
• [优化] 日志台高度没撑满
• 配置 npm client：npm/cnpm/tnpm

@alvinhui

• 依赖面板慢，依赖管理面板不需要显示更新信息
• [优化] 添加物料的 Dialog 太小
• [优化] 下载物料失败透出 URL 地址
• 无项目时，切换语言报错：https://user-images.githubusercontent.com/3995814/61025492-87a2ae00-a3e3-11e9-9784-c9ed948d0d9d.png
• 从 iceworks 中删除项目后 db.json 里的 panelSettings 内容还在

[ostli]

加油！

[luhc228]

问题描述

• Node版本: 10.16.0 LTS
• 系统：wIndows10
• 问题描述：开始项目（Vue项目）调试服务后，然后停止后，会报下面的错（第2、3图）。开始项目（React项目(使用ice-scripts)）调试服务，启动成功，然后停止调试，同样会下面的错（第2、3图）。

[imsobear]

从模板创建项目是个异步过程，界面上没有处理，网络慢的情况下就很明显

[imsobear]

入门指引面板建议跟其他面板保持一致，现在看起来有点奇怪：

[chenbin92]

入门指引面板建议跟其他面板保持一致，现在看起来有点奇怪：

这个当时设计的时候讨论过，是特意这样设计的，「入门指引」不属于一个功能性的面板，与其他面板有所不同所有特别突出了，可以在设置面板关闭

[chenbin92]

• 进入物料模块，默认会定位官方物料，此时异步请求未返回结果，切换至自定义物料，显示自定义物料内容，当官方物料结果返回后，会覆盖自定义物料内容

[alvinhui]

桌面端软件 Bugs

• 在部分机器上无法启动应用，报 iceworks-server 启动失败，无读文件权限； @imsobear
  
• 创建页面卡死；
• 退出时无等待效果 ；
• 窗口无法关闭。

发布流程相关

• 升级
  • iceworks-server 的升级：启动时升级，通过文件替换的形式。
  • iceworks-app 的升级：自动检测升级，使用 electron-autoupdate。
• changelog 的处理：
  • changelog/changelog.json：ice 站点使用；
  • changelog/${verison}.json：electron 升级时显示的更新详情；
• 将安装包上传到 OSS；
• 生成 update.json：ice 站点使用；
• 将 changelog、update.json 上传 到 osss

[zhaofeng-shu33]

在部分机器(mac 10.13)上无法启动应用的问题是启动方式不对，mac 上 /Volume下的 iceworks 文件夹是只读的

[zhaofeng-shu33]

应该安装到 application 目录下运行。

[alvinhui]

桌面软件版本的维护及升级策略

#2543

[ChasLui]

使用 3.0 之后经常 socket 断开连接(电脑休眠后), 这时候就需要重启 iceworks, 并且还需要 lsof -i:8000 找到 pid 然后 kill, 很是不方便

[chenbin92]

使用 3.0 之后经常 socket 断开连接(电脑休眠后), 这时候就需要重启 iceworks, 并且还需要 lsof -i:8000 找到 pid 然后 kill, 很是不方便

#2650 这里有 issue 记录，会尽快解决掉

[niweiL]

GeneralTable domo如何请求api数据渲染
能否给个具体demo
const mockData = async () => {
try {
const result = await axios('https://mock-api.hupu.io/mock/205/eg/test');
const data =[];
for(var i=0;i<result.data.length;i++){
data.fill(result.data[i]);
}

console.log("mockData:result:" + data);
return data;
// this.dataSource(result.data);

} catch (err) {
console.log(err)
}
};
这样写不行