ConstraintLayout으로 반응형 UI 빌드   Android Jetpack의 구성요소

제약조건이 누락되어도 컴파일 오류가 발생하지는 않지만, Layout Editor에서는 누락된 제약조건을 툴바에 오류로 표시합니다. 오류 및 기타 경고를 보려면 Show Warnings and Errors 를 클릭하세요. 제약조건이 누락되지 않도록 Layout Editor에서는 자동 연결 및 제약조건 추론 기능을 사용하여 제약조건을 자동으로 추가합니다.

ConstraintLayout을 프로젝트에 추가

프로젝트에서 ConstraintLayout를 사용하려면 다음 단계를 진행하세요.

1. settings.gradle 파일에 선언된 maven.google.com 저장소가 있는지 확인합니다.

   Groovy

       dependencyResolutionManagement {
         ...
         repositories {
             google()
         }
       )
       

   Kotlin

       dependencyResolutionManagement {
         ...
         repositories {
             google()
         }
       }
       

2. 다음 예와 같이 모듈 수준 build.gradle 파일에 종속 항목으로 라이브러리를 추가합니다. 최신 버전은 예에 표시된 버전과 다를 수 있습니다.

   Groovy

   dependencies {
       implementation "androidx.constraintlayout:constraintlayout:2.2.0-beta01"
       // To use constraintlayout in compose
       implementation "androidx.constraintlayout:constraintlayout-compose:1.1.0-beta01"
   }
   

   Kotlin

   dependencies {
       implementation("androidx.constraintlayout:constraintlayout:2.2.0-beta01")
       // To use constraintlayout in compose
       implementation("androidx.constraintlayout:constraintlayout-compose:1.1.0-beta01")
   }
   

3. 툴바 또는 동기화 알림에서 Sync Project with Gradle Files를 클릭합니다.

이제 ConstraintLayout으로 레이아웃을 빌드할 준비가 되었습니다.

레이아웃 변환

기존 레이아웃을 제약조건 레이아웃으로 변환하려면 다음 단계를 따르세요.

1. Android 스튜디오에서 레이아웃을 열고 편집기 창 맨 아래에 있는 Design 탭을 클릭합니다.
2. Component Tree 창에서 레이아웃을 마우스 오른쪽 버튼으로 클릭하고 Convert LinearLayout to ConstraintLayout을 클릭합니다.

새 레이아웃 생성

새 제약조건 레이아웃 파일을 시작하려면 다음 단계를 따르세요.

1. Project 창에서 모듈 폴더를 클릭하고 File > New > XML > Layout XML을 선택합니다.
2. 레이아웃 파일의 이름을 입력하고 Root Tag에 'androidx.constraintlayout.widget.ConstraintLayout'을 입력합니다.
3. Finish를 클릭합니다.

제약조건 추가 또는 삭제

제약조건을 추가하려면 다음 단계를 따르세요.

1. Palette 창에서 편집기로 보기를 드래그합니다.

   ConstraintLayout에 뷰를 추가하면 각 모서리에 정사각형의 크기 조절 핸들과 각 면에 원형 제약조건 핸들이 있는 경계 상자로 표시됩니다.

2. 보기를 클릭하여 선택합니다.
3. 다음 중 하나를 실행합니다.
   • 제약조건 핸들을 클릭하여 사용 가능한 앵커 포인트로 드래그합니다. 이 포인트는 다른 뷰의 가장자리, 레이아웃의 가장자리 또는 안내선일 수 있습니다. 제약 조건 핸들을 드래그하면 Layout Editor에 잠재적인 연결 앵커와 파란색 오버레이가 표시됩니다.

   • 그림 4와 같이 Attributes 창의 Layout 섹션에서 Create a connection 버튼 중 하나를 클릭합니다.

     

     그림 4. Attributes 창의 Layout 섹션을 사용하여 연결을 만들 수 있습니다.

제약조건이 생성되면 편집기에서 기본 여백을 지정하여 두 보기를 분리합니다.

제약조건을 만들 때 다음 규칙을 기억하세요.

• 모든 보기에는 가로와 세로 하나씩 두 개 이상의 제약조건이 있어야 합니다.
• 제약조건 핸들과 동일한 평면을 공유하는 앵커 포인트 간에만 제약조건을 만들 수 있습니다. 뷰의 수직 평면(왼쪽과 오른쪽)은 다른 수직 평면으로만 제한될 수 있으며, 기준은 다른 기준선으로만 제한될 수 있습니다.
• 각 제약조건 핸들은 하나의 제약조건에만 사용할 수 있지만 동일한 앵커 포인트에 여러 개의 제약조건(다른 보기에서)을 만들 수 있습니다.

다음 중 하나를 실행하여 제약조건을 삭제할 수 있습니다.

• 제약조건을 클릭하여 선택한 다음 삭제를 클릭합니다.

• 제약조건 앵커를 Control 키를 누른 상태에서 클릭 (macOS에서는 Command 키를 누른 상태에서 클릭)합니다. 그림 5와 같이 제약조건이 빨간색으로 변하여 클릭하면 삭제할 수 있다는 것을 나타냅니다.

  

  그림 5. 클릭하여 삭제할 수 있다는 것을 나타내는 빨간색 제약조건

• Attributes 창의 Layout 섹션에서 그림 6과 같이 제약조건 앵커를 클릭합니다.

  

  그림 6. 제약 조건 앵커를 클릭하여 삭제합니다.

동영상 2에 표시된 대로 보기에 반대되는 제약조건을 추가하면 제약조건 선이 스프링처럼 표시되어 반대쪽 힘을 나타냅니다. 이 효과는 보기 크기가 '고정' 또는 '콘텐츠 래핑'으로 설정되어 보기가 제약조건 사이 중앙에 배치될 때 가장 잘 나타납니다. 대신 제약조건에 맞게 보기 크기를 늘리려면 '제약조건과 일치'하도록 크기를 전환합니다. 현재 크기는 계속 유지하지만 보기가 중앙에 오지 않도록 이동하려면 제약조건 편향을 조정합니다.

다음 섹션에 설명된 대로 제약 조건을 사용하여 다양한 유형의 레이아웃 동작을 구현할 수 있습니다.

상위 요소 포지셔닝

위치 순서 지정

정렬

기준선 정렬

안내선으로 제한

경계선으로 제한

제약조건 편향 조정

보기의 양쪽에 제약조건을 추가하고 동일한 측정기준의 보기 크기가 '고정' 또는 '콘텐츠 래핑'인 경우 보기는 기본적으로 두 제약조건 사이의 중앙에 배치되며 편향은 50% 입니다. 동영상 3에 표시된 대로 Attributes 창에서 편향 슬라이더를 드래그하거나 보기를 드래그하여 편향을 조정할 수 있습니다.

대신 제약조건에 맞게 보기의 크기를 늘리려면 '제약조건과 일치'하도록 크기를 전환합니다.

보기 크기 조정

모서리 핸들을 사용하여 뷰의 크기를 조정할 수 있지만, 그러면 크기가 하드 코딩되어 뷰가 다른 콘텐츠나 화면 크기에 맞게 조정되지 않습니다. 다른 크기 조정 모드를 선택하려면 보기를 클릭하고 편집기의 오른쪽에 있는 Attributes 창을 엽니다.

Attributes 창 상단 근처에는 뷰 검사기가 있습니다. 이 검사기에는 그림 14와 같이 여러 레이아웃 속성의 컨트롤이 포함되어 있습니다. 이는 제약 조건 레이아웃의 뷰에만 사용할 수 있습니다.

그림 14에서 번호 3으로 표시된 기호를 클릭하여 높이와 너비를 계산하는 방법을 변경할 수 있습니다. 이 기호는 다음과 같이 크기 모드를 나타냅니다. 기호를 클릭하여 다음 설정 간에 전환합니다.

• 고정: 다음 텍스트 상자에서 특정 측정기준을 지정하거나 편집기에서 보기의 크기를 조정합니다.
• 콘텐츠 래핑: 뷰가 콘텐츠에 맞게 필요한 만큼만 확장됩니다.
• layout_constrainedWidth

제약 조건을 준수하도록 가로 크기가 변경되도록 하려면 이 값을 true로 설정합니다. 기본적으로 WRAP_CONTENT로 설정된 위젯은 제약 조건에 의해 제한되지 않습니다.

• 제약조건과 일치: 보기가 양쪽의 제약조건에 맞게 최대한 많이 확장됩니다(보기의 여백을 고려한 후). 그러나 다음 속성과 값을 사용하여 동작을 수정할 수 있습니다. 다음 속성은 보기 너비를 '제약조건과 일치'로 설정한 경우에만 적용됩니다.
  • layout_constraintWidth_min

    보기의 최소 너비에 dp 측정기준을 사용합니다.

  • layout_constraintWidth_max

    보기의 최대 너비에 dp 측정기준을 사용합니다.

  그러나 지정된 측정기준에 제약조건이 하나만 있으면 보기는 콘텐츠에 맞게 확장됩니다. 높이 또는 너비에서 이 모드를 사용하면 크기 비율을 설정할 수도 있습니다.

크기를 비율로 설정

보기 크기 중 하나 이상이 '제약조건과 일치' (0dp)로 설정된 경우 보기 크기를 16:9와 같은 비율로 설정할 수 있습니다. 비율을 사용 설정하려면 가로세로 비율 제약조건 전환 (그림 14의 콜아웃 1)을 클릭하고 표시되는 입력란에 width:height 비율을 입력합니다.

너비와 높이가 모두 '제약조건과 일치'로 설정되면 Toggle Aspect Ratio Constraint를 클릭하여 다른 측정기준의 비율을 기반으로 할 측정기준을 선택할 수 있습니다. 뷰 검사기는 상응하는 가장자리를 실선으로 연결하여 비율로 설정된 크기를 나타냅니다.

예를 들어 양쪽을 '제약조건과 일치'하도록 설정하는 경우 Toggle Aspect Ratio Constraint를 두 번 클릭하여 너비가 높이 비율이 되도록 설정합니다. 전체 크기는 그림 15와 같이 임의 방식으로 정의할 수 있는 뷰의 높이에 따라 결정됩니다.

보기 여백 조정

뷰의 간격을 균일하게 만들려면 툴바에서 Margin 을 클릭하여 레이아웃에 추가하는 각 뷰의 기본 여백을 선택합니다. 기본 여백을 변경하면 이후에 추가하는 보기에만 적용됩니다.

각 제약조건을 나타내는 선에서 번호를 클릭하여 Attributes 창에서 각 보기의 여백을 제어할 수 있습니다. 그림 14의 4번은 맨 아래 여백이 16dp로 설정되었음을 보여줍니다.

그림 16. 툴바의 Margin 버튼입니다.

이 도구에서는 모든 여백이 8dp의 배수로 표시되어 보기를 머티리얼 디자인의 8dp 정사각형 그리드 추천에 맞게 정렬하는 데 도움이 됩니다.

체인이 있는 선형 그룹 제어

체인은 양방향 위치 제약 조건을 통해 서로 연결된 보기 그룹입니다. 체인의 뷰는 세로 또는 가로로 분산될 수 있습니다.

체인 스타일은 다음 방법 중 하나로 지정할 수 있습니다.

1. 넓히기: 여백을 고려한 후 보기가 균등하게 분산됩니다. 이는 기본값입니다.
2. 내부에서 넓히기: 첫 번째 보기와 마지막 보기는 체인의 각 끝에 있는 제약조건에 고정되고 나머지 보기는 균등하게 분산됩니다.
3. 가중치: 체인이 펼치기 또는 안쪽으로 펼치기로 설정된 경우 하나 이상의 뷰를 '제약 조건에 맞추기' (0dp)로 설정하여 남은 공간을 채울 수 있습니다. 기본적으로 공간은 '제약 조건에 맞추기'로 설정된 각 뷰 간에 균등하게 분산되지만 layout_constraintHorizontal_weight 및 layout_constraintVertical_weight 속성을 사용하여 각 뷰에 중요도 가중치를 할당할 수 있습니다. 이는 선형 레이아웃에서 layout_weight와 동일한 방식으로 작동합니다. 가중치 값이 가장 높은 뷰에 가장 많은 공간이 할당되고 가중치가 동일한 뷰에는 동일한 크기의 공간이 할당됩니다.
4. 패킹됨: 여백을 고려한 후 보기가 함께 배치됩니다. 체인의 '헤드' 보기 편향을 변경하여 전체 체인의 편향(좌우 또는 상하)을 조정할 수 있습니다.

체인의 '헤드' 보기(가로 체인에서는 맨 왼쪽에 있는 보기이고, 세로 체인에서는 맨 위에 있는 보기)를 통해 XML에 체인의 스타일을 정의합니다. 그러나 체인에서 보기를 선택한 다음 보기 아래에 표시되는 체인 버튼 을 클릭하여 넓히기, 내부에서 넓히기, 채우기 간에 전환할 수 있습니다.

체인을 만들려면 동영상 4와 같이 다음 단계를 따르세요.

1. 체인에 포함할 뷰를 모두 선택합니다.
2. 뷰 중 하나를 마우스 오른쪽 버튼으로 클릭합니다.
3. 체인을 선택합니다.
4. Center Horizontally 또는 Center Vertically를 선택합니다.

다음은 체인을 사용할 때 고려해야 할 사항입니다.

• 뷰는 가로 및 세로 체인의 일부가 될 수 있으므로 유연한 그리드 레이아웃을 만들 수 있습니다.
• 그림 14와 같이 체인의 각 끝이 같은 축의 다른 개체로 제한된 경우에만 체인이 제대로 작동합니다.
• 체인의 방향이 세로 또는 가로이지만 체인을 사용해도 보기가 해당 방향으로 정렬되지 않습니다. 체인에 있는 각 뷰의 적절한 위치를 얻으려면 정렬 제약조건과 같은 다른 제약조건을 포함합니다.

자동으로 제약조건 만들기

레이아웃에 배치할 때 모든 보기에 제약조건을 추가하는 대신 Layout Editor에서 각 보기를 원하는 위치로 이동한 다음 Infer Constraints 를 클릭하여 자동으로 제약조건을 만듭니다.

Infer Constraints는 레이아웃을 검사하여 모든 뷰에 가장 효과적인 제약 조건 집합을 결정합니다. 뷰를 현재 위치로 제한하면서 유연성을 제공합니다. 다른 화면 크기와 방향에도 레이아웃이 제대로 반응하도록 조정해야 할 수도 있습니다.

Autoconnect to Parent는 개별적으로 사용할 수 있는 기능입니다. 이 기능을 사용 설정하고 상위 요소에 하위 뷰를 추가하면 레이아웃에 뷰를 추가할 때 뷰마다 제약 조건이 두 개 이상 자동으로 생성됩니다. 단, 뷰를 상위 레이아웃으로 제한하는 것이 적합한 경우에만 생성됩니다. 자동 연결은 레이아웃에 있는 다른 뷰에 대한 제약 조건을 생성하지 않습니다.

자동 연결은 기본적으로 사용되지 않습니다. Layout Editor 툴바에서 Enable Autoconnection to Parent 를 클릭하여 사용 설정합니다.

키프레임 애니메이션

ConstraintLayout 내에서 ConstraintSet 및 TransitionManager를 사용하여 요소의 크기 및 위치 변경사항을 애니메이션으로 표시할 수 있습니다.

ConstraintSet은 ConstraintLayout 내 모든 하위 요소의 제약 조건, 여백, 패딩을 나타내는 경량 객체입니다. ConstraintSet를 표시된 ConstraintLayout에 적용하면 레이아웃에서 모든 하위 요소의 제약조건을 업데이트합니다.

ConstraintSet를 사용하여 애니메이션을 빌드하려면 애니메이션의 시작 및 종료 키프레임 역할을 할 두 개의 레이아웃 파일을 지정합니다. 그런 다음 두 번째 키프레임 파일에서 ConstraintSet를 로드하고 표시된 ConstraintLayout에 적용할 수 있습니다.

다음 코드 예에서는 단일 버튼을 화면 하단으로 이동하는 애니메이션을 만드는 방법을 보여줍니다.

// MainActivity.kt

fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.keyframe_one)
    constraintLayout = findViewById(R.id.constraint_layout) // member variable
}

fun animateToKeyframeTwo() {
    val constraintSet = ConstraintSet()
    constraintSet.load(this, R.layout.keyframe_two)
    TransitionManager.beginDelayedTransition()
    constraintSet.applyTo(constraintLayout)
}

// layout/keyframe1.xml
// Keyframe 1 contains the starting position for all elements in the animation
// as well as final colors and text sizes.

<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <Button
        android:id="@+id/button2"
        android:layout_width="0dp"
        android:layout_height="wrap_content"
        android:text="Button"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintTop_toTopOf="parent" />
</androidx.constraintlayout.widget.ConstraintLayout>

// layout/keyframe2.xml
// Keyframe 2 contains another ConstraintLayout with the final positions.

<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <Button
        android:id="@+id/button2"
        android:layout_width="0dp"
        android:layout_height="wrap_content"
        android:text="Button"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintBottom_toBottomOf="parent" />
</androidx.constraintlayout.widget.ConstraintLayout>

추가 리소스

ConstraintLayout는 Sunflower 데모 앱에서 사용됩니다.