동작 탐색과의 호환성 보장

컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

Android 10(API 수준 29)부터 Android 시스템에서 완전한 동작 기반 탐색을 지원합니다. 앱이 이 기능과 호환되도록 하기 위해 앱 개발자가 취해야 할 두 가지 조치가 있습니다.

  • 앱 콘텐츠를 가장자리까지 더 넓게 확장합니다.
  • 충돌하는 앱 동작을 처리합니다.

더 넓은 앱 콘텐츠

플로팅 탐색 메뉴를 통해 활용 가능하게 된 추가 화면 공간을 사용하려면 앱에서 몇 가지를 변경해야 합니다.

투명한 시스템 표시줄 설정

테마에서 다음과 같이 값을 설정하면 됩니다.

<!-- values-29/themes.xml: -->

    <style name="AppTheme" parent="...">
        <item name="android:navigationBarColor">@android:color/transparent</item>

        <!-- Optional, but recommended for full edge-to-edge rendering -->
        <item name="android:statusBarColor">@android:color/transparent</item>
    </style>
    
버튼이 있는 투명한 탐색 메뉴가 사용 설정되었습니다.

또는 Window.setNavigationBarColor()Window.setStatusBarColor()를 사용하여 동적으로 설정할 수도 있습니다.

기기가 동작 탐색을 사용하도록 설정하고 앱 탐색 메뉴의 배경을 투명하게 지정하면 시스템은 뒤에 있는 콘텐츠 색상을 기반으로 자동으로 핸들 색상을 업데이트합니다. 그러나 사용자가 2버튼 또는 3버튼 탐색 모드에 있을 때는 버튼의 색상이 바뀌지 않습니다. 대신 시스템은 버튼이 계속 보이도록 반투명한 배경을 적용합니다. 하지만 앱이 API 수준 29 이상을 타겟팅하는 경우에만 시스템에서 이렇게 설정이 가능합니다.

UI 공개 상태 플래그 설정

더 넓은 뷰를 레이아웃할 수 있도록 하려면 앱이 이러한 뷰를 처리할 수 있음을 시스템에 알려야 합니다. View.setSystemUiVisibility()를 사용해 다음 플래그를 설정하여 이 작업을 할 수 있습니다.

Kotlin

    view.setSystemUiVisibility(View.SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION
            or View.SYSTEM_UI_FLAG_LAYOUT_STABLE)
    

자바

    view.setSystemUiVisibility(View.SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION
            | View.SYSTEM_UI_FLAG_LAYOUT_STABLE);
    

이러한 플래그는 모두 앱이 전체 화면에, 그리고 탐색 메뉴 및 상태 표시줄이 없는 것처럼 레이아웃되어야 함을 시스템에 알립니다. 추가 전체 화면 이벤트의 경우 상태 표시줄 뒤에 그리게 해주는 SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN을 설정할 수도 있습니다.

상태 표시줄을 자동으로 처리하는 CoordinatorLayout 또는 DrawerLayout 같은 뷰 클래스를 사용한다면 SYSTEM_UI_FLAG_LAYOUT_STABLESYSTEM_UI_FLAG_LAYOUT_FULLSCREEN 플래그가 이미 설정되었을 수 있습니다. 또한 setSystemUiVisibility()를 사용하여 SYSTEM_UI_FLAG_IMMERSIVE 같은 다른 플래그를 설정한다면 이러한 다른 플래그가 위에 언급한 플래그를 덮어쓰지 않도록 주의해야 합니다.

앱에서 더 넓은 뷰를 사용하더라도 시스템은 여전히 WindowInsets API를 사용하여 시스템 표시줄 위치를 나타냅니다.

수동으로 인셋 사용

앱에서 맞춤 뷰 계층 구조를 사용하면 수동으로 시스템 창 인셋을 사용해야 할 수 있습니다. 그렇게 하려면 일반적으로 다음과 같이 OnApplyWindowInsetsListener 인터페이스를 구현합니다.

Kotlin

    view.setOnApplyWindowInsetsListener() {v, insets ->
        insets.consumeSystemWindowInsets()
    

자바

    view.setOnApplyWindowInsetsListener(new View.OnApplyWindowInsetsListener() {
        @Override
        public WindowInsets onApplyWindowInsets(View v, WindowInsets insets) {
            // 1. Move views on top edge down by insets.getSystemWindowInsetTop()
            // 2. Move views on bottom edge up by insets.getSystemWindowInsetBottom()
            // 3. Also check getSystemWindowInsetLeft/Right(), such as for landscape
            // orientations
            return insets.consumeSystemWindowInsets();
        }
    });
    

WindowInsetsgetSystemWindowInsets()를 통해 모든 시스템 표시줄의 일반적인 시각적 인셋을 제공합니다. 또한 Android 10은 WindowInsets에 다음 메서드를 추가합니다.

충돌하는 앱 동작 처리

동작 탐색 모델은 앱 개발자가 이전에 사용했던 동작과 충돌할 수 있습니다. 그러면 앱 사용자 인터페이스도 조정해야 할 수 있습니다.

뒤로 동작과 충돌

'뒤로'의 새로운 시스템 동작은 화면 왼쪽 또는 오른쪽 가장자리에서 안쪽으로 스와이프하는 것입니다. 이 동작이 해당 영역의 앱 탐색 요소를 방해할 수 있습니다. 화면 왼쪽 및 오른쪽 가장자리에 있는 요소의 기능을 유지하려면 터치 입력을 수신해야 하는 영역을 시스템에 표시하여 선택적으로 뒤로 동작을 선택 해제해야 합니다. 이렇게 하려면 Android 10에서 도입된 View.setSystemGestureExclusionRects() API에 List<Rect>를 전달하면 됩니다. 이 메서드는 androidx.core:core:1.1.0-dev01부터 ViewCompat에서도 사용할 수 있습니다.

예를 들면 다음과 같습니다.

Kotlin

    var exclusionRects = listOf(rect1, rect2, rect3)

    fun onLayout(
            changedCanvas: Boolean, left: Int, top: Int, right: Int, bottom: Int) {
      // Update rect bounds and the exclusionRects list
      setSystemGestureExclusionRects(exclusionRects)
    }

    fun onDraw(canvas: Canvas) {
      // Update rect bounds and the exclusionRects list
      setSystemGestureExclusionRects(exclusionRects)
    }
    

자바

    List<Rect> exclusionRects;

    public void onLayout(
            boolean changedCanvas, int left, int top, int right, int bottom) {
        // Update rect bounds and the exclusionRects list
        setSystemGestureExclusionRects(exclusionRects);
    }

    public void onDraw(Canvas canvas) {
        // Update rect bounds and the exclusionRects list
        setSystemGestureExclusionRects(exclusionRects);
    }
    

홈/퀵 스위치 동작과 충돌

홈/퀵 스위치를 위한 새로운 시스템 동작은 모두 이전에 탐색 메뉴에서 사용했던 공간의 화면 하단에서 스와이프하는 동작을 포함합니다. 뒤로 동작과는 달리 앱에서는 이러한 동작을 선택 해제할 수 없습니다.

이 문제를 완화하기 위해 Android 10에서는 터치 인식 임곗값을 앱에 알려주는 WindowInsets.getMandatorySystemGestureInsets() API가 도입되었습니다.

게임 및 뷰가 없는 기타 앱

뷰 계층 구조가 없는 기타 앱 및 게임에서는 사용자가 시스템 동작 영역 근처에서 스와이프해야 하는 경우가 많습니다. 이 경우에 게임은 Window.setSystemGestureExclusionRects()를 사용하여 시스템 동작에 예약된 영역과 중첩되는 영역을 제외할 수 있습니다. 게임이 필요한 경우에만(예: 게임플레이 도중) 이러한 영역을 제외하도록 해야 합니다.

게임에서 사용자가 홈 동작 영역 근처에서 스와이프해야 한다면 앱은 몰입형 모드에서 레이아웃되도록 요청할 수 있습니다. 이렇게 하면 사용자가 게임과 상호작용하는 동안 시스템 동작이 사용 중지되지만, 사용자는 화면 하단에서 스와이프하여 시스템 동작을 다시 사용 설정할 수 있습니다.

추가 리소스

동작 탐색에 관해 자세히 알아보려면 다음 추가 리소스를 확인하세요.

블로그 게시물

동영상