Resource Manager로 앱의 UI 리소스 관리
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
Resource Manage는 앱에서 리소스를 가져오고 만들고 관리하고 사용할 수 있는 도구 창입니다. 도구 창을 열려면 메뉴에서 View > Tool Windows > Resource Manager를 선택하거나 왼쪽 사이드바에서 Resource Manager를 선택합니다.
그림 1. Resource Manager 도구 창
- Add
를 클릭하여 프로젝트에 새로운 리소스를 추가합니다. 이미지 애셋, 벡터 애셋, 글꼴, 리소스 파일, 값을 추가하거나 프로젝트로 드로어블을 가져올 수 있습니다.
- 모듈을 선택하여 해당 모듈과 관련된 리소스를 확인합니다.
- 검색창을 사용하여 프로젝트의 모든 모듈에서 리소스를 검색합니다.
- Resource Manager에서 유형에 따라 리소스를 표시합니다.
이 탭을 사용해 리소스 유형 간에 전환합니다. 더보기 아이콘
을 클릭하여 추가 리소스 유형을 표시합니다.
- 필터 버튼을 사용하여 로컬 종속 모듈, 외부 라이브러리, Android 프레임워크에서 표시된 리소스를 필터링합니다.
필터를 사용하여 테마 속성을 표시할 수도 있습니다.
- 기본 콘텐츠 영역에서 리소스를 미리 봅니다. 리소스를 마우스 오른쪽 버튼으로 클릭하면 리소스의 이름을 바꾸고 앱에서 리소스가 사용되는 곳을 검색할 수 있는 컨텍스트 메뉴가 표시됩니다.
- 이 버튼을 클릭하면 리소스를 타일 또는 목록 형식으로 볼 수 있습니다.
- 이 버튼을 클릭하면 리소스의 미리보기 크기를 변경할 수 있습니다.
이러한 기능 외에도 Resource Manager는 대량의 드로어블을 한 번에 프로젝트로 가져올 수 있는 기능을 제공합니다. 일괄적으로 가져오는 방법은 다음과 같습니다.
- SVG 파일을 포함한 이미지 파일을 Resource Manager로 직접 드래그합니다.
- Import Drawables 마법사를 사용합니다.
자세한 내용은 프로젝트로 드로어블 가져오기 섹션을 참고하세요.
자세한 정보를 보려면 Resource Manager에서 리소스를 더블클릭합니다. 여러 버전의 리소스가 있는 경우 이 상세 뷰에는 그림 2와 같이 관련 한정자와 함께 각 버전이 표시됩니다. 여기에서 특정 버전을 더블클릭하여 편집기 창에서 열 수 있습니다.
그림 2. 다양한 화면 밀도의 이미지 리소스 버전을 보여주는 Resource Manager
프로젝트로 드로어블 가져오기
Resource Manager를 사용하여 이미지 리소스를 프로젝트로 가져올 수 있습니다.
지원되는 이미지 유형 목록은 이미지 지원을 참고하세요.
이미지 리소스를 프로젝트로 가져오려면 다음 단계를 따르세요.
이미지를 Android 스튜디오의 Resource Manager 창으로 직접 드래그합니다.
- 또는 다음 방법을 이용할 수도 있습니다.
- 더하기 아이콘(+)을 클릭합니다.
- 그림 3과 같이 Import Drawables를 선택합니다.
- 가져올 파일 및 폴더를 선택합니다.
그림 3. 메뉴에서 Import Drawables를 선택합니다.
그림 4와 같이 Import drawables 대화상자가 나타납니다. 이 대화상자에는 가져올 리소스의 목록이 표시됩니다. 리소스 미리보기 위에 있는 텍스트 상자를 클릭하여 리소스 이름을 변경할 수 있습니다.
동일한 리소스를 여러 버전으로 제공하는 경우 다음 섹션에 설명된 대로 각 리소스가 지원하는 특정 구성을 설명하는 기기 구성 한정자를 추가합니다.
예를 들어 여러 화면 밀도에 동일한 리소스를 여러 버전으로 제공하는 경우 각 버전에 밀도 한정자를 추가할 수 있습니다. 이름과 한정자가 동일한 리소스가 2개 이상 있는 경우 1개의 버전만 가져옵니다.
리소스 한정자에 관한 자세한 내용은 대체 리소스 제공을 참고하세요.
그림 4. Import drawables 대화상자
리소스 이름을 지정하고 필요한 한정자를 추가한 후 Next를 클릭합니다.
다음 화면에는 가져올 리소스의 요약이 표시됩니다. 가져올 준비가 되면 Import를 클릭합니다.
그림 5와 같이 이제 리소스를 프로젝트에서 사용할 준비가 된 것을 Resource Manager 창에서 알 수 있습니다.
그림 5. 이제 Resource Manager에 가져온 이미지가 표시됩니다.
드로어블 밀도 자동 파싱
파일이나 폴더를 가져올 때 경로에 밀도 한정자가 포함된 경우 Resource Manager는 가져오는 과정에서 밀도 한정자를 자동 적용합니다. Resource Manager에서는 Android의 밀도 한정자와 iOS의 배율을 모두 파싱할 수 있습니다.
다음 표에는 Android 및 iOS에서 지원되는 다양한 밀도를 표시하는 방식이 나열되어 있습니다.
| 밀도 |
Android 밀도 한정자 |
iOS 배율 |
| 저밀도(약 120dpi) |
ldpi |
지원되지 않음 |
| 중밀도(약 160dpi) |
mdpi |
원래의 배율 |
| 고밀도(약 240dpi) |
hdpi |
지원되지 않음 |
| 초고밀도(약 320dpi) |
xhdpi |
@2x |
| 초초고밀도(약 480dpi) |
xxhdpi |
@3x |
| 초초초고밀도(약 640dpi) |
xxxhdpi |
@4x |
다음은 입력 경로가 가져오기 후 리소스 경로로 변환되는 방식을 보여주는 몇 가지 예시입니다.
- Android 밀도 한정자:
hdpi
- 입력 경로: /UserFolder/icon1/hdpi/icon.png
리소스 경로: <projectFolder>/<moduleFolder>
/src/main/res/drawable-hdpi/icon.png
- Android 밀도 한정자:
xxhdpi
- 입력 경로: /UserFolder/icon1/abc-xxhdpi/icon.png
리소스 경로: <projectFolder>/<moduleFolder>
/src/main/res/drawable-xxhdpi/icon.png
- iOS 배율: @2x
- 입력 경로: /UserFolder/icon1/icon@2x.png
리소스 경로: <projectFolder>/<moduleFolder>
/src/main/res/drawable-xhdpi/icon.png
- iOS 배율: @2x
- 입력 경로: /UserFolder/icon1/icon@2x_alternate.png
리소스 경로: <projectFolder>/<moduleFolder>
/src/main/res/drawable-xhdpi/icon_alternate.png
다양한 픽셀 밀도를 가진 기기를 지원하는 방법에 관한 자세한 내용은 다양한 픽셀 밀도 지원을 참고하세요.
레이아웃으로 드로어블 드래그
Resource Manager에서 레이아웃으로 드로어블을 직접 드래그할 수 있습니다. 리소스를 레이아웃으로 드래그하는 경우 Resource Manager는 애니메이션 1과 같이 드로어블에 상응하는 ImageView를 생성합니다.
애니메이션 1. Design 뷰에서 드로어블을 레이아웃으로 드래그합니다.
애니메이션 2에서처럼 레이아웃의 XML로 바로 드래그할 수도 있습니다.
애니메이션 2. Text 뷰에서 드로어블을 레이아웃으로 드래그합니다.
Text 탭에서 드로어블을 레이아웃으로 드래그할 때 생성되는 코드는 다음과 같이 레이아웃에 드로어블을 배치하는 위치에 따라 다릅니다.
- 드로어블을 빈 영역으로 드래그하면 Resource Manager는 상응하는
ImageView를 생성합니다.
- 드로어블을 레이아웃 XML의 속성으로 드래그하면 Resource Manager가 이 속성 값을 드로어블의 참조로 바꿉니다.
다른 리소스 유형을 XML 속성으로 드래그하여 속성 값을 바꿀 수도 있습니다.
- 드로어블을 기존
ImageView 요소로 드래그하면 Resource Manager는 상응하는 소스 속성을 바꿉니다.
이 페이지에 나와 있는 콘텐츠와 코드 샘플에는 콘텐츠 라이선스에서 설명하는 라이선스가 적용됩니다. 자바 및 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,["# Manage your app's UI resources with Resource Manager\n\nResource Manager is a tool window for importing, creating, managing, and\nusing resources in your app. To open the tool window, select\n**View \\\u003e Tool Windows \\\u003e Resource Manager** from the menu or select\n**Resource Manager** in the left side bar.\n\n**Figure 1.** The Resource Manager tool window.\n\n1. Click **Add** to add a new resource to your project. You can add image assets, vector assets, fonts, or resource files and values, or you can [import drawables](#import) into your project.\n2. Select a module to view resources specific to that module.\n3. Search for a resource across all modules in your project using the search bar.\n4. Display your resources according to [type](/guide/topics/resources/available-resources) in the Resource Manager. Use these tabs to switch between resource types. Click the overflow icon to show additional resource types.\n5. Filter the displayed resources from local dependent modules, external libraries, and the Android framework using the filter button. You can also use the filter to show theme attributes.\n6. Preview your resources in the main content area. Right-click a resource to see a context menu where you can rename the resource and search your app for where the resource is used.\n7. Click these buttons to view your resources as either tiles or lists.\n8. Click these buttons to change the preview size of your resources.\n\nIn addition to these features, the Resource Manager provides a\nway to bulk-import drawables into your project. To bulk-import, you can either:\n\n- Drag your image files---including SVG files---directly onto the Resource Manager.\n- Use the **Import Drawables** wizard.\n\nFor more information, see the [Import drawables into your project](#import)\nsection.\n\nTo see more detailed information, double-click a resource in Resource\nManager. If you have multiple versions of a resource, this detailed view\ndisplays each version along with any associated qualifiers, as shown in\nfigure 2. From here, you can double-click a specific version to open it\nin an editor window.\n\n**Figure 2.** The Resource Manager showing versions of an image resource for\ndifferent screen densities.\n\nImport drawables into your project\n----------------------------------\n\nYou can use the Resource Manager to import image resources into your project.\nFor a list of supported image types, see\n[Image support](/guide/topics/media/media-formats#image-formats).\n\nTo import image resources into your project, do the following:\n\n1. Drag your images directly onto the **Resource Manager** window in\n Android Studio.\n\n - Alternatively, you can:\n 1. Click the plus icon (**+**).\n 2. Choose **Import Drawables**, as shown in figure 3.\n 3. Select the files and folders that you want to import.\n\n **Figure 3.** Select **Import Drawables** from the menu.\n2. The **Import drawables** dialog appears, as shown in figure 4. This dialog\n displays a list of the resources you're importing. You can rename resources\n by clicking the text box above a resource's preview.\n\n If you're providing multiple versions of the same resource, add\n [device configuration qualifiers](#automatic-parsing), as described in the\n following section, that describe the\n specific configuration that each resource supports.\n\n For example, if you're providing multiple versions of the same resource for\n different screen densities, you can add a **Density** qualifier for each\n version. Note that if two or more resources have the same name and\n qualifiers, only one version is imported.\n\n For more information on resource qualifiers, see\n [Providing alternative resources](/guide/topics/resources/providing-resources#AlternativeResources).\n\n **Figure 4.** The **Import drawables** dialog.\n\n Once you've named your resources and added any necessary qualifiers, click\n **Next**.\n3. The next screen shows a summary of the resources you're importing. When\n you're ready to import, click **Import**.\n\nIn the **Resource Manager** window, your resources are now ready for you to use\nin your project, as shown in figure 5.\n\n**Figure 5.** The Resource Manager now shows your imported images.\n\n### Automatically parse drawable densities\n\nWhen you import a file or folder and its path contains a density qualifier,\nthe Resource Manager automatically applies the density qualifier as part of the\nimport. The Resource Manager can parse both Android's density qualifiers and\niOS's scale factors.\n\nThis table lists how different supported densities are represented for\nAndroid and iOS:\n\n| Density | Android density qualifier | iOS scaling factor |\n|--------------------------------------------|---------------------------|--------------------|\n| Low-density (\\~120 dpi) | `ldpi` | not supported |\n| Medium-density (\\~160 dpi) | `mdpi` | original scale |\n| High-density (\\~240 dpi) | `hdpi` | not supported |\n| Extra-high-density (\\~320 dpi) | `xhdpi` | @2x |\n| Extra-extra-high-density (\\~480 dpi) | `xxhdpi` | @3x |\n| Extra-extra-extra-high-density (\\~640 dpi) | `xxxhdpi` | @4x |\n\nHere are some examples of how input paths translate to resource paths after\nimport:\n\nAndroid density qualifier: `hdpi`\n: **Input path:** /UserFolder/icon1/***hdpi*** /icon.png \n\n **Resource path:** *\\\u003cprojectFolder\\\u003e* /*\\\u003cmoduleFolder\\\u003e* /src/main/res/***drawable-hdpi***/icon.png\n\nAndroid density qualifier: `xxhdpi`\n: **Input path:** /UserFolder/icon1/abc-***xxhdpi*** /icon.png \n\n **Resource path:** *\\\u003cprojectFolder\\\u003e* /*\\\u003cmoduleFolder\\\u003e* /src/main/res/***drawable-xxhdpi***/icon.png\n\niOS scaling factor: @2x\n: **Input path:** /UserFolder/icon1/icon***@2x*** .png \n\n **Resource path:** *\\\u003cprojectFolder\\\u003e* /*\\\u003cmoduleFolder\\\u003e* /src/main/res/***drawable-xhdpi***/icon.png\n\niOS scaling factor: @2x\n: **Input path:** /UserFolder/icon1/icon***@2x*** _alternate.png \n\n **Resource path:** *\\\u003cprojectFolder\\\u003e* /*\\\u003cmoduleFolder\\\u003e* /src/main/res/***drawable-xhdpi***/icon_alternate.png\n\nFor more information on supporting devices with different pixel densities, see\n[Support different pixel densities](/training/multiscreen/screendensities).\n\nDrag drawables into your layout\n-------------------------------\n\nYou can drag drawables from the Resource Manager directly onto a\nlayout. When you drag a resource onto a layout, the Resource Manager creates a\ncorresponding `ImageView` for that drawable, as shown in animation 1:\n\n**Animation 1.** Drag drawables onto a layout in **Design**\nview.\n\nYou can also drag directly onto the XML of the layout, as shown in\nanimation 2:\n\n**Animation 2.** Drag drawables onto a layout in **Text** view.\n\nWhen dragging a drawable onto a layout in the **Text** tab, the generated code\ndiffers depending on where you place the drawable in the layout:\n\n- If you drag a drawable onto a blank area, the Resource Manager generates a corresponding `ImageView`.\n- If you drag a drawable onto any attribute in the layout XML, the Resource Manager replaces that attribute value with a reference to the drawable. You can also drag any other resource type onto an XML attribute to replace the attribute value.\n- If you drag a drawable onto an existing `ImageView` element, the Resource Manager replaces the corresponding source attribute."]]
