发布首个Flutter包后README演示视频在pub.dev不显示但GitHub正常,求原因
问题原因
- pub.dev的Markdown渲染器有严格的安全过滤规则,会直接移除所有
<video>类HTML标签,仅支持静态图片、GIF动图类的媒体内容展示,这是平台为了避免恶意代码注入、保障页面加载性能做的统一限制。 - GitHub的Markdown渲染对HTML标签的支持更宽松,允许
<video>标签正常加载和播放,因此你在GitHub仓库页可以正常看到演示视频。
解决方案
你可以选择以下任意一种方式调整README的演示内容:
- 将原有MOV格式的视频导出为GIF动图,把GIF文件存放在你的Flutter包项目的静态资源目录中,用Markdown图片语法通过相对路径引用即可,pub.dev支持项目内GIF动图的正常渲染展示。
调整后的示例代码如下:# Demo iOS | Android :-: | :-:  |  - 截取视频的首帧作为静态演示图,放在README的对应位置即可。
内容的提问来源于stack exchange,提问作者RobbB
相关产品推荐
相关产品推荐

