Firebase App Hosting được thiết kế riêng để hỗ trợ việc phát triển ứng dụng web hiện đại tập trung vào khung. Hãy sử dụng trang này làm tài liệu tham khảo về các công cụ và khung mà App Hosting hỗ trợ trực tiếp, cũng như là điểm xuất phát để tìm hiểu về các công cụ và khung liên quan.
Khung web và App Hosting
App Hosting cung cấp hai cấp độ hỗ trợ rộng cho các khung web hiện đại: hỗ trợ xây dựng và triển khai được định cấu hình trước, cũng như hỗ trợ cấp cộng đồng thông qua các đóng góp nguồn mở tuân thủ thông số kỹ thuật của gói đầu ra. Trong cả hai trường hợp, thành phần trình chuyển đổi khung cho phép tích hợp một khung cụ thể với App Hosting.
Các khung có tính năng hỗ trợ tạo bản dựng và triển khai được định cấu hình sẵn
Với tính năng hỗ trợ tạo bản dựng và triển khai được định cấu hình trước, Firebase sẽ xác định khung bạn đang sử dụng bằng cách kiểm tra tệp package-lock.json hoặc tệp khoá khác, đồng thời tối ưu hoá quy trình tạo bản dựng và triển khai cho ứng dụng của bạn. Google cam kết duy trì hỗ trợ cho các khung này và nhóm hỗ trợ Firebase có thể chấp nhận báo cáo sự cố và yêu cầu tính năng.
Cấp độ hỗ trợ này được cung cấp cho:
- Next.js
- Angular
Hãy xem lịch hỗ trợ để biết thông tin chi tiết về các phiên bản và cấp độ hỗ trợ cụ thể.
Nếu bạn cố gắng triển khai một ứng dụng Node.js bị thiếu tệp khoá, thì App Hosting sẽ không tạo và chạy được ứng dụng. Bạn có thể tạo package-lock.json bằng cách chạy npm install trong thư mục gốc.
Khung được cộng đồng hỗ trợ
Ngoài Next.js và Angular, App Hosting cũng hỗ trợ mọi khung web có thể cung cấp đầu ra bản dựng khớp với quy cách gói đầu ra của chúng tôi. Tác giả khung có thể tận dụng thông số kỹ thuật gói đầu ra để đảm bảo khung của họ được App Hosting hỗ trợ. Ví dụ: khung Nuxt phổ biến được nhóm Nitro hỗ trợ. Nhóm này đã tạo một trình chuyển đổi Firebase để cho phép triển khai ứng dụng Nuxt trên App Hosting.
Nếu muốn xem các khung bổ sung được App Hosting hỗ trợ, bạn có thể tạo trình chuyển đổi khung hoặc liên hệ với trình bảo trì của khung để chuyển đổi đầu ra bản dựng thành định dạng App Hosting. Trình chuyển đổi Next.js và Angular là những ví dụ tham khảo hữu ích cho bất kỳ ai tạo trình chuyển đổi.
Bạn có thể xem thông tin về các khung do cộng đồng hỗ trợ trên Firebase Open Source. Bạn nên gửi các vấn đề và yêu cầu về tính năng cho các khung được cộng đồng hỗ trợ đến cộng đồng nguồn mở hoặc tác giả khung. Trong một số trường hợp, Google có thể hỗ trợ, nhưng cộng đồng là tuyến hỗ trợ đầu tiên cho các bộ chuyển đổi này.
Bộ chuyển đổi khung App Hosting
Trong App Hosting, hỗ trợ cho cả khung được định cấu hình trước và khung được cộng đồng hỗ trợ được cung cấp thông qua trình chuyển đổi khung. Bộ chuyển đổi khung App Hosting có hai vai trò chính:
- Các trình phân tích cú pháp này phân tích cú pháp mã nguồn và mọi tệp cấu hình dành riêng cho khung (chẳng hạn như
next.config.js) và tạo một gói đầu ra có thể được xử lý bằng phần còn lại của cơ sở hạ tầng App Hosting. - Các công cụ này chạy lệnh bản dựng của ứng dụng để tạo các thành phần tĩnh và tạo phiên bản ứng dụng được tối ưu hoá để phát hành công khai.
Bộ chuyển đổi khung tạo ứng dụng Node.js bằng npm run build, hoạt động tốt nhất với các tập lệnh bản dựng mặc định cho từng khung: next build cho Next.js và ng build cho Angular. App Hosting sẽ thử các bản dựng bằng các lệnh bản dựng tuỳ chỉnh, nhưng không thể đảm bảo chắc chắn về sự thành công. Bạn có thể ghi đè tập lệnh bản dựng và chạy trong apphosting.yaml.
Bạn có thể tìm thấy nguồn cho các bộ chuyển đổi Next.js và Angular trong firebase-framework-tools.
Môi trường thời gian chạy cho App Hosting
Sau khi được tạo và triển khai bởi App Hosting, ứng dụng Node.js sẽ chạy trong bản sửa đổi Cloud Run. Do đó, phiên bản thời gian chạy cho ứng dụng của bạn phải nằm trong cả phạm vi được hỗ trợ của Cloud Run và phạm vi của khung web mà bạn đã chọn. Đối với tính năng hỗ trợ được định cấu hình trước cho Angular và Next.js, điều này có nghĩa là các phiên bản Node.js sau đây được hỗ trợ:
- Next.js 13.5.x trở lên
- Angular 18.2.x trở lên
- Node.js 18 trở lên
App Hosting không tự động cung cấp dịch vụ hỗ trợ chủ động cho các phiên bản khung mới phát hành. Các phiên bản mới hơn phiên bản "đang hoạt động" hiện tại của chúng tôi sẽ được xem xét ở trạng thái "xem trước" cho đến khi được đánh dấu chính thức là "đang hoạt động" cho App Hosting.
App Hosting hỗ trợ dịch vụ hỗ trợ dài hạn (LTS) cho phiên bản nhỏ mới nhất của một bản phát hành lớn trong vòng một năm kể từ thời gian hỗ trợ đang hoạt động, miễn là bạn liên tục cập nhật lên các bản phát hành bản vá mới nhất trong phiên bản nhỏ đó. Hãy tham khảo các bảng sau để biết thông tin chi tiết về Next.js và Angular.
Lịch hỗ trợ Next.js
| Phiên bản | Trạng thái | Ngừng sử dụng |
|---|---|---|
| 13.5.x | lts | 2026-10-9 |
| 14.2.x | lts | 2026-10-9 |
| 15.0.x | hoạt động | không sớm hơn ngày 9 tháng 10 năm 2025 |
| 15.1.x | hoạt động | không sớm hơn ngày 9 tháng 10 năm 2025 |
| 15.2.x | hoạt động | - |
Lịch hỗ trợ Angular
| Phiên bản | Trạng thái | Ngừng sử dụng |
|---|---|---|
| 18.2.x | lts | 2026-10-9 |
| 19.0.x | hoạt động | không sớm hơn ngày 9 tháng 10 năm 2025 |
| 19.1.x | hoạt động | không sớm hơn ngày 9 tháng 10 năm 2025 |
| 19.2.x | hoạt động | - |
Trình quản lý gói
App Hosting sử dụng Gói bản dựng gốc trên đám mây để thực thi việc cài đặt các phần phụ thuộc và tạo ứng dụng bằng npm, yarn hoặc pnpm. Các trình quản lý gói khác như JSR không được hỗ trợ.
NPM
- NPM là trình quản lý gói mặc định.
- Các phần phụ thuộc không phải sản xuất sẽ bị cắt bỏ sau khi bản dựng thành công.
- Bạn có thể chỉ định phần phiên bản npm bằng cách sử dụng trường
engines.npmtrong tệppackage.json.
Sợi
- Thay vào đó, bạn sẽ sử dụng Yarn khi đưa tệp
yarn.lockvào dự án. - Bạn có thể chỉ định phiên bản yarn để sử dụng trong trường
engines.yarnhoặcpackageManagercủa tệppackage.json. - App Hosting hỗ trợ chế độ PnP Yarn2.
Pnpm
- Thay vào đó, Pnpm sẽ được sử dụng khi bạn đưa tệp
pnpm-lock.yamlvào dự án. - Bạn có thể chỉ định phiên bản pnpm trong trường
engines.pnpmhoặcpackageManagercủa tệppackage.json. - Để xem ví dụ về cách hoạt động, hãy xem sample-node-pnpm. ứng dụng.
Monorepo cho App Hosting
App Hosting hỗ trợ các ứng dụng dựa trên Nx. Hãy xem phần Sử dụng kho lưu trữ đơn bằng App Hosting để biết hướng dẫn chi tiết.
Các phiên bản Nx sau đây được hỗ trợ:
| Phiên bản | Trạng thái | Ngừng sử dụng |
|---|---|---|
| 19.5.x | bảo trì | 2025-10-9 |
| 19.6.x | bảo trì | 2025-10-9 |
| 19.7.x | bảo trì | 2025-10-9 |
| 19.8.x | lts | 2026-10-9 |
| 20.0.x | hoạt động | không sớm hơn ngày 9 tháng 10 năm 2025 |
| 20.1.x | hoạt động | không sớm hơn ngày 9 tháng 10 năm 2025 |
| 20.2.x | hoạt động | không sớm hơn ngày 9 tháng 10 năm 2025 |
| 20.3.x | hoạt động | không sớm hơn ngày 9 tháng 10 năm 2025 |
| 20.4.x | hoạt động | không sớm hơn ngày 9 tháng 10 năm 2025 |
| 20.5.x | hoạt động | không sớm hơn ngày 9 tháng 10 năm 2025 |
| 20.6.x | hoạt động | không sớm hơn ngày 9 tháng 10 năm 2025 |
| 20.7.x | hoạt động | — |
Nếu bạn cần được hỗ trợ cho các loại không gian làm việc monorepo khác, hãy cho chúng tôi biết tại Firebase UserVoice.