V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
ScottHU
V2EX  ›  推广

这次,我们想真正为前端开发的你做点儿贡献

  •  
  •   ScottHU · 227 天前 · 2396 次点击
    这是一个创建于 227 天前的主题,其中的信息可能已经有所发展或是发生改变。

    前段时间,我设计开发了一个叫做 alovajs 的 js 请求策略库,在 23 年 4 月份开始对外宣传以来已经取得了来自世界各地开发者的好评,也获得了 2400+stars ,其中不乏大厂的牛人的认可,这已经让我很兴奋得失眠了好几次。

    s0.png

    本来只是一个普通的请求工具,但我希望它做一些其他请求工具没有做的,真正能帮助前端的事。经过不断地思考,推翻,再思考,再推翻,我想我确实找到了这个点,接下来把这个新想法分享给你。

    在了解它前,还得简单说说 alovajs 的过去,这也可能会让对开源有更深入地认识,也希望可以给你提供一些能量。

    如果对你有帮助,请帮忙点个赞或留下宝贵的评论,我都会一一认真阅读。

    对啦,4 月 14 日(周天) 20:00 我将会开启一场直播,有空来聊聊啊,微信扫码提前预约↓↓↓

    9470dc110efc35ca38f31308d536532.jpg

    同时,如果你对 alovajs 感兴趣,也诚挚邀请你加入社区共同进步,我们也将会在微信群不定期直播分享一些技术干货。

    alovajs 源于小项目,使命却是驶向大海

    2022 年 3 月的一天,我因某种情况萌生了开发一个名叫“目标控”的 App ,那时候得益于微信设置功能和滴答清单的启发,我希望目标控可以实现无延迟的数据请求和提交,即立即响应模式,即使在弱网或断网模式下也可以正常使用,但由于在网上翻了一遍都没有合适的解决方案,相似的乐观更新方案也无法满足,该死的热爱分享欲又让我决定以一个请求库的形式实现它,这就是 alovajs 的萌芽点,但那会儿还没有这名儿呢。

    设计 alovajs

    一个库的开始不是设计,不是开发,而是理清需求

    温馨提示:强烈建议你先简单了解下 alovajs 的概述部分,才能更好地理解下面的内容。

    那会儿也没有产品定位可言,只是做出满足自己需求的 js 库,我研究了现有的请求库,列出了下面这些需求:

    1. 要支持无感数据交互模式,即在断网情况下也能正常提交且无延迟,让用户毫无感知
    2. 按时下热门的 useHook 设计,让接口更加易用
    3. 一套代码同时支持多种框架如 vue 、react 等,js 运行环境如浏览器、react-native 、uniapp 和 taro 等
    4. 多 js 环境下一致的使用方式
    5. 鉴于 react-query 的缓存功能很不错,这个也要加进来
    6. 由于 axios 的影响力和简便性,让 alovajs 容易上手,设计要类似 axios

    然后根据需求进行库的 API 设计。

    • 对于需求 1 是我做 alovajs 的出发点,但也不简单,当时的设计是在 useHook 的配置中加入了一个silent参数,它可以立即响应 success 回调,但后来也证明有问题,并且重新设计了,也就是现在的无感数据交互策略

    image.png

    • 针对需求 2 设计了 useRequest 、useWatcher 和 useFetcher 三个核心 useHook ,这个大家都很熟悉了,例如 ahooks 的 useRequest 、vueuse 的 useAsyncState 、react-query 以及 swr 这些,自不用多说,确实很方便

    • 既然要用 useHook 设计,那么不同框架需要会有不同的状态管理,但又不想像 react-query 一样针对每一个框架搞一个 js 库,因此针对需求 3 设计了 statesHook 适配器、请求适配器、存储适配器的规范,并按规范编写不同适配器即可,将框架环境和运行环境相关逻辑剥离成单独的模块。

    • 针对需求 4 设计了 method 实例代理的模式,method 实例代理去调用不同适配器的钩子函数,这样即使你开发任何应用都可以毫不陌生地上手 alovajs ,也可以无缝移植

    • 对于需求 5 ,同类 js 库都是自定义 key 的形式实现缓存的,而我的思路却放在了请求信息上,常见场景是在以相同请求方式、相同参数请求相同接口时需要命中上一次的响应数据,那我们何不把这些请求信息作为缓存 key 呢,因此 alovajs 设计了自动化的缓存机制,在 GET 请求上默认是开启的。

    • 需求 6 嘛,借鉴参考一下 axios 。

    这些设计确实在以后的时间里得到了证实,alovajs 已经通过适配器的方式完美兼容了 vue 、react 、svelte 框架,并且也可以在浏览器、react-native 、uniapp 和 taro 等多种 js 环境下运行,并且保持了一致的使用方式,这让我看到了曙光。

    在这之后的几个月里 alovajs 虽然发布了,但一直没有去宣传它,一方面是因为我就是拿他用在“目标控”项目上的,虽然它在这个项目上历练完善了一番,但依旧很不完整,定位也不清晰,最初的版本介绍就是这样的。

    企业微信截图_17016791831963.png

    到后来,“目标控”项目已宣告夭折了(但官网还在),但 alovajs 却还在继续坚持着。

    alovajs 的方向探索

    本着曾经互联网产品经理身份的执念,我还是希望将 alovajs 打造成一个差异化的产品。我常常会问自己,alovajs 和其他请求库有什么区别吗?用户为什么要用 alovajs ?它在设计上确实和其他库有些不一样,这并不是马上能回答出来的问题。后来我尝试将请求库的方向定位在“轻量级请求库”、“多端统一的请求库”,但后来都被自己否定了,因为这些都不能为开发者带来实质性的帮助,也都不能称之为优势。

    时间来到了 22 年 9 月份,一次契机让我发现了 vue-request 这个优秀的基于 vue 的请求库,它的usePaginationuseLoadMore立刻给了我灵感,这种分页的实现形式让我发现这也是我想要的,同时这让我意识到 useHook 的力量之强大,我可以把它按请求场景切分模块,根据不同场景使用不同的 useHook ,而且之前实现的无感数据交互其实也算是其中一种场景。如果以这为方向的话,开发者按不同的请求场景选择不同的 useHook 就可以了,既提高了开发效率、降低了编码复杂度,又能防止初级前端写出低效代码,还能更大化地利用 alovajs 的核心特性实现性能更好、服务端压力更小的请求功能,至此,“轻量级的请求策略库”被我选中了。

    然后为了指导 alovajs 以后的设计方向,我还提炼抽象出了 alovajs 的请求场景模型( RSM ),主要分为以下四个流程:

    请求时机 -> 请求行为 -> 请求事件 -> 响应处理
    

    这里就简单提一下。

    说干就干,我根据这个定位开始重构 alovajs2.0 ,将无感数据交互功能从 1.0 中剥离出来,并设计了中间件机制来适应更多请求场景策略 useHook 的开发,潜心研究并设计开发了分页策略和无感数据交互策略。

    • alovajs 的分页策略是我自认为最好用的usePagination,它利用 alovajs 的缓存功能实现了前后页数据的预加载、分页数据搜索和请求级防抖、提供自动化管理的新增编辑和删除函数,以及无需重置地刷新指定页码的数据。

    • 无感数据交互策略更是花了我 4 个月时间,不断遇到死胡同,又不断重新设计的成果,实现了一个即使在弱网或断网环境下,用户也能无延迟的数据交互策略,同时它也可以更稳定地保证请求成功。我设计了一个虚拟数据的玩意儿,可以让请求在响应之前作为响应数据的占位符使用,让用户感觉是立即响应的,当响应成功后 再将虚拟数据替换成真实数据。按目前的探索结果,它的使用场景可以是编辑器类的应用、系统设置类模块,以及部分较简单的列表中。

    在后来也陆续增加了其他的请求策略模块,但这还远远不够。

    星辰大海的未来

    到现在,alovajs 收到了一些负面评论,但更多的好评让我对这个项目有了更多的动力,谁还在乎那些负面评价呢。

    23 年的 5 月 13 日,我在 github 上收到了这样一个 issue

    openAPI 的支持.png

    起初我并没在意这个 issue ,只是简单了解了下 openAPI 自动生成请求代码的功能,觉得很不错,但迫于经历有限也没深入思考,那会儿也还没在思考 alovajs 的方向。但在最近,我又会偶尔思考 alovajs 的方向,这个还是 open 状态的 issue 一直跑到我的思绪里,然后默默地把这个 issue 的 label 从"feature-request"改成了"feature-request:confirmed"。

    同时,这个 issue 让我灵光闪到,其实 alovajs 还可以拉近前端和后端的协作距离,并更进一步地简化前端开发的工作流,这就是我为 alovajs 制定的下一个发展方向:

    alovajs 将在请求方面帮你省去大部分的工作,你只需要指定使用哪个 API ,以什么策略执行请求就可以了。别再花时间在请求这件小事上了,交给 alova

    截屏 2024-04-09 20.10.47.png

    具体如下:

    1. 自动生成 ts 类型完整的、描述完整的请求函数,无论是 js 项目还是 ts 项目,都调用无需引入,让开发者就像直接调用location.reload这样方便,并且请求函数可直接看到完整的描述和请求参数类型提示,这些都可以由 openAPI 自动生成。

    2. 由于自动生成的请求函数拥有完整的描述和类型提示,通过 vscode 插件完成交互式的方式快速检索需要使用的 API ,你也不再需要去查阅 API 文档了。

    3. 解决前后端协作断层的问题,接口的任何变动前端可自动被通知,如果在构建项目时发现存在变动,则会抛出错误停止构建,如果是 ts 项目也会在编译时抛出错误,也可以通过 vscode 插件查看变动记录。

    先发一张剧照,直接在编辑器中根据接口描述或接口地址来插入接口调用函数。

    image.png

    具体的方案可点此查看 alova 产品白皮书及 3.0 更新一览

    如果这个能实现,应该能为前端技术实打实地做出一点贡献吧。

    同时,alovajs 将会探索更广泛的使用场景,例如适配兼容 solidjs 、preact 、angular 、lit 、原生小程序等更多框架和 js 环境,最终,我们会实现这样一个蓝图

    截屏 2024-04-09 20.18.51.png

    只有不断探索不断精进,才能变得更加优秀

    当时一篇被吐槽的文章《是时候该替换你的 axios 了》冲上了热搜,我们曾经收到过这样的评论

    image.png

    在刚推出来的时候确实没那么好,但我深知每个产品都不是一蹴而就的,它需要时间沉淀。

    Apple 1 电脑开始连机箱都没有

    image.png

    vue 的发展旅程也是不断摸索前进的过程

    image.png

    我只是被这样的产品历程所打动,坚持做一件事是最容易成功的途径,好的产品都要经过几年十几的考验,何况 alovajs 也只有 1 年半左右时间,被一部分人接触只有 8 个月。在这个期间也在一次次地探索更好的方案一步步前进的。

    alovajs 开始设计的 useHook 包含 useRequest 、useWatcher 、useEffectWatcher 、useManual 、useController ,然后再慢慢缩减为只有 useRequest 、useWatcher 、useFetcher 三个核心 hooks 。

    image.png

    Commit 地址

    在并行请求的设计上,是自定义实现一个类似 Promise.all 的形式,还是现在的 onSuccess 函数绑定形式,在这里纠结了好几个版本,改来又改去,以下是当年被废弃的 responser 设计。

    当年被废弃的 responser 设计.jpg

    Commit 记录找不到了

    为了兼容 IndexedDB 等异步的缓存方案,一开始尝试将存储适配器设计为异步函数,但会带来一系列问题,然后又尝试 StorageConnector 通过事件机制实现,依然不够完美,最后再到现在的自定义 localCache 异步函数机制。

    新建项目的副本.jpg

    Commit 地址

    也感谢对 alovajs 做出支持和贡献的朋友们,以下随便截了几张图,还有很多未被包含的贡献。

    新建项目.jpg

    image.png

    image.png

    image.png

    以及对文档不断地对细节补充和最佳实践的完善、对缓存恢复模式大胆尝试了缓存版本的方案,以及为了让 alovajs 可以提供完整的 ts 类型提示,尽量地使用自动推断类型来减少开发者定义类型的麻烦,在这方面也确实花了很大的精力优化和兼容不同的 UI 框架等等。

    其中,文档大改了两到三次,感谢 @橘子皮 给我提供了第一次文档修改的意见,@well 给我提供了第二次文档修改的意见,然后我们的文档就有了这样的口碑。

    111.jpg

    @青木 却帮我打开了新的 alova 全端思路。

    得供起来!

    新建项目.jpg

    很多已经记不清楚了,npmjs 上的记录告诉我已经发布了 146 个版本。

    image.png

    github 上也有很多人提出 bug ,我也在第一时间回复和修复,真的非常感谢,如果无法马上判断问题所在,我也会在 codesandbox 上自行复现,并用这个 demo 作为和使用者的沟通桥梁。

    alovajs 推广的心路历程

    我自己对互联网推广真的是一窍不通,写文章又烂,毕竟搞技术的大多不擅长表达嘛,又没有办法沉下心来不断产出文章,但是不得不尝试一下。

    我清楚地认识到,在推广这件事上需要做的,一点也不比开发少,而且需要有耐心,不能一蹴而就,也需要有自己的坚定信念,因为喷子真的无处不在。

    所以在去年 8 月份尝试编写了一篇文章,然后在网上发一些介绍的文章,在 QQ 群里发广告消息,但发现没什么效果,QQ 群里还遭人讨厌,但也收获了 alovajs 的第一颗 star ,应该也是出于同情心给的吧,效果甚微。

    直到确定好了定位,项目 2.0 重构完成后,才开始编写大量 demo ,让人在了解后可以马上尝试一下。

    在 23 年 4 月初,碰运气写了一篇爆款文章获得了不错的阅读量,沾了 axios 的光,然后网上开始陆续有人试用并分享出了自己试用的情况,也有人开始推荐 alova 了,这让我很欣慰。

    但很多人对 alova 都是持怀疑态度,又是一个重复的轮子,在没有名气的时候被这样认为也无可厚非,当然,现在也只是稍微有名就了一点点,还需更加努力。

    在需要帮别人复现 bug 、改 bug 、思考新特性设计、维护文档的同时,还需要思考如何推,执行推广工作真的是一件很累人的事。

    但不能不推吧,然后就想把教程搬过来发一遍,总比没有好,不过这真的没啥人看。

    image.png

    也还发过一些类似自擂自吹的,没有说明白的文章。

    image.png

    但这种确实会让人反感想想自己看到这样的文章也是这样的反应。

    image.png

    所以在这方面确实有点力不从心,alovajs 也就只在发了这些文章的情况下成长的。

    之前听一位营销大佬说过一句话:

    做营销应该是做一组军体拳,而不是花里胡哨的舞技

    这句话让我对产品推广有了思维上的转变,产品好的话,只要把它的优势说清楚就行了,而不用搞过多的花拳绣腿,然后把产品体验和学习门槛降到足够低,比如一件体验产品,以及出个视频教程之类的。

    现在我就在这诚心地邀请正在看文章的你来体验体验 alovajs:

    alovajs 是一个请求策略库,它提供了一套完整的应对复杂请求场景的方案,我们称之为请求策略,只需一行代码就能快速实现各种复杂的请求逻辑,不仅能帮你提升开发效率,还能帮你提升 App 的运行效率,降低服务端压力。

    感兴趣的话可以前往alovajs 概述了解详情,这里也有一些 alovajs 示例,你可以立即体验体验,喜欢就直接拿去用,我也不赚你一分钱。

    如果喜欢的话,还请帮忙发发朋友圈、掘金文章,或者抖音 b 站发视频都行,你的分享可以让更多人从 alovajs 中受益,也可以加入我们的社区,我们也将会在微信群不定期直播分享一些技术干货。

    别忘了,4 月 14 日(周天) 20:00 我将会开启一场直播,有空来聊聊啊,微信扫码提前预约↓↓↓

    9470dc110efc35ca38f31308d536532.jpg

    寻找志同道合的人

    能看到这边的你,应该花了不少耐心吧,非常感谢你的阅读🤗!

    alovajs 至今已得到一定的可行性验证,为了加快发展,现需邀请两名认同 alovajs 的朋友加入核心团队(现已确认一名),负责 alovajs 的核心工作,这可能会让你获得丰厚的收益,有意愿进一步了解的朋友可以加我微信,具体可见成为核心成员

    24 条回复    2024-04-11 09:26:27 +08:00
    R1hu6Hs2sSN8pkVX
        1
    R1hu6Hs2sSN8pkVX  
       227 天前
    一个好的库不需要推广
    TwilightCool
        2
    TwilightCool  
       227 天前   ❤️ 13
    感谢分享,已 Block
    tianzx
        3
    tianzx  
       227 天前
    写这么多,应该没人会看的
    kneo
        4
    kneo  
       227 天前 via Android
    写这么多都是流水账,自己总结,对别人意义不大。
    Light3
        5
    Light3  
       227 天前   ❤️ 2
    鉴定为 推广
    uni
        6
    uni  
       227 天前   ❤️ 1
    楼上的怎么这么刻薄啊,正好这两天在搭前端框架,正好在纠结请求库的搭建,正好就看到这篇贴子,正好就挺能解决我们的需求,现在就决定用你这个试试
    加油!
    yanyiming
        7
    yanyiming  
       227 天前
    感觉是比较针对业务需求的库.
    lstz
        8
    lstz  
       227 天前 via Android   ❤️ 1
    不要灰心,互联网就是这样,永远不缺冷嘲热讽的人

    你所要做的就是坚持,有用的建议就听,没信息量的评论就当乐色就好
    katwalk
        9
    katwalk  
       227 天前
    楼主认为产品优势的清晰表述比复杂的营销手段更为重要,but 。。。
    PTLin
        10
    PTLin  
       227 天前   ❤️ 3
    难怪看这个库名这么熟悉,原来是这个 https://www.v2ex.com/t/948621#reply125
    43n5Z6GyW39943pj
        11
    43n5Z6GyW39943pj  
       227 天前   ❤️ 3
    不会网络营销?我看你每次推广贴标题都很会起啊
    Eillott
        12
    Eillott  
       227 天前 via Android
    会营销怎么了,不会的程序员才在这阴阳怪气
    timedivision
        13
    timedivision  
       227 天前
    原来你就是作者,产品非常棒,也很佩服你的执行力,我在 github 上给你提了几个建议,还有加上了 onComplete ,哈哈哈
    panlatent
        14
    panlatent  
       227 天前 via Android
    才意识到我看 V2 更多的是想看评论
    qingyingwan
        15
    qingyingwan  
       227 天前
    第一眼看上去是营销推广。点到 github 看了下,代码是认真写的,issue 也是认真在讨论。虽然我目前还没有用的想法,但还是非常肯定这样的项目,希望越做越好
    qW7bo2FbzbC0
        16
    qW7bo2FbzbC0  
       227 天前   ❤️ 1
    @livid 推广
    darkengine
        17
    darkengine  
       227 天前
    为毛不直接放 github 链接啊。。。
    pytth
        18
    pytth  
       226 天前 via iPhone
    内容太多了,没有看下去的欲望,一句话加个 github 会更有效果。
    ScottHU
        19
    ScottHU  
    OP
       226 天前
    @whatFoxSay 6 ,我分享自己的经历也叫推广是吗?
    ScottHU
        20
    ScottHU  
    OP
       226 天前
    @Light3 不喜欢看可以不看,我赚你一分钱了?
    ScottHU
        21
    ScottHU  
    OP
       226 天前
    @uni 感谢啊,有问题可以反馈过来哦,我会及时解决
    ScottHU
        22
    ScottHU  
    OP
       226 天前
    @yanyiming 对,针对不同的请求场景选用不同工具就好了
    ScottHU
        23
    ScottHU  
    OP
       226 天前
    @timedivision 原来你就是贡献者,哈哈哈
    ScottHU
        24
    ScottHU  
    OP
       226 天前
    @qingyingwan 非常感谢你的认可,不过我分享自己的经历过程也叫推广啊?
    关于   ·   帮助文档   ·   博客   ·   API   ·   FAQ   ·   实用小工具   ·   1656 人在线   最高记录 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 24ms · UTC 16:51 · PVG 00:51 · LAX 08:51 · JFK 11:51
    Developed with CodeLauncher
    ♥ Do have faith in what you're doing.