Эта страница переведена с помощью Cloud Translation API.

Exifinterface

Справочник API
androidx.exifinterface.media

Чтение и запись EXIF-тегов файлов изображений.

Последнее обновление	Стабильный релиз	Кандидат на релиз	Бета-версия	Альфа-релиз
3 декабря 2025 г.	1.4.2	-	-	-

Объявление зависимостей

Чтобы добавить зависимость от Exifinterface, необходимо добавить репозиторий Google Maven в свой проект. Подробнее см. в репозитории Google Maven .

Добавьте зависимости для необходимых артефактов в файл build.gradle вашего приложения или модуля:

классный

dependencies {
    implementation "androidx.exifinterface:exifinterface:1.4.2"
}

Котлин

dependencies {
    implementation("androidx.exifinterface:exifinterface:1.4.2")
}

Дополнительные сведения о зависимостях см. в разделе Добавление зависимостей сборки .

Обратная связь

Ваши отзывы помогают улучшить Jetpack. Сообщите нам, если вы обнаружите новые проблемы или у вас есть идеи по улучшению этой библиотеки. Пожалуйста, ознакомьтесь с уже существующими проблемами в этой библиотеке, прежде чем создавать новую. Вы можете проголосовать за существующую проблему, нажав на кнопку со звёздочкой.

Создать новый выпуск

Более подробную информацию см. в документации по системе отслеживания проблем .

Версия 1.4

Версия 1.4.2

3 декабря 2025 г.

Выпущен androidx.exifinterface:exifinterface:1.4.2 . Версия 1.4.2 содержит следующие коммиты .

Исправления ошибок

Поддержка анализа JPEG-файлов с дополнительными (разрешенными) байтами 0xFF перед любым маркером.

Версия 1.4.1

23 апреля 2025 г.

Выпущен androidx.exifinterface:exifinterface:1.4.1 . Версия 1.4.1 содержит следующие коммиты .

Исправления ошибок

Исправлена ошибка, из-за которой передача null в setAttribute для TAG_XMP приводила к возникновению исключения.

Версия 1.4.0

26 февраля 2025 г.

Выпущен androidx.exifinterface:exifinterface:1.4.0 . Версия 1.4.0 содержит следующие коммиты .

Версия 1.4.0-rc01

29 января 2025 г.

androidx.exifinterface:exifinterface:1.4.0-rc01 выпущен без изменений с версии beta01. Версия 1.4.0-rc01 содержит следующие коммиты .

Версия 1.4.0-beta01

15 января 2025 г.

Выпущен androidx.exifinterface:exifinterface:1.4.0-beta01 . Версия 1.4.0-beta01 содержит следующие коммиты .

Изменения API

Обновите обработку HEIC XMP, чтобы отдавать предпочтение данным XMP из отдельного сегмента в файле, а не тегу 700 в данных Exif.

Исправления ошибок

Исправлен метод ExifInterface.getThumbnail*() для корректной работы после вызова saveAttributes() (ранее вызовы выполнялись успешно, но результат был неверным/неопределенным).
Исправлена обработка PNG XMP для чтения и записи отдельного блока iTXt XMP вместо тега 700 внутри блока eXIf.
Исправление повреждения изображений WebP при обработке файлов изображений с конечными данными, отличными от WebP. ( b/385766064 ).

Версия 1.4.0-альфа01

13 ноября 2024 г.

Выпущен androidx.exifinterface:exifinterface:1.4.0-alpha01 . Версия 1.4.0-alpha01 содержит следующие коммиты .

Новые функции

Добавить поддержку чтения данных XMP из изображений HEIF.
Добавить поддержку чтения Exif и XMP из изображений AVIF.

Изменения API

Укажите, что параметр location для setGpsInfo — @Nullable и что передача значения null приведет к ошибке No-Op. ( If924c , b/236484611 )

Исправления ошибок

Продолжить анализ после обнаружения недопустимого смещения IFD ( b/264729367 ).
Обрабатывать изображения WebP, которые ошибочно содержат маркер JPEG APP1 перед данными Exif ( b/281638358 ).
Убедитесь, что изменения XMP в JPEG-файлах с отдельным сегментом XMP сохраняются в том же отдельном сегменте XMP с помощью saveAttributes() , а не записываются в тег TIFF/Exif 700, который не поддерживается спецификацией XMP и в котором многие инструменты их не найдут.
Избегайте дублирования данных XMP из отдельного сегмента в каталоге предварительного просмотра TIFF при сохранении ( b/309843390 ).
Повысить точность преобразований чисел двойной точности в рациональные числа. ( b/312680558 ).
Принимает рациональный формат (x/y) для setAttribute для «старых» рациональных тегов, которые автоматически преобразуются в десятичные при возврате из getAttribute ( b/312680558 ).
Убедитесь, что данные XMP, добавляемые к изображению JPEG, которое ещё не содержит XMP, записаны в отдельный сегмент, как указано в спецификации XMP. ExifInterface документирован как предпочитающий XMP в теге Exif 700 в изображениях JPEG (нарушая спецификацию), поэтому это поведение сохраняется при чтении/записи изображений с существующими данными XMP.
Исправление поврежденного вывода при записи изображений WebP с высотой или шириной более 8191 пикселей ( b/342697059 ).
Эта библиотека теперь использует аннотации JSpecify, определяющие значение null , которые являются типовыми. Разработчикам Kotlin следует использовать следующий аргумент компилятора для обеспечения корректного использования: -Xjspecify-annotations=strict (это значение по умолчанию, начиная с версии 2.1.0 компилятора Kotlin). ( I5cd0f , b/326456246 )
Удалено ручное описание доступа к новым API платформы, поскольку это происходит автоматически посредством моделирования API при использовании R8 с AGP 7.3 или более поздней версии (например, R8 версии 3.3) и для всех сборок с использованием AGP 8.1 или более поздней версии (например, D8 версии 8.1). Клиентам, не использующим AGP, рекомендуется обновиться до D8 версии 8.1 или более поздней. Подробнее см. в этой статье . ( If6b4c , b/345472586 )

Версия 1.3.7

13 декабря 2023 г.

Выпущен androidx.exifinterface:exifinterface:1.3.7 . Версия 1.3.7 содержит следующие коммиты.

Исправления ошибок

Выдать исключение из ExifInterface.saveAttributes() при попытке записать слишком большой сегмент JPEG APP1 (ранее мы записывали недопустимый сегмент APP1 с неверной, усеченной длиной: ( b/263747161 )). Продолжить анализ после обнаружения недопустимого смещения IFD (ранее анализ немедленно останавливался, что могло приводить к возврату неверных значений: ( b/264729367 )).

Версия 1.3.6

8 февраля 2023 г.

Выпущен androidx.exifinterface:exifinterface:1.3.6 . Версия 1.3.6 содержит следующие коммиты.

Исправления ошибок

Исправлено чтение альфа-бита из фрагментов WebP VP8L ( b/255405635 ).

Версия 1.3.5

24 октября 2022 г.

Выпущен androidx.exifinterface:exifinterface:1.3.5 . Версия 1.3.5 содержит следующие коммиты.

Исправления ошибок

Исправлены два случая, когда saveAttributes() приводил к созданию недействительных файлов WebP.

Версия 1.3.4

5 октября 2022 г.

Выпущен androidx.exifinterface:exifinterface:1.3.4 . Версия 1.3.4 содержит следующие коммиты.

Исправления ошибок

Удалена поддержка сохранения атрибутов в файлах DNG. Поддержка, добавленная в версии 1.3.3, была неполной и приводила к повреждению файлов.

Версия 1.3.3

4 августа 2021 г.

Выпущен androidx.exifinterface:exifinterface:1.3.3 . Версия 1.3.3 содержит следующие коммиты.

Исправления ошибок

Исправлен парсинг тегов, связанных с подзащитными. ( aosp/1508143 )
Предотвратить RuntimeException при вызове setDataSource. ( c8e66e9 )
Предотвратить бесконечное зацикливание skipBytes. ( fdbe88b )
Перехват исключения RuntimeException из MediaMetadataRetriever. ( 389b21a )
Добавить поддержку сохранения атрибутов для файлов DNG ( 3017dbc )
Заменить теги, не являющиеся миниатюрами, тегами миниатюр. ( e1b916d )

Версия 1.3.2

2 декабря 2020 г.

Выпущен androidx.exifinterface:exifinterface:1.3.2 . Версия 1.3.2 содержит следующие коммиты.

Исправления ошибок

Позволяет использовать SRATIONAL для GPS_LATITUDE и GPS_LONGITUDE .
Добавлена поддержка чтения/записи вторичного формата (2020-01-01 00:00:00) тега DateTime.
Предотвращено временное удаление исходного файла при вызове saveAttribute().

Версия 1.3.1

14 октября 2020 г.

Выпущен androidx.exifinterface:exifinterface:1.3.1 . Версия 1.3.1 содержит следующие коммиты.

Исправления ошибок

Исправлена реализация saveAttributes для сохранения данных изображения в MediaProvider.

Версия 1.3.0

16 сентября 2020 г.

Выпущен androidx.exifinterface:exifinterface:1.3.0 . Версия 1.3.0 содержит следующие коммиты.

Основные изменения по сравнению с версией 1.2.0

Расширенная поддержка записи WebP EXIF для включения файлов, содержащих только фрагменты VP8 или VP8L.
Удалена ненужная буферизация, которая вызывала исключения OutOfMemory для больших файлов изображений.
Удалено INVALID_DATE_TIME . Вместо него используйте NULL для возврата недопустимых значений datetime.
Функция getGpsDateTime теперь возвращает Long.MIN_VALUE вместо -1 для недопустимого значения.

Версия 1.3.0-rc01

2 сентября 2020 г.

androidx.exifinterface:exifinterface:1.3.0-rc01 выпущен без изменений с версии 1.3.0-beta01 . Версия 1.3.0-rc01 содержит следующие изменения.

Версия 1.3.0-beta01

19 августа 2020 г.

Выпущен androidx.exifinterface:exifinterface:1.3.0-beta01 . Версия 1.3.0-beta01 содержит следующие изменения.

Новые функции

Расширенная поддержка записи WebP EXIF для включения файлов, содержащих только фрагменты VP8 или VP8L.

Изменения API

Удалено INVALID_DATE_TIME . Вместо него используйте NULL для возврата недопустимого значения datetime.

Исправления ошибок

Функция getGpsDateTime теперь возвращает Long.MIN_VALUE вместо -1 , поскольку -1 является допустимым значением.
Теперь геттеры, связанные с DateTime, учитывают значение смещения (+/-) строки даты.
Удалена ненужная буферизация, которая вызывала исключения OutOfMemory для больших файлов изображений.
Установить региональные параметры по умолчанию на США
Добавление «.tmp» для создания временных файлов заменено на добавление префикса.

Версия 1.3.0-альфа01

19 февраля 2020 г.

Выпущен androidx.exifinterface:exifinterface:1.3.0-alpha01 . Версия 1.3.0-alpha01 содержит следующие коммиты.

Изменения API

Добавлен новый метод: ExifInterface.getGpsDateTime()

Версия 1.2.0

1 апреля 2020 г.

Выпущен androidx.exifinterface:exifinterface:1.2.0 . Версия 1.2.0 содержит следующие коммиты.

Основные изменения с версии 1.1.0

Добавлена поддержка добавления EXIF в файлы PNG.
Добавлена поддержка только потоков файлов WebP и EXIF-данных.
Добавлен API для проверки поддержки указанного типа MIME.
Добавлены дополнительные теги для времени смещения: TAG_OFFSET_TIME , TAF_OFFSET_TIME_DIGITIZED и TAG_OFFSET_TIME_ORIGINAL

Версия 1.2.0-rc01

19 февраля 2020 г.

Выпущен androidx.exifinterface:exifinterface:1.2.0-rc01 . Версия 1.2.0-rc01 содержит следующие коммиты.

Исправления ошибок

Исправлена ошибка, из-за которой файлы JPEG сохранялись некорректно, если в JPEG были данные XMP.

Версия 1.2.0-beta01

18 декабря 2019 г.

Выпущен androidx.exifinterface:exifinterface:1.2.0-beta01 . Версия 1.2.0-beta01 содержит следующие коммиты .

Новые функции

Добавлена поддержка добавления EXIF в файлы PNG.
Добавлена поддержка чтения и записи EXIF из файлов WebP.
Добавлена поддержка потока только данных EXIF.

Изменения API

Добавлен API для проверки поддержки указанного типа MIME.
Открыты теги OffsetTime* для чтения и записи

Исправления ошибок

Исправлена ошибка, из-за которой возвращались неверные смещения для getAttributeRange()

Версия 1.1.0

20 ноября 2019 г.

Выпущен androidx.exifinterface:exifinterface:1.1.0 . Версия 1.1.0 содержит следующие коммиты .

Важные изменения с версии 1.0.0

Поддержка формата HEIF и дополнительных тегов XMP
Добавлена поддержка создания объекта ExifInterface из File или FileDescriptor
Добавлены дополнительные методы для получения атрибутов: hasAttribute , getAttributeBytes и getAttributesRange

Версия 1.1.0-rc01

9 октября 2019 г.

Выпущен androidx.exifinterface:exifinterface:1.1.0-rc01 . Версия 1.1.0-rc01 содержит следующие коммиты .

Исправления ошибок

Добавлено отсутствующее имя формата (IFD) для предотвращения исключения ArrayIndexOutOfBoundsException при loadAttributes
Предотвращено удаление исходного файла при возникновении исключения во время вызова saveAttributes
Исправлена проблема исключения при вызове saveAttributes() после перезаписи файла.

Версия 1.1.0-beta01

2 июля 2019 г.

Выпущена версия androidx.exifinterface:exifinterface:1.1.0-beta01 . Изменения, включённые в эту версию, можно найти здесь .

Новые функции

Выдает NullPointerException когда для аргументов @NonNull установлено null
Поддержка XMP-тегов

Изменения API

Добавлены дополнительные методы для получения информации об атрибутах.
hasAttribute , getAttributeBytes и getAttributesRange

Исправления ошибок

Предотвращение утечки памяти файлового дескриптора

Версия 1.1.0-альфа01

13 марта 2019 г.

Выпущена версия androidx.exifinterface:exifinterface:1.1.0-alpha01 . Полный список изменений, включённых в эту версию, можно найти здесь .

Новые функции

Поддержка формата HEIF

Изменения API

Добавлены дополнительные конструкторы ExifInterface.
Исправлена опечатка: TAG_CAMARA_OWNER_NAME -> TAG_CAMERA_OWNER_NAME

Исправления ошибок

Исправлена проверка возможного переполнения для миниатюрного изображения ( aosp/748608 )