Constraintlayout

상대 위치에 따라 유연한 방식으로 위젯의 위치와 크기를 지정합니다.

이 표는 androidx.constraintlayout 그룹의 모든 아티팩트 목록을 보여줍니다.

아티팩트 현재 안정화 버전 다음 버전 후보 베타 버전 알파 버전
constraintlayout 2.1.1 - - -
constraintlayout-compose - 1.0.0-rc01 - -
이 라이브러리는 2021년 9월 27일에 최종 업데이트되었습니다.

종속 항목 선언

ConstraintLayout의 종속 항목을 추가하려면 프로젝트에 Google Maven 저장소를 추가해야 합니다. 자세한 내용은 Google Maven 저장소를 읽어보세요.

다음과 같이 앱 또는 모듈의 build.gradle 파일에 필요한 아티팩트의 종속 항목을 추가합니다.

Groovy

dependencies {
    implementation "androidx.constraintlayout:constraintlayout:2.1.1"
    // To use constraintlayout in compose
    implementation "androidx.constraintlayout:constraintlayout-compose:1.0.0-rc01"
}

Kotlin

dependencies {
    implementation("androidx.constraintlayout:constraintlayout:2.1.1")
}

종속 항목에 관한 자세한 내용은 빌드 종속 항목 추가를 참고하세요.

의견

제출하신 의견은 Jetpack을 개선하는 데 도움이 됩니다. 새로운 문제를 발견하거나 라이브러리 개선을 위한 아이디어가 있다면 Google에 알려 주세요. 새 의견을 제출하기 전에 이 라이브러리의 기존 문제를 살펴보시기 바랍니다. 별표 버튼을 클릭하여 기존 문제에 투표할 수 있습니다.

새 문제 만들기

자세한 내용은 Issue Tracker 문서를 참고하세요.

ConstraintLayout-compose 1.0

ConstraintLayout-compose 1.0은 Jetpack Compose에서 ConstraintLayout 기능을 제공합니다.

버전 1.0.0-rc01

2021년 9월 27일

androidx.constraintlayout:constraintlayout-compose:1.0.0-rc01이 출시되었습니다.

이 버전은 두 번째 베타 버전입니다. 이 버전은 기능이 완전한 것으로 간주되며 Compose에 ConstraintLayoutMotionLayout을 제공합니다.

자세한 내용은 GitHub 도움말 1.0(Compose)의 새로운 기능을 참고하세요.

버전 1.0.0-beta02

2021년 7월 30일

androidx.constraintlayout:constraintlayout-compose:1.0.0-beta02가 출시되었습니다.

이 버전은 두 번째 베타 버전입니다. 이 버전은 기능이 완전한 것으로 간주되며 Compose에 ConstraintLayoutMotionLayout을 제공합니다.

자세한 내용은 GitHub 도움말 1.0(Compose)의 새로운 기능을 참고하세요.

버전 1.0.0-beta01

2021년 7월 22일

androidx.constraintlayout:constraintlayout-compose:1.0.0-beta01이 출시되었습니다.

이 버전은 첫 번째 베타 버전입니다. 이 버전은 기능이 완전한 것으로 간주되며 Compose에 ConstraintLayoutMotionLayout을 제공합니다.

자세한 내용은 GitHub 도움말 1.0(Compose)의 새로운 기능을 참고하세요.

버전 1.0.0-alpha07

2021년 5월 18일

androidx.constraintlayout:constraintlayout-compose:1.0.0-alpha07이 출시되었습니다.

  • Compose 버전 1.0.0-beta07과 호환되도록 업데이트되었습니다.

버전 1.0.0-alpha06

2021년 5월 4일

androidx.constraintlayout:constraintlayout-compose:1.0.0-alpha06이 출시되었습니다.

  • Compose 최적화: Constraintlayout 인라인 컴포저블(#193)
  • Compose에서 재측정 최소화(#210)

버전 1.0.0-alpha05

2021년 3월 15일

androidx.constraintlayout:constraintlayout-compose:1.0.0-alpha05가 출시되었습니다.

  • 최적화 엔진에 관한 수정사항이 포함됩니다. (b/182657720)
  • ConstraintLayout 컴포저블에 optimizationLevel 매개변수를 추가합니다.

버전 1.0.0-alpha04

2021년 3월 11일

androidx.constraintlayout:constraintlayout-compose:1.0.0-alpha04가 출시되었습니다.

최신 constraintlayout-core 엔진을 사용하는 업데이트입니다.

버전 1.0.0-alpha03

2021년 2월 24일

androidx.constraintlayout:constraintlayout-compose:1.0.0-alpha03이 출시되었습니다.

Jetpack Compose beta01 버전에 관한 버전 업데이트입니다.

버전 1.0.0-alpha02

2021년 2월 10일

androidx.constraintlayout:constraintlayout-compose:1.0.0-alpha02가 출시되었습니다.

Jetpack Compose alpha12 버전에 관한 버전 업데이트입니다.

버전 1.0.0-alpha01

2021년 2월 2일

androidx.constraintlayout:constraintlayout-compose:1.0.0-alpha01이 출시되었습니다.

라이브러리의 첫 번째 버전으로, 제약 조건을 표현하기 위해 인라인 및 외부 DSL을 제공합니다.

버전 2.1

ConstraintLayout 2.1.0에서는 MotionLayout 및 새로운 도우미(캐러셀 등)에서 더 풍부한 기능을 제공합니다.

버전 2.1.1

2021년 9월 27일

androidx.constraintlayout:constraintlayout:2.1.1이 출시되었습니다.

이 버전은 2.1.1의 최종 출시 버전입니다.

자세한 내용은 GitHub 도움말 2.1의 새로운 기능을 참고하세요.

버전 2.1.0

2021년 7월 30일

androidx.constraintlayout:constraintlayout:2.1.0이 출시되었습니다.

이 버전은 2.1.0의 최종 출시 버전입니다.

자세한 내용은 GitHub 도움말 2.1의 새로운 기능을 참고하세요.

버전 2.1.0-rc01

2021년 7월 22일

androidx.constraintlayout:constraintlayout:2.1.0-rc01이 출시되었습니다.

이 버전은 2.1.0의 출시 후보로, 지난 베타 버전의 사소한 개선사항과 수정사항을 제공합니다. 자세한 내용은 GitHub 도움말 2.1의 새로운 기능을 참고하세요.

버전 2.1.0-beta02

2021년 5월 4일

androidx.constraintlayout:constraintlayout:2.1.0-beta02가 출시되었습니다.

MotionLayout의 새로운 기능은 다음과 같습니다.

  • 스프링(강성, 감쇠, 질량 등)을 포함한 OnSwipe 개선 및 완료되지 않도록 설정
  • jumpToState 함수
  • Down을 터치하면 100으로 재생되고 Up을 터치하면 0으로 역전되는 ViewTransition downUp 모드

주요 수정사항은 다음과 같습니다.

  • MotionLayout의 세로 스크롤 문제 해결(#173)
  • 중첩된 MotionLayout의 성능 개선(#189)
  • MotionLayout에서 NestedScrollView로 빠른 전환(#189)
  • MotionLayout에서 ConstraintSet을 없앰(#189)
  • MotionLayout에서 downUp ViewTransitions 지원(#190)
  • 드로어블 재사용 시 ImageFilter 문제 해결(#192)
  • MotionLayout에서 스프링 지원 추가(#199)
  • CircularFlow 성능 개선(#200)
  • 파생 제약 조건/제약 조건 재정의 문제 해결(#212)

버전 2.1.0-beta01

2021년 3월 11일

androidx.constraintlayout:constraintlayout:2.1.0-beta01이 출시되었습니다.

ConstraintLayout

android:layout_width 및 android:layout_height는 호환성 문제로 인해 다시 선택사항에서 제외되었습니다.

MotionLayout

  • 전환 시 onSwipe와 onClick을 삽입 및 삭제하는 프로그래매틱 방식을 지원합니다.
  • 화면 회전을 통한 전환에 관한 실험용 지원을 제공합니다.
  • 전환의 시간 인수를 지원합니다.
  • 부울 또는 참조인 customAttribute 지원을 개선합니다.

도우미

  • 캐러셀의 특정 항목으로 애니메이션을 실행하여 이동하거나 바로 이동하는 방법을 추가했습니다.
  • 새로운 CircularFlow 도우미가 제공됩니다.

이 버전에 관한 자세한 정보는 여기수정된 버그를 참고하세요.

버전 2.1.0-alpha2

2020년 12월 17일

androidx.constraintlayout:constraintlayout:2.1.0-alpha2가 출시되었습니다.

이 두 번째 알파 버전에서는 여러 새로운 기능을 추가합니다.

ConstraintLayout

  • android:layout_width 및 android:layout_height가 이제 선택사항이며 기본 동작으로 wrap_content가 사용됩니다.
  • 새 layout_constraintWidth 및 layout_constraintHeight 속성이 크기 제약 조건을 표현합니다.
  • 제약 조건의 음수 여백을 지원합니다.
  • 기준선에서 상단까지, 기준선에서 하단까지 제약 조건을 지원합니다.
  • 기준선 여백 제약 조건을 지원합니다.
  • SharedValues로 외부 값을 ConstraintLayout에 삽입할 수 있습니다.

MotionLayout

  • 오버슈트 보간기를 지원합니다(anticipate, overshoot).
  • MotionHelper 지원을 개선했습니다.
  • ConstraintSet의 애니메이션 업데이트를 MotionLayout updateStateAnimate(id,cset,duration)에 추가합니다.
  • 값에 기반한 ViewTransition을 공유했습니다.
  • scheduleTransitonTo로 현재 전환이 완료될 때 실행할 전환을 대기열에 추가할 수 있습니다.

도우미

  • 캐러셀이 이제 무한(wrap-around) 모드를 지원합니다.
  • ReactiveGuide - SharedValue가 변경될 때 자동으로 배치되는 가이드라인입니다.
  • MotionEffect - 주어진 방향으로 이동하는 참조된 뷰에 Keyframe을 삽입합니다.
  • MotionLabel - 단일 줄 텍스트를 애니메이션 처리하는 View입니다.

이 버전에 관한 자세한 내용은 여기를 참고하세요.

버전 2.1.0-alpha1

2020년 11월 19일

androidx.constraintlayout:constraintlayout:2.1.0-alpha1이 출시되었습니다.

2.1 버전의 최초 알파 버전입니다. 다음 지원을 도입합니다.

  • 캐러셀 모션 도우미로 맞춤 캐러셀 뷰를 빌드합니다.
  • MotionLayout 장면이 포함 및 제약 조건 재정의를 지원합니다.
  • MotionLayout이 더 풍부한 회전 지원을 추가합니다(입력 및 출력).
  • MotionLayout이 ViewTransitions를 추가하여 constraintsets의 변형을 위한 단일 뷰 전환을 허용합니다.

이 버전에 관한 자세한 내용은 여기를 참고하세요.

버전 2.0

ConstraintLayout 2.0에는 새로운 레이아웃 기능(가상 레이아웃 등)과 뷰 애니메이션을 단순화하는 MotionLayout이라는 새로운 클래스가 추가되었습니다.

버전 2.0.4

2020년 10월 29일

androidx.constraintlayout:constraintlayout:2.0.4가 출시되었습니다.

버그 수정

이 버전에서는 런타임에 하위 뷰를 삭제할 때 발생할 수 있는 잠재적인 NPE를 수정했습니다. 이 버전으로 업데이트하는 것이 좋습니다.

종료된 문제 목록은 여기를 참고하세요.

버전 2.0.3

2020년 10월 27일

androidx.constraintlayout:constraintlayout:2.0.3이 출시되었습니다.

버그 수정

이 버전에서는 몇 가지 문제를 해결했습니다. 이 버전으로 업데이트하는 것이 좋습니다.

  • Windows 인셋 처리
  • 일부 상황에서 크기 비율 처리
  • 일부 RTL 레이아웃에서 비정상 종료

종료된 문제 목록은 여기를 참고하세요.

버전 2.0.2

2020년 10월 6일

androidx.constraintlayout:constraintlayout:2.0.2가 출시되었습니다.

버그 수정

이번 버전에서는 성능을 개선할 뿐 아니라 몇 가지 문제를 수정했습니다. 이 버전으로 업데이트하는 것이 좋습니다.

  • ConstraintLayout에서 뷰 GONE의 공개 상태 처리가 잘못되는 경우가 있었음
  • ConstraintLayout에서 내장된 체인 처리가 잘못되는 경우가 있었음
  • Flow 가상 레이아웃 도우미에 관한 API 15의 인플레이션 예외가 수정됨
  • limitationBoundsTo가 MotionLayout에서 손상됨
  • MotionLayout에서 jump to end가 손상되는 경우가 있었음(체인 전환)

종료된 문제 목록은 여기를 참고하세요.

버전 2.0.1

2020년 8월 25일

androidx.constraintlayout:constraintlayout:2.0.1이 출시되었습니다.

이번 소규모 업데이트로 Android 스튜디오에서 MotionEditor를 사용할 수 있게 되었습니다.

버전 2.0.0

2020년 8월 21일

androidx.constraintlayout:constraintlayout:2.0.0이 출시되었습니다.

버그 수정

종료된 문제 목록은 여기를 참고하세요.

주목할 만한 수정사항은 다음과 같습니다.

  • MotionLayout 전환 지연 및 TransitionListener 수정
  • ConstraintLayout 흐름 및 경계선 수정

버전 2.0.0-rc1

2020년 7월 29일

androidx.constraintlayout:constraintlayout:2.0.0-rc1이 출시되었습니다.

버그 수정

종료된 문제 목록은 여기를 참고하세요.

주목할 만한 수정사항은 다음과 같습니다.

  • 흐름 수정
  • RecyclerView 수정(recyclerview 1.2.0 alpha 5 이상으로 업데이트하는 것이 좋음).
  • MotionLayout TransitionListener 수정
  • MotionLayout 메모리 누수 수정

버전 2.0.0-beta8

2020년 7월 7일

androidx.constraintlayout:constraintlayout:2.0.0-beta8이 출시되었습니다.

버그 수정

종료된 문제 목록은 여기를 참고하세요.

주목할 만한 수정사항은 다음과 같습니다.

  • 자리표시자 동작
  • 레이어 공개 상태
  • 흐름, 경계선 수정
  • transitionListener 수정

버전 2.0.0-beta7

2020년 6월 12일

androidx.constraintlayout:constraintlayout:2.0.0-beta7이 출시되었습니다.

버그 수정

종료된 문제 목록은 여기를 참고하세요.

주목할 만한 수정사항은 다음과 같습니다.

  • MotionLayout의 중첩 스크롤 뷰 문제
  • MotionLayout의 전환 리스너 문제
  • MotionLayout의 메모리 누수
  • RecyclerView 문제
  • 그룹 공개 상태
  • 패딩 문제

버전 2.0.0-beta6

2020년 5월 13일

androidx.constraintlayout:constraintlayout:2.0.0-beta6이 출시되었습니다.

버그 수정

종료된 문제 목록은 여기를 참고하세요. 중요 수정사항은 MotionLayout의 그룹 공개 상태 처리 및 파생 제약 조건 문제입니다.

버전 2.0.0-beta5

2020년 5월 7일

androidx.constraintlayout:constraintlayout:2.0.0-beta5가 출시되었습니다.

버그 수정

종료된 문제 목록은 여기를 참고하세요.

버전 2.0.0-beta4

2019년 12월 16일

androidx.constraintlayout:constraintlayout:2.0.0-beta4가 출시되었습니다.

새로운 기능

MotionLayout

새 전환 속성:

  • layoutDuringTransition: 전환하는 동안 MotionLayout이 하위 요소의 requestLayouts 호출에 어떻게 반응할지 구성할 수 있습니다. 가능한 값은 {ignoreRequest, honorRequest}입니다.
  • pathMotionArc: 움직이는 요소의 경로에는 호가 사용됩니다. 가능한 값은 {startVertical | startHorizontal | flip | none}입니다.

이제 시작 및 끝 ConstraintSets를 생략하는 것으로 기본 전환을 정의할 수 있습니다. 현재의 시작/끝 상태와 일치하는 기존의 다른 전환을 찾을 수 없는 경우 기본 전환이 사용됩니다.

버그 수정

종료된 문제 목록은 여기를 참고하세요.