Unlimited Plugins, WordPress themes, videos & courses! Unlimited asset downloads! From $16.50/m
Advertisement
  1. Code
  2. Android SDK
Code

Firebase для Android: хранилище файлов

by
Difficulty:BeginnerLength:MediumLanguages:

Russian (Pусский) translation by Ilya Nikov (you can also view the original English article)

Во время конференции Google I/O в 2016 году Firebase была вновь представлена сообществу разработчиков в качестве основного инструмента для быстрой поддержки веб-страниц и мобильных приложений. В этом руководстве вы познакомитесь с функциями хранения и извлечения файлов, доступными для ваших приложений Android.

Чтобы узнать больше о базе данных Firebase в реальном времени, аналитике, отчетах о сбоях и аутентификации, ознакомьтесь с некоторыми нашими другими учебниками здесь, в Envato Tuts +.

Настройка проверки подлинности

Для краткости мы пропустим общий процесс настройки  Firebase в вашем приложении Android и консоли Firebase. Если вы впервые пытаетесь использовать Firebase в приложении, я предлагаю сначала проверить статью Ashraff Hathibelagal «Начало работы с Firebase для Android».

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

Firebase storage section navigation

Затем вы заметите, что в верхней части экрана Storage находятся две вкладки: Файлы и Правила.

Rules tab in Firebase storage

Перейдите на вкладку «Правила», и в строке allow read, write: if request.auth != null; измените != на == и нажмите кнопку ОПУБЛИКОВАТЬ.

Authentication rules for Firebase storage access

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

Загрузка файлов вручную

Хотя возможность загрузки файлов из приложения очень удобная, иногда вы просто хотите хранить файлы где-то, где можно легко получить доступ и скачать их в ваше приложение. Здесь вы можете загружать файлы вручную из Firebase Console. На вкладке «Файлы» вы увидите синюю кнопку «Загрузить файл».

Button for manually uploading files to Firebase storage

Щелкните ее и выберите файл, который вы хотите загрузить, и он появится в вашем хранилище Firebase.

An uploaded file

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

An uploaded file details

Загрузка файлов из приложения для Android

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

Чтобы получить доступ к файлам хранилища Firebase, вам нужно сначала получить ссылку на объект FirebaseStorage, а затем создать StorageReference на URL вашего проекта и файл, который вы хотите загрузить. URL вашего проекта можно найти в верхней части раздела «Файлы» Хранилища в Firebase Console.

Затем вы можете создать объект File и попытаться загрузить нужный файл, вызвав getFile у вашего StorageReference с новым объектом File, переданным в качестве параметра. Поскольку эта операция выполняется асинхронно, вы можете добавить OnSuccessListener и OnFailureListener к вашему вызову, чтобы справляться с непредвиденными обстоятельствами.

В onSuccess() из OnSuccessListener вы можете взять объект FileDownloadTask.TaskSnapshot и получить файл, из которого мы установим изображение в наш ImageView.

Image downloaded from Firebase storage displayed in app

Загрузка файлов в виде массива байтов

Если вам нужно только загрузить файл в виде byte[], и он не нужен вам в качестве файла, что является более вероятным случаем при загрузке изображения в ImageView, тогда вы можете получить байты аналогичным образом.

Получение URL-адреса файла

Могут быть ситуации, когда вам не нужны фактические данные для сохраненного файла, но скорее будет нужен URL. Вы можете сделать это аналогично двум последним примерам, используя метод getDownloadUrl() на вашем StorageReference, который даст вам Uri, указывающий на местоположение файла.

Вышеуказанный метод распечатает URL-адрес изображения, которое мы вручную загрузили ранее в Android-мониторе.

Загрузка из Android приложения

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

Загрузка массива байтов

Как и при загрузке, вам нужно будет получить ссылку на объект FirebaseStorage и создать ссылку на место хранения вашего нового файла в качестве StorageReference. В этом примере мы покажем ic_launcher.png в нашем ImageView, а затем загрузим его как массив байтов.

Затем нам нужно будет получить массив байтов из изображения, хранящегося в памяти, через ImageView. Это делается путем извлечения его в виде Bitmap, сжимающего его в ByteArrayOutputStream, а затем превращая его в byte[].

Наконец, вы можете создать UploadTask, вызвав putBytes(byte[]), чтобы загрузить изображение в Firebase. В этом UploadTask также могут быть связанные с ним OnSuccessListener и OnFailureListener.

Когда вы проверяете страницу хранилища Firebase Console, вы должны увидеть ic_launcher.png в своем списке файлов.

Details from a programmatically uploaded image

Загрузка из InputStream или файла

Теперь, когда вы знаете, как загрузить массив байтов, два других типа загрузок должны быть достаточно интуитивно понятными. Допустим, у нас есть текстовый файл с именем test.txt в нашей папке с исходными ресурсами. Мы можем прочитать его в InputStream, а затем загрузить его, используя метод putStream(InputStream)  у StorageReference.

List of uploaded images including text file from InputStream

Загрузка существующего файла так же делается довольно легко: просто получите ссылку на файл и вызовите putFile(Uri) с URI, указывающим на ваш файл. В этом примере мы просто создадим пустой файл temp в нашем коде.

Raw file upload shown in Firebase storage

Управление загрузками и использование обратных вызовов

Пока файлы, которые мы загрузили до сих пор, были небольшими, могут быть случаи, когда у вас будут большие загрузки, которые занимают достаточно много времени. Firebase предоставляет несколько методов с UploadTask, которые позволят вам контролировать поток загрузки и слушать изменения прогресса и состояния. Эти методы включают pause(), resume() и cancel(). pause() и resume() позволят вам приостановить и возобновить UploadTask, тогда как cancel() полностью остановит ее. Кроме того, вы можете использовать OnPauseListener и OnProgressListener, чтобы отслеживать состояния загрузки и состояния паузы.

Вышеприведенный код позволит вам контролировать процесс загрузки для несколько большого (1 МБ, в данном случае) изображения и видеть его состояния, изменяющиеся в логах Android, когда нажаты кнопки паузы и возобновления.

Обработка жизненного цикла Android Activity

Как может подтвердить любой разработчик Android, иногда жизненный цикл Android  Activityможет вызвать непредвиденные проблемы. Одним из распространенных источников проблем является прослушивание, которое длится дольше, чем их родительская Activity, что может быть причиной для успешного или неуспешного завершения слушаетелй, связанных с задачей хранения Firebase.

Если Activity уничтожается и воссоздается (например, при вращении экрана) во время выполнения задачи, вы можете получить исключение NullPointerException, когда задача завершится. Чтобы этого избежать, вам нужно сохранить свой StorageReference в виде String в своем исходном Bundle в методе onSaveInstanceState(Bundle), а затем восстановить его и добавить слушателей успеха в каждую FileDownloadTask или FileUploadTask, связанную с этим StorageReference.

Вывод

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

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

А пока ознакомьтесь с некоторыми другими нашими статьями по разработке Android!

Advertisement
Advertisement
Advertisement
Advertisement
Looking for something to help kick start your next project?
Envato Market has a range of items for sale to help get you started.