5

维护两个10k+Star的Github项目,会遇到什么有趣的问题

 2 years ago
source link: http://www.androidchina.net/11857.html
Go to the source link to view the article. You can view the picture content, updated content and better typesetting reading experience. If the link is broken, please click the button below to view the snapshot at that time.

注意⚠️:阅读本文可能会浪费您宝贵的 5 分钟,本篇主要是吐槽和分享个人为维护 Github 项目以来的一些有趣的经历,所以阅读本文并不会增长你的技术,但是可能会给你带来一点欢乐。

开通 Github 至今也有 6 年多了,目前收获的总 star 数在 40k+ 左右,其中破 10k 的项目只有如下图所示这两个,今天突发奇想,“水一篇”分享关于项目收获的 issue 和感想。

GSYVideoPlayer

GSYVideoPlayer 这个项目算是比较小众,因为它是 Android 上的一个播放器集合项目,这个项目至今已经快 5 年了,所以你看到它 16k+ 的 star 基本都是靠时间换来的。

当然今天不是要讲项目的成长历程,今天主要聊有趣的 issue ,目前项目已有 3000+ 的 issue,当然聊之前,首先如下所示两张图是大前提,这个项目其实是有文档,有 Demo 和有 issue 模版的!!!

首先我想说的是:issue 模版真的是个“废物”

因为发现很多人基本都不看 issue 模版,直接提,爱怎么提就怎么提,今天心情好写个“大哥”,明天心情差来个“垃圾”,懒的时候直接只写了个标题让你意会,锻炼程序员隔空“盲狙”的能力,仿佛回到高中时期的阅读理解。

比如下图,我按照上面模版的内容检索,可以检索出近 500 的 issue ,是把模版原文直接提交,这里面还不包含那些无意义被我删了的。

其实一开始用 issue 模版是为了更好的沟通,引导使用者在查阅了相关资料后,能够根据我需要的问题内容来提出 issue ,这样才能更好的沟通,节约时间,只是没想到它反而成了 issue 里最多的 “垃圾内容”

接着的关键字是 “Demo 里有”, 是的,类似回复就有 300 多个 issue ,这年头 Demo 谁看呢,程序猿谁看 Demo ,你看 Demo 吗?

看 Demo 要 clone 代码,要打开工程,要运行,要查找,之后还要复制粘贴,提一个 issue 多好,只要坐等,喝杯茶就可以看到答案回复,妙啊~

然后作为一个播放器,被问最多的肯定就是 “播放失败”“为什么它可以播放你就不行,你是不是太“牙签”了?”

事实上关于 “播放失败” 的问题,大部分都可以在 issue 模版上的链接找到答案,当然眼力不好看不到的,帮忙复制一下也行,但是有时候也会遇到不按套路出牌的。

就比如下图所示这样,当时第一眼看过去还是很生气的,都带进门口了还需要帮忙动手开门,不过气归气,服务行业该有的素养还是要有的。

当然关于 “播放失败” 有时候也有苦笑不得的实话,比如下面这种,该怎么解释播放器它只是一个“孩子”,它读不懂 HTML 这么高深的内容呢?

当你以为上面的只是个例,这你就错了,考古更老的 issue ,还是可以找到类似的问题,并且你还反驳不了,因为浏览器确实可以播啊。

另外问 “录像”和“转码” 的问题也很多,但···它只是一个集合播放器啊,做不了编辑器相关的功能,请大家不要为难“胖虎”好吗?

当然,有时候遇上这类 issue 也是很有趣,因为代码里有 AD 这样的命名被 GP 拒绝❌上架,所以看来 Google 也不是很聪明的亚子嘛。

有时候你也会遇到“问题儿童”,因为他们问题真的很多,可能一个接着一个,而且可能还把你当兄弟,兄弟计较什么呢是吧?

当然,做视频 SDK 的,有时候也会遇到一些“尴尬”的视频链接,这时候我们就要义不容辞的清理,还 Github 一片净土。

“抖音” 肯定是现在做视频 SDK 不可避免的关键字,可以看到后期“抖音”出现的次数也不低,当然可惜的是,我一直没做

最后看看 GSYVideoPlayer 的 Traffic,可以看出来现在对视频播放需求还是不低的,同时写的文档也是有人看的,只是相比较起来,还是提 issue 更容易些~

gsy_github_app_flutter

gsy_github_app_flutter 项目是一个使用 Github 官方 API ,Flutter 开发的 Github 第三方 App,目前这个项目大概有 700+ 的 issue ,这项目 issue 其实不多,并且有价值的 issue 也比较少,因为里面有很多是开发人员的垃圾测试数据(因为我在 app 里把用户反馈数据提交到 issue 里)

这个项目最多的 issue 就是“跑不起来”,但是其实跑不起来的问题,90% 都可以看 README 里的这个流程解决!

但是搜索相关报错,可以看到很多都是在问“为什么缺少文件无法运行”,当然通过群问我这个问题的比 issue 更多。。。。

所以不看文档是一种共识!

而一般这种情况,如果有条件的状态下,我会回复“看 readme” ,毕竟 人家都叫 readme 了,你就 read 下嘛

当然也有说看不懂代码,让我添加一些中文注释的建议,我还是会欣然接受的,因为中文我还是可以的,要是加英文注释,按照我的水平,可能会写成:“This Function is dian zan and shou cang”

最后放一个我 RN 项目下的吐槽,就不打码了,这哥们也是真性情,可以看到哥们一脸不情愿的心路历程,说实话一般刚开始做跨平台开发的,都会遇到各种平台上的运行问题,对应的经历其实我就有不少,这是很正常,如果在逃不能逃的情况,只要熬过去了,有时候还是挺香的~因为你会发现,躺过的坑,都是你以后珍贵的财富。(前提是你有保存好这份财富)

最后,如果你看到这里,恭喜你浪费了人生中宝贵的 5 分钟,但是不管怎么样,希望我的开源项目能给你带来些许的帮助,这就是它存在的意义。

如果你也有什么关于开源和 Github 有趣的经历,欢迎评论,让大家也开心一下~


About Joyk


Aggregate valuable and interesting links.
Joyk means Joy of geeK