uni-app: framework đa nền tảng dùng Vue.js
/uni-app
uni-app là framework Vue.js biên dịch một codebase ra iOS, Android, HarmonyOS, web, và một loạt nền tảng mini-program của Trung Quốc. Giá trị thực sự nằm ở đúng phần việc mini-program đó — nhắm tới WeChat, Alipay, Baidu và ByteDance từ một codebase Vue duy nhất tốt hơn hẳn việc build tay từng nền tảng riêng lẻ. Điểm trừ: phần lớn tài liệu ưu tiên tiếng Trung. Team nói tiếng Anh nên dành thời gian dịch tài liệu trước khi bắt tay vào.
uni-app là gì
uni-app là framework mã nguồn mở dựa trên Vue.js của DCloud, cho phép build một codebase rồi phát hành lên iOS, Android, HarmonyOS, bản web responsive, và mini-program trên WeChat, Alipay, Baidu, ByteDance và nhiều nền tảng khác. Repo có hai engine: uni-app bản gốc render qua web-view, còn uni-app x biên dịch ngôn ngữ uts thẳng sang Kotlin, Swift và ArkTS native qua engine uvue.
Tính năng chính của uni-app
- ✓Một codebase Vue.js biên dịch ra iOS, Android, HarmonyOS, web, và mini-program trên WeChat, Alipay, Baidu, ByteDance, Feishu, QQ, Kuaishou, DingTalk, Taobao, JD và Xiaohongshu.
- ✓uni-app x thêm engine thứ hai: ngôn ngữ uts biên dịch sang Kotlin trên Android, Swift trên iOS, và ArkTS trên HarmonyOS Next thay vì chạy qua web-view.
- ✓Trên web và mini-program, uts biên dịch xuống JavaScript thuần thay vì code native.
- ✓Hỗ trợ cả Vue 2 và Vue 3, duy trì trên hai branch riêng: uni-app-vue2 và uni-app-vue3.
- ✓Nhắm cả tới quick app 快应用 và HarmonyOS meta-service (鸿蒙元服务) — những nền tảng mà đa số framework đa nền tảng khác bỏ qua.
- ✓Repo có sẵn thư mục benchmark/ chứa báo cáo đánh giá hiệu năng riêng của dự án.
- ✓Cấp phép Apache-2.0, cho phép fork, sửa đổi và phân phối lại mà không kèm điều kiện copyleft.
Vì sao phát triển đa nền tảng quan trọng
Build cho hệ sinh thái app Trung Quốc không chỉ dừng ở iOS và Android — WeChat, Alipay, Baidu, ByteDance, Kuaishou và DingTalk mỗi nền tảng chạy một runtime mini-program riêng, với cú pháp component và pipeline build khác nhau. Một team muốn phủ hết các nền tảng này mà không phải duy trì mười codebase riêng lẻ cần một trình biên dịch hiểu rõ từng target, chứ không chỉ một khẩu hiệu 'viết một lần, chạy mọi nơi'. README định vị uni-app đúng vào bài toán đó: ngay cả khi không cần đa nền tảng, tài liệu vẫn mô tả framework này như một công cụ mini-program tốt hơn.
Bạn có thể xây dựng gì với uni-app
- •Một team sản phẩm duy nhất ship cùng một app lên iOS, Android và bản web responsive từ một codebase Vue.
- •Một thương hiệu bán lẻ hoặc nội dung cần hiện diện trên WeChat, Alipay, Baidu, ByteDance và các mini-program khác mà không cần đội riêng cho từng nền tảng.
- •Một bản phát hành tập trung vào HarmonyOS, gồm cả biên dịch uts thẳng sang ArkTS hoặc phát hành dưới dạng HarmonyOS meta-service (鸿蒙元服务).
- •Một bản build quick-app (快应用) cho các kênh OEM Android như vivo, OPPO và Huawei — README nói đây là những target quick-app duy nhất được hỗ trợ.
- •Một team đang migrate project uni-app render qua web-view sang engine uni-app x render native để cải thiện hiệu năng.
Bắt đầu với uni-app
Các bước cài đặt không được tài liệu hoá rõ ràng trong phần thông tin có sẵn ở đây — README chỉ trỏ tới một QR code trải nghiệm nhanh và nói code mẫu hello uni-app / uni-app x có thể lấy từ GitHub, chứ không nêu cụ thể lệnh CLI hay tên package. Topic của repo liệt kê hbuilderx, IDE riêng của DCloud, là công cụ gắn liền nhất với dự án. Nên tải project mẫu từ GitHub và kiểm tra docs của DCloud trước khi giả định một lệnh cài đặt cụ thể.
Viết và triển khai code uni-app
Branch uni-app x của repo này tổ chức theo cấu trúc source tree điển hình của một framework: src/ chứa source code engine, examples/ có các project mẫu chạy được, docs/ là tài liệu, test/ chứa test suite, còn benchmark/ chứa báo cáo đánh giá hiệu năng riêng của dự án. Quy trình viết code và deploy hàng ngày — lệnh nào build cho target mini-program nào, uts biên dịch ra sao trên từng nền tảng — không được nêu chi tiết trong phần thông tin có ở đây; chi tiết đó nằm trong docs/, không phải README ở cấp cao nhất.
Điểm mạnh
- ✓Một codebase Vue.js phủ số lượng target hiếm framework nào bằng: iOS, Android, HarmonyOS, web, và một loạt mini-program được nêu tên cụ thể, chứ không chỉ hai ba nền tảng thông thường.
- ✓Biên dịch uts sang native (Kotlin, Swift, ArkTS) của uni-app x là bước tiến thật so với việc render mọi thứ qua web-view, với những project cần điều đó.
- ✓Giấy phép Apache-2.0 giữ việc phân phối lại và sửa đổi không bị ràng buộc.
- ✓Hỗ trợ HarmonyOS và HarmonyOS meta-service rõ ràng — điều mà đa số framework đa nền tảng phương Tây không có.
Hạn chế và đánh đổi của uni-app
- △Gần như toàn bộ README, các con số hệ sinh thái DCloud đưa ra, và (theo topic của repo) IDE chính đều ưu tiên tiếng Trung; mức độ tài liệu tiếng Anh không được xác nhận trong phần thông tin có ở đây.
- △uni-app và uni-app x là hai engine khác nhau với model render khác nhau (web-view so với native qua uts/uvue) — chuyển project từ bản này sang bản kia không phải việc đổi qua là chạy ngay.
- △Hỗ trợ quick-app (快应用) khá hẹp: README ghi rõ chỉ phủ vivo, OPPO và Huawei, chứ không phải toàn bộ hệ sinh thái OEM Android.
- △Quy trình cài đặt và CLI hàng ngày không được tài liệu hoá trong phần thông tin đã xem, nên muốn biết độ ma sát khi setup thì chỉ có cách tự thử.
Lựa chọn thay thế cho uni-app
Ai nên dùng uni-app
Team cần phủ WeChat, Alipay, Baidu, ByteDance hay các mini-program khác song song với iOS và Android — mà không muốn dựng một đội riêng cho từng nền tảng — là nhóm phù hợp nhất với uni-app, đặc biệt nếu team đã quen Vue.js. Nó cũng hợp với project nhắm riêng tới HarmonyOS, vì uts biên dịch thẳng sang ArkTS. Team làm việc thuần tiếng Anh, không muốn dịch tài liệu và cộng đồng ưu tiên tiếng Trung, hoặc cần pipeline render native đầy đủ ngay từ ngày đầu trên mọi nền tảng, nên dành thêm thời gian làm quen hoặc cân nhắc lựa chọn khác.
Câu hỏi thường gặp về uni-app
uni-app được phát hành theo giấy phép Apache-2.0, nên bạn được dùng, sửa đổi và phân phối lại miễn phí, kể cả trong dự án thương mại, mà không phải trả phí bản quyền cho DCloud. Apache-2.0 yêu cầu giữ nguyên thông báo bản quyền và giấy phép trong các bản sao source, nhưng không bắt buộc dự án phái sinh phải mở mã nguồn.
uni-app biên dịch một codebase Vue.js ra iOS, Android, HarmonyOS, và bản web responsive, cộng thêm mini-program trên WeChat, Alipay, Baidu, ByteDance (Douyin), Feishu, QQ, Kuaishou, DingTalk, Taobao, JD và Xiaohongshu. Nó còn hỗ trợ quick-app 快应用 trên vivo, OPPO, Huawei, và HarmonyOS meta-service (鸿蒙元服务).
uni-app bản gốc render qua web-view: logic chạy JavaScript còn giao diện hiển thị qua web view nhúng, giống kiến trúc mini-program. uni-app x là engine mới hơn, xây trên ngôn ngữ uts và engine render uvue, biên dịch thẳng sang Kotlin, Swift hoặc ArkTS native thay vì render qua web-view.
uts là ngôn ngữ kiểu TypeScript, đa nền tảng, được uni-app x biên dịch riêng cho từng target: sang Kotlin trên Android, sang Swift trên iOS, và sang ArkTS trên HarmonyOS Next. Trên web và mini-program, uts biên dịch xuống JavaScript thuần, nên cùng một source uts vừa ra native code trên mobile, vừa ra JS ở nơi khác.
README nói hệ sinh thái DCloud có lượng lớn developer, app đã publish, và người dùng hoạt động hàng tháng trên các app build bằng uni-app, cho thấy đã có sử dụng production thực tế, dù repo không công bố con số cụ thể. Dự án cũng có sẵn thư mục benchmark/ với báo cáo đánh giá hiệu năng riêng cho team nào muốn tự kiểm tra.
Điều này không được tài liệu hoá rõ trong README của uni-app — HBuilderX là IDE chính thức của DCloud và xuất hiện trong topic GitHub của repo, nhưng phần thông tin có ở đây không nói rõ đây có phải bắt buộc hay VS Code có được hỗ trợ như một lựa chọn thay thế hay không. Nên kiểm tra trực tiếp tài liệu của DCloud trước khi giả định.
Repo liên quan
uni-app có đáng để bạn bỏ thời gian?
ChatGPT, Claude và Perplexity đều đọc được trang này. Hỏi thử xem họ nghĩ gì về uni-app.