Flutter应用中Cupertino Icons在部分Android设备上不显示是什么原因？

问题触发原因 #

• 摩托罗拉Android 10定制ROM的Skia渲染管线存在兼容缺陷，无法正确解析Cupertino图标矢量路径的透明度参数，导致图标被渲染为完全透明，因此组件可响应点击事件、控制台有日志输出，但肉眼不可见。
• 部分厂商旧版系统会限制未在manifest中声明的自定义字体加载权限，Cupertino组件依赖的CupertinoIcons字体资源未被系统正常加载，也会导致图标渲染为空。

是否为已知Bug #

该问题属于Flutter 2.10~3.7版本区间的已知兼容问题，官方仓库有对应issue记录，仅影响部分搭载Android 10的摩托罗拉、LG等品牌旧款机型，高版本Android系统、其他品牌设备不受影响。

修复方案 #

• 临时修复：在android/app/src/main/AndroidManifest.xml的application标签添加android:hardwareAccelerated="false"属性，全局关闭硬件加速即可正常渲染图标；如果担心全应用性能损耗，可仅在使用Cupertino选择器的页面对应Activity单独配置该属性。
• 替代方案：使用Material Design系列图标替换页面中用到的Cupertino图标，或者手动引入第三方独立图标库，规避系统对Cupertino默认字体的加载限制。
• 永久修复：将Flutter SDK升级到3.10及以上稳定版本，官方已经在该版本修复了Skia渲染引擎对定制ROM的矢量图标渲染兼容问题。

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