Catch up on everthing we announced at this year's Firebase Summit. Learn more

Bắt đầu với Cloud Storage trên các nền tảng của Apple

Cloud Storage cho 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, cho phép bạn xây dựng nội dung đa phương tiện vào ứng dụng của mình. Dữ liệu của bạn được lưu trữ trong một Google Cloud Storage xô - một giải pháp lưu trữ đối tượng quy mô exabyte với tính sẵn sàng cao và khả năng dự phòng toàn cầu. Cloud Storage dành cho Firebase cho phép bạn tải lên một cách an toàn các tệp này trực tiếp từ thiết bị di động và trình duyệt web, xử lý các mạng thiếu sót một cách dễ dàng.

Điều kiện tiên quyết

  1. Cài đặt căn cứ hỏa lực SDK .
  2. Thêm ứng dụng của bạn để dự án căn cứ hỏa lực của bạn trong căn cứ hỏa lực console .

Tạo nhóm lưu trữ đám mây mặc định

  1. Từ cửa sổ chuyển hướng của các căn cứ hỏa lực console , chọn lưu trữ, sau đó nhấp vào Bắt đầu.

  2. Xem lại thông báo về cách bảo mật dữ liệu Bộ nhớ đám mây của bạn bằng các quy tắc bảo mật. Trong phát triển, xem xét việc thiết lập các quy tắc của bạn để truy cập công cộng .

  3. Chọn một vị trí để xô Cloud Storage mặc định của bạn.

    • Thiết lập vị trí này là dự án của bạn vị trí tài nguyên Google Cloud Platform (GCP) mặc định . Lưu ý rằng vị trí này sẽ được sử dụng cho các dịch vụ GCP trong dự án của bạn đòi hỏi phải có một thiết lập vị trí, đặc biệt là của bạn Mây FireStore cơ sở dữ liệu và bạn App Engine ứng dụng (đó là cần thiết nếu bạn sử dụng đám mây Scheduler).

    • Nếu bạn không thể chọn một vị trí, thì dự án của bạn đã có một vị trí tài nguyên GCP mặc định. Nó được thiết lập trong quá trình tạo dự án hoặc khi thiết lập một dịch vụ khác yêu cầu thiết lập vị trí.

    Nếu bạn đang sử dụng gói Blaze, bạn có thể tạo nhiều xô , mỗi riêng của mình vị trí .

  4. Nhấn Done.

Thiết lập quyền truy cập công khai

Cloud Storage cho Firebase cung cấp ngôn ngữ quy tắc khai báo cho phép bạn xác định cách dữ liệu của bạn nên được cấu trúc, cách lập chỉ mục dữ liệu và thời điểm dữ liệu của bạn có thể được đọc và ghi vào. Theo mặc định, quyền truy cập đọc và ghi vào Cloud Storage bị hạn chế nên 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 thành lập xác thực , bạn có thể cấu hình quy tắc của bạn để truy cập công cộng .

Điều này làm cho Cloud Storage có thể 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 đảm bảo hạn chế Cloud Storage của bạn một lần nữa khi bạn thiết lập xác thực.

Thêm bộ nhớ đám mây vào ứng dụng của bạn

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.

  1. Trong Xcode, với dự án ứng dụng của bạn mở, điều hướng tới File> Swift gói> Thêm gói phụ thuộc.
  2. Khi được nhắc, hãy thêm kho lưu trữ SDK nền tảng Apple Firebase:
  3.   https://github.com/firebase/firebase-ios-sdk
      
  4. Chọn thư viện Cloud Storage.
  5. Khi hoàn tất, Xcode sẽ tự động bắt đầu giải quyết và tải xuống các phần phụ thuộc của bạn trong nền.

Thiết lập bộ nhớ đám mây

Bạn phải khởi tạo Firebase trước khi tạo hoặc sử dụng bất kỳ tham chiếu Firebase nào. Nếu bạn đã thực hiện việc này cho một tính năng Firebase khác, bạn có thể bỏ qua bước này.

  1. Nhập module căn cứ hỏa lực trong bạn UIApplicationDelegate :

    Nhanh

    import Firebase

    Objective-C

    @import Firebase;
  2. Cấu hình một FirebaseApp chia sẻ Ví dụ, điển hình là trong ứng dụng của bạn application:didFinishLaunchingWithOptions: phương pháp:

    Nhanh

    // Use Firebase library to configure APIs
    FirebaseApp.configure()

    Objective-C

    // Use Firebase library to configure APIs
    [FIRApp configure];
  3. Tham khảo dịch vụ Cloud Storage, sử dụng Ứng dụng Firebase mặc định:

    Nhanh

    let storage = Storage.storage()
    

    Objective-C

    FIRStorage *storage = [FIRStorage storage];
    

Bạn đã sẵn sàng để bắt đầu sử dụng Cloud Storage!

Đầu tiên, chúng ta hãy cùng tìm hiểu làm thế nào để tạo ra một tài liệu tham khảo 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:

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 nhóm ở Hoa Kỳ, Châu Âu và Châu Á để lưu trữ dữ liệu cho người dùng ở các khu vực đó nhằm giảm độ trễ.

Trường hợp sử dụng thứ hai rất hữu ích nếu bạn có dữ liệu với các kiểu truy cập khác nhau. Ví dụ: bạn có thể thiết lập một nhóm đa vùng hoặc khu vực để lưu trữ hình ảnh hoặc nội dung được truy cập thường xuyên khác và một nhóm gần hoặc dòng lạnh lưu trữ các bản sao lưu của người dùng hoặc nội dung được truy cập không thường xuyên khác.

Trong cả hai trường hợp sử dụng, bạn sẽ muốn sử dụng nhiều xô Cloud Storage .

Trường hợp sử dụng thứ ba rất 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 tùy chỉnh căn cứ hỏa lực App dụ để xác thực mỗi tài khoản bổ sung.

Sử dụng nhiều nhóm Bộ nhớ đám mây

Nếu bạn muốn sử dụng một lưu trữ đám mây xô khác với mặc định cung cấp ở trên, hoặc sử dụng nhiều xô Cloud Storage trong một ứng dụng duy nhất, bạn có thể tạo một thể hiện của FIRStorage rằng tài liệu tham khảo xô tùy chỉnh của bạn:

Nhanh

// 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"];
    

Làm việc với các nhóm đã nhập

Khi nhập một xô Cloud Storage hiện vào căn cứ hỏa lực, bạn sẽ phải cấp căn cứ hỏa lực khả năng truy cập vào các file bằng cách sử dụng gsutil công cụ, bao gồm trong Google Cloud SDK :

gsutil -m acl ch -r -u service-<project number>@gcp-sa-firebasestorage.iam.gserviceaccount.com gs://<your-cloud-storage-bucket>

Bạn có thể tìm thấy số dự án của bạn như được mô tả trong các giới thiệu về dự án căn cứ hỏa lực .

Điều này không ảnh hưởng đến các nhóm mới được tạo, vì chúng có bộ kiểm soát 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 tùy chỉnh

Nếu bạn đang xây dựng một ứng dụng phức tạp hơn bằng cách sử dụng tùy chỉnh FirebaseApp , bạn có thể tạo một thể hiện của Storage khởi tạo với ứng dụng đó:

Nhanh

// 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"];
    

Bước tiếp theo