맞춤 뷰 구성요소 만들기

Compose 방법 사용해 보기
Jetpack Compose는 Android에 권장되는 UI 도구 키트입니다. Compose에서 레이아웃을 사용하는 방법을 알아보세요.

Android는 기본 레이아웃 클래스 ViewViewGroup를 기반으로 UI를 빌드하기 위한 정교하고 강력한 구성요소화된 모델을 제공합니다. 플랫폼에는 UI를 구성하는 데 사용할 수 있는 다양한 사전 빌드된 ViewViewGroup 서브클래스(각각 위젯과 레이아웃이라고 함)가 포함되어 있습니다.

사용 가능한 위젯의 일부 목록에는 Button, TextView, EditText, ListView, CheckBox, RadioButton, Gallery, Spinner 및 기타 특수 목적의 AutoCompleteTextView, ImageSwitcher, TextSwitcher가 포함됩니다.

사용 가능한 레이아웃에는 LinearLayout, FrameLayout, RelativeLayout 등이 있습니다. 더 많은 예는 일반 레이아웃을 참고하세요.

사전 빌드된 위젯이나 레이아웃이 요구사항을 충족하지 않으면 자체 View 서브클래스를 만들 수 있습니다. 기존 위젯이나 레이아웃을 약간만 조정해야 하는 경우 위젯 또는 레이아웃을 서브클래스로 만들고 그 메서드를 재정의할 수 있습니다.

자체 View 서브클래스를 만들면 화면 요소의 모양과 기능을 정밀하게 제어할 수 있습니다. 다음은 맞춤 뷰로 할 수 있는 컨트롤의 몇 가지 예입니다.

  • 완전히 맞춤 렌더링된 View 유형을 만들 수 있습니다. 예를 들어 아날로그 전자 컨트롤과 비슷한 2D 그래픽을 사용하여 렌더링된 '볼륨 조절' 노브를 만들 수 있습니다.
  • View 구성요소 그룹을 새로운 단일 구성요소로 결합하여 콤보 상자 (팝업 목록과 무료 입력 텍스트 필드의 조합), 이중 창 선택기 컨트롤 (어떤 항목이 어떤 목록에 있는지 재할당할 수 있는 각각의 목록이 있는 왼쪽 및 오른쪽 창) 등을 만들 수 있습니다.
  • EditText 구성요소가 화면에서 렌더링되는 방식을 재정의할 수 있습니다. NotePad 샘플 앱에서는 이 기능을 사용하여 줄이 있는 메모장 페이지를 만듭니다.
  • 키 누름과 같은 다른 이벤트를 캡처하여 게임과 같은 맞춤 방식으로 처리할 수 있습니다.

다음 섹션에서는 맞춤 뷰를 만들고 애플리케이션에서 사용하는 방법을 설명합니다. 자세한 참조 정보는 View 클래스를 참고하세요.

기본 접근 방식

다음은 자체 View 구성요소를 만들기 위해 알아야 하는 사항에 관한 대략적인 개요입니다.

  1. 자체 클래스로 기존 View 클래스 또는 서브클래스를 확장합니다.
  2. 슈퍼클래스에서 일부 메서드를 재정의합니다. 재정의할 슈퍼클래스 메서드는 on로 시작합니다(예: onDraw(), onMeasure()onKeyDown()). 이는 수명 주기 및 기타 기능 후크에 대해 재정의하는 Activity 또는 ListActivityon 이벤트와 유사합니다.
  3. 새 확장 클래스를 사용합니다. 완료되면 기반이 된 뷰 대신 새 확장 클래스를 사용할 수 있습니다.

완전히 맞춤설정된 구성요소

원하는 대로 표시되는 완전히 맞춤설정된 그래픽 구성요소를 만들 수 있습니다. 오래된 아날로그 게이지처럼 보이는 그래픽 VU 미터나 노래방 기계를 따라 노래를 부를 때 튀는 공이 단어를 따라 움직이는 텍스트 뷰를 원할 수 있습니다. 결합 방법에 관계없이 내장 구성요소가 할 수 없는 작업을 원할 수도 있습니다.

다행히 원하는 모양과 동작의 구성요소를 만들 수 있습니다. 이때 애플리케이션은 데스크톱 워크스테이션보다 성능이 훨씬 낮은 기기에서 실행되어야 할 수도 있다는 점을 염두에 두고 상상력, 화면 크기, 사용 가능한 처리 능력에 의해서만 제한됩니다.

완전히 맞춤설정된 구성요소를 만들려면 다음 사항을 고려하세요.

  • 확장할 수 있는 가장 일반적인 뷰는 View이므로 일반적으로 이를 확장하여 새로운 슈퍼 구성요소를 만듭니다.
  • XML에서 속성과 매개변수를 가져올 수 있는 생성자를 제공할 수 있으며 VU 미터의 색상과 범위 또는 바늘의 너비와 댐핑과 같은 고유한 속성과 매개변수를 사용할 수 있습니다.
  • 구성요소 클래스에서 보다 정교한 동작뿐만 아니라 자체 이벤트 리스너, 속성 접근자, 수정자를 만들고자 할 수 있습니다.
  • 대부분의 경우 onMeasure()를 재정의해야 하며 구성요소에 무언가를 표시하려면 onDraw()를 재정의해야 할 수도 있습니다. 둘 다 기본 동작이 있지만 기본 onDraw()는 아무 작업도 하지 않으며 기본 onMeasure()는 항상 100x100 크기로 설정합니다. 이는 바람직하지 않습니다.
  • 필요에 따라 다른 on 메서드를 재정의할 수도 있습니다.

onDraw() 및 onMeasure() 확장

onDraw() 메서드는 2D 그래픽, 기타 표준 또는 맞춤 구성요소, 스타일이 지정된 텍스트, 기타 원하는 모든 것을 구현할 수 있는 Canvas를 제공합니다.

onMeasure()는 좀 더 복잡합니다. onMeasure()는 구성요소와 컨테이너 간 렌더링 계약의 중요한 부분입니다. 포함된 부분의 측정값을 효율적이고 정확하게 보고하려면 onMeasure()를 재정의해야 합니다. 이는 상위 요소의 제한 요구사항(onMeasure() 메서드로 전달됨)과 계산된 후 측정된 너비 및 높이로 setMeasuredDimension() 메서드를 호출해야 한다는 요구사항으로 인해 약간 더 복잡해집니다. 재정의된 onMeasure() 메서드에서 이 메서드를 호출하지 않으면 측정 시간에 예외가 발생합니다.

개략적으로 onMeasure()의 구현은 다음과 같습니다.

  • 재정의된 onMeasure() 메서드는 너비와 높이 측정치를 제한하기 위한 요구사항으로 처리되는 너비 및 높이 사양과 함께 호출됩니다. widthMeasureSpecheightMeasureSpec 매개변수는 모두 치수를 나타내는 정수 코드입니다. 이러한 사양에서 요구할 수 있는 종류의 제한에 관한 전체 참조는 View.onMeasure(int, int)의 참조 문서에서 확인할 수 있습니다. 이 참조 문서에서는 전체 측정 작업도 설명합니다.
  • 구성요소의 onMeasure() 메서드는 구성요소를 렌더링하는 데 필요한 측정 너비와 높이를 계산합니다. 전달된 사양을 초과할 수는 있지만 그 범위를 벗어나지 않도록 해야 합니다. 이 경우 상위 요소는 다른 측정 사양을 사용하여 클리핑, 스크롤, 예외 발생, onMeasure()에 다시 시도 요청 등 실행할 작업을 선택할 수 있습니다.
  • 너비와 높이를 계산할 때 계산된 측정값으로 setMeasuredDimension(int width, int height) 메서드를 호출합니다. 이렇게 하지 않으면 예외가 발생합니다.

다음은 프레임워크가 뷰에서 호출하는 다른 표준 메서드를 요약한 것입니다.

카테고리 메서드 설명
생성 생성자 코드에서 뷰를 만들 때 호출되는 생성자의 양식과 레이아웃 파일에서 뷰가 확장될 때 호출되는 양식이 있습니다. 두 번째 형식은 레이아웃 파일에 정의된 속성을 파싱하고 적용합니다.
onFinishInflate() 뷰 및 모든 자식이 XML에서 팽창된 후에 호출됩니다.
레이아웃 onMeasure(int, int) 이 뷰와 그 하위의 모든 하위 요소의 크기 요구사항을 결정하기 위해 호출됩니다.
onLayout(boolean, int, int, int, int) 뷰가 모든 하위에 크기와 위치를 할당해야 할 때 호출됩니다.
onSizeChanged(int, int, int, int) 이 뷰의 크기가 변경될 때 호출됩니다.
그리기 onDraw(Canvas) 뷰가 콘텐츠를 렌더링해야 할 때 호출됩니다.
이벤트 처리 onKeyDown(int, KeyEvent) 키 다운 이벤트가 발생할 때 호출됩니다.
onKeyUp(int, KeyEvent) 주요 이벤트가 발생할 때 호출됩니다.
onTrackballEvent(MotionEvent) 트랙볼 모션 이벤트가 발생할 때 호출됩니다.
onTouchEvent(MotionEvent) 터치스크린 모션 이벤트가 발생할 때 호출됩니다.
초점 onFocusChanged(boolean, int, Rect) 뷰가 포커스를 얻거나 잃을 때 호출됩니다.
onWindowFocusChanged(boolean) 뷰가 포함된 창이 포커스를 얻거나 잃을 때 호출됩니다.
연결 onAttachedToWindow() 뷰가 창에 연결될 때 호출됩니다.
onDetachedFromWindow() 뷰가 창에서 분리될 때 호출됩니다.
onWindowVisibilityChanged(int) 뷰가 포함된 창의 공개 상태가 변경될 때 호출됩니다.

복합 컨트롤

완전히 맞춤설정된 구성요소를 만들지 않고 기존 컨트롤 그룹으로 구성된 재사용 가능한 구성요소를 함께 만들려는 경우 복합 구성요소 (또는 복합 컨트롤)를 만드는 것이 가장 좋을 수 있습니다. 요약하면 여러 가지 더 원자적인 컨트롤이나 뷰를 단일 항목으로 취급할 수 있는 논리적 항목 그룹으로 모읍니다. 예를 들어 콤보 상자는 한 줄로 된 EditText 필드와 팝업 목록이 첨부된 인접한 버튼의 조합일 수 있습니다. 사용자가 버튼을 탭하고 목록에서 항목을 선택하면 EditText 필드가 채워지지만 원하는 경우 EditText에 직접 입력할 수도 있습니다.

Android에서는 이 작업을 쉽게 실행할 수 있는 두 가지 뷰, 즉 SpinnerAutoCompleteTextView가 있습니다. 그럼에도 불구하고 콤보 상자에 대한 이 개념이 좋은 예입니다.

복합 구성요소를 만들려면 다음 단계를 따르세요.

  • Activity와 마찬가지로 선언적 (XML 기반) 접근 방식을 사용하여 포함된 구성요소를 만들거나 코드에서 프로그래매틱 방식으로 구성요소를 중첩합니다. 일반적인 시작점은 일종의 Layout이므로 Layout를 확장하는 클래스를 만듭니다. 콤보 상자의 경우 가로 방향의 LinearLayout를 사용할 수 있습니다. 내부에 다른 레이아웃을 중첩할 수 있으므로 복합 구성요소를 임의로 복잡하고 구조화할 수 있습니다.
  • 새 클래스의 생성자에서 슈퍼클래스가 예상하는 매개변수를 가져와서 먼저 슈퍼클래스 생성자에 전달합니다. 그런 다음 새 구성요소 내에서 사용할 다른 뷰를 설정할 수 있습니다. 여기에서 EditText 필드와 팝업 목록을 만듭니다. 생성자가 가져와서 사용할 수 있는 XML에 고유한 속성과 매개변수를 도입할 수 있습니다.
  • 필요한 경우 포함된 뷰에서 생성할 수 있는 이벤트의 리스너를 만듭니다. 예를 들어 목록이 선택되면 EditText의 콘텐츠를 업데이트하기 위해 목록 항목 클릭 리스너의 리스너 메서드가 있습니다.
  • 원하는 경우 접근자 및 수정자로 자체 속성을 만듭니다. 예를 들어 구성요소 초기에 EditText 값을 설정하고 필요할 때 콘텐츠를 쿼리하도록 합니다.
  • 필요한 경우 onDraw()onMeasure()를 재정의합니다. 레이아웃에는 정상적으로 작동하는 기본 동작이 있기 때문에 일반적으로 Layout를 확장할 때는 필요하지 않습니다.
  • 필요한 경우 특정 키를 탭할 때 콤보 상자의 팝업 목록에서 특정 기본값을 선택하는 등 onKeyDown()와 같은 다른 on 메서드를 재정의합니다.

Layout를 맞춤 컨트롤의 기반으로 사용하면 다음과 같은 이점이 있습니다.

  • 활동 화면과 마찬가지로 선언적 XML 파일을 사용하여 레이아웃을 지정하거나 프로그래매틱 방식으로 뷰를 만들어 코드에서 레이아웃에 중첩할 수 있습니다.
  • onDraw()onMeasure() 메서드와 기타 대부분의 on 메서드는 적절한 동작을 가지므로 재정의할 필요가 없습니다.
  • 임의로 복잡한 복합 뷰를 신속하게 생성하고 단일 구성요소인 것처럼 재사용할 수 있습니다.

기존 뷰 유형 수정

원하는 것과 유사한 구성요소가 있는 경우 그 구성요소를 확장하고 변경하려는 동작을 재정의할 수 있습니다. 완전히 맞춤설정된 구성요소로 할 수 있는 모든 작업을 할 수 있지만 View 계층 구조의 좀 더 전문화된 클래스로 시작하면 원하는 작업을 무료로 실행하는 일부 동작을 얻을 수 있습니다.

예를 들어 NotePad 샘플 앱은 Android 플랫폼 사용의 여러 측면을 보여줍니다. 그중 EditText 뷰를 확장하여 줄이 있는 메모장을 만듭니다. 이는 완벽한 예는 아니며, 이를 위한 API는 변경될 수 있지만 원리를 보여줍니다.

아직 하지 않았다면 메모장 샘플을 Android 스튜디오로 가져오거나 제공된 링크를 사용하여 소스를 살펴보세요. 특히 NoteEditor.java 파일에서 LinedEditText의 정의를 참고하세요.

다음은 이 파일에서 참고할 사항입니다.

  1. 정의

    클래스는 다음 행으로 정의됩니다.
    public static class LinedEditText extends EditText

    LinedEditTextNoteEditor 활동 내에서 내부 클래스로 정의되지만 NoteEditor 클래스 외부에서 NoteEditor.LinedEditText로 액세스할 수 있도록 공개되어 있습니다.

    또한 LinedEditTextstatic입니다. 즉, 상위 클래스의 데이터에 액세스하도록 허용하는 '합성 메서드'를 생성하지 않습니다. 즉, NoteEditor와 밀접하게 관련된 클래스가 아닌 별도의 클래스로 동작합니다. 이 방법은 외부 클래스에서 상태에 액세스할 필요가 없는 경우 내부 클래스를 만드는 더 깔끔한 방법입니다. 생성된 클래스를 작게 유지하고 다른 클래스에서 쉽게 사용할 수 있도록 합니다.

    LinedEditText는 이 경우에 맞춤설정할 뷰인 EditText를 확장합니다. 완료되면 새 클래스가 일반 EditText 뷰를 대체할 수 있습니다.

  2. 클래스 초기화

    항상 그렇듯이 슈퍼클래스가 먼저 호출됩니다. 이는 기본 생성자는 아니지만 매개변수화된 생성자입니다. EditText는 XML 레이아웃 파일에서 확장될 때 이러한 매개변수로 생성됩니다. 따라서 생성자는 이를 가져와서 슈퍼클래스 생성자에도 전달해야 합니다.

  3. 재정의된 메서드

    이 예에서는 onDraw() 메서드만 재정의하지만 맞춤 구성요소를 직접 만들 때 다른 메서드를 재정의해야 할 수도 있습니다.

    이 샘플의 경우 onDraw() 메서드를 재정의하면 EditText 뷰 캔버스의 파란색 선을 칠할 수 있습니다. 캔버스가 재정의된 onDraw() 메서드로 전달됩니다. super.onDraw() 메서드는 메서드가 종료되기 전에 호출됩니다. 슈퍼클래스 메서드를 호출해야 합니다. 이 경우 포함할 선을 그린 후 끝에서 호출하세요.

  4. 맞춤 구성요소

    이제 맞춤 구성요소가 생겼는데 어떻게 사용할 수 있을까요? 메모장 예에서는 맞춤 구성요소가 선언적 레이아웃에서 직접 사용되므로 res/layout 폴더의 note_editor.xml를 살펴보세요.

    <view xmlns:android="http://schemas.android.com/apk/res/android"
        class="com.example.android.notepad.NoteEditor$LinedEditText"
        android:id="@+id/note"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:background="@android:color/transparent"
        android:padding="5dp"
        android:scrollbars="vertical"
        android:fadingEdge="vertical"
        android:gravity="top"
        android:textSize="22sp"
        android:capitalize="sentences"
    />
    

    맞춤 구성요소는 XML의 일반 뷰로 생성되며, 클래스는 전체 패키지를 사용하여 지정됩니다. 정의한 내부 클래스는 자바 프로그래밍 언어에서 내부 클래스를 참조하는 표준 방법인 NoteEditor$LinedEditText 표기법을 사용하여 참조됩니다.

    맞춤 뷰 구성요소가 내부 클래스로 정의되지 않은 경우 XML 요소 이름으로 뷰 구성요소를 선언하고 class 속성을 제외할 수 있습니다. 예를 들면 다음과 같습니다.

    <com.example.android.notepad.LinedEditText
      id="@+id/note"
      ... />
    

    LinedEditText 클래스는 이제 별도의 클래스 파일입니다. 클래스가 NoteEditor 클래스에 중첩되어 있으면 이 기법이 작동하지 않습니다.

    정의에 있는 다른 속성과 매개변수는 맞춤 구성요소 생성자로 전달된 후 EditText 생성자로 전달되므로 EditText 뷰에 사용하는 매개변수와 동일합니다. 자체 매개변수를 추가할 수도 있습니다.

필요에 따라 복잡한 맞춤 구성요소를 만들 수도 있습니다.

더 정교한 구성요소는 더 많은 on 메서드를 재정의하고 자체 도우미 메서드를 도입하여 속성과 동작을 크게 맞춤설정할 수 있습니다. 유일한 한계는 상상력과 구성요소로 무엇을 해야 할지도 상상할 수 있습니다.