با Cloud Storage در Android شروع کنید

dependencies {
    // Import the BoM for the Firebase platform
    implementation(platform("com.google.firebase:firebase-bom:33.7.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 استفاده می‌کند.

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.1")
}

Cloud Storage در برنامه خود راه اندازی کنید

1. مطمئن شوید که فایل پیکربندی Firebase ( google-services.json ) در پایگاه کد برنامه شما با نام سطل Cloud Storage پیش فرض شما به روز شده است.

   1. فایل پیکربندی به روز شده خود را دریافت کنید. .

   2. از این فایل پیکربندی دانلود شده برای جایگزینی فایل google-services.json موجود در فهرست ماژول (سطح برنامه) برنامه خود استفاده کنید.

      مطمئن شوید که فقط آخرین فایل پیکربندی دانلود شده را در برنامه خود دارید و نام فایل آن با کاراکترهای اضافی مانند (2) ضمیمه نشده باشد.

2. با ایجاد نمونه ای از FirebaseStorage به سطل Cloud Storage خود دسترسی پیدا کنید:

   Kotlin+KTX

   storage = Firebase.storage
   StorageActivity.kt

   // Alternatively, explicitly specify the bucket name URL.
   // val storage = Firebase.storage("gs://BUCKET_NAME")

   Java

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

   // Alternatively, explicitly specify the bucket name URL.
   // FirebaseStorage storage = FirebaseStorage.getInstance("gs://BUCKET_NAME");

شما آماده شروع استفاده از Cloud Storage هستید!

مرحله بعدی؟ با نحوه ایجاد یک مرجع Cloud Storage آشنا شوید.

راه اندازی پیشرفته

چند مورد استفاده وجود دارد که نیاز به تنظیمات اضافی دارد:

• استفاده از سطل های Cloud Storage در چندین منطقه جغرافیایی
• استفاده از سطل های Cloud Storage در کلاس های ذخیره سازی مختلف
• استفاده از سطل‌های Cloud Storage با چندین کاربر احراز هویت شده در یک برنامه

اولین مورد استفاده اگر کاربرانی در سراسر جهان دارید و می خواهید داده های آنها را در نزدیکی آنها ذخیره کنید، عالی است. به عنوان مثال، می‌توانید سطل‌هایی در ایالات متحده، اروپا و آسیا ایجاد کنید تا داده‌ها را برای کاربران در آن مناطق ذخیره کنید تا تأخیر را کاهش دهید.

مورد دوم اگر داده هایی با الگوهای دسترسی متفاوت دارید مفید است. به عنوان مثال: می‌توانید یک سطل چند منطقه‌ای یا منطقه‌ای راه‌اندازی کنید که تصاویر یا سایر محتوایی که اغلب به آنها دسترسی دارد را ذخیره می‌کند، و یک سطل نزدیک یا سرد که پشتیبان‌گیری‌های کاربر یا سایر محتوای غیرقابل دسترسی را ذخیره می‌کند.

در هر یک از این موارد استفاده، می‌خواهید از چند سطل Cloud Storage استفاده کنید .

مورد سوم در صورتی مفید است که در حال ساختن برنامه‌ای مانند Google Drive هستید که به کاربران امکان می‌دهد چندین حساب وارد شده (به عنوان مثال، یک حساب شخصی و یک حساب کاری) داشته باشند. می توانید از یک نمونه برنامه Firebase سفارشی برای احراز هویت هر حساب اضافی استفاده کنید .

از چند سطل Cloud Storage استفاده کنید

اگر می‌خواهید از یک سطل Cloud Storage غیر از سطل پیش‌فرض که قبلاً در این راهنما توضیح داده شد استفاده کنید، یا از چندین سطل Cloud Storage در یک برنامه استفاده کنید، می‌توانید نمونه‌ای از FirebaseStorage ایجاد کنید که به سطل سفارشی شما ارجاع دهد:

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

// 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://BUCKET_NAME

می توانید شماره پروژه خود را همانطور که در مقدمه پروژه های Firebase توضیح داده شده است، پیدا کنید.

این روی سطل‌های تازه ایجاد شده تأثیری نمی‌گذارد، زیرا آن‌ها دارای تنظیم پیش‌فرض کنترل دسترسی برای اجازه دادن به Firebase هستند. این یک اقدام موقت است و در آینده به صورت خودکار انجام خواهد شد.

از یک برنامه Firebase سفارشی استفاده کنید

اگر با استفاده از FirebaseApp سفارشی برنامه پیچیده‌تری می‌سازید، می‌توانید یک نمونه از FirebaseStorage که با آن برنامه مقداردهی شده است ایجاد کنید:

// 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

// 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

مراحل بعدی

• برای راه اندازی برنامه خود آماده شوید:

  • برای اطمینان از اینکه فقط برنامه‌های شما می‌توانند به سطل‌های ذخیره‌سازی شما دسترسی داشته باشند، App Check فعال کنید.

  • هشدارهای بودجه را برای پروژه خود در کنسول Google Cloud تنظیم کنید.

  • داشبورد استفاده و صورت‌حساب را در کنسول Firebase نظارت کنید تا تصویری کلی از استفاده از پروژه خود در چندین سرویس Firebase داشته باشید. همچنین می‌توانید برای اطلاعات بیشتر در مورد استفاده، از داشبورد استفاده از Cloud Storage دیدن کنید.

  • چک لیست راه اندازی Firebase را مرور کنید.