Создайте эталон облачного хранилища на платформах Apple

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

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

Создать ссылку

Создайте ссылку для загрузки, скачивания или удаления файла, а также для получения или обновления его метаданных. Ссылку можно рассматривать как указатель на файл в облаке. Ссылки легковесны, поэтому вы можете создавать столько, сколько вам нужно. Их также можно использовать повторно для нескольких операций.

Ссылки создаются с помощью FirebaseStorage службы и вызова его reference метода.

Быстрый

// Get a reference to the storage service using the default Firebase App
let storage = Storage.storage()

// Create a storage reference from our storage service
let storageRef = storage.reference()
    

Цель-C

// Get a reference to the storage service using the default Firebase App
FIRStorage *storage = [FIRStorage storage];

// Create a storage reference from our storage service
FIRStorageReference *storageRef = [storage reference];
    

Вы можете создать ссылку на место ниже в дереве, скажем , 'images/space.jpg' , используя child метод на существующую ссылке.

Быстрый

// Create a child reference
// imagesRef now points to "images"
let imagesRef = storageRef.child("images")

// Child references can also take paths delimited by '/'
// spaceRef now points to "images/space.jpg"
// imagesRef still points to "images"
var spaceRef = storageRef.child("images/space.jpg")

// This is equivalent to creating the full reference
let storagePath = "\(your_firebase_storage_bucket)/images/space.jpg"
spaceRef = storage.reference(forURL: storagePath)
    

Цель-C

// Create a child reference
// imagesRef now points to "images"
FIRStorageReference *imagesRef = [storageRef child:@"images"];

// Child references can also take paths delimited by '/'
// spaceRef now points to "images/space.jpg"
// imagesRef still points to "images"
FIRStorageReference *spaceRef = [storageRef child:@"images/space.jpg"];

// This is equivalent to creating the full reference
spaceRef = [storage referenceForURL:@"gs://<your-firebase-storage-bucket>/images/space.jpg"];
     

Вы можете также использовать parent и root методы для навигации в нашей иерархии файлов. parent Перемещение вверх на один уровень, в то время как root переходит весь путь к вершине.

Быстрый

// Parent allows us to move to the parent of a reference
// imagesRef now points to 'images'
let imagesRef = spaceRef.parent()

// Root allows us to move all the way back to the top of our bucket
// rootRef now points to the root
let rootRef = spaceRef.root()
    

Цель-C

// Parent allows us to move to the parent of a reference
// imagesRef now points to 'images'
imagesRef = [spaceRef parent];

// Root allows us to move all the way back to the top of our bucket
// rootRef now points to the root
FIRStorageReference *rootRef = [spaceRef root];
    

child , parent , и root может быть соединены друг с другом несколько раз, так как каждый возвращает ссылку. Исключением является parent из root , который является nil .

Быстрый

// References can be chained together multiple times
// earthRef points to "images/earth.jpg"
let earthRef = spaceRef.parent()?.child("earth.jpg")

// nilRef is nil, since the parent of root is nil
let nilRef = spaceRef.root().parent()
    

Цель-C

// References can be chained together multiple times
// earthRef points to "images/earth.jpg"
FIRStorageReference *earthRef = [[spaceRef parent] child:@"earth.jpg"];

// nilRef is nil, since the parent of root is nil
FIRStorageReference *nilRef = [[spaceRef root] parent];
    

Справочные свойства

Вы можете проверить ссылки , чтобы лучше понять файлы , которые они указывают на использование fullPath , name и bucket свойства. Эти свойства получают полный путь, имя и сегмент файла.

Быстрый

// Reference's path is: "images/space.jpg"
// This is analogous to a file path on disk
spaceRef.fullPath

// Reference's name is the last segment of the full path: "space.jpg"
// This is analogous to the file name
spaceRef.name

// Reference's bucket is the name of the storage bucket where files are stored
spaceRef.bucket
    

Цель-C

// Reference's path is: "images/space.jpg"
// This is analogous to a file path on disk
spaceRef.fullPath;

// Reference's name is the last segment of the full path: "space.jpg"
// This is analogous to the file name
spaceRef.name;

// Reference's bucket is the name of the storage bucket where files are stored
spaceRef.bucket;
    

Ограничения на ссылки

Пути и имена ссылок могут содержать любую последовательность допустимых символов Unicode, но налагаются определенные ограничения, в том числе:

  1. Общая длина reference.fullPath должна быть от 1 до 1024 байтов в кодировке UTF-8.
  2. Нет символов возврата каретки или перевода строки.
  3. Избегайте использования # , [ , ] , * или ? , Так как они не очень хорошо работать с другими инструментами , такими как базы данных Firebase в реальном времени или GSUtil .

Полный пример

Быстрый

// Points to the root reference
let storageRef = Storage.storage().reference()

// Points to "images"
let imagesRef = storageRef.child("images")

// Points to "images/space.jpg"
// Note that you can use variables to create child values
let fileName = "space.jpg"
let spaceRef = imagesRef.child(fileName)

// File path is "images/space.jpg"
let path = spaceRef.fullPath;

// File name is "space.jpg"
let name = spaceRef.name;

// Points to "images"
let images = spaceRef.parent()
    

Цель-C

// Points to the root reference
FIRStorageReference *storageRef = [[FIRStorage storage] reference];

// Points to "images"
FIRStorageReference *imagesRef = [storageRef child:@"images"];

// Points to "images/space.jpg"
// Note that you can use variables to create child values
NSString *fileName = @"space.jpg";
FIRStorageReference *spaceRef = [imagesRef child:fileName];

// File path is "images/space.jpg"
NSString *path = spaceRef.fullPath;

// File name is "space.jpg"
NSString *name = spaceRef.name;

// Points to "images"
imagesRef = [spaceRef parent];
    

Далее, давайте узнаем , как загружать файлы в облачном хранилище.