Amazon Fire设备VLC播放器源码编译及安装问题咨询

适配配置（解决「应用不适配当前电视」报错） #

• 修改Module级build.gradle的SDK版本配置：Fire系列设备minSdk最低支持到22，targetSdk不要超过33，避免高版本API不适配

  android {
      defaultConfig {
          minSdk 22
          targetSdk 33
      }
  }
  

• 调整AndroidManifest.xml的特性声明：删除VLC源码默认的leanback强依赖配置，替换为兼容Fire设备的声明

  <!-- 移除原配置：<uses-feature android:name="android.software.leanback" android:required="true" /> -->
  <uses-feature android:name="android.software.leanback" android:required="false" />
  <uses-feature android:name="android.hardware.touchscreen" android:required="false" />
  <!-- 兼容Fire设备遥控器输入 -->
  <uses-feature android:name="amazon.hardware.fire_tv_remote" android:required="false" />
  

• 限定ABI架构：Fire Stick设备仅支持arm架构，过滤不需要的x86相关架构减少包体积同时避免兼容问题

  android {
      defaultConfig {
          ndk {
              abiFilters 'armeabi-v7a', 'arm64-v8a'
          }
      }
  }
  

Release包损坏问题修复 #

• 开启v1签名：Fire设备强制要求APK携带v1签名，不能仅使用v2/v3签名，修改签名配置如下

  android {
      signingConfigs {
          release {
              storeFile file("你的签名文件路径")
              storePassword "签名密码"
              keyAlias "签名别名"
              keyPassword "别名密码"
              v1SigningEnabled true
              v2SigningEnabled true
          }
      }
  }
  

• 添加VLC核心库混淆规则：避免R8压缩时误删native库关联的类，在proguard-rules.pro中添加以下规则

  -keep class org.videolan.libvlc.** { *; }
  -keep class org.videolan.vlc.media.** { *; }
  

• 直接构建APK安装包，不要使用App Bundle格式，避免Fire设备不支持拆分特性导致的安装失败

安装验证步骤 #

• 开启Fire设备的ADB调试：进入设置-我的Fire TV-开发者选项，开启「ADB调试」和「安装未知来源应用」
• 使用ADB命令安装，跳过系统安装器的额外校验

  adb connect [Fire设备的局域网IP地址]
  adb install -r -d 编译生成的APK文件路径
  

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