Google TV 및 Android OS에서는 AndroidManifest.xml를 통해 제공되는 아이콘을 세 가지 방식으로 사용합니다.
런처 아이콘 (가로세로 비율 1x1)
원형 런처 아이콘 (가로세로 비율 1x1, 원형)
배너 로고 (가로세로 비율 16x9)
이는 내 앱 행, 설정 또는 설치 진행률과 같은 다양한 사용 사례의 여러 위치에서 사용됩니다.
배너
배너 로고는 Android TV OS에서 앱 런처를 표시하는 데 사용되는
가로세로 비율 16x9의 로고입니다. TV 앱은 다음 사양으로 적응형 16:9 배너를 제공하는 것이 좋습니다. API 수준 25 이하를 사용할 때는
xhdpi 리소스를 320 x 180px 크기로 제공할 수도 있습니다.
밀도
최소 크기
폴더 위치 (해상도 아래)
픽셀 비율
mdpi
160x90 px
밉맵-mdpi
1
hdpi
240x135 px
mipmap-hdpi
1.5
xhdpi
320x180 px
mipmap-xhdpi
2
xxhdpi
480x270 px
mipmap-xxhdpi
3
xxxhdpi
640x360 px
mipmap-xxxhdpi
4
런처 아이콘
런처 아이콘은 Android TV의 설정 및 미디어 세션 통합 (Now Playing 카드)과 같은 여러 위치에서 사용되는 1x1 가로세로 비율 리소스입니다. 런처 아이콘은 Google TV의 내 앱 행에서도 사용할 수 있습니다.
밀도
최소 크기
폴더 위치 (해상도 아래)
픽셀 비율
mdpi
80x80 px
밉맵-mdpi
1
hdpi
120x120 px
mipmap-hdpi
1.5
xhdpi
160x160 px
mipmap-xhdpi
2
xxhdpi
240x240 px
mipmap-xxhdpi
3
xxxhdpi
320x320 px
mipmap-xxxhdpi
4
적응형 아이콘
Android 8.0 버전 (API 수준 26)부터 적응형 런처 아이콘이 지원되므로 앱 아이콘과 관련하여 더 유연하고 흥미로운 시각 효과가 가능합니다. 즉, 개발자의 경우 앱 아이콘이 포그라운드 레이어와 백그라운드 레이어라는 두 가지 레이어로 구성되어 있습니다.
적응형 배너
레이어가 두 개 있는 런처 아이콘 배너와 유사하게 기존 배너와 함께 적응형 배너를 제공할 수도 있습니다.
적응형 런처 아이콘
적응형 아이콘이 다양한 모양과 시각적 효과를 지원하도록 하려면 디자인이 다음 요구사항을 충족해야 합니다.
아이콘의 컬러 버전에 대해 각각 포그라운드와 백그라운드를 위한 두 개의 레이어를 제공합니다.
적응형 아이콘은 포그라운드 및 백그라운드 레이어를 사용하여 정의됩니다. 첫 번째 이미지의 72x72 안전 영역은 모양 마스크에 의해 아이콘과 포그라운드 레이어가 잘리지 않는 위치를 보여줍니다.
Android TV는 테마 아이콘을 지원하지 않으므로 흑백 버전의 아이콘은 필요하지 않습니다.
이 페이지에 나와 있는 콘텐츠와 코드 샘플에는 콘텐츠 라이선스에서 설명하는 라이선스가 적용됩니다. 자바 및 OpenJDK는 Oracle 및 Oracle 계열사의 상표 또는 등록 상표입니다.
최종 업데이트: 2025-07-27(UTC)
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-07-27(UTC)"],[],[],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)"]]
