Join us in person and online for Firebase Summit on October 18, 2022. Learn how Firebase can help you accelerate app development, release your app with confidence, and scale with ease. Register now

Bắt đầu với Cloud Storage trên Android

Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

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 nhóm Google Cloud Storage - giải pháp lưu trữ đối tượng quy mô exabyte với tính khả dụng cao và khả năng dự phòng toàn cầu. Cloud Storage 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

Nếu bạn chưa có, hãy thêm Firebase vào dự án Android của bạn .

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

  1. Từ ngăn điều hướng của bảng điều khiển Firebase , chọn Bộ nhớ , 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 quá trình phát triển, hãy cân nhắc thiết lập các quy tắc của bạn để truy cập công khai .

  3. Chọn vị trí cho nhóm Bộ nhớ đám mây mặc định của bạn.

    • Cài đặt vị trí này là vị trí tài nguyên Google Cloud Platform (GCP) mặc định của dự án của bạn. 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 yêu cầu cài đặt vị trí, cụ thể là cơ sở dữ liệu Cloud Firestoreứng dụng App Engine của bạn (bắt buộc nếu bạn sử dụng Cloud 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 đang sử dụng gói Blaze, bạn có thể tạo nhiều nhóm , mỗi nhóm có vị trí riêng.

  4. Nhấp vào Xong .

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 nó được lập chỉ mục và khi nào 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 cần thiết lập Xác thực , bạn có thể định cấu hình các quy tắc của mình để truy cập công khai .

Đ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 SDK lưu trữ đám mây vào ứng dụng của bạn

Trong tệp Gradle mô-đun (cấp ứng dụng) của bạn (thường là <project>/<app-module>/build.gradle ), hãy thêm phần phụ thuộc cho thư viện Cloud Storage Android. Chúng tôi khuyên bạn nên sử dụng Firebase Android BoM để kiểm soát việc lập phiên bản thư viện.

Java

dependencies {
    // Import the BoM for the Firebase platform
    implementation platform('com.google.firebase:firebase-bom:30.5.0')

    // Add the dependency for the Cloud Storage library
    // When using the BoM, you don't specify versions in Firebase library dependencies
    implementation 'com.google.firebase:firebase-storage'
}

Bằng cách sử dụng Firebase Android BoM , ứng dụng của bạn sẽ luôn sử dụng các phiên bản tương thích của thư viện Firebase Android.

(Thay thế) Thêm phụ thuộc thư viện Firebase mà không cần sử dụng BoM

Nếu bạn chọn không sử dụng Firebase BoM, bạn phải chỉ định từng phiên bản thư viện Firebase trong dòng phụ thuộc của nó.

Lưu ý rằng nếu bạn sử dụng nhiều thư viện Firebase trong ứng dụng của mình, chúng tôi thực sự khuyên bạn nên sử dụng BoM để quản lý các phiên bản thư viện, điều này đảm bảo rằng tất cả các phiên bản đều tương thích.

dependencies {
    // Add the dependency for the Cloud Storage library
    // When NOT using the BoM, you must specify versions in Firebase library dependencies
    implementation 'com.google.firebase:firebase-storage:20.0.2'
}

Kotlin+KTX

dependencies {
    // Import the BoM for the Firebase platform
    implementation platform('com.google.firebase:firebase-bom:30.5.0')

    // Add the dependency for the Cloud Storage library
    // When using the BoM, you don't specify versions in Firebase library dependencies
    implementation 'com.google.firebase:firebase-storage-ktx'
}

Bằng cách sử dụng Firebase Android BoM , ứng dụng của bạn sẽ luôn sử dụng các phiên bản tương thích của thư viện Firebase Android.

(Thay thế) Thêm phụ thuộc thư viện Firebase mà không cần sử dụng BoM

Nếu bạn chọn không sử dụng Firebase BoM, bạn phải chỉ định từng phiên bản thư viện Firebase trong dòng phụ thuộc của nó.

Lưu ý rằng nếu bạn sử dụng nhiều thư viện Firebase trong ứng dụng của mình, chúng tôi thực sự khuyên bạn nên sử dụng BoM để quản lý các phiên bản thư viện, điều này đảm bảo rằng tất cả các phiên bản đều tương thích.

dependencies {
    // Add the dependency for the Cloud Storage library
    // When NOT using the BoM, you must specify versions in Firebase library dependencies
    implementation 'com.google.firebase:firebase-storage-ktx:20.0.2'
}

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

Bước đầu tiên để truy cập nhóm Cloud Storage của bạn là tạo một phiên bản của FirebaseStorage :

Java

FirebaseStorage storage = FirebaseStorage.getInstance();

Kotlin+KTX

storage = Firebase.storage

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

Trước tiên, hãy 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:

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 một trong hai trường hợp sử dụng này, bạn sẽ muốn sử dụng nhiều nhóm Bộ nhớ đám mây .

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 phiên bản Ứng dụng Firebase tùy chỉnh để xác thực từng 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 nhóm Bộ nhớ đám mây khác với nhóm mặc định được cung cấp ở trên hoặc sử dụng nhiều nhóm Bộ nhớ đám mây trong một ứng dụng, bạn có thể tạo một phiên bản của FirebaseStorage tham chiếu nhóm tùy chỉnh của bạn:

Java

// Get a non-default Storage bucket
FirebaseStorage storage = FirebaseStorage.getInstance("gs://my-custom-bucket");

Kotlin+KTX

// Get a non-default Storage bucket
val storage = Firebase.storage("gs://my-custom-bucket")

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

Khi nhập nhóm Bộ nhớ đám mây hiện có vào Firebase, bạn sẽ phải cấp cho Firebase khả năng truy cập 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://<your-cloud-storage-bucket>

Bạn có thể tìm thấy số dự án của mình như được 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 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 FirebaseApp tùy chỉnh, bạn có thể tạo một phiên bản FirebaseStorage được khởi tạo bằng ứng dụng đó:

Java

// Get the default bucket from a custom FirebaseApp
FirebaseStorage storage = FirebaseStorage.getInstance(customApp);

// Get a non-default bucket from a custom FirebaseApp
FirebaseStorage customStorage = FirebaseStorage.getInstance(customApp, "gs://my-custom-bucket");

Kotlin+KTX

// Get the default bucket from a custom FirebaseApp
val storage = Firebase.storage(customApp!!)

// Get a non-default bucket from a custom FirebaseApp
val customStorage = Firebase.storage(customApp, "gs://my-custom-bucket")

Bước tiếp theo