头图

前言

NutUI 自诞生以来,一直在紧跟技术的发展不断推陈出新,NutUI 经历了 v1.0、v2.0、v3.0 三次技术的革新蜕变。始终保持稳健的发展态势,从一个单一的基础组件库发展到如今服务于数千开发者的多端 UI 组件库。NutUI 的成长离不开团队成员的努力,更重要的是离不开广大社区开发者的反馈和共建。

开源收获

活跃的 Github

从 2019 年开源到现在为止,共计 10490 条 commits 记录,发布了 249 个版本。在团队成员和社区开发者的共同努力下,累计关闭了 1553 个 issue。社区的小伙伴非常给力,积极的解决 issue,共提交 134 条 PR。

活跃的社区

官网文档是开发者入门的钥匙,官网每日的访问量达到 1.5w 左右。同时,为了及时的解决大家的疑问,开发者们积极进行社区交流群的建设。同时定期更新 NutUI 相关的文章和视频,帮助大家了解组件的开发设计,现有技术文章 50+ 篇,发布视频 5 个。NutUI 现有 5 个微信开发者交流群,4 个内部咚咚群,团队成员每天都会接收到诸如组件问题、开发者建议、bug 等信息。

贡献者们

NutUI 由衷感谢各位小伙伴对开源事业做出的贡献!目前社区贡献者已经达到了 74 位。(🚀 增加ing)

NutUI 贡献者

面对日新月异的技术发展,用户环境越来越复杂,所面临的挑战也越来越多。正所谓“众人拾柴火焰高”,特别感谢大家为组件库做出的工作和努力,欢迎大家成为 contributor。

期待您的加入

每天社区都会有新的问题产生,大家都可以去尝试修改,或者提供自己的看法思路。当然,大家提交 PR 不局限于新组件新功能,也可在 issues 中选择自己感兴趣的问题去修改。

issues

为方便共建,为大家提供了几个共建方向,大家可根据自身的技术能力去考虑。

1. issues 类

解决 github 上关于组件的问题或建议,与开发者互动交流,解决开发者的疑问。可以根据 question、suggest 等标签识别,常涉及项目启动、依赖包报错、组件兼容等问题,可根据实践经验进行 comment,涉及组件会通知在哪个版本发布,涉及工程可提供解决问题的参考链接。

2. bug 类

某个组件的功能出现问题或无法满足当前业务场景,根据开发者反馈的复现代码,我们进行本地调试复现,使用测试仓库来复现问题。定位问题后在本地的 NutUI 源码中进行修改,测试通过后打包 dist 文件夹,替换测试仓库中 node_modules 中 @nutui/nutui 下的 dist 文件夹进行校验。

3. 新增组件

从业务代码中可提取出通用的、适用场景较广的组件。新增组件需要经过严格的测试,首先保证组件的功能已实现并正常运行,其次增加对应的单元测试,然后在我们提供的测试仓库中模拟使用,最后完善组件 md 使用文档,具体步骤可参考 NutUI 贡献指南

4. 国际化

目前支持中文、英语、泰语、印尼语、繁体中文五种语言。如您的场景有使用到其他语言,欢迎 PR 新的语言包,具体内容可参考语言包。如果您想在业务代码中实现国际化,可以借助 vue-i18n 实现。

5. UI 定制

我们现在有4套官方主题,如果您有特殊的需求可以使用NutUI 在线主题预览生成器生成主题,根据配置会下载 custom_theme.scss 文件,可将文件引入到项目中或将内容复制到指定文件,从而实现自定义主题。详情可参考视频教程

6. 平台类适配

在 H5 和小程序(微信小程序、支付宝小程序、京东小程序等)平台适配过程中可根据 Taro.getEnv() 判断环境。H5 环境我们需要对浏览器或 android、ios 进行适配,小程序环境应在对应的开发平台中开发测试,并且手机可扫码体验,保证组件在各平台正常运行。

7. 跨端扩展

在支持 H5 和小程序场景外,对移动端跨端技术适配进行探究,如 uni-app、react-native、flutter 等。规划阶段可参与开发方案、组件交互设计等建设,为开展跨端组件库开发工作做准备。

关于更详细的共建流程,感兴趣的小伙伴戳这里 👉 NutUI 贡献指南

同时,在 github 上会不间断更新遇到的棘手问题,甚至是底层架构技术等,有兴趣的小伙伴想要挑战的,欢迎 PR。目前在 github discussions 定期维护更新,欢迎大家发言。

共建方向

知识共享

如果您有更加广泛的爱好,比如写作、拍视频等,非常欢迎有此特长的小伙伴。目前 NutUI 也在推出一系列的文章和视频,欢迎大家投稿呀~ 每隔一段时间会定期评审,给投稿的小伙伴发送小礼物哦~

一. NutUI 开发实践或源码解析等文章

邮箱:nutui@jd.com

内容:

  1. 个人信息及 md 文件
  2. NutUI 团队会及时与您沟通文章发布问题

二. NutUI 系列相关视频

邮箱:nutui@jd.com

内容:

  1. 个人信息及相关视频
  2. NutUI 团队会及时与您沟通视频发布问题

定制共建

NutUI 默认是京东 APP 视觉规范,通过“组件级 UI 定制”能力(共建兄弟团队:京东科技-金融科技群-UED、京东零售-B商城前端团队)已陆续定制出 NutUI-JDT (偏B端业务) 和 NutUI-JDB(B 商城 UI 规范)两套 UI。接下来我们还将基于京东各 BG 陆续输出符合业务诉求的 UI 样式。

如果您的业务场景中有个性化(定制 UI)诉求,欢迎您使用 NutUI 在线主题预览生成器,可快速生成一套自己的 UI 组件库。同时可将组件皮肤贡献到 NutUI 社区,让更多的开发者享受到福利。

NutUI 助力发展

写在最后

庞大的开源社区一定有很多值得去学习的东西,开源本身是一场历练和修行。成为 contributor 不是目的,通过阅读代码和修复 bug 也是一种提升,也会认识很多志同道合的朋友。我们希望每一个开源者都能用微笑面对这一路的风景。

NutUI 诚邀您的加入

联系邮箱:nutui@jd.com

邮件标题:【NutUI 共建】+ 您的 github 账号

欢迎加入 NutUI 交流群

京东设计中心JDC
696 声望1k 粉丝

致力为京东零售消费者提供完美的购物体验。以京东零售体验设计为核心,为京东集团各业务条线提供设计支持, 包括线上基础产品体验设计、营销活动体验设计、品牌创意设计、新媒体传播设计、内外部系统产品设计、企...