Điều hướng trong UIKit vẫn là kỹ năng phải có khi bạn bảo trì ứng dụng lâu năm, xây phần mở rộng cho hệ thống hiện có hoặc cần một container mà SwiftUI chưa thay thế hoàn toàn. Trong iOS 27.2, UINavigationController, modal presentation, tab, split view và Storyboard không biến mất; chúng chỉ không còn là lựa chọn mặc định cho một app SwiftUI mới.
Mục lục
Cập nhật 2026: UIKit không bị deprecated
- Stack hiện tại là iOS 27.2 và Xcode 27.2. UIKit vẫn là framework chính thức; đừng xóa một màn hình UIKit chỉ vì dự án đang thêm SwiftUI.
- Với app mới viết bằng SwiftUI,
NavigationStackvàNavigationSplitViewcho mô hình điều hướng khai báo, route có kiểu và state dễ khôi phục hơn. - Storyboards và segues vẫn chạy tốt trong dự án cũ, nhưng identifier dạng chuỗi và logic rải trong
prepare(for:sender:)làm việc migrate, test và deep link khó hơn. - Swift 6.4 khuyến khích concurrency rõ ràng. Mọi thao tác thay đổi UI, gồm push và present, phải quay về main actor.
Mô hình tư duy: container sở hữu luồng màn hình
Một UIViewController không nên tự xem mình là toàn bộ navigation system. Nó quản lý view, dữ liệu hiển thị và các hành động của một màn hình. Container mới quyết định màn hình nào đứng trước, màn hình nào được phủ lên và cách người dùng quay lại.
Hãy hình dung ba lớp. Hierarchical navigation là một stack: danh sách đẩy detail, detail pop để quay lại. Modal navigation là một luồng tạm thời được present trên context hiện tại; luồng đó thường tự đóng khi hoàn tất. Split hoặc tab navigation là container nhiều nhánh, trong đó mỗi nhánh có thể sở hữu navigation controller riêng.
Vì vậy, thay vì gọi ngẫu nhiên một phương thức trên view controller đang có, hãy hỏi: màn hình này thuộc stack nào, thuộc modal flow nào, và ai là owner của flow đó? Câu hỏi này ngăn được phần lớn lỗi double-push, present sai context và giữ tham chiếu vòng.
UINavigationController: push, pop và interactive pop
UINavigationController giữ mảng viewControllers. Root ở đáy stack; view controller mới được push lên đỉnh; pop lấy màn hình trên cùng ra. Người dùng có thể bấm Back hoặc vuốt từ cạnh trái nếu gesture tương tác đang được bật. Một detail không nên tự tạo navigation controller mới chỉ để push; hãy dùng container đang quản lý nó.
import UIKit
@MainActor
final class ProductListViewController: UIViewController {
func showProduct(id: UUID) {
let detail = ProductDetailViewController(productID: id)
navigationController?.pushViewController(detail, animated: true)
}
}
@MainActor
final class ProductDetailViewController: UIViewController {
private let productID: UUID
init(productID: UUID) {
self.productID = productID
super.init(nibName: nil, bundle: nil)
}
@available(*, unavailable)
required init?(coder: NSCoder) {
fatalError("Storyboard initialization is not supported")
}
func closeToRoot() {
navigationController?.popToRootViewController(animated: true)
}
}
Gán dữ liệu trước khi push giúp destination nhận được dependency hợp lệ ngay từ initializer. Nếu bạn cần pop về một màn hình cụ thể, tìm instance trong viewControllers rồi gọi popToViewController; đừng tạo một instance mới để làm đích quay về, vì state và lifecycle của instance cũ sẽ mất.
Interactive pop có thể hoàn tất hoặc bị hủy giữa animation. Đừng đặt side effect không thể đảo ngược trong lúc gesture mới bắt đầu. Nếu cần biết kết quả, dùng UINavigationControllerDelegate hoặc cập nhật state khi màn hình thật sự xuất hiện lại trong viewDidAppear. Khi một màn hình custom thay đổi interactivePopGestureRecognizer, hãy kiểm tra cả trạng thái Back button và gesture delegate để không vô tình khóa thao tác quay lại.
Modal present/dismiss: một luồng tạm thời, không phải push trá hình
Dùng modal cho login, form tạo dữ liệu, picker, xác nhận hoặc một task độc lập với màn hình đang xem. Modal có thể là một view controller đơn lẻ, nhưng một flow nhiều bước thường nên được bọc trong UINavigationController. Khi flow hoàn tất, root của modal flow gọi dismiss; không cần pop từng màn hình rồi mới đóng.
import UIKit
@MainActor
func presentSettings(from presenter: UIViewController) {
let settings = SettingsViewController()
let modal = UINavigationController(rootViewController: settings)
modal.modalPresentationStyle = .pageSheet
modal.isModalInPresentation = false
presenter.present(modal, animated: true)
}
@MainActor
final class SettingsViewController: UIViewController {
func didTapDone() {
dismiss(animated: true)
}
}
Trước khi present, đảm bảo presenter đang nằm trong window và chưa có một modal khác đang được trình bày. Nếu bạn đang ở trong một container, thường nên present từ view controller đang hiển thị hoặc từ container có trách nhiệm, không phải từ một controller đã bị remove khỏi hierarchy. Với thao tác phát sinh sau một callback async, kiểm tra lại viewIfLoaded?.window và presentedViewController trước khi gọi.
Các presentation style cần phân biệt
| Style | Khi dùng | Lưu ý |
|---|---|---|
.fullScreen |
Login bắt buộc, flow chiếm toàn bộ màn hình | Presenter có thể nhận lifecycle khác với sheet; đừng dựa vào một callback không kiểm tra. |
.pageSheet |
Form hoặc task có ngữ cảnh, hỗ trợ kéo xuống | Có thể bị interactive dismissal; dùng delegate để xác nhận dữ liệu chưa lưu. |
.formSheet |
Biểu mẫu gọn trên iPad hoặc kích thước phù hợp | Kích thước phụ thuộc trait và thiết bị, không hard-code layout theo iPhone. |
.popover |
Menu, bộ lọc, lựa chọn ngắn | Trên iPad cần cấu hình source view hoặc bar button, nếu không sẽ crash. |
Vòng đời modal dễ gây nhầm. viewDidLoad chỉ nên khởi tạo view và dependency; nó không phải nơi cập nhật mỗi lần modal quay lại. Dữ liệu cần làm mới thường xử lý trong viewWillAppear hoặc qua một event rõ ràng. Với page sheet, người dùng có thể kéo để đóng; triển khai UIAdaptivePresentationControllerDelegate để chặn dismissal khi form bẩn và hỏi xác nhận.
Tab và split: nhiều nhánh, nhiều navigation state
UITabBarController phù hợp cho các khu vực ngang hàng như Home, Search và Profile. Mỗi tab nên có navigation controller riêng nếu người dùng có thể đi sâu trong tab đó. Đừng dùng một stack chung cho tất cả tab: khi đổi tab, người dùng kỳ vọng vị trí của từng tab được giữ độc lập.
UISplitViewController dành cho layout hai hoặc nhiều cột, đặc biệt trên iPad và màn hình rộng. Hãy nghĩ nó là container điều phối primary, supplementary và secondary; đừng giả định secondary luôn tồn tại hoặc luôn hiển thị cạnh primary. Khi compact, split có thể chuyển thành một stack; deep link phải hoạt động được ở cả hai kích thước.
State của tab hoặc split cần có một nguồn sự thật. Nếu tab bar giữ selected index, coordinator giữ một index khác và view model lại giữ một index thứ ba, việc khôi phục state sẽ trở thành cuộc đua. Chọn container làm owner, phát sự kiện một chiều và chỉ lưu những route cần thiết.
Storyboard và segue: legacy hợp lý, nhưng phải kiểm soát rủi ro
Storyboard hữu ích khi team đang duy trì một flow đã được thiết kế trực quan, đặc biệt khi có nhiều constraint và segue ổn định. Các loại thường gặp là Show, Present Modally, Popover và Custom. Tuy nhiên, segue identifier là string; gõ sai hoặc đổi tên mà quên cập nhật code có thể gây crash runtime.
override func prepare(for segue: UIStoryboardSegue, sender: Any?) {
guard segue.identifier == "ShowProductDetail",
let detail = segue.destination as? ProductDetailViewController,
let id = sender as? UUID else {
assertionFailure("Unexpected segue or payload")
return
}
detail.configure(productID: id)
}
func openSelectedProduct(_ id: UUID) {
performSegue(withIdentifier: "ShowProductDetail", sender: id)
}
Với modal được bọc bởi navigation controller, segue.destination không phải destination màn hình cuối. Bạn cần lấy UINavigationController rồi đọc topViewController, hoặc tốt hơn là tạo một abstraction/coordinator để việc unwrap chỉ xuất hiện ở một nơi. Nếu flow mới hoàn toàn, điều hướng bằng code thường dễ review, test và đổi route hơn Storyboard.
Coordinator, custom transition và deep link
Coordinator tách quyết định điều hướng khỏi view controller. Coordinator tạo container, lắng nghe action từ child và quyết định push, present hay dismiss. Child không cần biết tab nào đang chứa nó; đổi flow vì thế ít kéo theo thay đổi UI code hơn.
Giữ child coordinator bằng property mạnh trong lúc flow sống, nhưng tránh để child giữ coordinator mạnh nếu coordinator lại giữ child. Một completion hoặc delegate có thể kết thúc flow và giải phóng child. Đây là chỗ ARC liên quan trực tiếp đến navigation: leak thường xuất hiện sau nhiều lần mở và đóng màn hình, không phải ngay lần đầu.
Custom transition nên được dùng khi animation mang ý nghĩa sản phẩm, không phải để thay thế một push đơn giản. Đảm bảo transition coordinator xử lý cả interactive cancel và completion. Nếu animation bị hủy mà state đã chuyển sang route mới, UI sẽ lệch với stack thực tế.
Deep link cũng là navigation state, không chỉ là một lệnh gọi push. Parse URL thành route có kiểu, xác thực ID và quyền truy cập, sau đó để coordinator dựng đúng hierarchy. Nếu app đang khởi động, chờ root container sẵn sàng; nếu đang có modal, quyết định rõ deep link sẽ thay thế flow, xếp sau flow hiện tại hay chỉ cập nhật màn hình đang có.
State restoration: lưu route, không lưu view controller
UIKit có cơ chế restoration identifier và encode/decode state. Hãy lưu những dữ liệu tối thiểu có thể tái tạo màn hình: tab đang chọn, ID item, filter và bước của form. Không serialize cả object graph của view controller hoặc coi địa chỉ instance là state bền vững.
Restoration phải chịu được dữ liệu cũ, item đã bị xóa và quyền truy cập đã thay đổi. Khi khôi phục thất bại, fallback về một root hợp lệ thay vì cố push một destination thiếu dữ liệu. Deep link và restoration có thể đến cùng lúc, nên cần một policy ưu tiên rõ ràng, thường là deep link mới nhất sau khi session hợp lệ.
SwiftUI: route dạng giá trị và chiến lược migrate
Trong SwiftUI, bạn thường không giữ một stack các view controller. Bạn giữ một mảng route hoặc NavigationPath, rồi ánh xạ route sang destination. Route có thể là enum Hashable, nên deep link, test và state restoration làm việc trên dữ liệu thay vì instance UI.
import SwiftUI
enum AppRoute: Hashable {
case product(UUID)
case settings
}
struct RootView: View {
@State private var path: [AppRoute] = []
var body: some View {
NavigationStack(path: $path) {
ProductListView(onSelect: { id in
path.append(.product(id))
})
.navigationDestination(for: AppRoute.self) { route in
switch route {
case .product(let id): ProductDetailView(id: id)
case .settings: SettingsView()
}
}
}
}
}
NavigationSplitView là lựa chọn tự nhiên cho sidebar-detail trên iPad và Mac; nó mô tả các cột thay vì buộc bạn tự chuyển đổi compact/regular như trong một số UIKit flow. Điều đó không có nghĩa UIKit phải bị loại bỏ. Bạn có thể bọc màn hình cũ bằng UIViewControllerRepresentable, giữ coordinator UIKit ở ranh giới module, rồi di chuyển từng route.
Chiến lược an toàn là bắt đầu từ route contract. Liệt kê các destination, payload và điều kiện quyền; sau đó chọn một nguồn state duy nhất. Migrate màn hình leaf trước, giữ một adapter cho callback hoặc delegate, rồi mới thay container. Đừng chạy song song một navigation state trong UIKit và một state khác trong SwiftUI cho cùng flow.
| Tình huống | Ưu tiên | Lý do |
|---|---|---|
| App UIKit lớn, storyboard ổn định | Giữ container, thêm coordinator | Giảm thay đổi và khoanh vùng rủi ro runtime. |
| Màn hình mới, route có dữ liệu rõ | SwiftUI NavigationStack |
State và deep link dễ kiểm thử hơn. |
| iPad nhiều cột | UISplitViewController hoặc NavigationSplitView |
Chọn theo phần còn lại của module và mức độ migrate. |
Các lỗi thực tế và cách tránh
- Giữ view controller quá lâu: coordinator, closure hoặc delegate tạo retain cycle. Dùng capture
[weak self]khi ownership không cần mạnh, và kiểm tra deinit bằng Instruments. - Push/present ngoài main: bọc entry point bằng
@MainActorhoặc chuyển kết quả async về main trước khi đổi UI. Đừng gọi UIKit trực tiếp từ background task. - Present khi đã present: nối nhiều callback có thể tạo double-present. Kiểm tra hierarchy, debounce action và có một presenter owner.
- Nhân đôi navigation state: tab, coordinator, view model cùng sửa stack. Chọn một owner và phát event một chiều.
- Segue identifier crash: dùng hằng số, test từng flow và kiểm tra type của destination; đừng ép kiểu bằng
as!nếu input có thể thay đổi. - Deep link thiếu validation: không push màn hình khi ID không hợp lệ hoặc user chưa đăng nhập. Route phải có trạng thái lỗi và fallback.
- Interactive dismissal làm mất dữ liệu: dùng presentation controller delegate để cho phép, chặn hoặc yêu cầu xác nhận trước khi đóng.
Checklist trước khi merge
- Vẽ hierarchy: tab, split, navigation stack và modal flow; chỉ rõ owner của từng flow.
- Đảm bảo mọi push/present chạy trên main và presenter còn trong window.
- Kiểm thử Back button, edge-swipe, cancel transition, kéo đóng sheet và rotation/trait compact.
- Thử deep link khi app lạnh, app nền, đang ở tab khác và đang có modal.
- Khôi phục state với ID cũ hoặc dữ liệu bị xóa; luôn có fallback hợp lệ.
- Nếu bắt đầu migrate, chuyển route thành giá trị trước, rồi thay từng destination thay vì đổi toàn bộ container một lần.
Góc nhìn 2027
SwiftUI sẽ tiếp tục là lựa chọn mặc định cho màn hình mới, còn UIKit sẽ sống lâu trong các app nhiều năm tuổi, surface chuyên biệt và module cần kiểm soát thấp hơn. Kỹ năng có giá trị không phải là chọn một framework theo xu hướng, mà là giữ navigation state nhất quán khi hai thế giới cùng tồn tại.
Bạn có thể xem lại nền tảng view controller trong bài điều hướng và chuyển đổi view trong iOS, cách dựng màn hình UIKit trong bài xây dựng giao diện với UIKit, và phần SwiftUI về Views, modifiers và điều hướng. Đây cũng là một bước trong iOS roadmap tổng thể.



