Xamarin.Forms Android Release模式下LibVLCSharp播放HLS黑屏（仅SDK程序集）

发布模式下播放进度正常、但屏幕始终黑屏的问题，本质是Android链接器配合R8代码裁剪时，误删了LibVLC.Android原生层与.NET托管层交互必需的JNI桥接代码。
从捕获的运行日志可以直接定位核心故障：日志中反复出现的AndroidNativeWindow jni init failed、InitJNIFields failed，说明原生VLC层尝试通过JNI调用.NET侧的窗口初始化方法时，因为方法所在的类被链接器判定为“无直接静态引用”，被判定为无用代码直接裁剪移除，最终导致视频输出窗口创建流程中断。视频流的解码、进度推进逻辑不受裁剪影响，所以能看到进度条正常走动，但因为拿不到合法的渲染窗口，始终输出黑屏。
你观察到的两个现象完全匹配这个根因：

• 调试模式下功能完全正常，是因为默认配置下调试构建不会开启链接器裁剪，也会关闭R8代码压缩，所有代码都会被完整打包进应用
• 把链接器设置为“无”之后发布模式功能恢复，本质是关闭了代码裁剪流程，没有触发JNI方法丢失的问题

按照生产环境的可用性优先级排序：

方案1：添加链接器保留规则（适配当前版本的首选方案） #

这个方案不需要修改现有依赖版本，也不会损失发布包的优化收益：

• 在Android项目根目录新建LinkerDescription.xml文件，写入如下规则，明确要求链接器保留LibVLC相关的所有托管代码，避免被误裁剪：

  <linker>
    <assembly fullname="VideoLAN.LibVLC.Android">
      <type fullname="*" preserve="all" />
    </assembly>
    <assembly fullname="LibVLCSharp">
      <type fullname="*" preserve="all" />
    </assembly>
    <assembly fullname="LibVLCSharp.Forms">
      <type fullname="*" preserve="all" />
    </assembly>
  </linker>
  

• 打开Android项目的.csproj文件，在配置节中添加对该规则文件的引用，让链接器在执行裁剪时自动读取保留规则：

  <ItemGroup>
    <LinkDescription Include="LinkerDescription.xml" />
  </ItemGroup>
  

配置完成后，即使保留“仅SDK程序集”的链接器设置、开启R8代码压缩，也不会出现JNI方法被误删的故障。

方案2：升级官方Nuget依赖（长期维护的最优选择） #

你当前使用的LibVLCSharp.Forms v3.4.9、VideoLAN.LibVLC.Android v3.2.0属于较早的版本，这类版本没有在Nuget包中内置对应的链接器保留规则，才会出现裁剪误删的问题。后续官方发布的v3.6.0及以上版本，已经将完整的链接器保留规则内置到Nuget包中，升级后不需要手动编写保留规则，链接器会自动识别并保留所有LibVLC运行必需的代码，从根源上解决该问题。

方案3：临时规避配置（不推荐生产环境使用） #

也就是你当前测试使用的“将链接器设置为无”的配置，这个设置会完全关闭代码裁剪、移除R8的压缩优化能力，直接导致发布包体积大幅上涨，仅适合快速验证故障点，不建议在正式发布版本中使用。

内容的提问来源于stack exchange，提问作者Sjors Miltenburg