Renative项目中Android TV和tvOS应用图标配置指南

在Renative跨平台开发框架中，正确配置应用图标对于Android TV和tvOS平台至关重要。本文将详细介绍如何在这些平台上设置应用图标，避免常见误区，并分享最佳实践。

应用图标配置基础

Renative项目通过appConfig目录和renative.json文件来管理应用资源。对于图标配置，开发者需要在appConfigs/app/assets目录下创建特定平台文件夹来存放图标资源。

Android TV图标配置

1. 默认配置方式：

   • 在appConfigs/app/assets/android目录下放置图标资源
   • 系统默认会使用android目录的资源同时适用于Android和Android TV平台
   • 图标文件应包含不同分辨率的版本（mdpi, hdpi, xhdpi等）

2. 专属Android TV配置： 如需为Android TV单独配置图标，需在renative.json中添加以下配置：

   "androidtv": {
       "assetFolderPlatform": "androidtv",
       "templateAndroid": {
           "AndroidManifest_xml": {
               "tag": "manifest",
               "children": [
                   {
                       "tag": "application",
                       "android:name": ".MainApplication",
                       "android:icon": "@mipmap/ic_launcher",
                       "android:roundIcon": "@mipmap/ic_launcher",
                       "android:banner": "@drawable/banner"
                   }
               ]
           }
       }
   }
   

   然后在appConfigs/app/assets/androidtv目录下放置专属图标资源。

tvOS图标配置

对于tvOS平台，图标配置略有不同：

1. 在appConfigs/app/assets/ios目录下放置图标资源
2. 确保包含所有必需的图标尺寸（App Store、主屏幕等）
3. 在renative.json中可配置资源引用：

   "tvos": {
       "templateXcode": {
           "project_pbxproj": {
               "resourceFiles": []
           }
       }
   }
   

常见问题解决

问题现象：修改图标后，platformBuilds目录中仍显示默认图标

解决方案：

1. 确保图标文件放置在正确的assets子目录中
2. 运行npx rnv clean清除构建缓存
3. 重新构建项目npx rnv build -p androidtv -s release -r

最佳实践：

• 始终通过appConfig目录管理资源，而非直接修改platformBuilds生成的内容
• 为不同平台维护独立的图标资源集
• 定期清理构建缓存以确保资源更新生效

高级配置技巧

对于需要更精细控制的场景，可以考虑：

1. 多环境图标：通过构建参数为不同环境（开发/测试/生产）配置不同图标
2. 动态图标：利用平台原生能力实现节假日或特殊活动的动态图标切换
3. 图标格式优化：使用矢量图形（Android的XML矢量图/iOS的PDF矢量图）确保最佳显示效果

通过以上方法，开发者可以高效地在Renative项目中管理Android TV和tvOS平台的应用图标，确保应用在各平台商店和用户设备上呈现专业、一致的品牌形象。