Khắc phục lỗi "Phiên bản Xcode này không được hỗ trợ" trên macOS

Nếu bạn là nhà phát triển iOS/macOS hoặc chỉ dùng Xcode để chỉnh sửa code, có khả năng bạn đã gặp thông báo lỗi: "Phiên bản Xcode này không được hỗ trợ trong phiên bản macOS này". Lỗi này rất khó chịu, đặc biệt khi bạn đang giữa dự án quan trọng.

Xcode là môi trường phát triển tích hợp (IDE) của Apple để phát triển ứng dụng trên mọi nền tảng của nó. Giờ Xcode 16 có nhiều chức năng mới. Đảm bảo phiên bản Xcode và macOS tương thích là thiết yếu để duy trì quy trình phát triển suôn sẻ. Trong bài này, chúng ta thảo luận nguyên nhân và khám phá vài cách giải quyết.

Lỗi này thường xảy ra khi phiên bản Xcode bạn dùng không tương thích với macOS hiện tại. Apple thường xuyên cập nhật cả macOS và Xcode, giới thiệu tính năng mới và bản vá bảo mật. Khi cập nhật không đồng bộ, như macOS cập nhật nhưng Xcode không, hoặc ngược lại, hệ thống sinh ra lỗi này. Sự không tương thích này dẫn đến Xcode không khởi động, chạy build, hoặc truy cập công cụ phát triển mới.

Một số nguyên nhân thường gặp của lỗi cảnh báo Xcode trên Mac bao gồm:

Chạy phiên bản Xcode cũ trên macOS mới cập nhật.
Cố gắng cài Xcode beta mới trên macOS cũ.
Thiếu hoặc cập nhật không hoàn chỉnh cho macOS hoặc Xcode.

Thảo luận Reddit về cách khắc phục lỗi Phiên bản Xcode này không được hỗ trợ

Nhiều người dùng Mac hỏi cách giải quyết lỗi Phiên bản Xcode này không được hỗ trợ... Ví dụ, người dùng Reddit tìm trợ giúp gặp lỗi khi cập nhật Mac lên macOS Sequoia beta và Xcode báo lỗi này.

Trong các phản hồi, mẹo hữu ích là gỡ Xcode beta hoặc hạ cấp macOS Sequoia về macOS Sonoma, vì ứng dụng và hệ điều hành không tương thích gây lỗi.

Xcode not working apter updating to macos 18 beta
by u/OkBerry3600 in iOSProgramming

Một số người dùng cũng khuyên dùng lệnh Terminal Mac để dùng Xcode mới. Dù nhu cầu gì, hướng dẫn này nêu rõ cách tốt nhất gỡ lỗi Phiên bản Xcode này không được hỗ trợ... Hãy đọc tiếp để tìm phương án phù hợp~

Cách khắc phục lỗi Phiên bản Xcode này không được hỗ trợ...

Nếu thông báo lỗi Phiên bản Xcode này không được hỗ trợ trong phiên bản macOS này làm bạn bực bội hoặc can thiệp sử dụng bình thường, hãy giải quyết với các phương pháp dưới:

Phương pháp 1: Kiểm tra tương thích macOS

Trước khi đi sâu cập nhật hoặc cài đặt, bước đầu là xác minh phiên bản Xcode bạn dùng có tương thích với macOS hiện tại không. Apple thường cung cấp biểu đồ tương thích cho biết phiên bản Xcode nào hoạt động với macOS nào. Ví dụ, Xcode 16 beta yêu cầu tối thiểu macOS 14.5.

Làm sao biết? Có trong tài liệu nhà phát triển chính thức của Apple. Bằng cách đảm bảo phần mềm phù hợp yêu cầu Apple, bạn tránh lỗi không cần thiết.

Khắc phục lỗi Phiên bản Xcode này không được hỗ trợ trên macOS – Hướng dẫn từng bước

Nếu thấy macOS/Xcode đã cũ, cập nhật một trong hai lên bản mới nhất là quan trọng.

Cập nhật macOS: Menu Apple > Cài đặt hệ thống > Chung > Cập nhật phần mềm, cập nhật nếu có mới.
Cập nhật Xcode: App Store > Tìm Xcode > Nhấp Cập nhật nếu có.

Thay vào đó, nếu bạn tải Xcode beta từ trang Apple Developer, truy cập trang để tải bản ổn định mới nhất.

Vào trang web Apple Developer.
Đăng nhập Apple ID.
Duyệt phần More Downloads tìm phiên bản Xcode cũ.
Tải và cài phiên bản phù hợp.

Vì vậy, nhớ đừng mở Xcode beta mới trên macOS cũ~

Phương pháp 2: Gỡ cài đặt và cài lại Xcode hoàn toàn

Trong một số trường hợp, cài đặt không hoàn chỉnh hoặc hỏng của Xcode gây vấn đề tương thích. Cài lại hoàn toàn có thể giải quyết. Để gỡ Xcode hoàn toàn, xóa đơn giản trong Finder hoặc Launchpad không đủ. Dữ liệu liên quan vẫn còn trong thư viện, làm chậm Mac.

Vì vậy, bạn được khuyến nghị dùng iBoysoft MagicMenu, gỡ hoàn toàn ứng dụng không muốn trong vài cú nhấp. Với nó, bạn không cần mở thư mục trong Library hay gõ lệnh Terminal huyền bí～

Tải miễn phí, cài, mở iBoysoft MagicMenu.
Finder > Applications > Chuột phải Xcode > Chọn Uninstall (Gỡ cài đặt).
Chọn file liên quan Xcode rồi nhấp Uninstall > Yes. (như hành động này)
Khi mọi thứ xóa xong, cài lại Xcode qua App Store hoặc trang Apple Developer.

Dễ phải không? Tôi chắc bạn sẽ yêu thích công cụ tinh tế này! Chia sẻ phương pháp giúp nhiều người.

Phương pháp 3: Dùng Xcode command-line tools

Nếu bạn chỉ quan tâm dùng khía cạnh nhất định của Xcode, như command-line tools để compile/build code, bạn có thể bỏ qua IDE hoàn toàn bằng cách cài Xcode command-line tools. Cách làm:

Finder > Applications > Utilities > Terminal.
Nhập xcode-select --install hoặc open/Applications/Xcode-15.4.0.app/Contents/MacOS/Xcode rồi nhấn Enter.
(Thay 15.4.0 bằng phiên bản tương thích.)
Làm theo nhắc.

Có lẽ bạn đã khắc phục lỗi Phiên bản Xcode này không được hỗ trợ trong phiên bản macOS này, hãy chia sẻ bài viết với người khác~

Kết luận

Gặp lỗi "Phiên bản Xcode này không được hỗ trợ trong phiên bản macOS này" khó chịu, nhưng thường dễ giải quyết bằng cách đảm bảo tương thích giữa Xcode và macOS.