[null,null,["最后更新时间 (UTC)：2025-07-27。"],[],[],null,["# TV app icon design guidelines\n\nThis guide describes creating banners and launcher icons for Android TV.\n\nKey takeaways\n-------------\n\nThe following are the key takeaways from this page:\n\n- There are two icon types for Android TV OS apps in AndroidManifest.xml:\n - `android:icon` (standard, mandatory)\n - `android:banner` (banner, mandatory)\n- Adaptive icons are highly recommended.\n- Both the icon and banner must comply with the design guidelines outlined in this guide.\n- Use the [official figma template](https://www.figma.com/community/file/1283953738855070149) for generating the banner \\& icons\n- Android TV OS doesn't support themed icons.\n\n| **Note:** `android:roundIcon` is deprecated and shouldn't be used in favor of adaptive icons.\n\nOverview\n--------\n\nGoogle TV and Android OS make use of iconography provided through your\n`AndroidManifest.xml` in three ways:\n\n- Launcher icon (1x1 aspect ratio)\n- Round launcher icon (1x1 aspect ratio, but circular)\n- Banner logo (16x9 aspect ratio)\n\nThese are used in different places for different use cases, such as the\n**Your apps** row, Settings, or installation progress.\n\nBanner\n------\n\nThe Banner logo is a 16x9 aspect ratio logo that is used in Android TV OS to\nshow your app launcher. We recommend that TV apps provide an adaptive\n16:9 banner with the following specifications. You can also provide\nxhdpi resources with size of `320 x 180px` when using API level 25 or lower. \n\n| Density | Min Size | Folder location (under res) | Pixel Ratio |\n|---------|------------|-----------------------------|-------------|\n| mdpi | 160x90 px | mipmap-mdpi | 1 |\n| hdpi | 240x135 px | mipmap-hdpi | 1.5 |\n| xhdpi | 320x180 px | mipmap-xhdpi | 2 |\n| xxhdpi | 480x270 px | mipmap-xxhdpi | 3 |\n| xxxhdpi | 640x360 px | mipmap-xxxhdpi | 4 |\n\n| **Note:** Text must be included in the image. If your app is available in more than one language, you must provide separate versions of the banner with text for each supported language.\n\nLauncher icon\n-------------\n\nThe Launcher icon is a 1x1 aspect ratio resource that is used in multiple\nplaces such as Settings and Media session integrations (Now playing card)\non Android TV. The launcher icon can also be used in **Your apps** row\non Google TV. \n\n| Density | Min Size | Folder location (under res) | Pixel Ratio |\n|---------|------------|-----------------------------|-------------|\n| mdpi | 80x80 px | mipmap-mdpi | 1 |\n| hdpi | 120x120 px | mipmap-hdpi | 1.5 |\n| xhdpi | 160x160 px | mipmap-xhdpi | 2 |\n| xxhdpi | 240x240 px | mipmap-xxhdpi | 3 |\n| xxxhdpi | 320x320 px | mipmap-xxxhdpi | 4 |\n\nAdaptive icons\n--------------\n\nAs of the Android 8.0 release (API level 26), there is support for\nadaptive launcher icons, which allows for more flexibility and interesting\nvisual effects when it comes to app icons. For developers, that means that\nyour app icon is made up of two layers: a foreground and a background layer.\n\n### Adaptive banner\n\nYou can also provide an adaptive banner along with a legacy banners,\nsimilar to launcher icon banners that also have two layers. \n\n### Adaptive launcher icon\n\nTo ensure that your adaptive icon supports different shapes, and visual\neffects the design must meet the following requirements:\n\nProvide two layers for the color version of the icon:\none for the foreground, and one for the background. \n\nAdaptive icons are defined using foreground and background layers. The 72 x 72\nsafe zone in the first image shows where your icon and foreground layers are\nnever be clipped by a shaped mask.\n\nA monochrome version of the icon is not required as Android TV\ndoes not support themed icons.\n| **Note:** Android or Google TV don't support themed icons.\n\nExamples\n--------\n\nBelow are some do's and don'ts to consider when designing a TV app icon.\n\n### Banner examples\n\ncheck_circle\n\n### Do\n\nFollow the guidelines, keep the logo in safe area \ncancel\n\n### Don't\n\nAvoid using text or graphic elements to indicate any additional information. \ncancel\n\n### Don't\n\nDon't use text or graphic elements that can mislead users \ncancel\n\n### Don't\n\nDo not spill the logo out of safe area \ncancel\n\n### Don't\n\nAvoid adding any border around the logo as they get cropped and create unpolished visuals. \ncancel\n\n### Don't\n\nAvoid cropping the logo \nwarning\n\n### Caution\n\nWhen using a banner its recommend you show your full logo, icon + text.\n\n### Launcher examples\n\ncheck_circle\n\n### Do\n\nFollow the guidelines, keep the logo in safe area \ncancel\n\n### Don't\n\nDon't use text or graphic elements to indicate any additional information. \ncancel\n\n### Don't\n\nDon't use text or graphic elements that can mislead users \ncancel\n\n### Don't\n\nDo not spill the logo out of safe area \ncancel\n\n### Don't\n\nAvoid adding any border around the logo as they get cropped and create unpolished visuals. \ncancel\n\n### Don't\n\nAvoid cropping the logo\n\nResources\n---------\n\n- [Official figma template](https://www.figma.com/community/file/1283953738855070149) for banner \\& icons\n\nRelated reading\n---------------\n\n- [Adaptive icons mobile](/develop/ui/views/launch/icon_design_adaptive)\n- [Using the adaptive icons](/codelabs/basic-android-kotlin-compose-training-change-app-icon#2)\n- [Designing adaptive icons](https://codelabs.developers.google.com/design-android-launcher#0)"]]
