iceworks CLI version：3.2.0

RT

问题描述

目前侧边栏上提供了一些快捷操作，如 NPM 脚本执行、依赖管理等。

但由于是单独的侧边栏，用户的主要操作在资源管理面板，因此对于一些常用的操作路径太深：

建议的解决方案

在标签栏右边添加以下几个快捷操作按钮：

• 启动调试
• 重装依赖
• 发布（仅内网）
  • 点击按钮后让用户选择发布的环境：「日常」或「线上」
  • 点击环境后，执行命令行：def p -d or def p -o

附加说明

• 该功能在 iceworks-app 插件中实现
• 不建议添加太多的操作按钮，以避免对用户造成干扰。宁缺毋滥。

使用命令iceworks add 添加区块的时候，期望下载区块代码的时候，同时安装相应依赖。一般区块开发的时候是会在package.json中定义依赖的，期望能自动安装这些依赖。不然自己还要手动去安装，手动安装步骤会比较繁琐。

需求来自 @enboga

问题描述

进入创建应用流程，然后直接点击下一步，弹出了「请选择一个模板」：

建议的解决方案

进入创建应用流程，默认选中一个模板，方便用户快速启动：

附加信息

注意在切换了左侧物料源后，需保持之前的选择。

• 插件名：iceworks-material-import
• 插件版本：v0.1.1

您遇到的问题及复现步骤？

• 物料面板滚动区域有误，滚动时无法切换物料源
• 缺少物料源配置按钮

您期待的正确结果？

• 只滚动物料列表，物料源切换和搜索框位置固定
• 添加物料源配置按钮

目前文档存在的问题：

• 演示图更新，使用最新的效果进行录屏
• 补充启用插件的说明

• 插件名：iceworks-team.iceworks-app
• 插件版本：v0.1.34

您遇到的问题及复现步骤？

1. 新建 VS Code 窗口

2. 点击 Iceworks 图标，出现如下视图：

   

您期待的正确结果？

出现欢迎侧边栏和创建应用的引导页：

https://github.com/ice-lab/iceworks/blob/master/packages/generate-project/src/fommatProject.ts#L50

您反馈问题的插件是？

• 插件名：Iceworks Application Viewer
• 插件版本：v0.1.33

您遇到问题的操作复现步骤？

点击启动，命令面板报错。

您期待的正确结果？

期望启动时如果相关命令行工具没有安装则自动帮我进行依赖安装。

方案

• 新增文件：demo/data.json，或者 data.js，动态性更强一些，针对一些循环的场景比较友好
• mock.json 的内容作为区块预览 demo 的属性

问题描述

模板的名称不太表意：

建议的解决方案

• Scaffold Lite => Fusion Design Lite
• Scaffold Simple => Simple

附加信息

物料源数据是根据 https://github.com/alibaba-fusion/materials 内的模板包 package.json 生成的

可以提 PR 或 issue 到该仓库。

settings.json 配置如下：

"iceworks.materialSources": [
    {
        "name": "PC Web",
        "type": "vue",
        "source": "http://ice.alicdn.com/assets/materials/vue-materials.json",
        "description": "飞冰官方推荐 Vue 物料"
    }
]

• 插件名：iceworks-material-import
• 插件版本：0.1.1

您遇到的问题及复现步骤？

不能向 pages 页面下的 components 添加物料组件

您期待的正确结果？

支持上述功能

简述

执行icesworks add block命令时，让填写block name，不管输入什么区块名字都报名字已存在

问题描述

按照 飞冰 文档-快速开发物料的步骤进行开发

1. $ npm install iceworks -g

2. $ iceworks -V
=> 3.2.0

3. $ iceworks init
填写信息

4. 在根目录下执行：
$ iceworks add block
block name EastEggLogin(试了无数名字)
=> this block name(@eastCentury/east-egg-login) has already exist. please retry

错误信息

this block name(@eastCentury/east-egg-login) has already exist. please retry

来自：@1YOYO

iceworks init --options={name: 'xxx', title: 'yyy', category: 'aaa'}

来自企业智能和 bizcharts 团队的需求

目前官方物料源信息也是放在用户配置里的，后面如果要改描述/地址或者增删物料源不太好操作，建议这个信息写死在代码里，用户只能配置自定义物料源。

• 插件名：iceworks-config-helper
• 插件版本：v0.1.1

您遇到的问题及复现步骤？

在 icejs 编辑 build.json 时的代码提示有误：

您期待的正确结果？

在 icejs 和 rax-app 项目的 build.json 有各自域的代码提示。

Do you want to request a feature or report a bug?

What is the current behavior?

If the current behavior is a bug, please provide the steps to reproduce and if possible a minimal demo of the problem.

• iceworks CLI version：
• Node verson：
• Platform：

What is the expected behavior?

习惯上，直观感受是执行创建项目会以输入项目名称，生成目录。建议这种出错能够错误提示，不要抛异常。因为新用户并不清楚这个工具的约定

来自 @hipoyang

在老版本发布下线公告，公告红底白色，用户可点击关闭公告栏，下次进入软件或刷新页面，公告继续显示。

内容：本软件已停止维护，请使用最新的 Iceworks Pack 进行替换 >>。

Iceworks 2.0

处理方式：发布 2.26.0 版本。

1. 上线公告，公告位置：

   

2. 停止接受新版的升级提醒。

Iceworks 3.0

处理方式：发布 3.2.6 版本。

1. 上线公告，公告位置：

   

2. 说明将在下一个版本(4.0.0)下线该功能。

Iceworks 4.0

处理方式：发布 4.1.2 版本。

1. 上线公告，公告位置：

   

发布时间：2020 年 7 月 2 日

能力增强 @alvinhui

目标

通过引入低代码手段，降低 UI 编排和物料使用门槛。

手段

• 新增：物料引用器插件(iceworks-material-importer)，提供通过点击物料引用物料的能力。RFC first @luhc228
  
• 新增：样式使用帮助插件(iceworks-style-helper)，新增主题变量自动补全能力。 @fyangstudio
  变量名补全：
  
  值补全（输入值，补全为值对应的变量）：
  

体验优化 @luhc228

• Iceworks App @luhc228
  • 当前窗口 workspace 为空时，调起项目创建器插件
  • 状态栏添加「iceworks」按钮，点击唤起 iceworks 相关的命令面板
    
  • 增加 Config Helper Ref: #21
• Iceworks Project Creator @luhc228
  • 【第一步】无线选择模板页面改为手机形状，参考：Need RFC
    

统一多端研发套件 @fyangstudio

目标

统一多端研发套件用户心智，Rax 首推使用 Iceworks。

衡量标准

• Iceworks 覆盖原 Rax VS Code 插件的功能
• Rax 钉钉群可宣导 Iceworks

手段

• Rax 插件下线
  • rax.vscode-rax-css-class 迁移到 iceworks-team.iceworks-style-helper
  • rax.vscode-rax-config-helper 迁移到 iceworks-team.iceworks-config-helper @alvinhui
  • rax.vscode-rax 中只依赖 iceworks-team.iceworks，更新 README.md 说明已下线
• Iceworks 插件中添加 Rax/ICE 关键字
  • 《快速开始》章节补充 Iceworks 流程
  • 《使用 VS Code 开发 Rax》章节更新

全面发布 @alvinhui

目标

面向 ICE 体系全面推广使用 Iceworks 新版本，统一研发套件的用户心智。

衡量标准

• ICE 体系统一透出 Iceworks 的品牌和口号
• 老版本 80% 升级到使用 Iceworks，以当前 DAU 量为基准

手段

• 仓库更新
  • icejs 仓库 的 README.md 「快速开始」中添加 Iceworks 创建项目流程
  • 其他仓库补充「 Ecosystem 章节」或更新「 iceworks 行的描述」
    • icestore
    • icestark
    • icejs
• ICE 站点更新
  • 首页
    • 首焦图添加 Iceworks 安装链接：vscode:extension/iceworks-team.iceworks
    • Iceworks 版图添加安装链接
  • 《快速开始》 章节补充 Iceworks 流程
  • Iceworks 章节
    • 直接使用安装链接：《安装》 、《快速开始》
    • 《概述》章节补充示例图
    • 插件列表补充最新的插件
• fusion 更新 @alvinhui
  • 工具页：https://fusion.alibaba-inc.com/tool
  • 开发者指南：https://fusion.design/help.html#/dev-use-module

Do you want to request a feature or report a bug?

What is the current behavior?

If the current behavior is a bug, please provide the steps to reproduce and if possible a minimal demo of the problem.

• Iceworks CLI version：
• Node verson：
• Platform：

What is the expected behavior?

Deadline: 6.18

工程 @luhc228

目标

• 快速初始化：拿到项目后，即可以通过 npm run setup 初始化项目并且进行开发调试
• 统一代码风格和编码规范，有持续集成进行保障
• 发布机制：有 packages 和 extensions 的 Beta 和正式发布机制

具体措施

• 快速初始化
  • webview 类型的插件，将前端应用单独到一个文件夹
  • extensions 下的插件 link packages
• 统一风格和规范
  • eslintrc 整个项目使用一份配置文件
  • tsconfig：整个项目使用一份配置文件
  • CI 问题跟进，确保 CI 流程可用。
• 发布机制 @fyangstudio
  • 将 packages 的发布加入持续集成流程
  • Beta 发布机制

数据统计 @alvinhui

目标

明确业务指标和统计业务指标的方法，根据业务指标持续迭代套件功能

具体措施

• DAU 统计
• 各插件具体功能的使用情况统计
• 数据统计的工具方法

日志监控 @alvinhui

目标

• 程序错误有记录，能够查看程序的错误发生趋势
• 用户反馈问题时，能追溯用户行为及复现

具体措施

• 明确错误分类及上报错误
• 统一的日志方案

能力增强 @fyangstudio

目标

持续丰富插件能力

具体措施

• Rax 插件迁移一份到 iceworks

文档 @alvinhui

目标

为用户提供统一的，一体化的使用文档。

手段

• 在 http://ice.work 导航栏提供文档入口，文档形式与站点保持一致。入口：https://ice.work/docs/iceworks/about
• 相关插件的文档可链接到插件市场。

功能增强

• 新增快捷操作按钮 #183
• 新增：组件创建器插件(iceworks-component-builder)添加通过可视化操作生成全局 UI 组件的能力。Need RFC
  

整体优化

• 添加日志监控 Need RFC @alvinhui
  • 用户反馈问题时，能追溯用户行为及复现
  • 对应用错误进行上传
• 国际化：跟随 VS Code 设置更新中英文

Iceworks Project Creator @luhc228

• 添加日志输出步骤
• 【第三步】填写过远端仓库地址，本地自动初始化并关联仓库
• 【第三步】工号和域名输入重复，改为仅输入工号（花名信息后台通过接口自动获取）

统一多端研发套件

• Rax 插件下线 @fyangstudio
  • rax.vscode-rax-snippets 迁移到 iceworks-team.iceworks-snippets
  • rax.vscode-flexbox-picker 迁移到 iceworks-team.iceworks-style-helper
  • iceworks-team.iceworks-project-creator 全面支持 rax.vscode-create-rax
  • 在 VS Code 插件市场下线 Rax 相关插件
• 老版本升级提醒 #147

文档

规范插件说明文档 #229 @sspku-yqLiu

背景

VS Code 插件打包成功后发布到插件市场，Azure 将会进行校验。

目前我们的插件发布到插件市场后，校验未通过，发布失败，返回信息：The extension 'iceworks-app' from 'iceworks-team' contains an entry which is unsafe for extraction.

问题定位

目前排查到引发问题的是 ice-npm-utils 依赖的包 npmlog。

验证方法是 ice-npm-utils 发布了 1.4.6-alpha.0 版本，当中移除掉了 npmlog 的依赖，最终插件 iceworks-team.iceworks-app 发布成功 0.1.17 版本。

解决方案

方案一

寻找类似的替代包，替换 npmlog ，并发布 ice-npm-utils 的 1.x.y 版本。

风险：

• ice-npm-utils 被依赖较多且将 log 对象导出，完全兼容 npmlog 的 API 可行性不大；
• 类似的替换包仍需进行测试，确保能够通过 VS Code 插件市场的检查。

方案二

• ice-npm-utils 移除 npmlog 使用 console 并发布 的 2.0.0 版本。将 ICE 内部管理的包对 ice-npm-utils 的依赖版本都升级到 2.0.0
• ICE 内部管理的包如有使用到 ice-npm-utils 1.x.x 版本的 log ，则改为内部引用 npmlog

风险：待评估

问题

icework-cli 目前放在本仓库中的问题：

1. 依赖的安装和单测的执行影响 CI 的执行时长：参考此 CI
   • 依赖的安装对 CI 的执行时长影响较弱，但单测的执行则拖慢了整体 CI 的时长，原因是 iceworks-cli 内有网络请求。
   • 单测还会因为网络原因经常执行失败，影响 Iceworks Pack 进行分支合并。
2. 从包职责来说，与目前的 Iceworks Pack 无关联性，开发者没必要下载和关注其代码实现；
3. 相关 issue 对 Iceworks pack 用户造成一定干扰。

iceworks pack 迭代高，而 iceworks-cli 迭代低，这样的 CI 资源消耗性价比太低了。

处理方式

将 iceworks-cli 独立一个仓库；

目前使用iceworks生成物料库及component的模板代码生成，基于build-scripts做工程构建。多数场景物料库是一个多组件的场景（多npm包），其中不乏多包依赖的问题。目前的这个工程套件没有支持lerna，在做包管理比较低效，希望增加lerna多包管理能力。

需求来自 @hipoyang

背景

用户有时候可能因为网络原因、VS Code 内部原因无法从插件市场安装：

这时候就需要走手动安装流程。

解法

• 正式发布时将安装包同步一份到 OSS
• 文档上补充手动安装的操作说明

您遇到的问题及复现步骤？

CI 执行 Auto Publisher，建构并发布 @iceworks/[email protected] 在 iceworks-component-builder 插件内的展示：

您期待的正确结果？

正常来说主题变量的赋值的样式应该生效：

期望走 CI 构建并发布 @iceworks/material-ui 的样式正常。

附加信息

可以对比 @iceworks/[email protected] 和 @iceworks/[email protected] 的构建产物的差别。

问题

1. npm 和 unpkg 是私有服务下物料模板未展示
2. 物料源地址：http://119.3.244.32:20024/gpx-components@latest/build/materials.json

注：飞冰群 #胜枫 反馈

问题描述

目前只能通过状态栏右下角或命令面板输入命名的方式唤起添加物料插件，唤起路径较长。

建议的解决方案

在 JSX 文件点击鼠标右键唤起的列表中显示「添加物料」：

考虑的备选方案

注册快捷键用于唤起「添加物料面板」。

打开工作台，点击终端，显示终端断开连接（提示终止终端或重新连接终端）

问题描述

• 目前的命令中，即有中文又有英文
• 命令列表中缺失了部分功能的命令唤起

建议的解决方案

• 命令默认使用中文
• 添加以下命令:
  • Iceworks: 添加依赖
  • Iceworks: 添加运行时依赖
  • Iceworks: 添加开发时依赖
  • Iceworks: 重装依赖

更换为：http://ice.alicdn.com/assets/materials/rax-materials.json

Release Date: 2020.6.3

新增插件

• 项目大纲树 iceworks Project Viewer @luhc228
• 项目创建器 iceworks Project Creator @luhc228
• 组件创建器 iceworks Component Creator @alvinhui
• 项目仪表盘 iceworks Project Dashboard @fyangstudio
• ~阿里内网登录 iceworks Alibaba Login @alvinhui ~
• 页面创建器 iceworks Page Builder @alvinhui

老插件迁移

将原有 Rax 插件合并及迁移到：

• 样式帮助 iceworks Style Helper
  • Rax CSS Class
  • Rax Inline Style
  • Flexbox Picker?
• 配置文件帮助 iceworks Config Helper
  • Rax Config Helper
• 物料引用帮助 iceworks Material Importer
  • Rax Tag Helper
• 物料使用帮助 iceworks Material Helper
  • Rax Props Helper

备选

• 项目质量评估 iceworks Project Quality @fyangstudio

发布时间：7 月 9 日

体验提升

整体

• 首次安装完成，弹出创建应用页 Need RFC @alvinhui
• 补充手动安装流程 #135 @fyangstudio
• 提升插件初次启动速度 @luhc228

Iceworks App @luhc228

• 启动应用时如依赖命令行工具不存在，则自动执行安装 #162
• 依赖列表，点击「安装」和「重装」后，自动刷新依赖列表
  
• [功能] NPM 脚本，提供停止图标，终止调试
  

其他

• 物料添加插件文档优化 #207
• 命令面板梳理 #186
• 添加依赖的输入框提示文案优化 #185
• 在 JSX 文件点击鼠标右键列表唤起的列表中显示「添加物料」 #182
• 进入创建应用流程，默认选择一个模板 #181

统一多端研发套件

Rax 宣导 @fyangstudio

• Rax 站点更新
  • 首页添加安装链接
  • 导航添加研发套件链接？

问题描述

添加依赖时会弹出文本输入框：

1. 需要是中文
2. 需要说明可以通过空格的方式添加多个依赖（目前用户以为只可以添加一个依赖）

建议的解决方案

请输入您需要安装的 npm 包名，通过空格分隔多个包。例如：lodash / lodash@lastest / lodash react / lodash@lastest react@^16.8.0