레이아웃

레이아웃은 사용자 인터페이스에 대한 시각적 구조를 정의합니다. 예컨대 액티비티 또는 앱 위젯에 대한 UI가 이에 해당됩니다. 레이아웃을 선언하는 데에는 다음과 같은 두 가지 방법이 있습니다.

  • UI 요소를 XML로 선언. Android는 위젯과 레이아웃 등과 같이 View 클래스와 서브클래스에 해당하는 간단한 XML 어휘를 제공합니다.
  • 런타임에 레이아웃 요소 인스턴스화. 애플리케이션이 프로그래밍 방식으로 View 및 ViewGroup 객체를 만들고 속성을 조작할 수 있습니다.

Android 프레임워크에서는 이와 같이 애플리케이션의 UI를 선언하고 관리하기 위한 메서드를 둘 중 하나만, 또는 둘 모두 사용할 수 있는 유연성을 부여합니다. 예를 들어, 애플리케이션의 기본 레이아웃을 XML에서 선언하면서 그 안에 나타날 화면 요소와 그 속성을 포함할 수 있습니다. 그러면 이제 애플리케이션에 코드를 추가하여 화면 객체의 상태를 수정하도록 할 수 있으며, 여기에는 런타임에 XML로 선언된 것도 포함됩니다.

UI를 XML로 선언하는 것의 이점은 이렇게 하면 애플리케이션을 그 동작을 제어하는 코드로부터 따로 표시하기가 더 좋다는 것입니다. UI 설명은 애플리케이션 코드의 외부에 있습니다. 이는 다시 말해 소스 코드를 수정하고 다시 컴파일하지 않아도 이를 수정 또는 변경할 수 있다는 뜻입니다. 예를 들어, 서로 다른 화면 방향, 사로 다른 기기 화면 크기 및 서로 다른 언어에 대해 XML 레이아웃을 생성할 수 있습니다. 이외에도 레이아웃을 XML로 선언하면 UI의 구조를 시각화하기가 더 쉬우므로 문제를 디버깅하기도 더 쉽습니다. 따라서, 이 문서는 레이아웃을 XML로 선언하는 방법을 가르치는 데 주안점을 두고 있습니다. 런타임에 View 객체를 인스턴스화하는 것에 흥미가 있는 경우, ViewGroupView 클래스 참조를 참조하세요.

일반적으로 UI 요소를 선언하는 데 쓰이는 XML 어휘는 클래스와 메서드 구조와 명명 규칙을 충실히 따릅니다. 여기에서 요소 이름은 클래스 이름에 상응하며 특성 이름은 메서드에 상응합니다. 사실 이러한 일치성은 아주 직접적인 경우가 잦아 어느 XML 특성이 클래스 메서드에 상응하는지를 추측할 수 있고, 어느 클래스가 주어진 XML 요소에 상응하는지도 추측할 수 있습니다. 다만 모든 어휘가 다 같지는 않다는 점을 유의하세요. 몇몇 경우에는 명명에 약간의 차이점이 있습니다. 예를 들어, EditText 요소에는 text 특성이 있으며 이는 EditText.setText()에 상응합니다.

팁: 여러 가지 레이아웃 유형에 대해서는 일반적 레이아웃 객체를 참조하세요.

XML 쓰기

Android의 XML 어휘를 사용하면 UI 레이아웃과 그 안에 들어있는 화면 요소를 HTML에서 웹 페이지를 디자인할 때와 같은 방식으로 신속하게 디자인할 수 있습니다. 즉 일련의 중첩된 요소를 사용하는 것입니다.

각 레이아웃 파일에는 반드시 딱 하나의 루트 요소만 있어야 하며, 이는 View 또는 ViewGroup 객체여야 합니다. 루트 요소를 정의한 후에, 더 많은 레이아웃 객체 또는 위젯을 하위 요소로 추가하여 계층적으로 레이아웃을 정의하는 뷰 계층을 구축할 수 있습니다. 예를 들어, 다음은 수직 LinearLayout을 사용하여 TextViewButton을 보유하는 XML 레이아웃을 나타낸 것입니다.

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
              android:layout_width="match_parent"
              android:layout_height="match_parent"
              android:orientation="vertical" >
    <TextView android:id="@+id/text"
              android:layout_width="wrap_content"
              android:layout_height="wrap_content"
              android:text="Hello, I am a TextView" />
    <Button android:id="@+id/button"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="Hello, I am a Button" />
</LinearLayout>

레이아웃을 XML로 선언하고 나면 그 파일을 Android 프로젝트의 res/layout/ 디렉터리 내에 .xml 확장자로 저장하여 적절하게 컴파일되도록 합니다.

레이아웃 XML 파일의 구문에 대한 자세한 정보는 레이아웃 리소스 문서에서 확인할 수 있습니다.

XML 리소스 로드

애플리케이션을 컴파일하는 경우, 각 XML 레이아웃 파일이 View 리소스 안에 컴파일됩니다. 애플리케이션 코드로부터 가져온 레이아웃 리소스는 Activity.onCreate() 콜백 구현에 로드해야 합니다. 이렇게 하려면 setContentView()를 호출한 다음, 이를 R.layout.layout_file_name 형태로 레이아웃 리소스의 참조에 전달합니다. 예를 들어, XML 레이아웃이 main_layout.xml로 저장된 경우, 이것을 액티비티에 대해 로드하려면 다음과 같이 하면 됩니다.

public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.main_layout);
}

액티비티 내의 onCreate() 콜백 메서드는 액티비티가 시작될 때 Android 프레임워크가 호출합니다(수명 주기에 대한 논의는 액티비티 문서에서 확인하세요).

특성

모든 View 및 ViewGroup 객체는 자신만의 다양한 XML 특성을 지원합니다. 몇몇 특성은 View 객체에만 특화되어 있지만(예를 들어, TextView는 textSize 특성을 지원), 이와 같은 특성은 이 클래스를 확장할 수 있는 모든 View 객체가 상속하기도 합니다. 모든 View 객체에 공통으로 쓰이는 것도 몇 가지 있습니다. 왜냐하면 이들은 루트 View 클래스에서 상속된 것이기 때문입니다(예: id 특성). 그리고 나머지 특성은 "레이아웃 매개변수"로 간주됩니다. 이들은 View 객체의 특정한 레이아웃 방향을 설명하는 것으로, 이는 해당 객체의 상위 VeiwGroup 객체에서 정의된 바에 따릅니다.

ID

모든 View 객체에는 연관된 정수 ID가 있을 수 있습니다. 이는 트리 내에서 해당 뷰를 고유하게 식별하기 위한 것입니다. 애플리케이션이 컴파일되면 이 ID가 정수로 참조되지만, ID는 일반적으로 레이아웃 XML 파일에 문자열로 할당되며, id 특성으로 쓰입니다. 이것은 모든 View 객체에 공통적인 XML 특성으로 (View 클래스가 정의) 매우 자주 사용하게 됩니다. ID에 대한, XML 태그 내에 있는 구문은 다음과 같습니다.

android:id="@+id/my_button"

문자열 시작 부분에 있는 앳 기호(@)는 XML 파서가 ID 문자열의 나머지를 파싱하고 확장하여 ID 리소스로 식별해야 한다는 것을 나타냅니다. 더하기 기호(+)는 이것이 새 리소스 이름이며, 이것을 반드시 생성하여 리소스에 추가해야 한다는 것을 뜻합니다(R.java 파일에서). Android 프레임워크는 다른 ID 리소스도 아주 많이 제공합니다. Android 리소스 ID를 참조할 때에는 더하기 기호는 필요하지 않지만 android 패키지 네임스페이스를 다음과 같이 반드시 추가해야 합니다.

android:id="@android:id/empty"

android 패키지 네임스페이스를 제자리에 넣으면 이제 ID를 로컬 리소스 클래스에서가 아니라 android.R 리소스 클래스에서 참조하고 있는 것이 됩니다.

뷰를 생성하고 이를 애플리케이션에서 참조하는 데 쓰이는 보편적인 패턴은 다음과 같습니다.

  1. 레이아웃 파일에서 뷰/위젯을 정의한 다음 이를 고유한 ID에 할당합니다.
    <Button android:id="@+id/my_button"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="@string/my_button_text"/>
    
  2. 그런 다음 View 객체의 인스턴스를 생성하고 이를 레이아웃에서 캡처합니다 (일반적으로 onCreate() 메서드에서).
    Button myButton = (Button) findViewById(R.id.my_button);
    

RelativeLayout을 생성할 때에는 View 객체의 ID를 정의하는 것이 중요합니다. 관계 레이아웃에서는 형제 뷰가 또 다른 형제 뷰와 관련된 자신의 레이아웃을 정의할 수 있으며, 이를 고유한 ID로 참조하게 됩니다.

ID는 트리 전체를 통틀어 고유할 필요는 없지만, 트리에서 검색하고 있는 부분 내에서는 고유해야 합니다(이것이 트리 전체인 경우가 잦으므로, 가급적이면 완전히 고유한 것을 쓰는 것이 가장 좋습니다).

레이아웃 매개변수

layout_something이라는 XML 레이아웃 특성이 뷰가 상주하는 ViewGroup에 대해 적절한 뷰의 레이아웃 매개변수를 정의합니다.

모든 ViewGroup 클래스가 중첩된 클래스를 하나씩 구현하며 이것이 ViewGroup.LayoutParams를 확장합니다. 이 서브클래스에는 각 하위 뷰의 크기와 위치를 뷰 그룹에 적절한 방식으로 정의하는 속성 유형이 들어 있습니다. 그림 1에서 볼 수 있듯이, 상위 뷰 그룹이 각 하위 뷰의 레이아웃 매개변수를 정의합니다(하위 뷰 그룹 포함).

그림 1. 각 뷰와 연관된 레이아웃 매개변수가 있는 뷰 계층을 시각화한 것.

모든 LayoutParams 서브클래스에는 설정 값에 대한 각기 자신만의 구문이 있다는 점을 눈여겨 보세요. 각 하위 요소는 자신의 상위에 적합한 LayoutParams를 정의해야 합니다. 다만 이것은 자신의 하위에 대해 각기 다른 LayoutParams도 정의할 수 있습니다.

모든 뷰 그룹에는 너비와 높이가 포함되며(layout_widthlayout_height), 각 뷰는 이들을 반드시 정의해야 합니다. 선택 사항으로 여백과 테두리도 포함하는 LayoutParams도 많습니다.

너비와 높이는 정확한 치수로 지정할 수 있습니다. 다만 이것은 자주 하지 않는 것이 좋습니다. 그보다는 다음과 같은 상수 중 하나를 사용하여 너비 또는 높이를 설정하는 경우가 더 많습니다.

  • wrap_content는 콘텐츠에 필요한 치수대로 알아서 크기를 조정하도록 뷰에 지시합니다.
  • match_parent는 상위 뷰 그룹이 허용하는 한 최대한으로 커지도록 뷰에 지시합니다.

일반적으로 픽셀과 같이 절대적인 단위를 사용하여 레이아웃 너비와 높이를 지정하는 것은 권장하지 않습니다. 그 대신, 밀도 독립적인 픽셀 단위(dp), wrap_content 또는 match_parent와 같이 상대적인 측정치를 사용하는 것이 더 낫습니다. 이렇게 하면 애플리케이션이 다양한 기기 화면 크기에 걸쳐서도 적절하게 표시되도록 보장하는 데 도움이 되기 때문입니다. 허용된 측정 유형은 사용 가능한 리소스 문서에 정의되어 있습니다.

레이아웃 위치

뷰의 모양은 직사각형입니다. 뷰에는 위치가 있으며, 이는 한 쌍의 왼쪽상단 좌표, 그리고 두 개의 치수가 너비와 높이를 나타내는 형식으로 표현됩니다. 위치와 치수의 단위는 픽셀입니다.

뷰의 위치를 검색할 수 있습니다. getLeft()getTop() 메서드를 호출하면 됩니다. 전자는 뷰를 나타내는 직사각형의 왼쪽, 즉 X 좌표를 반환합니다. 후자는 뷰를 나타내는 직사각형의 상단, 즉 Y 좌표를 반환합니다. 이들 메서드는 둘 다 해당 뷰의 상위에 상대적인 뷰의 위치를 반환합니다. 예를 들어, getLeft()가 20을 반환하는 경우 이는 해당 뷰가 그 뷰의 바로 상위의 왼쪽 가장자리에서 오른쪽으로 20픽셀 떨어진 곳에 있다는 뜻입니다.

이외에도 불필요한 계산을 피하기 위해 여러 가지 편의 메서드가 제공됩니다. 구체적으로 getRight()getBottom()을 들 수 있습니다. 이들 메서드는 해당 뷰를 나타내는 직사각형의 오른쪽과 하단 가장자리의 좌표를 반환합니다. 예를 들어 getRight()를 호출하는 것은 다음 계산과 비슷합니다. getLeft() + getWidth()

크기, 패딩 및 여백

뷰의 크기는 너비와 높이로 표현됩니다. 사실 하나의 뷰는 두 쌍의 너비 및 높이 값을 소유합니다.

첫 번째 쌍을 측정된 너비측정된 높이라고 합니다. 이들 치수는 뷰가 상위 내에서 얼마나 커지고자 하는지를 정의합니다. 측정된 치수를 가져오려면 getMeasuredWidth()getMeasuredHeight()를 호출하면 됩니다.

두 번째 쌍은 단순히 너비높이라고 일컬으며, 때로는 그리기 너비그리기 높이로 부를 때도 있습니다. 이러한 치수는 그리기 시간 및 레이아웃 후에 뷰가 화면에 표시되는 실제 크기를 정의합니다. 이들 값은 측정된 너비 및 높이와 달라도 되지만 꼭 달라야 하는 것은 아닙니다. 너비와 높이를 가져오려면 getWidth()getHeight()를 호출하면 됩니다.

뷰의 치수를 측정하기 위해 뷰는 자신의 패딩을 감안합니다. 패딩은 뷰의 왼쪽, 상단, 오른쪽 및 하단 부분에 대해 픽셀로 표시됩니다. 패딩은 정해진 픽셀 수를 사용하여 뷰의 콘텐츠를 오프셋하는 데 쓰일 수도 있습니다. 예를 들어 왼쪽 패딩을 2로 설정하면 해당 뷰의 콘텐츠를 왼쪽 가장자리에서 오른쪽으로 2픽셀 밀어냅니다. 패딩을 설정할 때에는 setPadding(int, int, int, int) 메서드를 사용하면 되고, 이를 쿼리하려면 getPaddingLeft(), getPaddingTop(), getPaddingRight()getPaddingBottom()을 사용하면 됩니다.

뷰는 패딩을 정의할 수 있지만, 여백에 대한 지원은 전혀 제공하지 않습니다. 다만 뷰 그룹이 그와 같은 지원을 제공합니다. 자세한 정보는 ViewGroupViewGroup.MarginLayoutParams를 참조하세요.

치수에 대한 자세한 정보는 치수 값을 참조하세요.

일반 레이아웃

ViewGroup 클래스의 각 서브클래스는 각기 고유한 방식으로 자신 안에 중첩된 뷰를 표시합니다. 아래는 Android 플랫폼에서 기본 제공되는, 보다 보편적인 레이아웃 유형을 몇 가지 나타낸 것입니다.

참고: 하나 이상의 레이아웃을 또 다른 레이아웃에 중첩하여 UI 디자인을 이룰 수도 있지만, 레이아웃 계층을 가능한 한 얕게 유지하도록 애써야 합니다. 중첩된 레이아웃이 적을수록 레이아웃이 더욱 빠르게 그려집니다(가로로 넓은 뷰 계층이 깊은 뷰 계층보다 낫습니다).

선형 레이아웃

여러 하위를 하나의 가로 방향 또는 세로 방향 행으로 정리하는 레이아웃. 이 레이아웃은 창의 길이가 화면 길이를 웃도는 경우 스크롤바를 생성합니다.

상대적 레이아웃

여러 하위 객체의 위치를 서로 상대적으로 나타내거나(하위 A가 하위 B의 왼쪽), 상위와 상대적으로 나타낼 수 있도록 해줍니다(상위의 맨 위에 맞춰 정렬).

웹 뷰

웹 페이지를 표시합니다.

어댑터로 레이아웃 구축

레이아웃의 콘텐츠가 동적이거나 미리 정의되지 않은 경우, AdapterView의 서브클래스가 되는 레이아웃을 사용하여 런타임에 뷰로 레이아웃을 채울 수 있습니다. AdapterView 클래스의 서브클래스는 Adapter를 사용하여 자신의 레이아웃에 데이터를 바인드합니다. Adapter가 데이터 소스와 AdapterView 레이아웃 사이의 중개자 역할을 합니다. —Adapter가 데이터를 검색하여(배열 또는 데이터베이스 쿼리와 같은 소스로부터) 각 항목을 뷰로 변환해서 AdapterView 레이아웃에 추가될 수 있도록 합니다.

어댑터로 지원되는 일반적인 레이아웃의 몇 가지 예는 다음과 같습니다.

목록 뷰

스크롤 단일 열 목록을 표시합니다.

그리드 뷰

열과 행의 스크롤 눈금을 표시합니다.

데이터로 어댑터 뷰 채우기

ListView 또는 GridView와 같은 AdapterView를 채우려면 AdapterView 인스턴스를 Adapter에 바인딩하면 됩니다. 이는 외부 소스로부터 데이터를 검색하여 각 데이터 항목을 나타내는 View를 생성합니다.

Android는 Adapter의 서브클래스를 여러 개 제공합니다. 이는 여러 가지 종류의 데이터를 검색하고 AdapterView에 대한 뷰를 구축하는 데 유용합니다. 가장 보편적인 어댑터 두 가지를 예로 들면 다음과 같습니다.

ArrayAdapter
데이터 소스가 배열인 경우에 이 어댑터를 사용합니다. 기본적으로 ArrayAdapter가 각 배열 항목에서 toString()을 호출하고 그 콘텐츠를 TextView에 배치함으로써 각 항목에 대한 뷰를 생성합니다.

예를 들어, ListView로 문자열 배열을 표시하고자 하는 경우, 생성자를 사용하여 새로운 ArrayAdapter를 초기화해서 각 문자열과 문자열 배열에 대한 레이아웃을 지정하면 됩니다.

ArrayAdapter<String> adapter = new ArrayAdapter<String>(this,
        android.R.layout.simple_list_item_1, myStringArray);

이 생성자에 대한 인수는 다음과 같습니다.

  • 개발자의 앱 Context
  • 배열에 있는 각 문자열에 대한 TextView가 들어있는 레이아웃
  • 문자열 배열

그런 다음 ListView에서 setAdapter()를 호출하기만 하면 됩니다.

ListView listView = (ListView) findViewById(R.id.listview);
listView.setAdapter(adapter);

각 항목의 외관을 사용자 지정하려면 배열의 객체에 대한 toString() 메서드를 재정의하면 됩니다. 아니면, 각 항목에 대하여 TextView가 아닌 다른 뷰를 생성하고자 하는 경우(예를 들어 각 배열 항목에 ImageView를 원하는 경우), ArrayAdapter 클래스를 확장하고 getView()를 재정의하여 각 항목에 대해 원하는 유형의 뷰를 반환하도록 할 수 있습니다.

SimpleCursorAdapter
데이터 소스가 Cursor인 경우에 이 어댑터를 사용합니다. SimpleCursorAdapter를 사용하는 경우, Cursor에 있는 각 행에 대하여 사용할 레이아웃을 지정해야 합니다. 또한 Cursor 의 어느 열이 레이아웃의 어느 뷰에 삽입되어야 할지도 지정해야 합니다. 예를 들어 사람 이름과 전화번호로 이루어진 목록을 생성하고자 하는 경우, 각 사람에 대해 행이 하나씩 있고 이름과 번호에 대해 열이 들어 있는 Cursor를 반환하는 쿼리를 수행하면 됩니다. 그런 다음 레이아웃에서 각 결과에 대하여 Cursor의 어느 열을 원하는지 지정하는 문자열 배열을 만들 수 있고, 각 열이 배치되어야 하는 상응하는 뷰를 지정하는 정수 배열을 만들면 됩니다.

String[] fromColumns = {ContactsContract.Data.DISPLAY_NAME,
                        ContactsContract.CommonDataKinds.Phone.NUMBER};
int[] toViews = {R.id.display_name, R.id.phone_number};

SimpleCursorAdapter를 인스턴스화하는 경우, 각 결과에 대해 사용할 레이아웃과 결과가 들어있는 Cursor, 그리고 다음의 두 배열을 전달합니다.

SimpleCursorAdapter adapter = new SimpleCursorAdapter(this,
        R.layout.person_name_and_number, cursor, fromColumns, toViews, 0);
ListView listView = getListView();
listView.setAdapter(adapter);

그러면 SimpleCursorAdapterCursor에 있는 각 행에 대한 뷰를 하나씩 생성합니다. 이때 상응하는 toViews 뷰 안에 각 fromColumns 항목을 삽입함으로써 제공된 레이아웃을 사용합니다.

누릅니다.

애플리케이션의 수명이 진행되는 동안에 어댑터가 읽는 기본 데이터를 변경하는 경우, notifyDataSetChanged()를 호출해야 합니다. 이렇게 하면 첨부된 뷰에 데이터가 변경되었으며 스스로 새로 고쳐야 한다는 사실을 알려줍니다.

클릭 이벤트 처리

AdapterView에 있는 각 항목에서의 클릭 이벤트에 응답하려면 AdapterView.OnItemClickListener 인터페이스를 구현하면 됩니다. 예:

// Create a message handling object as an anonymous class.
private OnItemClickListener mMessageClickedHandler = new OnItemClickListener() {
    public void onItemClick(AdapterView parent, View v, int position, long id) {
        // Do something in response to the click
    }
};

listView.setOnItemClickListener(mMessageClickedHandler);