Android에서 Cloud Storage 시작하기

Cloud Storage for Firebase을(를) 통해 다음과 같은 사용자 제작 콘텐츠를 업로드하고 공유할 수 있습니다. 광고를 이미지와 동영상으로 만들 수 있습니다. 이를 통해 웹사이트에 리치 미디어 콘텐츠를 있습니다. 데이터는 Google Cloud Storage 버킷 — 엑사바이트급 규모의 객체 스토리지 솔루션으로서 이중화. Cloud Storage for Firebase을(를) 통해 이러한 파일을 안전하게 업로드할 수 있습니다. 모바일 장치 및 웹 브라우저에서 직접 연결되고, 인터넷 연결로 인해 있습니다.

기본 요건

아직 추가하지 않았다면 Android 프로젝트에 Firebase를 추가합니다.

기본 Cloud Storage 버킷 만들기

  1. Firebase 콘솔의 탐색창에서 Storage를 선택합니다. 시작하기를 클릭합니다.

  2. 보안을 사용하여 Cloud Storage 데이터를 보호하는 방법에 관한 메시지 검토 있습니다. 개발 중에는 공개 액세스 규칙 설정

  3. 기본 위치를 선택합니다. Cloud Storage 버킷

    • 이 위치 설정이 프로젝트의 기본 Google Cloud Platform(GCP) 리소스 위치입니다. 이 위치는 프로젝트의 GCP 서비스에 사용됩니다. 위치 설정이 필요한 광고를 게재합니다. Cloud Firestore 데이터베이스 및 App Engine 앱 (Cloud Scheduler를 사용하는 경우 필수)

    • 위치를 선택할 수 없다면 프로젝트에 이미 기본 GCP 리소스 위치가 있는 것입니다. 이 위치는 프로젝트 생성 과정이나 위치 설정이 필요한 다른 서비스를 설정할 때 지정한 것입니다.

    Blaze 요금제에서는 각 위치가 설정된 버킷을 여러 개 만들 수 있습니다.

  4. 완료를 클릭합니다.

공개 액세스 설정

Cloud Storage for Firebase는 선언적 규칙 언어를 제공하므로 이를 통해 데이터의 구조, 색인 생성 방법 및 시기 정의 데이터를 읽고 쓸 수 있습니다 기본적으로 Cloud Storage 앱은 인증된 사용자만 읽거나 쓸 수 있도록 제한됩니다. 데이터입니다. Authentication을 설정하지 않고 시작하려면 공개 액세스 규칙을 구성하면 됩니다.

이렇게 하면 내 기기를 사용하지 않는 사람을 포함하여 모두에게 Cloud Storage이(가) 공개됩니다. 설정 시 Cloud Storage을(를) 다시 제한하세요. 있습니다.

앱에 Cloud Storage SDK 추가

모듈 (앱 수준) Gradle 파일에서 (일반적으로 <project>/<app-module>/build.gradle.kts 또는 <project>/<app-module>/build.gradle), Android용 Cloud Storage 라이브러리의 종속 항목을 추가합니다. 이때 Firebase Android BoM 드림 라이브러리 버전 관리를 제어할 수 있습니다. 

dependencies {
    // Import the BoM for the Firebase platform
    implementation(platform("com.google.firebase:firebase-bom:33.2.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")
}

Firebase Android BoM를 사용하면 앱은 항상 호환되는 Firebase Android 라이브러리 버전만 사용합니다.

(대안) BoM를 사용하지 않고 Firebase 라이브러리 종속 항목을 추가합니다.

Firebase BoM를 사용하지 않도록 선택하는 경우 각 Firebase 라이브러리 버전을 지정해야 합니다. 를 사용해야 합니다.

앱에서 여러 Firebase 라이브러리를 사용하는 경우 BoM를 사용하여 라이브러리 버전을 관리하는 것이 좋습니다. 이렇게 하면 모든 버전이 지원합니다. 

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:21.0.0")
}
 드림 Kotlin 전용 라이브러리 모듈을 찾고 계신가요? 시작까지 남은 시간: 2023년 10월 (Firebase BoM 32.5.0), Kotlin 및 Java 개발자 모두 기본 라이브러리 모듈에 종속됩니다. 자세한 내용은 이 이니셔티브에 관한 FAQ).

Cloud Storage 설정

Cloud Storage 버킷에 액세스하는 첫 번째 단계는 FirebaseStorage의 인스턴스:

Kotlin+KTX 

storage = Firebase.storage
StorageActivity.kt

Java 

FirebaseStorage storage = FirebaseStorage.getInstance();
StorageActivity.java

이제 Cloud Storage을(를) 사용할 준비가 되었습니다.

먼저 Cloud Storage를 만드는 방법을 알아보세요. 참조

고급 설정

다음 사용 사례에는 추가 설정이 필요합니다.

첫 번째 사용 사례는 사용자가 전 세계에 분포해 있고 사용자와 가까운 곳에 데이터를 저장하려는 경우에 적합합니다. 예를 들어 미국, 유럽, 아시아에 버킷을 만들고 해당 리전 사용자의 데이터를 저장하면 지연 시간을 줄일 수 있습니다.

두 번째 사용 사례는 데이터의 액세스 패턴이 다양할 때 유용합니다. 예를 들어 사진과 같은 자주 액세스하는 콘텐츠를 저장하는 멀티 리전 또는 리전 버킷을 설정하고, 사용자 백업과 같은 자주 액세스하지 않는 콘텐츠를 저장하는 Nearline 또는 Coldline 버킷을 설정할 수 있습니다.

이러한 사용 사례에서는 여러 Cloud Storage 버킷 사용

세 번째 사용 사례는 Google Drive와 같이 사용자가 여러 개의 계정(예: 개인용 계정과 업무용 계정)으로 로그인할 수 있는 앱을 빌드할 때 유용합니다. 커스텀 Firebase 앱 인스턴스를 사용하여 추가 계정을 각각 인증할 수 있습니다.

여러 Cloud Storage 버킷 사용

위에 제공된 기본값 이외의 Cloud Storage 버킷을 사용하려면 다음 안내를 따르세요. 단일 앱에서 여러 Cloud Storage 버킷을 사용하려는 경우 인스턴스를 만들어 커스텀 버킷을 참조하는 FirebaseStorage 그룹:

Kotlin+KTX 

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

Java 

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

가져온 버킷 활용하기

기존 Cloud Storage 버킷을 Firebase로 가져올 때 다음을 수행합니다. 파일에 액세스할 수 있도록 Firebase에 권한을 부여해야 합니다. gsutil 도구( Google Cloud SDK:

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

Firebase 프로젝트 소개에 설명된 대로 프로젝트 번호를 확인할 수 있습니다.

새로 생성된 버킷은 액세스 제어에서 Firebase를 허용하도록 기본 설정되어 있으므로 이에 영향을 받지 않습니다. 이는 일시적인 조치로 향후 자동으로 수행될 예정입니다.

커스텀 Firebase 앱 사용

커스텀 FirebaseApp을 사용하여 보다 복잡한 앱을 빌드하는 경우 해당 앱으로 초기화된 FirebaseStorage 인스턴스를 만들 수 있습니다.

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")
StorageActivity.kt

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");
StorageActivity.java

다음 단계