맞춤형 뒤로 탐색 기능 제공

뒤로 탐색 기능은 사용자가 이전에 방문한 화면 기록을 통해 뒤로 이동하는 기능입니다. 모든 Android 기기는 이 유형의 탐색을 위해 뒤로 버튼을 제공하므로 앱 UI에 뒤로 버튼을 추가하지 마세요. 사용자의 Android 기기에 따라 이 버튼은 물리적 버튼 또는 소프트웨어 버튼이 될 수 있습니다.

Android는 사용자가 애플리케이션을 탐색할 때 대상의 백 스택을 유지합니다. 이를 통해 Android는 뒤로 버튼을 누를 때 이전 대상으로 적절하게 이동할 수 있습니다. 하지만, 최상의 사용자 환경을 제공하기 위해 앱에서 뒤로 이동하는 동작을 자체적으로 구현해야 하는 경우도 있습니다.

예를 들어, WebView를 사용할 때는 기본 뒤로 버튼 동작을 재정의하여 사용자에게 앱의 이전 화면 대신 웹 방문 기록을 통해 뒤로 이동하도록 하는 것이 좋습니다.

Android 13 이상에는 Android 기기용 뒤로 탐색 예측 동작이 포함되어 있습니다. 이 기능에 관한 자세한 내용은 뒤로 탐색 예측 동작 지원 추가를 참고하세요.

맞춤 뒤로 탐색 구현

FragmentActivity와 AppCompatActivity의 기본 클래스인 ComponentActivity를 사용하면 OnBackPressedDispatcher(getOnBackPressedDispatcher()를 호출하여 가져옴)를 사용하여 뒤로 버튼의 동작을 제어할 수 있습니다.

OnBackPressedDispatcher는 뒤로 버튼 이벤트가 하나 이상의 OnBackPressedCallback 객체로 전달되는 방법을 제어합니다. OnBackPressedCallback의 생성자는 초기 사용 설정 상태를 나타내는 불리언 값을 사용합니다. 콜백을 사용 설정하면, 즉 isEnabled()가 true을 반환하면 디스패처는 콜백의 handleOnBackPressed()를 호출하여 뒤로 버튼 이벤트를 처리합니다. 사용 설정 상태는 setEnabled()를 호출하여 변경할 수 있습니다.

콜백은 addCallback 메서드를 사용하여 추가됩니다. LifecycleOwner를 사용하는 addCallback() 메서드를 사용하는 것이 좋습니다. 이렇게 하면 LifecycleOwner가 Lifecycle.State.STARTED일 때만 OnBackPressedCallback이 추가되도록 할 수 있습니다. 또한 활동은 연결된 LifecycleOwner가 소멸될 때 등록된 콜백을 삭제합니다. 이는 메모리 누수를 방지하며, LifecycleOwner를 전체 기간이 활동보다 짧은 프래그먼트 또는 기타 수명 주기 소유자에 사용하기 적합하도록 만듭니다.

다음은 콜백 구현 예입니다.

Kotlin

class MyFragment : Fragment() {

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)

        // This callback is only called when MyFragment is at least started
        val callback = requireActivity().onBackPressedDispatcher.addCallback(this) {
            // Handle the back button event
        }

        // The callback can be enabled or disabled here or in the lambda
    }
    ...
}

Java

public class MyFragment extends Fragment {

    @Override
    public void onCreate(@Nullable Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);

        // This callback is only called when MyFragment is at least started
        OnBackPressedCallback callback = new OnBackPressedCallback(true /* enabled by default */) {
            @Override
            public void handleOnBackPressed() {
                // Handle the back button event
            }
        };
        requireActivity().getOnBackPressedDispatcher().addCallback(this, callback);

        // The callback can be enabled or disabled here or in handleOnBackPressed()
    }
    ...
}

addCallback()을 사용하여 여러 콜백을 제공할 수 있습니다. 이렇게 하면 콜백이 추가된 순서의 역순으로 호출되며 마지막으로 추가된 콜백이 뒤로 버튼 이벤트를 처리할 기회를 처음으로 얻게 됩니다. 예를 들어 one, two, three라는 콜백 세 개를 순서대로 추가하면 three, two, one 순으로 호출됩니다.

콜백은 책임 연쇄(Chain of Responsibility) 패턴을 따릅니다. 체인의 각 콜백은 앞의 콜백이 사용 설정되지 않은 경우에만 호출됩니다. 즉, 앞의 예에서 콜백 two는 콜백 three가 사용 설정되지 않은 경우에만 호출되고 콜백 one은 콜백 two가 사용 설정되지 않은 경우에만 호출됩니다.

addCallback()을 사용하여 콜백이 추가되는 경우 LifecycleOwner가 Lifecycle.State.STARTED 상태로 전환될 때까지 책임 연쇄에 추가되지 않습니다.

임시 변경을 위해 OnBackPressedCallback의 사용 설정 상태를 변경하는 것이 좋습니다. 이렇게 하면 위에 설명한 순서가 유지됩니다. 이는 콜백이 중첩된 여러 수명 주기 소유자에 등록된 경우 특히 중요합니다.

OnBackPressedCallback을 완전히 삭제하려는 경우 remove()를 호출하면 됩니다. 콜백은 연결된 LifecycleOwner가 소멸될 때 자동으로 삭제되므로 일반적으로 필수사항은 아닙니다.

onBackPressed() 활동

onBackPressed()를 사용하여 뒤로 버튼 이벤트를 처리하고 있다면 이 메서드 대신 OnBackPressedCallback을 사용하는 것이 좋습니다. 하지만 변경이 불가능하다면 다음 규칙이 적용됩니다.

  • addCallback을 통해 등록된 모든 콜백은 super.onBackPressed()를 호출할 때 평가됩니다.
  • Android 12(API 수준 32) 이하에서는 OnBackPressedCallback의 등록된 인스턴스와 관계없이 onBackPressed가 항상 호출됩니다.