Cloud Storage for Firebase cho phép bạn tải lên và chia sẻ nội dung do người dùng tạo, chẳng hạn như hình ảnh và video, nhờ đó bạn có thể tạo nội dung đa phương tiện phong phú trong ứng dụng. Dữ liệu của bạn được lưu trữ trong một Google Cloud Storage vùng chứa – một giải pháp lưu trữ đối tượng ở quy mô exabyte với khả năng hoạt động cao và tính dư thừa trên toàn cầu. Cloud Storage for Firebase cho phép bạn tải các tệp này lên một cách an toàn trực tiếp từ thiết bị di động và trình duyệt web, dễ dàng xử lý các mạng không ổn định với.
Trước khi bắt đầu
Nếu chưa, hãy nhớ hoàn tất hướng dẫn bắt đầu sử dụng cho các ứng dụng nền tảng Apple. Chẳng hạn như:
Tạo một dự án Firebase.
Đăng ký ứng dụng nền tảng Apple với dự án, và kết nối ứng dụng với Firebase bằng cách thêm thư viện Firebase và tệp cấu hình Firebase (
GoogleService-Info.plist) vào ứng dụng.
Đảm bảo dự án Firebase của bạn sử dụng Gói giá linh hoạt (trả tiền theo mức dùng), đây là yêu cầu bắt đầu từ tháng 10 năm 2024 (xem Câu hỏi thường gặp). Lưu ý rằng nếu bạn mới sử dụng Firebase và Google Cloud, hãy kiểm tra xem bạn có đủ điều kiện nhận khoản tín dụng trị giá 300 USD hay không.
Tạo vùng chứa mặc địnhCloud Storage
Trên ngăn điều hướng của Firebase bảng điều khiển, hãy chọn Storage (Bộ nhớ).
Nếu dự án của bạn chưa sử dụng Gói giá linh hoạt (trả tiền theo mức dùng), thì bạn sẽ được nhắc nâng cấp dự án.
Nhấp vào Bắt đầu.
Chọn vị trí cho vùng chứa mặc định.
Các vùng chứa trong
US-CENTRAL1US-EAST1US-WEST1Nếu muốn, sau này bạn có thể tạo nhiều vùng chứa, mỗi vùng chứa có một vị trí riêng.
Định cấu hình Firebase Security Rules cho vùng chứa mặc định. Trong quá trình phát triển, hãy cân nhắc thiết lập các quy tắc cho quyền truy cập công khai.
Nhấp vào Xong.
Giờ đây, bạn có thể xem vùng chứa trong thẻ
Cloud Storage Files
của bảng điều khiển.Firebase Định dạng tên vùng chứa mặc định là
PROJECT_ID.firebasestorage.app
Thiết lập quyền truy cập công khai
Cloud Storage for Firebase cung cấp một ngôn ngữ quy tắc khai báo cho phép bạn xác định cách cấu trúc dữ liệu, cách lập chỉ mục dữ liệu và thời điểm có thể đọc và ghi dữ liệu. Theo mặc định, quyền truy cập đọc và ghi vào Cloud Storage bị hạn chế để chỉ những người dùng đã xác thực mới có thể đọc hoặc ghi dữ liệu. Để bắt đầu mà không cần thiết lập Authentication, bạn có thể định cấu hình các quy tắc cho quyền truy cập công khai.
Điều này khiến Cloud Storage mở cho bất kỳ ai, ngay cả những người không sử dụng ứng dụng của bạn. Vì vậy, hãy nhớ hạn chế lại Cloud Storage khi bạn thiết lập tính năng xác thực.
Thêm Cloud Storage vào ứng dụng
Sử dụng Trình quản lý gói Swift để cài đặt và quản lý các phần phụ thuộc của Firebase.
- Trong Xcode, khi dự án ứng dụng của bạn đang mở, hãy chuyển đến File > Add Packages.
- Khi được nhắc, hãy thêm kho lưu trữ SDK nền tảng Apple của Firebase:
- Chọn thư viện Cloud Storage.
- Thêm cờ
-ObjCvào phần Other Linker Flags (Cờ trình liên kết khác) trong chế độ cài đặt bản dựng của mục tiêu. - Khi hoàn tất, Xcode sẽ tự động bắt đầu phân giải và tải các phần phụ thuộc xuống ở chế độ nền.
https://github.com/firebase/firebase-ios-sdk.git
Thiết lập Cloud Storage trong ứng dụng
Khởi chạy Firebase trước khi tạo hoặc sử dụng bất kỳ tham chiếu Firebase nào.
Bạn có thể đã thực hiện việc này nếu đã thiết lập một sản phẩm Firebase khác, nhưng bạn cần đảm bảo thêm thư viện
FirebaseStoragevào danh sách các lệnh nhập.Nhập mô-đun
FirebaseCorevà mô-đunFirebaseStoragetrongUIApplicationDelegate. Bạn cũng nên thêmFirebaseAuth.SwiftUI
import SwiftUI import FirebaseCore import FirebaseStorage import FirebaseAuth // ...Swift
import FirebaseCore import FirebaseStorage import FirebaseAuth // ...Objective-C
@import FirebaseCore; @import FirebaseStorage; @import FirebaseAuth; // ...Định cấu hình một
FirebaseAppthực thể dùng chung trong phương thứcapplication(_:didFinishLaunchingWithOptions:)của đại diện ứng dụng:SwiftUI
// Use Firebase library to configure APIs FirebaseApp.configure()Swift
// Use Firebase library to configure APIs FirebaseApp.configure()Objective-C
// Use Firebase library to configure APIs [FIRApp configure];(Chỉ SwiftUI) Tạo một đại diện ứng dụng và đính kèm đại diện đó vào cấu trúc
AppbằngUIApplicationDelegateAdaptorhoặcNSApplicationDelegateAdaptor. Bạn cũng phải tắt tính năng hoán đổi đại diện ứng dụng. Để biết thêm thông tin, hãy xem hướng dẫn về SwiftUI.SwiftUI
@main struct YourApp: App { // Register app delegate for Firebase setup @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate var body: some Scene { WindowGroup { NavigationView { ContentView() } } } }
Lấy tham chiếu đến dịch vụ Cloud Storage bằng Ứng dụng Firebase mặc định.
Đảm bảo tệp cấu hình Firebase (
GoogleService-Info.plist) trong cơ sở mã của ứng dụng được cập nhật bằng tên của vùng chứa Cloud Storage mặc định.Sử dụng tệp cấu hình đã tải xuống này để thay thế tệp hiện có
GoogleService-Info.plisttrong thư mục gốc của dự án Xcode. Nếu được nhắc, hãy chọn để thêm tệp cấu hình vào tất cả các mục tiêu.Đảm bảo rằng bạn chỉ có tệp cấu hình đã tải xuống gần đây nhất này trong ứng dụng và tên tệp không được thêm các ký tự khác, chẳng hạn như
(2).
Lấy tham chiếu đến dịch vụ Cloud Storage bằng Ứng dụng Firebase mặc định:
Swift
let storage = Storage.storage()
// Alternatively, explicitly specify the bucket name URL. storage = Storage.storage(url:"gs://BUCKET_NAME")
Objective-C
FIRStorage *storage = [FIRStorage storage];
// Alternatively, explicitly specify the bucket name URL. // FIRStorage storage = [FIRStorage storageWithURL:@"gs://BUCKET_NAME"];
Bạn đã sẵn sàng bắt đầu sử dụng Cloud Storage!
Bước tiếp theo? Tìm hiểu cách tạo tham chiếu Cloud Storage.
Thiết lập nâng cao
Có một số trường hợp sử dụng yêu cầu thiết lập bổ sung:
- Sử dụng vùng chứa Cloud Storage ở nhiều khu vực địa lý
- Sử dụng vùng chứa Cloud Storage ở các lớp lưu trữ khác nhau
- Sử dụng vùng chứa Cloud Storage với nhiều người dùng đã xác thực trong cùng một ứng dụng
Trường hợp sử dụng đầu tiên là hoàn hảo nếu bạn có người dùng trên khắp thế giới và muốn lưu trữ dữ liệu của họ ở gần họ. Ví dụ: bạn có thể tạo vùng chứa ở Hoa Kỳ, Châu Âu và Châu Á để lưu trữ dữ liệu cho người dùng ở những khu vực đó nhằm giảm độ trễ.
Trường hợp sử dụng thứ hai sẽ hữu ích nếu bạn có dữ liệu với các mẫu truy cập khác nhau. Ví dụ: bạn có thể thiết lập một vùng chứa nhiều khu vực hoặc vùng chứa khu vực lưu trữ hình ảnh hoặc nội dung thường xuyên được truy cập khác và một vùng chứa nearline hoặc coldline lưu trữ bản sao lưu của người dùng hoặc nội dung khác ít được truy cập.
Trong một trong những trường hợp sử dụng này, bạn sẽ muốn sử dụng nhiều Cloud Storage vùng chứa.
Trường hợp sử dụng thứ ba sẽ hữu ích nếu bạn đang xây dựng một ứng dụng, chẳng hạn như Google Drive, cho phép người dùng có nhiều tài khoản đã đăng nhập (ví dụ: tài khoản cá nhân và tài khoản công việc). Bạn có thể sử dụng một thực thể Ứng dụng Firebase tuỳ chỉnh để xác thực từng tài khoản bổ sung.
Sử dụng nhiều vùng chứa Cloud Storage
Nếu muốn sử dụng một vùng chứa Cloud Storage khác với vùng chứa mặc định được cung cấp ở trên,
hoặc sử dụng nhiều vùng chứa Cloud Storage trong một ứng dụng, bạn có thể tạo một thực thể
của FIRStorage tham chiếu đến vùng chứa tuỳ chỉnh:
Swift
// Get a non-default Cloud Storage bucket storage = Storage.storage(url:"gs://my-custom-bucket")
Objective-C
// Get a non-default Cloud Storage bucket FIRStorage storage = [FIRStorage storageWithURL:@"gs://my-custom-bucket"];
Thao tác với các vùng chứa đã nhập
Khi nhập một vùng chứa Cloud Storage hiện có vào Firebase, bạn sẽ
phải cấp cho Firebase quyền truy cập vào các tệp này bằng công cụ
gsutil có trong
Google Cloud SDK:
gsutil -m acl ch -r -u service-PROJECT_NUMBER@gcp-sa-firebasestorage.iam.gserviceaccount.com gs://BUCKET_NAME
Bạn có thể tìm thấy số dự án như mô tả trong phần giới thiệu về các dự án Firebase.
Điều này không ảnh hưởng đến các vùng chứa mới tạo, vì các vùng chứa đó có quyền kiểm soát quyền truy cập mặc định được đặt để cho phép Firebase. Đây là biện pháp tạm thời và sẽ được thực hiện tự động trong tương lai.
Sử dụng Ứng dụng Firebase tuỳ chỉnh
Nếu đang xây dựng một ứng dụng phức tạp hơn bằng FirebaseApp tuỳ chỉnh, bạn có
thể tạo một thực thể Storage được khởi chạy bằng ứng dụng đó:
Swift
// Get the default bucket from a custom FirebaseApp storage = Storage.storage(app:customApp) // Get a non-default bucket from a custom FirebaseApp storage = Storage.storage(app:customApp, url:"gs://my-custom-bucket")
Objective-C
// Get the default bucket from a custom FIRApp FIRStorage storage = [FIRStorage storageForApp:customApp]; // Get a non-default bucket from a custom FIRApp FIRStorage storage = [FIRStorage storageForApp:customApp withURL:@"gs://my-custom-bucket"];
Các bước tiếp theo
Chuẩn bị ra mắt ứng dụng:
Bật App Check để giúp đảm bảo rằng chỉ ứng dụng của bạn mới có thể truy cập vào các vùng chứa bộ nhớ.
Thiết lập cảnh báo ngân sách cho dự án của bạn trong bảng điều khiển Google Cloud.
Theo dõi trang tổng quan Usage and billing trong bảng điều khiển Firebase để nắm được bức tranh tổng thể về mức sử dụng của dự án trên nhiều dịch vụ Firebase. Bạn cũng có thể truy cập vào trang tổng quan Cloud Storage Usage dashboard để biết thông tin chi tiết hơn về mức sử dụng.
Xem lại danh sách kiểm tra ra mắt Firebase.