好的工具应该能够提供好的开发体验并促进效率的提升。为此 AppWorks 提供了基于 VS Code 的前端研发套件 —— AppWorks Pack 从以下几个方面来提高源码开发领域的体验和效率。
AppWorks Pack地址:
https://marketplace.visualstudio.com/items?itemName=iceworks-team.iceworks
▐ 极简的开发流程
Pack 将创建、调试和发布项目等操作通过插件的方式集成到了 VS Code 中,在编辑器内即可完成常见的工程操作以及与线上平台的对接。这些能力的集成使得开发者不需要频繁地在多个客户端、平台间进行切换和学习:
▐ 友好的可视化开发
Pack 提供了基于物料的可视化开发方式,基于 AppWorks Material 提供的海量物料,通过区块组装生成页面,一键添加物料到代码,物料的文档、示例都可以在编辑器中直接触达:
更详细的说明可以参见:《使用物料》
阅读地址:
https://appworks.site/pack/basic/materials.html
▐ 强大的编码辅助
Pack 提供的编码辅助能力包括:代码提示(自动补全、信息提示和定义跳转)、代码重构和代码片段等功能,这些功能是覆盖多种编程语言(Javascript、CSS)和多种 DSL(React、Rax)和多套研发框架(rax-app、ice.js)的。
以 Pack 提供代码重构功能为例,可以快速删除组件文件及组件文件所有的引用,同时删除掉由于组件属性所带来的不需要的变量:
更详细的说明可以参见:《代码补全》、《代码重构》
阅读地址:
《代码补全》:https://appworks.site/pack/basic/intelli-code.html
《代码重构》:https://appworks.site/pack/basic/refactor-code.html
让好的代码获得持续的关注
好的代码质量是软件工程的立身之本,好的开发工具应该能够为软件工程的代码质量提供保障。
为此 AppWorks 提供了代码质量解决方案 —— AppWorks Doctor 来解决该问题。Doctor 提供了代码规范和项目质量评估模型,并结合编辑器来进行自动修复规范问题和产出项目质量评估报告;线上则提供数据大盘来全面了解团队和项目的质量情况,帮助开发者和管理者对代码质量保持持续的关注。
▐ 代码规范
Doctor 通过 @appworks/spec 包来声明和约束代码规范。该规范遵循阿里巴巴前端编码规范,并结合了我们在 ICE 和 Rax 项目的最佳实践,包含 ESLint、stylelint、commitlint 及 Prettier 的相关规则,开发者可以很方便地与自己的前端项目进行结合。
地址:
@appworks/spec:https://www.npmjs.com/package/@appworks/spec
ICE:https://ice.work/
Rax:https://rax.js.org/
▐ 质量分析
Doctor 建立了项目质量评估模型,该模型包含以下几个维度的分析:
-
代码规范:通过 @ 扫描代码,并提供一键修复功能(Doctor 提供了默认的配置,但用户项目的 @appworks/spec 配置优先级将更高)。
-
代码可维护度:通过 typhonjs-escomplex 扫描代码。复杂度评分低说明代码的判断逻辑复杂,可能质量低且难于阅读、测试和维护。
-
代码重复度:通过 jscpd 扫描代码。重复的代码一旦出错,意味着加倍的工作量和持续的不可控。将提示进行代码抽象和重构来减少冗余代码。
地址:
typhonjs-escomplex:https://www.npmjs.com/package/typhonjs-escomplex
jscpd:https://www.npmjs.com/package/jscpd
开发者可以在 VS Code 中对自己的本地项目进行质量检测,并自动修复规范问题,查看维护度和重复度方面的分析及优化建议:
亦或者针对依赖的基础库和框架进行自动化的升级,Doctor 也提供了人为监督和偶尔干预的方式:
▐ 线上治理
代码规范和质量分析让开发者可以在本地主动地去优化项目的质量。但对于团队来说,依然需要有被动的方式来促进项目的质量治理。例如了解重点项目的质量趋势情况,团队成员的质量情况,推进落地最佳实践或某些依赖包的升级等等。
在阿里内部,Doctor 通过对接 DEF 工程平台,在项目的发布部署环节收集项目的质量信息,并给开发者发送此次迭代的质量报告,由此来提升团队成员的质量意识。同时发布环节的质量检测是可控的,当遇到一些特殊情况时,例如我们发现了某个有重大缺陷或安全问题的代码或依赖包,可以中断此次发布流程:
通过对项目发布时质量情况的采集,Doctor 能够知道团队内项目和成员的质量概况和趋势,在 AppWorks Data Platform 上进行数据的展示和分析:
地址:
AppWorks Data Platform:https://appworks.alibaba-inc.com/
这里面目前开发经常使用的场景是在线上网站展示项目的质量信息,开发者可以通过跳转到 WebIDE 唤起 Doctor 插件完成一键修复和优化代码:
让提升代码编率可度量
广义的研发效率是指软件从需求到上线的完整过程中的投入和产出比。编程效率是指单位时间内有效的代码产出,编程效率是研发效率的重要组成部分。
AppWorks 目标通过定义编程效率的评估标准,产出团队的编程效率报告,分析影响编程效率的因素,制定提升编程效率的方案,对方案进行实施,观测效率数据变化,调整提效方案,最终达到提升个人和团队编程效率的目的。
现阶段,AppWorks 主要完成了编程数据的采集及统计。
▐ 数据采集
AppWorks 通过 Time Master 插件来将自动追踪开发者在编辑器中的编码行为,Time Master 采集的数据包括开发者的编辑器使用时长及其在编辑器上针对代码文件的所有操作,例如打开文件、关闭文件、在代码文件上进行键入等;
最终可以做到统计开发者在每个文件、每个项目的详细编辑行为,例如:
-
停留时长
-
编辑时长
-
添加、删除的代码行数
-
添加、删除的字符数
-
键盘输入数
-
等等
在阿里内网环境,Time Master 将会把这些数据上报到 AppWorks Data Platform。
▐ 数据分析
基于上报的数据,AppWorks Data Platform 可以提供个人、项目和团队编程数据的统计和分析:
-
项目大盘:提供具体项目的成员开发投入情况的数据统计及分析;
-
个人大盘:提供个人质效数据统计及分析,并与团队的整体情况进行对比;
-
团队大盘:提供团队整体的项目质效数据统计及分析,团队成员的质效概况。
未来展望
▐ 编码辅助增强
从过往一年的用户使用数据来看,编码辅助功能依然是开发者使用最频繁的功能,对该功能准确率的提升会促进曝光率和转换率的提升:
- 转换率:使用量/曝光量
- 曝光率:曝光量/活跃用户数
从日常的用户访谈来看,开发者对基础库和框架的代码提示和代码重构有迫切的期待,诸如快速提取代码、快速变量命名、Inline Style to CSS 等操作,能为开发者提供愉悦的编码体验。未来 AppWorks 将持续增强编码辅助能力,并结合 Time Master 对相关功能的实际编码效率提升进行量化。
▐ 项目质量治理
AppWorks 在上一个年度完成了 Data Platform 的雏形,打通了质量数据的上报、存储和统计链路。
但有数据只是提供了参考价值,基于数据做出行动,持续完善数据模型,使得指标数据提升,才能完成体现数据中心的价值。
未来 AppWorks 将通过线上网站和编辑器端信息的触达,让开发者和管理者了解基础库和框架的最新动态,配套升级工具,推动团队基础设施的升级。例如通过线上线下的联动,推进 React 15 升级到 17,Rax 核心库从 0.6 升级到 1.0 等等。
▐ 工具箱能力完善
AppWorks Toolkit 的第一个版本中已完成快速安装必备工具和管理 Node 版本功能。未来将持续完善对前端工具和开发环境的管理和配置能力,成为前端开发的第一入口,帮助初学者快速开始前端开发,引导开发者用好工具,排查和修复开发环境问题。例如:
-
全局 npm 的管理
-
Git/SSH 配置
-
浏览器/编辑器插件管理
▐ 编程数据价值挖掘
AppWorks 在上一个年度完成了编程数据的上报、存储和统计链路。未来 AppWorks 将主要通过 API 或离线数据分享的方式,让业务平台和工程平台利用编程数据进行研发效能的度量或分析,使得数据价值更大化。
写在文末
AppWorks 将持续重视用户体验,做开发者喜欢的、好用的工具。任何建议或意见,可以提交 issue 给我们:https://github.com/appworks-lab/site/issues
相关资料
-
AppWorks 官网:https://appworks.site
-
AppWorks Toolkit: https://github.com/appworks-lab/toolkit
-
AppWorks Pack: https://marketplace.visualstudio.com/items?itemName=iceworks-team.iceworks
-
AppWorks Material: https://appworks.site/materialCenter/fusion
✿ 拓展阅读
自我介绍一下,小编13年上海交大毕业,曾经在小公司待过,也去过华为、OPPO等大厂,18年进入阿里一直到现在。
深知大多数前端工程师,想要提升技能,往往是自己摸索成长或者是报班学习,但对于培训机构动则几千的学费,着实压力不小。自己不成体系的自学效果低效又漫长,而且极易碰到天花板技术停滞不前!
因此收集整理了一份《2024年Web前端开发全套学习资料》,初衷也很简单,就是希望能够帮助到想自学提升又不知道该从何学起的朋友,同时减轻大家的负担。
既有适合小白学习的零基础资料,也有适合3年以上经验的小伙伴深入学习提升的进阶课程,基本涵盖了95%以上前端开发知识点,真正体系化!
由于文件比较大,这里只是将部分目录截图出来,每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频,并且会持续更新!
如果你觉得这些内容对你有帮助,可以扫码获取!!(备注:前端)
最后
一个好的心态和一个坚持的心很重要,很多冲着高薪的人想学习前端,但是能学到最后的没有几个,遇到困难就放弃了,这种人到处都是,就是因为有的东西难,所以他的回报才很大,我们评判一个前端开发者是什么水平,就是他解决问题的能力有多强。
分享一些简单的前端面试题以及学习路线给大家,狂戳这里即可获取
上前端开发知识点,真正体系化!**
[外链图片转存中…(img-E6vB5zfX-1713352642666)]
由于文件比较大,这里只是将部分目录截图出来,每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频,并且会持续更新!
如果你觉得这些内容对你有帮助,可以扫码获取!!(备注:前端)
最后
一个好的心态和一个坚持的心很重要,很多冲着高薪的人想学习前端,但是能学到最后的没有几个,遇到困难就放弃了,这种人到处都是,就是因为有的东西难,所以他的回报才很大,我们评判一个前端开发者是什么水平,就是他解决问题的能力有多强。
分享一些简单的前端面试题以及学习路线给大家,狂戳这里即可获取
[外链图片转存中…(img-QIag7IER-1713352642666)]