Начало работы с облачным хранилищем на платформах Apple

Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

Cloud Storage for Firebase позволяет вам загружать и делиться пользовательским контентом, таким как изображения и видео, что позволяет вам встраивать в свои приложения богатый медиаконтент. Ваши данные хранятся в контейнере Google Cloud Storage — решении для хранения объектов в масштабе экзабайт с высокой доступностью и глобальной избыточностью. Cloud Storage for Firebase позволяет вам безопасно загружать эти файлы напрямую с мобильных устройств и веб-браузеров, легко справляясь с нестабильными сетями.

Прежде чем начать

1. Если вы еще этого не сделали, убедитесь, что вы завершили руководство по началу работы с приложениями для платформ Apple . Это включает в себя:

   • Создание проекта Firebase.

   • Регистрация вашего приложения для платформы Apple в проекте и подключение вашего приложения к Firebase путем добавления библиотеки Firebase и файла конфигурации Firebase ( GoogleService-Info.plist ) в ваше приложение.

2. Убедитесь, что ваш проект Firebase находится на тарифном плане Blaze с оплатой по мере использования . Если вы новичок в Firebase и Google Cloud, проверьте, имеете ли вы право на кредит в размере 300 долларов .

Создайте контейнер Cloud Storage по умолчанию

1. На панели навигации консоли Firebase выберите Хранилище .

   Если ваш проект еще не включен в тарифный план Blaze с оплатой по факту использования, вам будет предложено обновить его.

2. Нажмите « Начать» .

3. Выберите местоположение для контейнера по умолчанию.

   • Ведра в US-CENTRAL1 , US-EAST1 и US-WEST1 может воспользоваться уровнем "Always Free" для Google Cloud Storage . Бакеты во всех других местах следуют ценам и использованию Google Cloud Storage .

   • При желании вы можете позже создать несколько контейнеров , каждый из которых будет иметь свое собственное местоположение.

4. Настройте Firebase Security Rules для вашего контейнера по умолчанию. Во время разработки рассмотрите возможность настройки правил для публичного доступа .

5. Нажмите Готово .

Теперь вы можете просмотреть контейнер на вкладке Cloud Storage Files консоли Firebase . Формат имени контейнера по умолчанию: PROJECT_ID .firebasestorage.app .

Настроить публичный доступ

Cloud Storage for Firebase предоставляет декларативный язык правил, который позволяет вам определять, как должны быть структурированы ваши данные, как они должны быть индексированы и когда ваши данные могут быть прочитаны и записаны. По умолчанию доступ для чтения и записи в Cloud Storage ограничен, поэтому только аутентифицированные пользователи могут читать или записывать данные. Чтобы начать работу без настройки Authentication , вы можете настроить правила для публичного доступа .

Это делает Cloud Storage открытым для всех, даже для людей, не использующих ваше приложение, поэтому не забудьте снова ограничить свое Cloud Storage при настройке аутентификации.

Добавьте Cloud Storage в свое приложение

Используйте Swift Package Manager для установки и управления зависимостями Firebase.

1. В Xcode откройте проект приложения и перейдите в меню Файл > Добавить пакеты .
2. При появлении соответствующего запроса добавьте репозиторий Firebase Apple platform SDK:

  https://github.com/firebase/firebase-ios-sdk.git

3. Выберите библиотеку Cloud Storage .
4. Добавьте флаг -ObjC в раздел «Другие флаги компоновщика» настроек сборки вашей цели.
5. По завершении Xcode автоматически начнет разрешать и загружать ваши зависимости в фоновом режиме.

Настройте Cloud Storage в своем приложении

1. Инициализируйте Firebase перед созданием или использованием любой ссылки Firebase.

   Возможно, вы уже сделали это, если настроили другой продукт Firebase, но вам нужно обязательно добавить библиотеку FirebaseStorage в список импорта.

   1. Импортируйте модуль FirebaseCore и модуль FirebaseStorage в ваш UIApplicationDelegate . Мы также рекомендуем добавить FirebaseAuth .

      SwiftUI

      import SwiftUI
      import FirebaseCore
      import FirebaseStorage
      import FirebaseAuth
      // ...
      

      Быстрый

      import FirebaseCore
      import FirebaseStorage
      import FirebaseAuth
      // ...
      

      Objective-C

      @import FirebaseCore;
      @import FirebaseStorage;
      @import FirebaseAuth;
      // ...
      

   2. Настройте общий экземпляр FirebaseApp в методе делегата приложения application application(_:didFinishLaunchingWithOptions:) :

      SwiftUI

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

      Быстрый

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

      Objective-C

      // Use Firebase library to configure APIs
      [FIRApp configure];
      

   3. (Только SwiftUI) Создайте делегат приложения и присоедините его к структуре App с помощью UIApplicationDelegateAdaptor или NSApplicationDelegateAdaptor . Вам также необходимо отключить swizzling делегата приложения. Для получения дополнительной информации см. инструкции SwiftUI .

      SwiftUI

      @main
      struct YourApp: App {
        // Register app delegate for Firebase setup
        @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate
      
        var body: some Scene {
          WindowGroup {
            NavigationView {
              ContentView()
            }
          }
        }
      }
      

2. Получите ссылку на службу Cloud Storage , используя приложение Firebase по умолчанию.

   1. Убедитесь, что файл конфигурации Firebase ( GoogleService-Info.plist ) в кодовой базе вашего приложения обновлен с использованием имени вашего контейнера Cloud Storage по умолчанию.

      1. Получите обновленный файл конфигурации.

      2. Используйте этот загруженный файл конфигурации для замены существующего файла GoogleService-Info.plist в корне вашего проекта Xcode. Если будет предложено, выберите добавление файла конфигурации ко всем целям.

         Убедитесь, что в вашем приложении есть только последний загруженный файл конфигурации и что к его имени не добавлены дополнительные символы, например (2) .

   2. Получите ссылку на службу Cloud Storage , используя приложение Firebase по умолчанию:

      Быстрый

      let storage = Storage.storage()

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

      Objective-C

      FIRStorage *storage = [FIRStorage storage];

      // Alternatively, explicitly specify the bucket name URL.
      // FIRStorage storage = [FIRStorage storageWithURL:@"gs://BUCKET_NAME"];

Вы готовы начать использовать Cloud Storage !

Следующий шаг? Узнайте, как создать ссылку на Cloud Storage .

Расширенная настройка

Есть несколько вариантов использования, требующих дополнительной настройки:

• Использование Cloud Storage в нескольких географических регионах
• Использование контейнеров Cloud Storage в разных классах хранения
• Использование Cloud Storage с несколькими аутентифицированными пользователями в одном приложении

Первый вариант использования идеален, если у вас есть пользователи по всему миру, и вы хотите хранить их данные рядом с ними. Например, вы можете создать контейнеры в США, Европе и Азии для хранения данных пользователей в этих регионах, чтобы сократить задержку.

Второй вариант использования полезен, если у вас есть данные с разными шаблонами доступа. Например: вы можете настроить мультирегиональный или региональный контейнер, который хранит изображения или другой часто используемый контент, и nearline или coldline контейнер, который хранит резервные копии пользователей или другой редко используемый контент.

В любом из этих случаев вам понадобится использовать несколько контейнеров Cloud Storage .

Третий вариант использования полезен, если вы создаете приложение, например Google Drive, которое позволяет пользователям иметь несколько учетных записей для входа (например, личную учетную запись и рабочую учетную запись). Вы можете использовать пользовательский экземпляр Firebase App для аутентификации каждой дополнительной учетной записи.

Используйте несколько Cloud Storage

Если вы хотите использовать контейнер Cloud Storage отличный от указанного выше по умолчанию, или использовать несколько контейнеров Cloud Storage в одном приложении, вы можете создать экземпляр FIRStorage , который ссылается на ваш пользовательский контейнер:

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

// Get a non-default Cloud Storage bucket
FIRStorage storage = [FIRStorage storageWithURL:@"gs://my-custom-bucket"];
    

Работа с импортными ковшами

При импорте существующего контейнера 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

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

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