Thiết lập tính năng Xem trước thao tác quay lại

Theo mặc định, tính năng xem trước thao tác quay lại và ảnh động hệ thống sẽ được bật. Nếu ứng dụng của bạn chặn sự kiện quay lại và bạn chưa di chuyển sang tính năng xem trước thao tác quay lại, hãy cập nhật ứng dụng để sử dụng các API điều hướng quay lại được hỗ trợ.

Bật ảnh động mặc định của hệ thống

Ảnh động hệ thống cho thao tác quay lại trang chủ, giữa các hoạt động và tác vụ có trên các thiết bị Android 15 trở lên cho những ứng dụng đã di chuyển sang các API xử lý thao tác quay lại được hỗ trợ.

• Quay lại màn hình chính: Đưa người dùng trở lại màn hình chính.
• Nhiều hoạt động: Chuyển đổi giữa các hoạt động trong ứng dụng.
• Nhiều nhiệm vụ: Chuyển đổi giữa các nhiệm vụ.

Các ảnh động này được bật theo mặc định trên Android 15 trở lên. Trên thiết bị chạy Android 13 hoặc 14, người dùng có thể bật các tính năng này thông qua Tùy chọn cho nhà phát triển.

Để nhận ảnh động hệ thống, hãy cập nhật phần phụ thuộc AndroidX Activity lên phiên bản 1.6.0 trở lên.

Bật tính năng xem trước thao tác quay lại bằng Navigation Compose

Để sử dụng tính năng xem trước thao tác quay lại trong Navigation Compose, hãy đảm bảo rằng bạn đang dùng thư viện navigation-compose 2.8.0 trở lên.

Navigation Compose tự động làm mờ dần giữa các màn hình khi người dùng vuốt về phía sau:

Khi điều hướng, bạn có thể tạo hiệu ứng chuyển đổi tuỳ chỉnh bằng popEnterTransition và popExitTransition. Khi được áp dụng cho NavHost, các đối tượng sửa đổi này cho phép bạn xác định cách màn hình vào và thoát tạo ảnh động. Bạn có thể sử dụng các hiệu ứng này để tạo nhiều hiệu ứng, chẳng hạn như điều chỉnh tỷ lệ, làm mờ hoặc trượt.

Trong ví dụ này, scaleOut được dùng trong popExitTransition để thu nhỏ màn hình thoát khi người dùng quay lại. Ngoài ra, tham số transformOrigin xác định điểm mà quá trình điều chỉnh ảnh động theo tỷ lệ diễn ra xung quanh đó. Theo mặc định, điểm này là trung tâm của màn hình (0.5f, 0.5f). Bạn có thể chỉnh sửa giá trị này để quá trình điều chỉnh theo tỷ lệ bắt đầu từ một điểm khác.

NavHost(
    navController = navController,
    startDestination = Home,
    popExitTransition = {
        scaleOut(
            targetScale = 0.9f,
            transformOrigin = TransformOrigin(pivotFractionX = 0.5f, pivotFractionY = 0.5f)
        )
    },
    popEnterTransition = {
        EnterTransition.None
    },
    modifier = modifier,
)
PredictiveBackSnippets.kt

Mã này tạo ra kết quả sau:

Cụ thể, popEnterTransition và popExitTransition kiểm soát ảnh động khi bật ngăn xếp lui, chẳng hạn như bằng cử chỉ quay lại. Bạn cũng có thể sử dụng enterTransition và exitTransition để xác định ảnh động cho việc vào và thoát các thành phần kết hợp nói chung, không chỉ cho tính năng xem trước thao tác quay lại. Nếu bạn chỉ đặt enterTransition và exitTransition, thì các giá trị này sẽ được dùng cho cả thao tác điều hướng thông thường và thao tác bật ngăn xếp lui. Tuy nhiên, việc sử dụng popEnterTransition và popExitTransition cho phép bạn tạo ảnh động riêng biệt cho thao tác điều hướng quay lại.

Tích hợp với hiệu ứng chuyển đổi phần tử dùng chung

Hiệu ứng chuyển đổi phần tử dùng chung mang lại kết nối hình ảnh mượt mà giữa các thành phần kết hợp có nội dung dùng chung, thường được dùng để điều hướng.

Để sử dụng các thành phần dùng chung với Navigation Compose, hãy xem phần Xem trước thao tác quay lại với các thành phần dùng chung.

Hỗ trợ tính năng xem trước thao tác quay lại bằng các thành phần Material Compose

Nhiều thành phần trong thư viện Material Compose được thiết kế để hoạt động liền mạch với cử chỉ xem trước thao tác quay lại. Để bật ảnh động xem trước thao tác quay lại trong các thành phần này, hãy thêm phần phụ thuộc Material3 mới nhất (androidx.compose.material3:material3-*:1.3.0 trở lên) vào dự án của bạn.

Các thành phần Material hỗ trợ ảnh động xem trước thao tác quay lại bao gồm:

• SearchBar
• ModalBottomSheet
• ModalDrawerSheet/DismissibleDrawerSheet
• ModalNavigationDrawer/DismissibleNavigationDrawer

SearchBar và ModalBottomSheet tự động tạo ảnh động bằng cử chỉ xem trước thao tác quay lại. ModalNavigationDrawer, ModalDrawerSheet, DismissibleDrawerSheet và DismissibleNavigationDrawer yêu cầu bạn truyền drawerState đến các thành phần kết hợp nội dung trang tính tương ứng.

Kiểm thử ảnh động xem trước thao tác quay lại

Nếu vẫn dùng Android 13 hoặc Android 14, bạn có thể kiểm thử ảnh động quay lại màn hình chính.

Để kiểm tra ảnh động này, hãy làm theo các bước sau:

1. Trên thiết bị của bạn, hãy chuyển đến phần Cài đặt > Hệ thống > Tuỳ chọn cho nhà phát triển (Settings > System > Developer options).
2. Chọn Ảnh động vuốt ngược dự đoán.
3. Chạy ứng dụng đã cập nhật và dùng cử chỉ vuốt ngược để xem ứng dụng hoạt động.

Trên Android 15 trở lên, tính năng này được bật theo mặc định.

Tài nguyên khác

• Lớp học lập trình về cách thêm ảnh động xem trước thao tác quay lại
• Video về ảnh động bố cục nâng cao trong Compose