You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

发布首个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
    :-: | :-:
    ![iOS演示](assets/demo_ios.gif) | ![Android演示](assets/demo_android.gif)
    
  • 截取视频的首帧作为静态演示图,放在README的对应位置即可。

内容的提问来源于stack exchange,提问作者RobbB

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.09.25 15:15:02