Join us for Firebase Summit on November 10, 2021. Tune in to learn how Firebase can help you accelerate app development, release with confidence, and scale with ease. Register

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

فضای ذخیره سازی ابری برای Firebase به شما امکان می دهد محتوای ایجاد شده توسط کاربر ، مانند تصاویر و ویدئو را بارگذاری و به اشتراک بگذارید ، که به شما امکان می دهد محتوای رسانه غنی را در برنامه های خود ایجاد کنید. اطلاعات شما در یک ذخیره می شود گوگل ابر ذخیره سازی راه حل ذخیره سازی جسم در مقیاس اگزابایت با در دسترس بودن بالا و افزونگی جهانی - سطل. فضای ذخیره سازی ابری برای Firebase به شما امکان می دهد این فایل ها را مستقیماً از دستگاه های تلفن همراه و مرورگرهای وب بارگذاری کنید و به راحتی با شبکه های لکه دار کار کنید.

پیش نیازها

اگر شما در حال حاضر، اضافه فایربیس به پروژه آندروید خود را .

یک سطل ذخیره سازی پیش فرض Cloud Storage ایجاد کنید

  1. از پیمایش از فایربیس کنسول ، ذخیره سازی را انتخاب کنید، سپس با کلیک آغاز شده است.

  2. پیام های مربوط به امنیت داده های Cloud Storage خود را با استفاده از قوانین امنیتی مرور کنید. در طول توسعه، در نظر راه اندازی قوانین خود را برای دسترسی عموم مردم .

  3. یک SELECT محل برای پیش فرض سطل ابر ذخیره سازی خود را.

    • این تنظیم محل پروژه شما است محل منابع پلتفرم ابری گوگل (GCP) به طور پیش فرض . توجه داشته باشید که این مکان خواهد شد برای خدمات GCP در پروژه خود که نیاز به تنظیم محل، به طور خاص، خود را مورد استفاده قرار ابر Firestore پایگاه داده و خود را موتور برنامه برنامه (که مورد نیاز است در صورت استفاده از ابر زمانبند).

    • اگر نمی توانید مکانی را انتخاب کنید ، پروژه شما از قبل دارای موقعیت منبع پیش فرض GCP است. یا هنگام ایجاد پروژه یا هنگام راه اندازی سرویس دیگری که نیاز به تنظیم موقعیت مکانی دارد تنظیم شد.

    اگر شما بر روی طرح فروغ، شما می توانید سطل های متعدد ایجاد ، هر کدام با خود را به محل .

  4. کلیک کنید انجام می شود.

راه اندازی دسترسی عمومی

Cloud Storage for Firebase یک زبان قوانین اعلانی را ارائه می دهد که به شما امکان می دهد نحوه ساختار داده های خود ، نحوه نمایه سازی آنها و زمان خواندن و نوشتن داده ها را برای آنها تعریف کنید. به طور پیش فرض ، دسترسی به خواندن و نوشتن به Cloud Storage محدود است ، بنابراین فقط کاربران تأیید شده می توانند داده ها را بخوانند یا بنویسند. برای شروع بدون راه اندازی احراز هویت ، شما می توانید قوانین خود را برای دسترسی عموم پیکربندی .

این باعث می شود Cloud Storage برای همه باز شود ، حتی افرادی که از برنامه شما استفاده نمی کنند ، بنابراین هنگام تنظیم احراز هویت ، حتماً Cloud Storage خود را دوباره محدود کنید.

SDK ذخیره سازی ابری را به برنامه خود اضافه کنید

با استفاده از فایربیس آندروید BOM ، اعلام وابستگی برای کتابخانه ابر ذخیره سازی آندروید در ماژول خود را (در سطح برنامه) فایل Gradle (معمولا app/build.gradle ).

جاوا

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

    // Declare 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'
}

با استفاده از فایربیس آندروید BOM ، برنامه شما همیشه نسخه های سازگار با کتابخانه فایربیس آندروید استفاده خواهد کرد.

(جایگزین) اعلام فایربیس وابستگی کتابخانه بدون استفاده از BOM

در صورت عدم استفاده از Firebase BoM ، باید هر نسخه کتابخانه Firebase را در خط وابستگی مشخص کنید.

توجه داشته باشید که در صورت استفاده از کتابخانه فایربیس های متعدد در برنامه شما، ما به شدت توصیه با استفاده از BOM به مدیریت نسخه های کتابخانه، که تضمین می کند که تمام نسخه های سازگار است.

dependencies {
    // Declare 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.0'
}

Kotlin+KTX

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

    // Declare 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'
}

با استفاده از فایربیس آندروید BOM ، برنامه شما همیشه نسخه های سازگار با کتابخانه فایربیس آندروید استفاده خواهد کرد.

(جایگزین) اعلام فایربیس وابستگی کتابخانه بدون استفاده از BOM

در صورت عدم استفاده از Firebase BoM ، باید هر نسخه کتابخانه Firebase را در خط وابستگی مشخص کنید.

توجه داشته باشید که در صورت استفاده از کتابخانه فایربیس های متعدد در برنامه شما، ما به شدت توصیه با استفاده از BOM به مدیریت نسخه های کتابخانه، که تضمین می کند که تمام نسخه های سازگار است.

dependencies {
    // Declare 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.0'
}

Cloud Storage را راه اندازی کنید

اولین گام در دسترسی به سطل ابر ذخیره سازی خود را برای ایجاد یک نمونه از FirebaseStorage :

جاوا

FirebaseStorage storage = FirebaseStorage.getInstance();

Kotlin+KTX

storage = Firebase.storage

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

اول، اجازه دهید یاد بگیرند که چگونه به ایجاد یک مرجع ابر ذخیره سازی .

تنظیمات پیشرفته

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

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

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

در هر کدام از این موارد استفاده، شما می خواهید به استفاده از چند سطل ابر ذخیره سازی .

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

از چندین سطل ذخیره سازی ابری استفاده کنید

اگر شما می خواهید به استفاده از ذخیره سازی ابر سطل دیگر از پیش فرض ارائه شده در بالا، یا استفاده از چندین سطل ابر ذخیره سازی در یک برنامه واحد، شما می توانید یک نمونه از ایجاد FirebaseStorage که مراجع سطل سفارشی خود را:

جاوا

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

کار با سطل های وارداتی

هنگام وارد کردن موجود سطل ابر ذخیره سازی به فایربیس، شما باید به اعطای فایربیس توانایی دسترسی به این فایل ها با استفاده از gsutil ابزار، از جمله در گوگل ابر SDK :

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

شما می توانید تعداد پروژه خود را همانطور که در توصیف پیدا معرفی به پروژه های فایربیس .

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

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

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

جاوا

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

مراحل بعدی