1page.title=리소스 액세스 2parent.title=애플리케이션 리소스 3parent.link=index.html 4@jd:body 5 6<div id="qv-wrapper"> 7<div id="qv"> 8 <h2>간략히 보기</h2> 9 <ul> 10 <li>리소스는 {@code R.java}의 정수를 사용하는 코드, 예를 들어 11{@code R.drawable.myimage}에서 참조할 수 있습니다.</li> 12 <li>리소스는 특수 XML 구문을 사용하는 리소스, 예를 들어 {@code 13@drawable/myimage}에서 참조할 수 있습니다.</li> 14 <li> 15{@link android.content.res.Resources}의 메서드로 앱 리소스에 액세스할 수도 있습니다.</li> 16 </ul> 17 18 <h2>Key 클래스</h2> 19 <ol> 20 <li>{@link android.content.res.Resources}</li> 21 </ol> 22 23 <h2>이 문서의 내용</h2> 24 <ol> 25 <li><a href="#ResourcesFromCode">코드에서 리소스 액세스</a></li> 26 <li><a href="#ResourcesFromXml">XML에서 리소스 액세스</a> 27 <ol> 28 <li><a href="#ReferencesToThemeAttributes">스타일 속성 참조</a></li> 29 </ol> 30 </li> 31 <li><a href="#PlatformResources">플랫폼 리소스 액세스</a></li> 32 </ol> 33 34 <h2>참고 항목</h2> 35 <ol> 36 <li><a href="providing-resources.html">리소스 제공</a></li> 37 <li><a href="available-resources.html">리소스 유형</a></li> 38 </ol> 39</div> 40</div> 41 42 43 44 45<p>일단 어떤 리소스를 애플리케이션에 제공한 다음에는(<a href="providing-resources.html">리소스 제공</a>에서 논의), 46해당 리소스의 리소스 ID를 참조함으로써 이를 적용할 수 있습니다. 모든 리소스 ID는 47{@code aapt} 도구가 자동으로 생성하는 프로젝트의 {@code R} 클래스에서 정의됩니다.</p> 48 49<p>애플리케이션이 컴파일링되면, {@code aapt}가 {@code R} 클래스를 생성하며, 이 클래스 안에 {@code 50res/} 디렉터리에 있는 모든 리소스의 51리소스 ID가 들어있습니다. 각 리소스 유형에는 {@code R} 하위 클래스가 있고(예: 모든 드로어블 리소스에 대한 52{@code R.drawable}), 해당 유형의 각 리소스에는 정적 53정수가 있습니다(예: {@code R.drawable.icon}). 이 정수가 54리소스를 검색하는 데 사용할 수 있는 리소스 ID입니다.</p> 55 56<p>{@code R} 클래스가 리소스 ID가 지정되는 곳이기는 하지만, 리소스 ID를 찾기 위해 57이곳을 볼 필요는 전혀 없습니다. 하나의 리소스 ID는 항상 다음과 같이 구성됩니다.</p> 58<ul> 59 <li><em>리소스 유형</em>: 각 리소스는 "유형"으로 그룹화됩니다. 예: {@code 60string}, {@code drawable} 및 {@code layout} 다양한 유형에 관한 자세한 정보는 <a href="available-resources.html">리소스 유형</a>을 참조하십시오. 61 </li> 62 <li><em>리소스 이름</em>: 63리소스가 단순 값(예: 문자열 등)일 경우, 64확장자를 제외한 파일 이름이나 XML {@code android:name} 속성 값 중 하나입니다.</li> 65</ul> 66 67<p>리소스에 액세스하는 방법은 두 가지가 있습니다.</p> 68<ul> 69 <li><strong>코드 내부에서:</strong> {@code R} 70클래스의 하위 클래스에서 정적 정수를 사용합니다. 예: 71 <pre class="classic no-pretty-print">R.string.hello</pre> 72 <p>{@code string}은 리소스 유형이고 {@code hello}는 리소스 이름입니다. 리소스 ID를 이 형식으로 제공하면 리소스에 액세스할 수 있는 73Android API가 많습니다. 74<a href="#ResourcesFromCode">코드 내 리소스 액세스</a>를 참조하십시오.</p> 75 </li> 76 <li><strong>XML 내부에서:</strong> {@code R} 클래스에서 정의된 77리소스 ID에 상응하기도 하는 특수 XML 구문을 사용합니다. 예: 78 <pre class="classic no-pretty-print">@string/hello</pre> 79 <p>{@code string}은 리소스 유형이고 {@code hello}는 리소스 이름입니다. 이 80구문은 리소스로 값을 제공할 것으로 예상되는 어느 곳에서나 XML 리소스 형태로 사용할 수 있습니다. <a href="#ResourcesFromXml">XML에서 리소스 액세스</a>를 참조하십시오.</p> 81 </li> 82</ul> 83 84 85 86<h2 id="ResourcesFromCode">코드 내 리소스 액세스 </h2> 87 88<p>리소스 ID를 메서드 매개변수로 전달하면 코드 내 리소스를 사용할 수 있습니다. 예를 들어 89, {@link android.widget.ImageView}를 설정하여 {@link android.widget.ImageView#setImageResource(int) setImageResource()}를 사용하는 {@code res/drawable/myimage.png} 90리소스를 사용할 수 있습니다.</p> 91<pre> 92ImageView imageView = (ImageView) findViewById(R.id.myimageview); 93imageView.setImageResource(<strong>R.drawable.myimage</strong>); 94</pre> 95 96<p>{@link 97android.content.res.Resources}에서 메서드를 사용하는 개별 리소스를 검색할 수도 있으며, 이는 98{@link android.content.Context#getResources()}로 인스턴스를 가져올 수 있습니다.</p> 99 100<div class="sidebox-wrapper"> 101<div class="sidebox"> 102<h2>원본 파일에 액세스</h2> 103 104<p>흔한 일은 아니지만, 원본 파일과 디렉터리에 액세스해야 하는 경우가 있습니다. 이 경우에는 105{@code res/}에 파일을 저장하더라도 소용이 없습니다. 106{@code res/}에서 리소스를 읽는 방법은 리소스 ID를 사용하는 것뿐이기 때문입니다. 그 대신 리소스를 107{@code assets/} 디렉터리에 저장하면 됩니다.</p> 108<p>{@code assets/} 디렉터리에 저장된 파일은 리소스 109ID가 부여되지 <em>않으므로</em>, 이와 같은 리소스는 {@code R} 클래스나 XML 리소스에서 참조할 수 없습니다. 그 대신 110일반 파일 시스템처럼 {@code assets/} 디렉터리에 파일을 쿼리하고 111{@link android.content.res.AssetManager}를 사용하여 원시 데이터를 읽을 수 있습니다.</p> 112<p>하지만 필요한 것이 원시 데이터(동영상 또는 오디오 파일 등)를 읽는 능력뿐인 경우라면, 113파일을 {@code res/raw/} 디렉터리에 저장한 다음 일련의 바이트 스트림을 {@link 114android.content.res.Resources#openRawResource(int) openRawResource()}를 사용하여 읽으면 됩니다.</p> 115 116</div> 117</div> 118 119 120<h3>구문</h3> 121 122<p>다음은 코드로 리소스를 참조하는 데 쓰는 구문입니다.</p> 123 124<pre class="classic no-pretty-print"> 125[<em><package_name></em>.]R.<em><resource_type></em>.<em><resource_name></em> 126</pre> 127 128<ul> 129 <li><em>{@code <package_name>}</em>은(는) 리소스가 위치한 패키지의 이름입니다( 130자체 패키지의 리소스를 참조할 경우에는 필요하지 않습니다).</li> 131 <li><em>{@code <resource_type>}</em>은(는) 해당 리소스 유형의 {@code R} 하위 클래스입니다.</li> 132 <li><em>{@code <resource_name>}</em>은(는) 확장자가 없는 리소스 파일 이름이거나 133XML 요소의 {@code android:name} 속성 값입니다(단순 134값의 경우).</li> 135</ul> 136<p>각 리소스 유형과 참조 방법에 관한 자세한 내용은 <a href="available-resources.html">리소스 유형</a> 137을 참조하십시오.</p> 138 139 140<h3>사용 사례</h3> 141 142<p>리소스 ID 매개변수를 허용하는 메서드가 많이 있고, {@link android.content.res.Resources}에서 메서드를 143 사용하여 리소스를 검색할 수 있습니다. {@link android.content.Context#getResources 144Context.getResources()}로 {@link 145android.content.res.Resources}의 인스턴스를 가져올 수 있습니다.</p> 146 147 148<p>다음은 코드로 리소스에 액세스한 몇 가지 예시입니다.</p> 149 150<pre> 151// Load a background for the current screen from a drawable resource 152{@link android.app.Activity#getWindow()}.{@link 153android.view.Window#setBackgroundDrawableResource(int) 154setBackgroundDrawableResource}(<strong>R.drawable.my_background_image</strong>) ; 155 156// Set the Activity title by getting a string from the Resources object, because 157// this method requires a CharSequence rather than a resource ID 158{@link android.app.Activity#getWindow()}.{@link android.view.Window#setTitle(CharSequence) 159setTitle}(getResources().{@link android.content.res.Resources#getText(int) 160getText}(<strong>R.string.main_title</strong>)); 161 162// Load a custom layout for the current screen 163{@link android.app.Activity#setContentView(int) 164setContentView}(<strong>R.layout.main_screen</strong>); 165 166// Set a slide in animation by getting an Animation from the Resources object 167mFlipper.{@link android.widget.ViewAnimator#setInAnimation(Animation) 168setInAnimation}(AnimationUtils.loadAnimation(this, 169 <strong>R.anim.hyperspace_in</strong>)); 170 171// Set the text on a TextView object using a resource ID 172TextView msgTextView = (TextView) findViewById(<strong>R.id.msg</strong>); 173msgTextView.{@link android.widget.TextView#setText(int) 174setText}(<strong>R.string.hello_message</strong>); 175</pre> 176 177 178<p class="caution"><strong>주의:</strong> 손으로 {@code 179R.java} 파일을 수정해서는 안 됩니다.—이것은 프로젝트가 180컴파일되었을 때 {@code aapt} 도구가 생성한 파일입니다. 모든 변경 사항은 다음 번 컴파일에서 재정의됩니다.</p> 181 182 183 184<h2 id="ResourcesFromXml">XML에서 리소스 액세스</h2> 185 186<p>기존 리소스에 대한 참조를 사용하여 187일부 XML 속성과 요소의 값을 정의할 수 있습니다. 이 작업은 레이아웃 파일을 생성할 때 위젯에 문자열과 이미지를 제공하기 위해 188자주 하게 됩니다.</p> 189 190<p>예를 들어, 레이아웃에 {@link android.widget.Button}을 추가하면 191해당 버튼 텍스트에 <a href="string-resource.html">문자열 리소스</a>를 사용해야 합니다.</p> 192 193<pre> 194<Button 195 android:layout_width="fill_parent" 196 android:layout_height="wrap_content" 197 android:text="<strong>@string/submit</strong>" /> 198</pre> 199 200 201<h3>구문</h3> 202 203<p>다음은 XML 리소스로 리소스를 참조하는 데 쓰는 구문입니다.</p> 204 205<pre class="classic no-pretty-print"> 206@[<em><package_name></em>:]<em><resource_type></em>/<em><resource_name></em> 207</pre> 208 209<ul> 210 <li>{@code <package_name>}은(는) 리소스가 위치한 패키지의 이름입니다( 211같은 패키지의 리소스를 참조할 경우에는 필요하지 않습니다).</li> 212 <li>{@code <resource_type>}은(는) 해당 리소스 유형의 213{@code R} 하위 클래스입니다.</li> 214 <li>{@code <resource_name>}은(는) 확장자가 없는 리소스 파일 이름이거나 215XML 요소의 {@code android:name} 속성 값입니다(단순 216값의 경우).</li> 217</ul> 218 219<p>각 리소스 유형과 참조 방법에 관한 자세한 내용은 <a href="available-resources.html">리소스 유형</a> 220을 참조하십시오.</p> 221 222 223<h3>사용 사례</h3> 224 225<p>몇몇 경우에는 값에 대한 리소스를 반드시 XML로 사용해야 하지만(예: 위젯에 드로어블 이미지를 226 적용하기 위해), 단순 값을 허용하는 곳이라면 어디서든 XML로 리소스를 사용할 수도 있습니다. 예를 들어 227, <a href="more-resources.html#Color">색상 리소스</a>와 <a href="string-resource.html">문자열 리소스</a>를 포함한 다음과 같은 리소스 파일을 가지고 있다고 합시다.</p> 228 229<pre> 230<?xml version="1.0" encoding="utf-8"?> 231<resources> 232 <color name="opaque_red">#f00</color> 233 <string name="hello">Hello!</string> 234</resources> 235</pre> 236 237<p>텍스트 색상과 238텍스트 문자열을 설정하는 데 이와 같은 리소스를 다음의 레이아웃 파일에서 사용할 수 있습니다.</p> 239 240<pre> 241<?xml version="1.0" encoding="utf-8"?> 242<EditText xmlns:android="http://schemas.android.com/apk/res/android" 243 android:layout_width="fill_parent" 244 android:layout_height="fill_parent" 245 android:textColor="<strong>@color/opaque_red</strong>" 246 android:text="<strong>@string/hello</strong>" /> 247</pre> 248 249<p>이 경우, 리소스를 자체 패키지에서 가져왔으므로 리소스 참조에 패키지 이름을 250지정하지 않아도 됩니다. 251시스템 리소스를 참조하려면 패키지 이름을 포함해야 합니다. 예:</p> 252 253<pre> 254<?xml version="1.0" encoding="utf-8"?> 255<EditText xmlns:android="http://schemas.android.com/apk/res/android" 256 android:layout_width="fill_parent" 257 android:layout_height="fill_parent" 258 android:textColor="<strong>@android:color/secondary_text_dark</strong>" 259 android:text="@string/hello" /> 260</pre> 261 262<p class="note"><strong>참고:</strong> 항상 문자열 리소스를 사용해야 263사용자의 애플리케이션이 다른 언어에 맞게 지역화될 수 있습니다. 264대체 265리소스(예: 지역화된 문자열) 생성에 관한 자세한 정보는 <a href="providing-resources.html#AlternativeResources">대체 266리소스 제공</a>을 참조하십시오. 다른 언어로 애플리케이션을 지역화하기 위한 전체 지침은 267<a href="localization.html">지역화</a>를 참조하십시오.</p> 268 269<p>XML의 리소스를 사용하여 별명을 생성할 수도 있습니다. 예를 들어, 드로어블 리소스이면서 270또 다른 드로어블 리소스의 별명인 것을 생성할 수 있습니다.</p> 271 272<pre> 273<?xml version="1.0" encoding="utf-8"?> 274<bitmap xmlns:android="http://schemas.android.com/apk/res/android" 275 android:src="@drawable/other_drawable" /> 276</pre> 277 278<p>이것은 일견 중복되는 것처럼 들리지만, 대체 리소스를 사용할 때 매우 유용하게 쓰일 수 있습니다. 279<a href="providing-resources.html#AliasResources">별명 리소스 생성</a>에 관해 자세히 알아보십시오.</p> 280 281 282 283<h3 id="ReferencesToThemeAttributes">스타일 속성 참조</h3> 284 285<p>스타일 속성 리소스는 현재 적용된 테마의 속성 값을 286참조할 수 있게 해줍니다. 스타일 속성을 참조하면 287하드 코드로 작성된 값을 제공하는 것 대신에 UI 요소의 외관을 사용자 지정하여 288현재 테마에서 제공한 표준 변형에 맞춰 스타일링할 수 있습니다. 스타일 속성을 참조하는 것은 289기본적으로 "이 속성이 정의한 스타일을 현재 테마로 사용하라"는 말과 같습니다.</p> 290 291<p>스타일 속성을 참조하는 경우, 이름 구문은 보통 292리소스와 거의 똑같습니다. 다만 앳 기호({@code @})를 사용하는 대신 물음표({@code ?})를 사용하며, 293리소스 유형 부분이 선택 사항이라는 점만이 다릅니다. 예:</p> 294 295<pre class="classic"> 296?[<em><package_name></em>:][<em><resource_type></em>/]<em><resource_name></em> 297</pre> 298 299<p>예컨대 다음은 텍스트 색상을 시스템 테마의 "기본" 텍스트 색상에 300일치하도록 설정하기 위해 속성을 참조하는 방법을 나타낸 것입니다.</p> 301 302<pre> 303<EditText id="text" 304 android:layout_width="fill_parent" 305 android:layout_height="wrap_content" 306 android:textColor="<strong>?android:textColorSecondary</strong>" 307 android:text="@string/hello_world" /> 308</pre> 309 310<p>여기서 {@code android:textColor} 속성이 주어진 스타일 속성의 이름을 현재 테마대로 311지정합니다. Android는 이제 {@code android:textColorSecondary} 312스타일 속성에 적용된 값을 이 위젯의 {@code android:textColor}에 대한 값으로 사용합니다. 시스템 313리소스 도구는 속성 리소스가 이 컨텍스트에서 예상된다는 것을 알기 때문에 314유형( 315<code>?android:attr/textColorSecondary</code>)을 명시적으로 선언하지 않아도 됩니다.—{@code attr} 유형은 배제해도 됩니다.</p> 316 317 318 319 320<h2 id="PlatformResources">플랫폼 리소스 액세스</h2> 321 322<p>Android에는 스타일, 테마 및 레이아웃 등 여러 가지 표준 리소스가 포함되어 있습니다. 323이와 같은 리소스에 액세스하려면 324<code>android</code> 패키지 이름으로 리소스 참조를 한정합니다. 예를 들어 Android는 325{@link android.widget.ListAdapter}의 목록 항목으로 사용할 수 있는 레이아웃 리소스를 제공합니다.</p> 326 327<pre> 328{@link android.app.ListActivity#setListAdapter(ListAdapter) 329setListAdapter}(new {@link 330android.widget.ArrayAdapter}<String>(this, <strong>android.R.layout.simple_list_item_1</strong>, myarray)); 331</pre> 332 333<p>이 예시에서 {@link android.R.layout#simple_list_item_1}은 334{@link android.widget.ListView}의 항목에 대해 플랫폼이 정의한 레이아웃 리소스입니다. 목록 항목에 대해 나름의 레이아웃을 335만드는 대신 이것을 사용해도 됩니다. 자세한 내용은 336<a href="{@docRoot}guide/topics/ui/layout/listview.html">목록 보기</a> 개발자 가이드를 참조하십시오.</p> 337 338
