docs/html-intl/intl/ko/guide/topics/resources/providing-resources.jd

page.title=리소스 제공
parent.title=애플리케이션 리소스
parent.link=index.html
@jd:body

<div id="qv-wrapper">
<div id="qv">
  <h2>간략히 보기</h2>
  <ul>
    <li>{@code res/}의 여러 가지 하위 디렉터리에 속한 여러 가지 유형의 리소스</li>
    <li>구성별 리소스 파일을 제공하는 대체 리소스</li>
    <li>항상 기본 리소스를 포함해야 앱이 특정 기기 구성에
좌우되지 않습니다.</li>
  </ul>
  <h2>이 문서의 내용</h2>
  <ol>
    <li><a href="#ResourceTypes">리소스 유형 그룹화</a></li>
    <li><a href="#AlternativeResources">대체 리소스 제공</a>
      <ol>
        <li><a href="#QualifierRules">한정자 이름 규칙</a></li>
        <li><a href="#AliasResources">별명 리소스 생성</a></li>
      </ol>
    </li>
    <li><a href="#Compatibility">리소스와 연관된 최선의 기기 호환성 제공</a></li>
    <li><a href="#BestMatch">Android가 가장 잘 일치하는 리소스를 찾는 방법</a></li>
  </ol>

  <h2>참고 항목</h2>
  <ol>
    <li><a href="accessing-resources.html">리소스 액세스</a></li>
    <li><a href="available-resources.html">리소스 유형</a></li>
    <li><a href="{@docRoot}guide/practices/screens_support.html">다중
화면 지원</a></li>
  </ol>
</div>
</div>

<p>이미지나 문자열과 같은 애플리케이션 리소스는 항상 코드에서 외부화해야 합니다.
그래야 이들을 독립적으로 유지관리할 수 있습니다. 특정 기기 구성에 대한 대체 리소스도
제공해야 합니다. 이것은 특별하게 명명한 리소스 디렉터리에 그룹화하는 방법을 씁니다. Android는
런타임에 현재 구성을 근거로 적절한 리소스를 사용합니다. 예를 들어
여러 가지 화면 크기에 따라 여러 가지 UI 레이아웃을 제공하거나 언어 설정에 따라
각기 다른 문자열을 제공하고자 할 수 있습니다.</p>

<p>애플리케이션 리소스를 외부화하면
프로젝트 {@code R} 클래스에서 발생하는 리소스 ID로 액세스할 수 있습니다. 애플리케이션에서
리소스를 사용하는 방법은 <a href="accessing-resources.html">리소스
액세스</a>에서 설명합니다. 이 문서에서는 Android 프로젝트에서 리소스를 그룹화하는 방법과 특정 기기 구성에 대한
대체 리소스를 제공하는 법을 보여드립니다.</p>


<h2 id="ResourceTypes">리소스 유형 그룹화</h2>

<p>프로젝트
{@code res/} 디렉터리의 특정 하위 디렉터리에 각 유형의 리소스를 배치해야 합니다. 예를 들어, 다음은 간단한 프로젝트의 파일 계층입니다.</p>

<pre class="classic no-pretty-print">
MyProject/
    src/  <span style="color:black">
        MyActivity.java  </span>
    res/
        drawable/  <span style="color:black">
            graphic.png  </span>
        layout/  <span style="color:black">
            main.xml
            info.xml</span>
        mipmap/  <span style="color:black">
            icon.png </span>
        values/  <span style="color:black">
            strings.xml  </span>
</pre>

<p>이 예시에서 {@code res/} 디렉터리가 모든 리소스(이미지 리소스, 레이아웃 리소스 두 개, 시작 관리자 아이콘용 {@code mipmap/} 디렉터리,
 문자열 리소스 파일)를 (하위 디렉터리에
) 포함하는 것을 볼 수 있습니다. 리소스 디렉터리 이름은
중요하며 표1에 설명되어 있습니다.</p>

<p class="note"><strong>참고:</strong> Mipmap 폴더를 사용하는 자세한 방법은
<a href="{@docRoot}tools/projects/index.html#mipmap">프로젝트 관리 개요</a>를 참조하십시오.</p>

<p class="table-caption" id="table1"><strong>표 1</strong>. 프로젝트
{@code res/} 디렉터리 내부에서 지원하는 리소스 디렉터리입니다.</p>

<table>
  <tr>
    <th scope="col">디렉터리</th>
    <th scope="col">리소스 유형</th>
  </tr>

  <tr>
    <td><code>animator/</code></td>
    <td><a href="{@docRoot}guide/topics/graphics/prop-animation.html">속성
애니메이션</a>을 정의하는 XML 파일입니다.</td>
  </tr>

  <tr>
    <td><code>anim/</code></td>
    <td><a href="{@docRoot}guide/topics/graphics/view-animation.html#tween-animation">tween
애니메이션</a>을 정의하는 XML 파일입니다 (속성 애니메이션도 이 디렉터리에 저장할 수 있지만
두 가지 유형을 구분하기 위해 속성 애니메이션에는 {@code animator/} 디렉터리가 기본 설정됩니다
).</td>
  </tr>

  <tr>
    <td><code>color/</code></td>
    <td>색상의 상태 목록을 정의하는 XML 파일입니다. <a href="color-list-resource.html">색상 상태
목록 리소스</a>를 참조하십시오.</td>
  </tr>

  <tr>
    <td><code>drawable/</code></td>

    <td><p>다음 드로어블 리소스 하위 유형으로 컴파일 되는 비트맵 파일({@code .png}, {@code .9.png}, {@code .jpg}, {@code .gif}) 또는 XML 파일입니다.
</p>
      <ul>
        <li>비트맵 파일</li>
        <li>나인 패치(크기 조절 가능한 비트맵)</li>
        <li>상태 목록</li>
        <li>형태</li>
        <li>드로어블 애니메이션</li>
        <li>기타 드로어블</li>
      </ul>
      <p><a href="drawable-resource.html">드로어블 리소스</a>를 참조하십시오.</p>
    </td>
  </tr>

  <tr>
    <td><code>mipmap/</code></td>
    <td>각기 다른 시작 관리자 아이콘 밀도에 대한 드로어블 파일입니다.
{@code mipmap/} 폴더로 시작 관리자 아이콘을 관리하는 자세한 방법은
<a href="{@docRoot}tools/project/index.html#mipmap">프로젝트 관리 개요</a>를 참조하십시오.</td>
  </tr>

  <tr>
    <td><code>layout/</code></td>
    <td>사용자 인터페이스 레이아웃을 정의하는 XML 파일입니다.
        <a href="layout-resource.html">레이아웃 리소스</a>를 참조하십시오.</td>
  </tr>

  <tr>
    <td><code>menu/</code></td>
    <td>옵션 메뉴, 컨텍스트 메뉴 또는 하위
메뉴 등과 같은 애플리케이션 메뉴를 정의하는 XML입니다. <a href="menu-resource.html">메뉴 리소스</a>를 참조하십시오.</td>
  </tr>

  <tr>
    <td><code>raw/</code></td>
    <td><p>원시 형태로 저장하기 위한 임의의 파일입니다. 원시
{@link java.io.InputStream}으로 이런 리소스를 열려면 리소스 ID, {@code R.raw.<em>filename</em>}으로 {@link android.content.res.Resources#openRawResource(int)
Resources.openRawResource()}를 호출합니다.</p>
      <p>그러나 원본 파일 이름과 파일 계층에 액세스해야 하는 경우,
({@code res/raw/}가 아니라) {@code
assets/} 디렉터리에 몇몇 리소스를 저장해두는 것을 고려해 볼 수 있습니다. {@code assets/}에 있는 파일에는
리소스 ID가 주어지지 않으므로, 이들을 읽는 유일한 방법은 {@link android.content.res.AssetManager}를 사용하는 것뿐입니다.</p></td>
  </tr>

  <tr>
    <td><code>values/</code></td>
    <td><p>문자열, 정수 및 색과 같은 단순 값이 들어있는 XML 파일입니다.</p>
      <p>다른 {@code res/} 하위 디렉터리에 있는 XML 리소스 파일은 XML 파일 이름을 근거로
하나의 리소스를 정의하는 반면, {@code values/} 디렉터리에 있는 파일은 여러 개의 리소스를 설명합니다.
이 디렉터리 안에 있는 파일의 경우, {@code &lt;resources&gt;} 요소의 각 하위 요소가 리소스를 하나씩
정의합니다. 예를 들어 {@code &lt;string&gt;} 요소는
{@code R.string} 리소스를 생성하고 {@code &lt;color&gt;} 요소는 {@code R.color}
 리소스를 생성합니다.</p>
      <p>각 리소스가 자체 XML 요소로 정의되므로, 원하는 대로 파일을 정의하고 하나의 파일에 여러 가지 리소스 유형을
배정할 수 있습니다. 하지만 명확히 하려면 여러 가지 파일에
각기 고유한 리소스를 배치하는 것이 좋을 수도 있습니다. 예를 들어, 다음은 이 디렉터리에서 생성할 수 있는 리소스를 위한
파일 이름 명명법입니다.</p>
      <ul>
        <li>리소스 배열을 위한 arrays.xml(<a href="more-resources.html#TypedArray">입력 배열</a>).</li>
        <li><a href="more-resources.html#Color">색상 값</a>을 위한 colors.xml</li>
        <li><a href="more-resources.html#Dimension">치수 값</a>을 위한 dimens.xml</li>
        <li><a href="string-resource.html">문자열
값</a>을 위한 strings.xml</li>
        <li><a href="style-resource.html">스타일</a>을 위한 styles.xml</li>
      </ul>
      <p><a href="string-resource.html">문자열 리소스</a>,
<a href="style-resource.html">스타일 리소스</a> 및
<a href="more-resources.html">자세한 리소스 유형</a>을 참조하십시오.</p>
    </td>
  </tr>

  <tr>
    <td><code>xml/</code></td>
    <td>런타임에 읽을 수 있는 임의의 XML 파일로, 이때 {@link
android.content.res.Resources#getXml(int) Resources.getXML()}을 호출하는 방법을 씁니다. 다양한 XML 구성 파일을 여기에 저장해야 합니다. 예를 들어
<a href="{@docRoot}guide/topics/search/searchable-config.html">검색 가능한 구성</a> 등이 이에 해당됩니다.
<!-- or preferences configuration. --></td>
  </tr>
</table>

<p class="caution"><strong>주의:</strong> 리소스 파일을
{@code res/} 디렉터리에 직접 저장하면 절대로 안 됩니다. 컴파일러 오류를 초래하게 됩니다.</p>

<p>특정 유형의 리소스에 관한 자세한 정보는 <a href="available-resources.html">리소스 유형</a> 문서를 참조하십시오.</p>

<p>표1에 정의된 하위 디렉터리에 저장하는 리소스는 "기본"
리소스입니다. 다시 말해, 이러한 리소스가 애플리케이션의 기본 디자인과 콘텐츠를 정의한다는 뜻입니다.
그러나, 여러 가지 유형의 Android 구동 기기는 각기 다른 유형의 리소스를 호출할 수도 있습니다.
예를 들어 어느 기기의 화면이 보통보다 큰 편이라면, 추가적인 화면 공간의 이점을 활용할 수 있는
다른 레이아웃 리소스를 제공해야 합니다. 또는, 기기에 다른 언어 설정이 있을 경우
해당 텍스트를 사용자 인터페이스에 번역하는 다른 문자열 리소스를
제공해야 합니다. 여러 가지 기기 구성에 여러 가지 리소스를 제공하려면,
기본 리소스 외에 대체 리소스를
제공해야 합니다.</p>


<h2 id="AlternativeResources">대체 리소스 제공</h2>


<div class="figure" style="width:429px">
<img src="{@docRoot}images/resources/resource_devices_diagram2.png" height="167" alt="" />
<p class="img-caption">
<strong>그림 1.</strong> 서로 다른 두 개의 기기로, 서로 다른 레이아웃 리소스를 사용합니다.</p>
</div>

<p>거의 모든 애플리케이션이 특정 기기 구성을 지원하는
대체 리소스를 제공해야 합니다. 예를 들어 여러 가지 화면 밀도에 맞는 대체 드로어블 리소스를
포함시켜야 하며 여러 가지 언어에 맞게 대체 문자열 리소스도 포함시켜야 합니다. Android는 런타임에
현재 기기 구성을 감지하고 애플리케이션에 대해 적절한 리소스를
로드합니다.</p>

<p>리소스 세트에 대하여 구성별로 적절한 대체를 지정하려면 다음과 같이 합니다.</p>
<ol>
  <li>{@code res/}에 {@code
<em>&lt;resources_name&gt;</em>-<em>&lt;config_qualifier&gt;</em>} 형식으로 이름을 지정한 새 디렉터리를 만듭니다.
    <ul>
      <li><em>{@code &lt;resources_name&gt;}</em>은 해당 기본 리소스의 디렉터리 이름입니다(표1에 정의).
</li>
      <li><em>{@code &lt;qualifier&gt;}</em>는 리소스를 사용할 개별 구성을 지정하는
이름입니다(표2에 정의).</li>
    </ul>
    <p>하나 이상의 <em>{@code &lt;qualifier&gt;}</em>를 추가할 수 있습니다. 각기 대시로
구분합니다.</p>
    <p class="caution"><strong>주의:</strong> 여러 한정자를 추가할 때는
표2에 나열된 것과 같은 순서로 배치해야 합니다. 한정자의 순서가 잘못 지정되면
해당 리소스가 무시됩니다.</p>
  </li>
  <li>해당되는 각 대체 리소스를 이 새 디렉터리에 저장하십시오. 이 리소스 파일은 기본 리소스 파일과
똑같은 이름을 지정해야 합니다.</li>
</ol>

<p>예를 들어 다음은 기본 리소스와 대체 리소스입니다.</p>

<pre class="classic no-pretty-print">
res/
    drawable/   <span style="color:black">
        icon.png
        background.png    </span>
    drawable-hdpi/  <span style="color:black">
        icon.png
        background.png  </span>
</pre>

<p>{@code hdpi} 한정자는 해당 디렉터리의 리소스가
고화질 화면 기기용이라는 것을 나타냅니다. 각 드로어블 디렉터리의 이미지는 특정 화면 화질에 맞추어
크기가 지정되었으나 파일 이름은
똑같습니다. 이렇게 하면 {@code icon.png} 또는 {@code
background.png} 이미지를 참조하는 데 사용하는 리소스 ID는 항상 같지만 Android가 각 리소스 중에서 현재 기기에 가장 잘 일치하는
버전을 선택하게 됩니다. 이때 리소스 디렉터리 이름의 한정자를 기기 구성 정보와
비교하는 방법을 씁니다.</p>

<p>Android는 여러 가지 구성 한정자를 지원하며 한 디렉터리 이름에
여러 개의 한정자를 추가할 수 있습니다. 각 한정자를 대시로 구분하면 됩니다. 표 2는
유효한 구성 한정자를 우선 순위대로 나열한 것입니다. 리소스 디렉터리에 여러 개의
한정자를 사용하는 경우, 해당 한정자를 디렉터리 이름에 추가할 때 이 표에 나열된 것과 같은
순서로 추가해야 합니다.</p>


<p class="table-caption" id="table2"><strong>표 2.</strong> 구성 한정자
이름입니다.</p>
<table>
    <tr>
        <th>구성</th>
        <th>한정자 값</th>
        <th>설명</th>
    </tr>
    <tr id="MccQualifier">
      <td>MCC 및 MNC</td>
      <td>예:<br/>
        <code>mcc310</code><br/>
        <code><nobr>mcc310-mnc004</nobr></code><br/>
        <code>mcc208-mnc00</code><br/>
        등.
      </td>
      <td>
        <p>이동통신 국가 코드(MCC)에 선택적으로 이동통신 네트워크 코드(MNC)가 이어지는 형태로,
기기의 SIM 카드에서 가져옵니다. 예를 들어, <code>mcc310</code>은 모든 이동통신사를 포함한 미국이고,
<code>mcc310-mnc004</code>는 Verizon을 사용하는 미국, <code>mcc208-mnc00</code>은 Orange를 사용하는
프랑스입니다.</p>
        <p>기기가 무선 연결(GSM 전화)을 사용할 경우, MCC와 MNC 값은
SIM 카드에서 가져옵니다.</p>
        <p>MCC만 단독으로 사용할 수도 있습니다(예를 들어, 애플리케이션에 국가별 합법적 리소스를
 포함하는 경우). 언어에 기초해서만 지정해야 할 경우,
<em>언어 및 지역</em> 한정자를 대신 사용합니다(아래에 설명). MCC와
MNC 한정자를 사용할 경우, 조심해서 사용하고 예상한 대로 작동하는지 테스트해야 합니다.</p>
        <p>또한, 구성 필드 {@link
android.content.res.Configuration#mcc}와 {@link
android.content.res.Configuration#mnc}를 참조하십시오. 이 구성 필드는 각각 이동통신 국가 코드와
이동통신 네트워크 코드를 나타냅니다.</p>
      </td>
    </tr>
    <tr id="LocaleQualifier">
      <td>언어 및 지역</td>
      <td>예:<br/>
        <code>en</code><br/>
        <code>fr</code><br/>
        <code>en-rUS</code><br/>
        <code>fr-rFR</code><br/>
        <code>fr-rCA</code><br/>
        등.
      </td>
      <td><p>언어는 두 글자의 <a href="http://www.loc.gov/standards/iso639-2/php/code_list.php">ISO
639-1</a> 언어 코드로 정의되고,
뒤이어 두 글자의 <a href="http://www.iso.org/iso/en/prods-services/iso3166ma/02iso-3166-code-lists/list-en1.html">ISO
3166-1-alpha-2</a> 지역 코드가 선택적으로 따라옵니다(소문자 "{@code r}" 뒤에 붙음).
        </p><p>
        코드는 대소문자를 구별하지 <em>않습니다</em>. {@code r} 접두사는
지역 부분을 구별하기 위해 사용합니다.
        지역만 지정할 수는 없습니다.</p>
        <p>사용자가 시스템 설정에서 언어를 변경할 경우
애플리케이션 수명 중에 변경될 수 있습니다. 런타임에서 애플리케이션에 어떤 영향을 미치는지 자세히 알아보려면 <a href="runtime-changes.html">런타임 변경 처리</a>를 참조하십시오.
</p>
        <p>다른 여러 언어에 맞게 애플리케이션을 지역화하기 위한 전체 지침은
<a href="localization.html">지역화</a>를 참조하십시오.</p>
        <p>또한, 현재 로케일을 나타내는 {@link android.content.res.Configuration#locale} 구성 필드도
참조하십시오.</p>
      </td>
    </tr>
    <tr id="LayoutDirectionQualifier">
      <td>레이아웃 방향</td>
      <td><code>ldrtl</code><br/>
        <code>ldltr</code><br/>
      </td>
      <td><p>애플리케이션의 레이아웃 방향입니다. {@code ldrtl}는 "오른쪽에서 왼쪽 방향 레이아웃"을 나타냅니다.
{@code ldltr}는 "왼쪽에서 오른쪽 방향 레이아웃"을 나타내고 기본 암시적 값입니다.
      </p>
      <p>이는 레이아웃이나 드로어블, 값 등의 모든 리소스에 적용할 수 있습니다.
      </p>
      <p>예를 들어, 아랍어에 대한 특정 레이아웃을 제공하고
다른 "오른쪽에서 왼쪽으로 쓰는" 언어(히브리어 또는 페르시아어)에 제네릭 레이아웃을 제공하고 싶다면 다음과 같이 해야 합니다.
      </p>
<pre class="classic no-pretty-print">
res/
    layout/   <span style="color:black">
        main.xml  </span>(Default layout)
    layout-ar/  <span style="color:black">
        main.xml  </span>(Specific layout for Arabic)
    layout-ldrtl/  <span style="color:black">
        main.xml  </span>(Any "right-to-left" language, except
                  for Arabic, because the "ar" language qualifier
                  has a higher precedence.)
</pre>
        <p class="note"><strong>참고:</strong> 앱에서 오른쪽에서 왼쪽 레이아웃 기능을 활성화하려면
<a href="{@docRoot}guide/topics/manifest/application-element.html#supportsrtl">{@code
supportsRtl}</a>을 {@code "true"}로 설정하고 <a href="{@docRoot}guide/topics/manifest/uses-sdk-element.html#target">{@code targetSdkVersion}</a>을 17 이상으로 설정해야 합니다.</p>
        <p><em>API 레벨 17에서 추가되었습니다.</em></p>
      </td>
    </tr>
    <tr id="SmallestScreenWidthQualifier">
      <td>smallestWidth</td>
      <td><code>sw&lt;N&gt;dp</code><br/><br/>
        예:<br/>
        <code>sw320dp</code><br/>
        <code>sw600dp</code><br/>
        <code>sw720dp</code><br/>
        등.
      </td>
      <td>
        <p>화면의 기본 크기로, 사용 가능한 화면 영역의 가장 짧은 치수가
나타냅니다. 구체적으로 기기의 smallestWidth는 해당 화면의 이용 가능한 높이와 너비의
가장 짧은 치수를 말합니다(이것을 화면에 대한 "가능한 한 가장 좁은 너비"로 생각해도 됩니다). 이 한정자를 사용하면
화면의 현재 방향에 관계 없이
애플리케이션이 해당 UI에서 이용 가능한 너비 중 최소 {@code &lt;N&gt;}dps를 확보하도록 할 수 있습니다.</p>
        <p>예를 들어, 레이아웃에 언제나
600dp 이상의 화면 최소 치수가 필요하다면, 이 한정자를 사용하여 레이아웃 리소스, {@code
res/layout-sw600dp/}를 만들 수 있습니다. 시스템이 이러한 리소스를 사용하는 것은 사용 가능한 화면의 최소 치수가 적어도 600dp가
되는 경우뿐이며, 이때 600dp라는 크기가 사용자 쪽에서 보기에 높이이든 너비이든
관계 없습니다. 이 smallestWidth는 기기의 고정된 화면 크기 특성입니다. <strong>
기기의 smallestWidth는 화면 방향이 변경되어도 바뀌지 않습니다</strong>.</p>
        <p>기기의 smallestWidth는 화면 장식과 시스템 UI를 감안합니다. 예를 들어,
화면 상에서 최소 너비의 축 주변 공간을 차지하는 영구 UI 요소가 있다면,
시스템은 smallestWidth를 실제 화면 크기보다 작게 선언합니다.
이것은 개발자의 UI가 사용할 수 없는 화면 픽셀이기 때문입니다. 따라서 개발자가 사용하는 값은
<em>레이아웃에서 요구하는</em> 실제 최소 치수여야 합니다(일반적으로 이 값은 화면의 현재 방향과 관계없이
레이아웃이 지원하는 "최소 너비"가 됩니다.).</p>
        <p>다음의 몇몇 값은 보편적인 화면 크기에 대하여 사용할 수 있습니다.</p>
        <ul>
          <li>화면 크기 320에 화면 구성이 아래와 같은 기기:
            <ul>
              <li>240x320ldpi(QVGA 핸드셋)</li>
              <li>320x480mdpi(핸드셋)</li>
              <li>480x800hdpi(고화질 핸드셋)</li>
            </ul>
          </li>
          <li>480x800mdpi(태블릿/핸드셋) 등의 화면에는 480을 사용합니다.</li>
          <li>600x1024mdpi (7인치 태블릿) 등의 화면에는 600을 사용합니다.</li>
          <li>720x1280mdpi (10인치 태블릿) 등의 화면에는 720을 사용합니다.</li>
        </ul>
        <p>애플리케이션이
smallestWidth 한정자의 여러 값이 포함된 여러 리소스 디렉터리를 제공하면, 시스템은
기기의 smallestWidth에 가장 가까운(그러나 이를 초과하지 않는) 값을 사용합니다. </p>
        <p><em>API 레벨 13에서 추가되었습니다.</em></p>
        <p>이외에도 애플리케이션과 호환되는 최소한의 smallestWidth를 선언하는 <a href="{@docRoot}guide/topics/manifest/supports-screens-element.html#requiresSmallest">{@code
android:requiresSmallestWidthDp}</a> 속성과
기기의 smallestWidth 값을 보유한 {@link
android.content.res.Configuration#smallestScreenWidthDp}
구성 필드도 참조하십시오.</p>
        <p>여러 가지 화면에 맞는 디자인과 한정자 사용에 관한 자세한 정보는
<a href="{@docRoot}guide/practices/screens_support.html">다중 화면
지원</a> 개발자 가이드를 참조하십시오.</p>
      </td>
    </tr>
    <tr id="ScreenWidthQualifier">
      <td>이용 가능한 너비</td>
      <td><code>w&lt;N&gt;dp</code><br/><br/>
        예:<br/>
        <code>w720dp</code><br/>
        <code>w1024dp</code><br/>
        등.
      </td>
      <td>
        <p>리소스를 사용해야 하는 {@code dp} 단위에서 최소 이용 가능한 화면 너비를 지정합니다.
이는 <code>&lt;N&gt;</code> 값이 정의합니다.  이 구성
값은 현재 실제 너비에 맞추기 위해 화면 방향이 가로와 세로 사이를 오가며 바뀔 때
변경됩니다.</p>
        <p>애플리케이션이 이 구성에 대해 서로 다른 값이 포함된 여러 개의 리소스 디렉터리를 제공하면,
시스템은 기기의 현재 화면 너비에 가장 가까운(그러나 이를 초과하지 않는)
값을 사용합니다.  이 값은
화면 장식을 감안한 것이므로, 기기의 왼쪽이나 오른쪽 가장자리에
영구 UI 요소가 있을 경우, 기기는
이러한 UI 요소를 감안하여 애플리케이션의 이용 가능한 공간을 줄여서
 실제 화면 크기보다 작은 너비 값을 사용합니다.</p>
        <p><em>API 레벨 13에서 추가되었습니다.</em></p>
        <p>현재 화면 너비를 보유한 {@link android.content.res.Configuration#screenWidthDp}
 구성 필드도 참조하십시오.</p>
        <p>여러 가지 화면에 맞는 디자인과 한정자 사용에 관한 자세한 정보는
<a href="{@docRoot}guide/practices/screens_support.html">다중 화면
지원</a> 개발자 가이드를 참조하십시오.</p>
      </td>
    </tr>
    <tr id="ScreenHeightQualifier">
      <td>이용 가능한 높이</td>
      <td><code>h&lt;N&gt;dp</code><br/><br/>
        예:<br/>
        <code>h720dp</code><br/>
        <code>h1024dp</code><br/>
        등.
      </td>
      <td>
        <p>리소스가 사용되어야 하는 최소한의 사용 가능한 화면 높이를 "dp" 단위로 나타냅니다.
이는 <code>&lt;N&gt;</code> 값이 정의합니다.  이 구성
값은 현재 실제 높이에 맞추기 위해 화면 방향이 가로와 세로 사이를 오가며 바뀔 때
변경됩니다.</p>
        <p>애플리케이션이 이 구성에 대해 서로 다른 값이 포함된 여러 개의 리소스 디렉터리를 제공하면,
시스템은 기기의 현재 화면 높이에 가장 가까운(그러나 이를 초과하지 않는)
값을 사용합니다.  이 값은
화면 장식을 감안한 것이므로, 기기의 상단이나 하단 가장자리에
영구 UI 요소가 있을 경우, 기기는
이러한 UI 요소를 감안하여 애플리케이션의 이용 가능한 공간을 줄여서
 실제 화면 크기보다 작은 높이 값을 사용합니다.
상태 표시줄에 고정되지 않은 화면 장식(예를 들어
전화 상태 표시줄은 전체 화면에서 숨길 수 있음)은 여기에서 감안하지 <em>않았고</em>,
제목 표시줄이나 작업 모음 등의 창 장식도 감안되지 않았으므로, 애플리케이션 입장에서는 자신이 지정한 것보다 어느 정도 작은 공간을
받아들일 대비를 해야 합니다.
        <p><em>API 레벨 13에서 추가되었습니다.</em></p>
        <p>현재 화면 너비를 보유한 {@link android.content.res.Configuration#screenHeightDp}
 구성 필드도 참조하십시오.</p>
        <p>여러 가지 화면에 맞는 디자인과 한정자 사용에 관한 자세한 정보는
<a href="{@docRoot}guide/practices/screens_support.html">다중 화면
지원</a> 개발자 가이드를 참조하십시오.</p>
      </td>
    </tr>
    <tr id="ScreenSizeQualifier">
      <td>화면 크기</td>
      <td>
        <code>small</code><br/>
        <code>normal</code><br/>
        <code>large</code><br/>
        <code>xlarge</code>
      </td>
      <td>
        <ul class="nolist">
        <li>{@code small}: 저밀도 QVGA 화면과 비슷한
크기의 화면입니다. 작은 화면의 최소 레이아웃 크기는
약 320x426 dp단위입니다.  이 화면의 예시로는 QVGA 저밀도 및 VGA 고밀도가
있습니다.</li>
        <li>{@code normal}: 중밀도 HVGA 화면과
비슷한 크기의 화면입니다. 정상 화면의
 최소 레이아웃 크기는 약 320x470 dp 단위입니다.  이 화면의 예로는
WQVGA 저밀도, HVGA 중밀도, WVGA 고밀도 등이 있습니다.
</li>
        <li>{@code large}: 중밀도 VGA 화면과
비슷한 크기의 화면입니다.
        큰 화면의 최소 레이아웃 크기는 약 480x640 dp 단위입니다.
        이 화면의 예시로는 VGA 및 WVGA 중밀도 화면이 있습니다.</li>
        <li>{@code xlarge}: 일반적인 중밀도 HVGA 화면보다 상당히 큰 화면을
말합니다. 초대형 화면의
 최소 레이아웃 크기는 약 720x960 dp 단위입니다.  대부분의 경우, 초대형 화면 기기는
주머니에 넣어 다니기에 너무 큽니다. 따라서 태블릿 스타일의 기기일 가능성이
높습니다. <em>API 레벨 9에서 추가되었습니다.</em></li>
        </ul>
        <p class="note"><strong>참고:</strong> 크기 한정자를 사용하더라도 해당 리소스가 그 크기의 화면
<em>전용</em>이라는 뜻은 아닙니다. 현재 기기 구성과 더욱 잘 맞는 한정자가 포함된 대체 리소스를
제공하지 않으면,
시스템이 <a href="#BestMatch">가장 잘 일치하는</a> 리소스를 사용합니다.</p>
        <p class="caution"><strong>주의:</strong> 모든 리소스가 현재 화면보다
<em>큰</em> 크기 한정자를 사용하는 경우, 시스템은 리소스를 사용하지 <strong>않으며</strong> 애플리케이션은 런타임에 작동이 중단됩니다(예를 들어, 모든 레이아웃 리소스에 {@code
xlarge} 한정자가 태그되어 있지만 기기는 일반 크기 화면일 경우
).</p>
        <p><em>API 레벨 4에서 추가되었습니다.</em></p>

        <p>자세한 정보는 <a href="{@docRoot}guide/practices/screens_support.html">다중 화면
지원</a>을 참조하십시오.</p>
        <p>{@link android.content.res.Configuration#screenLayout} 구성 필드도 참조하십시오.
이것은 화면이 소형, 일반 크기 또는
대형인지를 나타냅니다.</p>
      </td>
    </tr>
    <tr id="ScreenAspectQualifier">
      <td>화면 비율</td>
      <td>
        <code>long</code><br/>
        <code>notlong</code>
      </td>
      <td>
        <ul class="nolist">
          <li>{@code long}: WQVGA, WVGA, FWVGA 등의 긴 화면</li>
          <li>{@code notlong}: QVGA, HVGA 및 VGA 등의 길지 않은 화면</li>
        </ul>
        <p><em>API 레벨 4에서 추가되었습니다.</em></p>
        <p>이것은 순전히 화면 비율에만 기초합니다("긴" 화면이 더 넓습니다). 이는
화면 방향과 관계가 없습니다.</p>
        <p>{@link android.content.res.Configuration#screenLayout}도 참조하십시오.
이것은 화면이 긴 화면인지 여부를 나타냅니다.</p>
      </td>
    </tr>
    <tr id="OrientationQualifier">
      <td>화면 방향</td>
      <td>
        <code>port</code><br/>
        <code>land</code>  <!-- <br/>
        <code>square</code>  -->
      </td>
      <td>
        <ul class="nolist">
          <li>{@code port}: 기기가 세로 방향(수직)입니다.</li>
          <li>{@code land}: 기기가 가로 방향(수평)입니다.</li>
          <!-- Square mode is currently not used. -->
        </ul>
        <p>이것은 사용자가 화면을 돌리는 경우 애플리케이션 수명 중에
변경될 수 있습니다. 이것이 런타임에 애플리케이션에 어떤 영향을 미치는지 알아보려면
<a href="runtime-changes.html">런타임 변경 처리</a>를 참조하십시오.</p>
        <p>{@link android.content.res.Configuration#orientation} 구성 필드도 참조하십시오.
이는 현재 기기 방향을 나타냅니다.</p>
      </td>
    </tr>
    <tr id="UiModeQualifier">
      <td>UI 모드</td>
      <td>
        <code>car</code><br/>
        <code>desk</code><br/>
        <code>television</code><br/>
        <code>appliance</code>
        <code>watch</code>
      </td>
      <td>
        <ul class="nolist">
          <li>{@code car}: 기기가 차량용 도크에서 표시되고 있습니다.</li>
          <li>{@code desk}: 기기가 데스크용 도크에서 표시되고 있습니다.</li>
          <li>{@code television}: 기기가 텔레비전에서 표시되고 있으며,
UI가 큰 화면에 있고 사용자가 여기에서 멀리 떨어져 있는
"텐 풋(ten foot)" 환경을 제공하고 있습니다. 이는 주로 DPAD 또는
기타 비-포인터 상호 작용 주변을 가리킵니다.</li>
          <li>{@code appliance}: 기기가 가전 제품 역할을 하고 있으며, 디스플레이
화면이 없습니다.</li>
          <li>{@code watch}: 기기에 디스플레이 화면이 있고 손목에 착용됩니다.</li>
        </ul>
        <p><em>API 레벨 8에서 추가되었고, 텔레비전은 API 13에서, 시계는 API 20에서 추가되었습니다.</em></p>
        <p>기기가 도크에 삽입되거나 제거될 때 앱이 응답하는 방식에 관한 정보는
<a href="{@docRoot}training/monitoring-device-state/docking-monitoring.html">도킹 상태 및 유형
판별과 모니터링</a>을 읽어보십시오.</p>
        <p>이것은 사용자가 기기를 도크에 놓는 경우 애플리케이션 수명 중에
변경될 수 있습니다. 이러한 모드 중 몇 가지는 {@link
android.app.UiModeManager}를 사용하여 활성화 또는 비활성화할 수 있습니다. 이것이 런타임에 애플리케이션에 어떤 영향을 미치는지 알아보려면 <a href="runtime-changes.html">런타임 변경 처리</a>를
참조하십시오.</p>
      </td>
    </tr>
    <tr id="NightQualifier">
      <td>야간 모드</td>
      <td>
        <code>night</code><br/>
        <code>notnight</code>
      </td>
      <td>
        <ul class="nolist">
          <li>{@code night}: 야간</li>
          <li>{@code notnight}: 주간</li>
        </ul>
        <p><em>API 레벨 8에서 추가되었습니다.</em></p>
        <p>이것은 야간 모드가 자동 모드인 상태(기본)에서 애플리케이션의 수명 중에
변경될 수 있습니다. 이 경우 모드는 하루 중 시간대를 기반으로 변경됩니다.  이 모드는
{@link android.app.UiModeManager}를 사용하여 활성화 또는 비활성화할 수 있습니다. 이것이 런타임 중 애플리케이션에 어떤 영향을 미치는지 알아보려면 <a href="runtime-changes.html">런타임 변경 처리</a>를
참조하십시오.</p>
      </td>
    </tr>
    <tr id="DensityQualifier">
      <td>화면 픽셀 밀도(dpi)</td>
      <td>
        <code>ldpi</code><br/>
        <code>mdpi</code><br/>
        <code>hdpi</code><br/>
        <code>xhdpi</code><br/>
        <code>xxhdpi</code><br/>
        <code>xxxhdpi</code><br/>
        <code>nodpi</code><br/>
        <code>tvdpi</code>
      </td>
      <td>
        <ul class="nolist">
          <li>{@code ldpi}: 저밀도 화면, 약 120dpi.</li>
          <li>{@code mdpi}: 중밀도(일반적인 HVGA에서) 화면, 약
160dpi.</li>
          <li>{@code hdpi}: 고밀도 화면, 약 240dpi.</li>
          <li>{@code xhdpi}: 초고밀도 화면, 약 320dpi. <em>API 레벨 8에서
추가되었습니다.</em></li>
          <li>{@code xxhdpi}: 슈퍼 초고밀도 화면, 약 480dpi. <em>API 레벨 16에서
추가되었습니다.</em></li>
          <li>{@code xxxhdpi}: 울트라 슈퍼 초고밀도 화면 사용(시작 관리자 아이콘만 해당,
<em>다중 화면 지원</em>의
<a href="{@docRoot}guide/practices/screens_support.html#xxxhdpi-note">참고</a>를 참조하십시오), 약 640dpi. <em>API 레벨 18에서
추가되었습니다.</em></li>
          <li>{@code nodpi}: 이것은 기기 밀도에 일치하도록 크기를 조정하고자 하지 않는 비트맵 리소스에
사용할 수 있습니다.</li>
          <li>{@code tvdpi}: Mdpi와 hdpi 사이 어딘가에 해당되는 화면, 약 213dpi. 이것은
"기본" 밀도 그룹으로 간주되지 않습니다. 이는 대체로 텔레비전용으로 만들어진 것이며
대부분의 앱에는 필요하지 않는 것이 정상입니다. mdpi 및 hdpi만 제공하면 대부분의 앱에는 충분하고
시스템이 필요에 따라 크기를 조정해줍니다. 이 한정자는 API 레벨 13과 함께 도입되었습니다.</li>
        </ul>
        <p>여섯 가지 기본 밀도간에 3:4:6:8:12:16 비율 척도가 있습니다(tvdpi 밀도는
무시). 그러므로 ldpi의 9x9 비트맵은 mdpi에서 12x12이고, hdpi에서 18x18, xhdpi에서 24x24 등, 이런 식으로 적용됩니다.
</p>
        <p>이미지 리소스가 텔레비전이나 특정 기기에서 제대로 보이지 않는다고 결정하고
tvdpi 리소스를 사용하려 할 경우, 배율은 1.33*mdpi입니다. 예를 들어,
mdpi 화면의 100px x 100px 이미지는 tvdpi에서 133px x 133px가 되어야 합니다.</p>
        <p class="note"><strong>참고:</strong> 밀도 한정자를 사용하더라도 해당 리소스가 그 밀도의 화면
<em>전용</em>이라는 뜻은 아닙니다. 현재 기기 구성과 더욱 잘 맞는 한정자가 포함된 대체 리소스를
제공하지 않으면,
시스템이 <a href="#BestMatch">가장 잘 일치하는</a> 리소스를 사용합니다.</p>
        <p>다양한 화질을 처리하는 방법과
Android가 현재 화질에 맞춰 비트맵을 축소하는 방법에 관한 자세한 정보는 <a href="{@docRoot}guide/practices/screens_support.html">다중 화면
지원</a>을 참조하십시오.</p>
       </td>
    </tr>
    <tr id="TouchscreenQualifier">
      <td>터치 스크린 유형</td>
      <td>
        <code>notouch</code><br/>
        <code>finger</code>
      </td>
      <td>
        <ul class="nolist">
          <li>{@code notouch}: 기기에 터치 스크린이 없습니다.</li>
          <li>{@code finger}: 기기에 터치 스크린이 있으며 이를
사용자의 손가락을 사용한 방향 지시 상호 작용을 통해 쓰도록 되어 있습니다.</li>
        </ul>
        <p>{@link android.content.res.Configuration#touchscreen} 구성 필드도 참조하십시오.
이는 기기에서 사용되는 터치 스크린의 유형을 나타냅니다.</p>
      </td>
    </tr>
    <tr id="KeyboardAvailQualifier">
      <td>키보드 가용성</td>
      <td>
        <code>keysexposed</code><br/>
        <code>keyshidden</code><br/>
        <code>keyssoft</code>
      </td>
      <td>
        <ul class="nolist">
          <li>{@code keysexposed}: 기기에서 키보드를 사용할 수 있습니다. 키보드에
소프트웨어 키보드가 활성화되어 있으면(이럴 가능성이 큽니다), 하드웨어 키보드가 사용자에게 노출되어 있지
<em>않거나</em> 기기에 하드웨어 키보드가 없더라도 이 리소스를 사용할 수 있습니다. 소프트웨어
키보드가 제공되어 있지 않거나 비활성화되어 있는 경우 이것은 하드웨어 키보드가 노출되어 있을 때에만
사용할 수 있습니다.</li>
          <li>{@code keyshidden}: 기기에서 하드웨어 키보드를 사용할 수 있지만
숨겨져 있고 <em>이에 더하여</em> 기기에 소프트웨어 키보드가 활성화되어 있지 <em>않습니다</em>.</li>
          <li>{@code keyssoft}: 기기에 활성화된 소프트웨어 키보드가 있습니다(표시 여부는
무관).</li>
        </ul>
        <p><code>keysexposed</code> 리소스를 제공하지만 <code>keyssoft</code>
리소스는 제공하지 않는다면, 시스템은 소프트웨어 키보드가 활성화되어 있는 동안은 키보드가 보이는지 여부와 관계없이 <code>keysexposed</code>
리소스를 사용합니다.</p>
        <p>이것은 사용자가 하드웨어 키보드를 여는 경우 애플리케이션 수명 중에
변경될 수 있습니다. 이것이 런타임에 애플리케이션에 어떤 영향을 미치는지 알아보려면 <a href="runtime-changes.html">런타임 변경 처리</a>를
참조하십시오.</p>
        <p>또한, 구성 필드 {@link
android.content.res.Configuration#hardKeyboardHidden}과 {@link
android.content.res.Configuration#keyboardHidden}을 참조하십시오. 이 필드는 각각 하드웨어 키보드의 가시성과
모든 종류의 키보드(소프트웨어 포함)의 가시성을 나타냅니다.</p>
      </td>
    </tr>
    <tr id="ImeQualifier">
      <td>기본 텍스트 입력 메서드</td>
      <td>
        <code>nokeys</code><br/>
        <code>qwerty</code><br/>
        <code>12key</code>
      </td>
      <td>
        <ul class="nolist">
          <li>{@code nokeys}: 기기에 텍스트 입력을 위한 하드웨어 키가 없습니다.</li>
          <li>{@code qwerty}: 기기에 하드웨어 쿼티 키보드가 있습니다(이것이
사용자
에게 표시되는지 여부는 무관).</li>
          <li>{@code 12key}: 기기에 하드웨어 12-키 키보드가 있습니다(이것이 사용자에게 표시되는지 여부는
무관).</li>
        </ul>
        <p>{@link android.content.res.Configuration#keyboard} 구성 필드도 참조하십시오.
이는 기본 텍스트 입력 메서드를 사용할 수 있는지 여부를 나타냅니다.</p>
      </td>
    </tr>
    <tr id="NavAvailQualifier">
      <td>탐색 키 가용성</td>
      <td>
        <code>navexposed</code><br/>
        <code>navhidden</code>
      </td>
      <td>
        <ul class="nolist">
          <li>{@code navexposed}: 사용자가 탐색 키를 사용할 수 있습니다.</li>
          <li>{@code navhidden}: 탐색 키를 사용할 수 없습니다(예: 닫힌 뚜껑 뒤에 있는
경우).</li>
        </ul>
        <p>이것은 사용자가 탐색 키를 드러내는 경우 애플리케이션 수명 중에
변경될 수 있습니다. 이것이 런타임에 애플리케이션에 어떤 영향을 미치는지 알아보려면 <a href="runtime-changes.html">런타임 변경 처리</a>를
참조하십시오.</p>
        <p>{@link android.content.res.Configuration#navigationHidden} 구성
필드도 참조하십시오. 이는 탐색 키가 숨겨져 있는지 여부를 나타냅니다.</p>
      </td>
    </tr>
    <tr id="NavigationQualifier">
      <td>기본 비터치 탐색 메서드</td>
      <td>
        <code>nonav</code><br/>
        <code>dpad</code><br/>
        <code>trackball</code><br/>
        <code>wheel</code>
      </td>
      <td>
        <ul class="nolist">
          <li>{@code nonav}: 기기에 터치 스크린을 제외하고 다른 탐색 기능이
없습니다.</li>
          <li>{@code dpad}: 기기에 탐색용 방향 패드(d-pad)가 있습니다.</li>
          <li>{@code trackball}: 기기에 탐색용 트랙볼이 있습니다.</li>
          <li>{@code wheel}: 기기에 탐색용 방향 휠이 있습니다.</li>
        </ul>
        <p>{@link android.content.res.Configuration#navigation} 구성 필드도 참조하십시오.
이는 사용 가능한 탐색 메서드의 유형을 나타냅니다.</p>
      </td>
    </tr>
<!-- DEPRECATED
    <tr>
      <td>Screen dimensions</td>
      <td>Examples:<br/>
        <code>320x240</code><br/>
        <code>640x480</code><br/>
        etc.
      </td>
      <td>
        <p>The larger dimension must be specified first. <strong>This configuration is deprecated
and should not be used</strong>. Instead use "screen size," "wider/taller screens," and "screen
orientation" described above.</p>
      </td>
    </tr>
-->
    <tr id="VersionQualifier">
      <td>플랫폼 버전(API 레벨)</td>
      <td>예:<br/>
        <code>v3</code><br/>
        <code>v4</code><br/>
        <code>v7</code><br/>
        등.</td>
      <td>
        <p>기기에서 지원하는 API 레벨입니다. 예를 들어, <code>v1</code>는 API 레벨
1용이고(Android 1.0 이상 기기), <code>v4</code>는 API 레벨 4용(Android
1.6 이상 기기)입니다. 이러한 값에 관한 자세한 정보는 <a href="{@docRoot}guide/topics/manifest/uses-sdk-element.html#ApiLevels">Android API 레벨</a> 문서를
참조하십시오.</p>
      </td>
    </tr>
</table>


<p class="note"><strong>참고:</strong> 일부 구성 한정자는 Android
1.0 이후부터 추가되었으므로 모든 Android 버전이 모든 한정자를 지원하는 것은 아닙니다. 새로운 한정자를 사용하면 암시적으로
플랫폼 버전 한정자도 추가하므로 구형 기기가 이를 무시하게 됩니다. 예를 들어
<code>w600dp</code> 한정자를 사용하면 자동적으로 <code>v13</code> 한정자를 포함합니다.
사용 가능한 너비 한정자가 API 레벨 13부터 새로 도입되었기 때문입니다. 문제를 애초에 피하려면, 항상
기본 리소스를 한 세트 포함하세요(<em>한정자 없는</em> 리소스 한 세트). 자세한 정보는
<a href="#Compatibility">리소스와 연관된 최선의 기기 호환성 제공
</a>을 참조하십시오.</p>



<h3 id="QualifierRules">한정자 이름 규칙</h3>

<p>다음은 구성 한정자 이름 사용에 관한 규칙입니다.</p>

<ul>
    <li>한 가지 리소스 세트에 여러 개의 한정자를 사용할 수 있으며, 이를 대시로 구분하면 됩니다. 예를 들어,
<code>drawable-en-rUS-land</code>는 수평 방향의
US-English 기기에 적용합니다.</li>
    <li>한정자는 <a href="#table2">표2</a>에 나열된 순서를 따라야 합니다. 예:

      <ul>
        <li>잘못된 배열: <code>drawable-hdpi-port/</code></li>
        <li>맞는 배열: <code>drawable-port-hdpi/</code></li>
      </ul>
    </li>
    <li>대체 리소스 디렉터리는 중첩될 수 없습니다. 예를 들어,
<code>res/drawable/drawable-en/</code>는 있을 수 없습니다.</li>
    <li>값은 대소문자를 구분하지 않습니다.  리소스 컴파일러가 처리 전에 디렉터리 이름을
소문자로 바꿔 대소문자를 구분하지 않는
파일 시스템에서 문제를 일으키지 않도록 방지합니다. 이름에 대문자가 있는 것은 오로지 가독성을 향상하기 위해서입니다.</li>
    <li>각 한정자 유형마다 한 개의 값만 지원됩니다. 예를 들어, 스페인과 프랑스에
같은 드로어블 파일을 사용하고자 하는 경우 디렉터리 이름이
<code>drawable-rES-rFR/</code>이면 <em>안 됩니다.</em> 대신
<code>drawable-rES/</code>와 <code>drawable-rFR/</code> 같이 적절한 파일이 포함된 두 개의 리소스 디렉터리가 필요합니다.
그러나 두 위치에서 같은 파일을 실제로 복제할 필요는 없습니다. 대신
리소스에 별명을 만들면 됩니다. 아래의 <a href="#AliasResources">별명 리소스
생성</a>을 참조하십시오.</li>
</ul>

<p>이런 한정자로 이름을 지은 디렉터리에 대체 리소스를 저장하고 나면
Android가 현재 기기 구성에 기초하여 애플리케이션에 자동으로 리소스를 적용합니다.
 리소스가 요청될 때마다 Android가 요청한 리소스 파일이 들어있는
대체 리소스 디렉터리를 확인하고, 그런 다음 <a href="#BestMatch">가장 잘 일치하는
리소스를 찾습니다</a>(아래에서 논함). 특정 기기 구성에 일치하는 대체 리소스가 없는 경우,
Android는 상응하는 기본 리소스(구성 한정자를 포함하지 않는
특정 리소스 유형에 대한 리소스 세트
)를 사용합니다.</p>



<h3 id="AliasResources">별명 리소스 생성</h3>

<p>어떤 리소스를 하나 이상의 기기 구성에서 사용하고자 하는 경우(그렇지만
이를 기본 리소스를 제공하는 것은 원치 않는 경우), 같은 리소스를 하나 이상의 대체 리소스 디렉터리에
넣지 않아도 됩니다. 대신, 기본 리소스 디렉터리에 저장된 리소스에 대해 별명 역할을 하는
대체
리소스를 만들면 됩니다(경우에 따라).</p>

<p class="note"><strong>참고:</strong> 모든 리소스가 다른 리소스에 대한
별명을 생성할 수 있는 메커니즘을 제공하는 것은 아닙니다. 특히, {@code xml/} 디렉터리의 애니메이션, 메뉴, 원시 및 기타 지정되지 않은
리소스는 이 기능을 제공하지 않습니다.</p>

<p>예를 들어, 애플리케이션 아이콘 {@code icon.png}이 있고 서로 다른 로케일에서 이 아이콘의 고유 버전이
필요한 경우가 있습니다. 그러나 두 로케일, English-Canadian과 French-Canadian은 같은 버전을
사용해야 합니다. 같은 이미지를 English-Canadian과 French-Canadian 양쪽
모두에 대한 리소스 디렉터리에 복사해야 한다고 생각할 수 있지만, 실은
그렇지 않습니다. 대신, 두 로케일에서 사용하는 이미지를 {@code icon_ca.png}(
{@code icon.png} 이외에 어떤 이름이든 가능)로 저장하고 이를
기본 {@code res/drawable/} 디렉터리에 넣으면 됩니다. 그런 다음 {@code icon.xml} 파일을 {@code icon_ca.png}
리소스를 참조하는 {@code
res/drawable-en-rCA/} 및 {@code res/drawable-fr-rCA/}로 생성합니다. 이때, {@code &lt;bitmap&gt;} 요소를 사용하면 됩니다. 이렇게 하면
PNG 파일 버전 하나와 그것을 가리키는 작은 XML 파일 두 개만 저장할 수 있습니다. (XML 파일 예시는 아래와 같습니다.)</p>


<h4>드로어블</h4>

<p>기존 드로어블에 별명을 생성하려면 {@code &lt;bitmap&gt;} 요소를 사용합니다.
예를 들면 다음과 같습니다.</p>

<pre>
&lt;?xml version="1.0" encoding="utf-8"?>
&lt;bitmap xmlns:android="http://schemas.android.com/apk/res/android"
    android:src="@drawable/icon_ca" />
</pre>

<p>파일을 (
{@code res/drawable-en-rCA/}와 같은 대체 리소스 디렉터리에) {@code icon.xml}로 저장하면,
{@code R.drawable.icon}으로 참조할 수 있지만 실제로는 {@code
R.drawable.icon_ca} 리소스({@code res/drawable/}에 저장됨)의 별명인 리소스로 컴파일링됩니다.</p>


<h4>레이아웃</h4>

<p>기존 레이아웃에 별명을 생성하려면 {@code &lt;merge&gt;}로 래핑되어 있는 {@code &lt;include&gt;}
요소를 사용합니다. 예:</p>

<pre>
&lt;?xml version="1.0" encoding="utf-8"?>
&lt;merge>
    &lt;include layout="@layout/main_ltr"/>
&lt;/merge>
</pre>

<p>파일을 {@code main.xml}로 저장하면, {@code R.layout.main}으로 참조할 수 있지만 실제로는 {@code R.layout.main_ltr}
 리소스의 별명인 리소스로
컴파일링됩니다.</p>


<h4>문자열 및 기타 단순 값</h4>

<p>기존 문자열에 별명을 생성하려면 원하는 문자열의 리소스 ID를
새 문자열의 값으로 사용하면 됩니다. 예:</p>

<pre>
&lt;?xml version="1.0" encoding="utf-8"?>
&lt;resources>
    &lt;string name="hello">Hello&lt;/string>
    &lt;string name="hi">@string/hello&lt;/string>
&lt;/resources>
</pre>

<p>이제 {@code R.string.hi} 리소스는 {@code R.string.hello}의 별명입니다.</p>

<p> <a href="{@docRoot}guide/topics/resources/more-resources.html">기타 단순 값도</a> 같은 방식으로
동작합니다. 예를 들면 색상은 다음과 같습니다.</p>

<pre>
&lt;?xml version="1.0" encoding="utf-8"?>
&lt;resources>
    &lt;color name="yellow">#f00&lt;/color>
    &lt;color name="highlight">@color/red&lt;/color>
&lt;/resources>
</pre>




<h2 id="Compatibility">리소스와 연관된 최선의 기기 호환성 제공</h2>

<p>애플리케이션이 여러 기기 구성을 지원하게 하려면,
언제나 애플리케이션이 사용하는 각 유형의 리소스에 기본 리소스를 제공하는 것이 매우 중요합니다.</p>

<p>예를 들어 애플리케이션이 여러 언어를 지원할 경우, 항상 <em>언어 및 지역 한정자</em> <a href="#LocaleQualifier">없이</a> {@code
values/} 디렉터리(여기에 문자열 저장)를 포함시켜야 합니다. 그렇게 하지 않고 언어와 지역 한정자가 있는 디렉터리에
모든 문자열을 넣으면, 문자열이 지원하지 않는 언어로 설정된 기기에서 애플리케이션을
실행하면 작동이 중단됩니다. 그러나 기본
{@code values/} 리소스를 제공하는 한은 애플리케이션이 제대로 실행됩니다(사용자가 이해하지 못하는
언어로라도 작동합니다. 작동 중단보다 낫습니다.)</p>

<p>마찬가지로 화면 방향에 기초하여 여러 가지 레이아웃 리소스를 제공하는 경우
하나의 방향을 기본값으로 선택해야 합니다. 예를 들어 가로 방향에는 {@code
layout-land/}로, 세로 방향에는 {@code layout-port/}로 레이아웃 리소스를 제공하는 대신 하나를 기본으로 남겨두십시오.
가로 방향에 {@code layout/}, 세로 방향에 {@code layout-port/}와 같은 식으로 하면 됩니다.</p>

<p>애플리케이션이 예상치 못한 구성에서 실행될 수 있을 뿐만 아니라
Android의 새 버전에서 이전 버전에서는 지원하지 않는 구성 한정자를 추가할 수도 있으므로,
기본 리소스를 제공하는 것이 중요합니다. 새 리소스 한정자를 사용하지만,
Android 이전 버전과 코드 호환성은 유지한 경우, 그 후 Android 이전 버전이
애플리케이션을 실행하면 새로운 한정자로 이름을 지정한 리소스를 사용할 수 없으므로 기본 리소스를 제공하지 않으면
애플리케이션 작동이 중단됩니다. 예를 들어, <a href="{@docRoot}guide/topics/manifest/uses-sdk-element.html#min">{@code
minSdkVersion}</a>이 4로 설정되고 <a href="#NightQualifier">야간 모드</a>(API 레벨 8에서 추가된 {@code night} 또는 {@code notnight})를 사용하는 모든 드로어블 리소스를 한정할 경우, API 레벨 4 기기는
드로어블 리소스에 액세스하지 못하고 사용이 중단됩니다. 이 경우,
{@code notnight}를 기본 리소스로 제공하는 것이 좋습니다. 그래야 해당 한정자를 배제하고
드로어블 리소스가 {@code drawable/} 또는 {@code drawable-night/}이 됩니다.</p>

<p>그러므로 최선의 기기 호환성을 제공하려면 언제나
애플리케이션에서 반드시 제대로 수행해야 하는 리소스에 대해 기본 리소스를 제공하십시오. 그런 다음 구성 한정자를 사용하여
특정 기기 구성에 대해 대체 리소스를 생성하면 됩니다.</p>

<p>이 규칙에는 한 가지 예외가 있습니다. 애플리케이션의 <a href="{@docRoot}guide/topics/manifest/uses-sdk-element.html#min">{@code minSdkVersion}</a> 이 4 이상이면
<a href="#DensityQualifier">화면 밀도</a> 한정자로 대체 드로어블 리소스를 제공할 때 기본 드로어블
리소스가 <em>없어도 됩니다</em>. 기본
드로어블 리소스가 없더라도 Android가 대체 화면 화질 중에서 가장 잘 맞는 리소스를 찾고
필요에 따라 비트맵을 축소합니다. 그러나 모든 유형의 기기에서 최상의 경험을 제공하려면,
모든 세 가지 유형의 밀도에 대해 대체 드로어블을 제공해야 합니다.</p>



<h2 id="BestMatch">Android가 가장 잘 일치하는 리소스를 찾는 방법</h2>

<p>개발자가 자신이 대체를 제공하는 리소스를 요청하면 Android가 런타임에 어느 대체 리소스를
사용할지 현대 기기 구성에 따라 여러 가지로 선택합니다. Android가
대체 리소스를 선택하는 방법을 보여주기 위해 다음 드로어블 디렉터리에 각각 같은 이미지의
서로 다른 버전이 들어있다고 가정하겠습니다.</p>

<pre class="classic no-pretty-print">
drawable/
drawable-en/
drawable-fr-rCA/
drawable-en-port/
drawable-en-notouch-12key/
drawable-port-ldpi/
drawable-port-notouch-12key/
</pre>

<p>그리고 기기 구성은 다음과 같다고 가정해봅시다.</p>

<p style="margin-left:1em;">
로케일 = <code>en-GB</code> <br/>
화면 방향 = <code>port</code> <br/>
화면 픽셀 밀도 = <code>hdpi</code> <br/>
터치 스크린 유형 = <code>notouch</code> <br/>
기본 텍스트 입력 메서드 = <code>12key</code>
</p>

<p>Android는 기기 구성을 이용 가능한 대체 리소스와 비교하여,
{@code drawable-en-port}에서 드로어블을 선택합니다.</p>

<p>시스템은 다음과 같은 논리에 따라
어느 리소스를 사용할지 결정합니다.</p>


<div class="figure" style="width:371px">
<img src="{@docRoot}images/resources/res-selection-flowchart.png" alt="" height="471" />
<p class="img-caption"><strong>그림 2.</strong> Android가 가장 잘 일치하는 리소스를 찾는 방법을 나타낸
흐름도입니다.</p>
</div>


<ol>
  <li>기기 구성과 충돌하는 리소스 파일을 제거합니다.
    <p><code>drawable-fr-rCA/</code>는
<code>en-GB</code> 로케일과 충돌하므로 제거되었습니다.</p>
<pre class="classic no-pretty-print">
drawable/
drawable-en/
<strike>drawable-fr-rCA/</strike>
drawable-en-port/
drawable-en-notouch-12key/
drawable-port-ldpi/
drawable-port-notouch-12key/
</pre>
<p class="note"><strong>예외:</strong> 화면 픽셀 밀도 한정자 하나만은 충돌을 이유로 제거되지
않습니다. 기기의 화면 밀도가 hdpi라도,
현 시점에서는 모든 화면 밀도가 일치로 간주되므로 <code>drawable-port-ldpi/</code>를 제거하지 않습니다.
 자세한 정보는 <a href="{@docRoot}guide/practices/screens_support.html">다중 화면
지원</a> 문서에서 이용하실 수 있습니다.</p></li>

  <li>목록(<a href="#table2">표2</a>)에서 (그 다음으로) 우선 순위가 가장 높은 한정자를 선택합니다
(MCC부터 시작하여 아래로 내려가십시오). </li>
  <li>리소스 디렉터리 중에 이 한정자를 포함한 것이 있나요?  </li>
    <ul>
      <li>없는 경우, 2단계로 돌아가 다음 한정자를 살펴보십시오 (이 예시의 경우
언어 한정자에 도달할 때까지 답은 "없습니다"입니다).</li>
      <li>있는 경우, 4단계로 계속 진행합니다.</li>
    </ul>
  </li>

  <li>이 한정자를 포함하지 않는 디렉터리를 제거합니다. 이 예시에서는 시스템이
언어 한정자를 포함하지 않는 디렉터리를 모두 제거합니다.</li>
<pre class="classic no-pretty-print">
<strike>drawable/</strike>
drawable-en/
drawable-en-port/
drawable-en-notouch-12key/
<strike>drawable-port-ldpi/</strike>
<strike>drawable-port-notouch-12key/</strike>
</pre>
<p class="note"><strong>예외:</strong> 문제의 한정자가 화면 픽셀 밀도라면,
Android는 기기 화면 밀도와 가장 가깝게 일치하는 옵션을 선택합니다.
일반적으로, Android는 작은 원본 이미지를 확대하는 것보다
큰 원본 이미지를 축소하는 것을 선호합니다. <a href="{@docRoot}guide/practices/screens_support.html">다중 화면
지원</a>을 참조하십시오.</p>
  </li>

  <li>뒤로 돌아가 디렉터리가 한 개만 남을 때까지 2, 3 및 4단계를 반복합니다. 이 예시에서, 일치하는 것이 있는 다음 한정자는
화면 방향입니다.
그러므로 화면 방향을 지정하지 않는 리소스가 제거됩니다.
<pre class="classic no-pretty-print">
<strike>drawable-en/</strike>
drawable-en-port/
<strike>drawable-en-notouch-12key/</strike>
</pre>
<p>남은 디렉터리는 {@code drawable-en-port}입니다.</p>
  </li>
</ol>

<p>이 절차는 요청된 각 리소스에 대해 실행하지만, 시스템이 몇 가지 측면을 추가로
최적화합니다. 그러한 최적화 가운데에는 일단 기기 구성을 알게 되고 나면 절대 일치할 가능성이 없는
대체 리소스를 시스템이 제거할 수 있다는 점도 있습니다. 예를 들어, 구성 언어가
영어("en")이고 영어 이외의 다른 언어 한정자로 설정된 리소스 디렉터리는
절대 확인된 리소스 풀에 포함되지 않습니다(
언어 한정자가 포함되지 <em>않는</em> 리소스 디렉터리는 여전히 포함됩니다).</p>

<p>화면 크기 한정자에 기초하여 리소스를 선택할 때 시스템은 가장 잘 일치하는 리소스가 없다면
현재 화면보다 작은 화면에 지정된 리소스를 사용합니다
(예를 들어, 큰 화면은 필요에 따라 일반 크기 화면 리소스를 사용합니다). 그러나
이용 가능한 리소스가 현재 화면보다 <em>큰</em> 리소스뿐이라면, 시스템은
이를 사용하지 <strong>않고</strong>, 기기 구성에 일치하는 리소스가 없으면 애플리케이션 사용이 중단됩니다
(예를 들어 모든 레이아웃 리소스가 {@code xlarge} 한정자에 태그되어 있지만,
기기가 보통 크기 화면일 경우).</p>

<p class="note"><strong>참고:</strong> 한정자의 <em>우선 순위</em>(<a href="#table2">표 2</a> 참조)가 기기와 정확하게 일치하는
한정자 수보다 더 중요합니다. 예를 들어 위의 4단계에서
목록의 마지막 선택에 기기와 정확히 일치하는 한정자가 세 개 포함되어 있지만(방향, 터치 스크린
유형 및 입력 메서드), <code>drawable-en</code>에는 일치하는 매개변수가
하나뿐입니다(언어). 다만, 언어가 이러한 다른 한정자보다 우선 순위가 높기 때문에
<code>drawable-port-notouch-12key</code>는 탈락합니다.</p>

<p>애플리케이션에서 리소스를 사용하는 것에 대한 자세한 정보는 <a href="accessing-resources.html">리소스 액세스</a>로 계속 진행하여 알아보십시오.</p>