glide README

The project's README from github.com/bumptech/glide. As one markdown file: README.md.

Glide

Maven Central | View Glide's documentation | 简体中文文档 | Report an issue with Glide

Glide is a fast and efficient open source media management and image loading framework for Android that wraps media decoding, memory and disk caching, and resource pooling into a simple and easy to use interface.

Glide supports fetching, decoding, and displaying video stills, images, and animated GIFs. Glide includes a flexible API that allows developers to plug in to almost any network stack. By default Glide uses a custom HttpUrlConnection based stack, but also includes utility libraries plug in to Google's Volley project or Square's OkHttp library instead.

Glide's primary focus is on making scrolling any kind of a list of images as smooth and fast as possible, but Glide is also effective for almost any case where you need to fetch, resize, and display a remote image.

Download

For detailed instructions and requirements, see Glide's download and setup docs page.

You can download a jar from GitHub's releases page.

Or use Gradle:

repositories {
  google()
  mavenCentral()
}

dependencies {
  implementation 'com.github.bumptech.glide:glide:5.0.9'
}

Or Maven:

<dependency>
  <groupId>com.github.bumptech.glide</groupId>
  <artifactId>glide</artifactId>
  <version>5.0.9</version>
</dependency>

For info on using the bleeding edge, see the Snapshots docs page.

R8 / Proguard

The specific rules are already bundled into the aar which can be interpreted by R8 automatically

How do I use Glide?

Check out the documentation for pages on a variety of topics, and see the javadocs.

For Glide v3, see the wiki.

Simple use cases will look something like this:

// For a simple view:
@Override public void onCreate(Bundle savedInstanceState) {
  ...
  ImageView imageView = (ImageView) findViewById(R.id.my_image_view);

  Glide.with(this).load("https://goo.gl/gEgYUd").into(imageView);
}

// For a simple image list:
@Override public View getView(int position, View recycled, ViewGroup container) {
  final ImageView myImageView;
  if (recycled == null) {
    myImageView = (ImageView) inflater.inflate(R.layout.my_image_view, container, false);
  } else {
    myImageView = (ImageView) recycled;
  }

  String url = myUrls.get(position);

  Glide
    .with(myFragment)
    .load(url)
    .centerCrop()
    .placeholder(R.drawable.loading_spinner)
    .into(myImageView);

  return myImageView;
}

Status

Version 4 is now released and stable. Updates are released periodically with new features and bug fixes.

Comments/bugs/questions/pull requests are always welcome! Please read CONTRIBUTING.md on how to report issues.

Compatibility

If you need to support older versions of Android, consider staying on Glide v3, which works on API 10, but is not actively maintained.

Build

Building Glide with gradle is fairly straight forward:

git clone https://github.com/bumptech/glide.git
cd glide
./gradlew jar

Note: Make sure your Android SDK has the Android Support Repository installed, and that your $ANDROID_HOME environment variable is pointing at the SDK or add a local.properties file in the root project with a sdk.dir=... line.

Samples

Follow the steps in the Build section to set up the project and then:

./gradlew :samples:flickr:run
./gradlew :samples:giphy:run
./gradlew :samples:svg:run
./gradlew :samples:contacturi:run

You may also find precompiled APKs on the releases page.

Development

Follow the steps in the Build section to setup the project and then edit the files however you wish. Android Studio cleanly imports both Glide's source and tests and is the recommended way to work with Glide.

To open the project in Android Studio:

  1. Go to File menu or the Welcome Screen
  2. Click on Open...
  3. Navigate to Glide's root directory.
  4. Select setting.gradle

For more details, see the Contributing docs page.

Getting Help

To report a specific problem or feature request, open a new issue on Github. For questions, suggestions, or anything else, email Glide's discussion group, or join our IRC channel: irc.freenode.net#glide-library.

Contributing

Before submitting pull requests, contributors must sign Google's individual contributor license agreement.

Thanks

Author

Sam Judd - @sjudd on GitHub, @samajudd on Twitter

License

BSD, part MIT and Apache 2.0. See the LICENSE file for details.

Disclaimer

This is not an official Google product.

glide (bumptech/glide)

Searching Database…

35K ·GitHub
Glide
Что это такое?Быстрый и эффективный open source фреймворк для работы с медиа и загрузки изображений на Android: он прячет за простым интерфейсом декодирование медиафайлов, кэширование в памяти и на диске и переиспользование ресурсов.
Это фреймворк или библиотека?В README его называют фреймворком, но пользоваться им можно как библиотекой: подключаете его как зависимость, и он сам занимается загрузкой, декодированием, кэшированием и отображением медиа через простой API.
Как добавить Glide в мой Android-проект?Подключите его через Gradle или Maven, либо скачайте jar со страницы релизов на GitHub; полные инструкции есть на странице документации по скачиванию и настройке. Правила R8/ProGuard уже встроены в aar.
Какие версии Android он поддерживает?Glide v4 требует минимальный Android API level 14, а проект должен компилироваться с API 26 или выше. Поддержка более старых устройств (вплоть до API 10) означает использование v3, которая больше активно не поддерживается.
Есть ли известные подводные камни?Круглые ImageView вроде CircleImageView конфликтуют с crossfade-переходами и анимированными GIF — используйте BitmapTransformation, например circleCrop, или .dontAnimate(). Огромные изображения, например карты, загружаются с уменьшением разрешения, но view с зумом и панорамированием не поддерживаются.
Работает ли Glide на iOS или в вебе?Нет — Glide это фреймворк для загрузки изображений, созданный специально для Android-приложений; версий для iOS, десктопа или веба нет.
Какие медиа он умеет загружать — только статичные картинки?Нет — помимо обычных изображений Glide так же загружает, декодирует и показывает кадры из видео и анимированные GIF через тот же конвейер.
Привязывает ли Glide меня к какой-то конкретной сетевой библиотеке?Нет. Сетевой стек по умолчанию построен на HttpUrlConnection, а дополнительные библиотеки интеграции позволяют вместо него подключить Volley от Google или OkHttp от Square.
Почему плавный скролл для Glide так важен?Это его главная цель: сделать прокрутку любого списка изображений максимально плавной и быстрой — ради этого существуют кэширование и переиспользование ресурсов. Он также хорошо подходит, когда нужно загрузить, изменить размер и показать изображение из сети.
Glide v4 стабилен и всё ещё поддерживается?Да — версия 4 выпущена и стабильна, обновления выходят регулярно, с новыми возможностями и исправлениями ошибок. Документация по старой линейке v3 находится в вики.
What are similar projects?Android-Universal-Image-Loader, fresco, uCrop, EventBus, GSYVideoPlayer, zxing, MaterialDrawer, SlidingMenu
Which topics is it in?gif, android-development, android-library, image, caching, memory, image-processing, bsd, developers, java, mobile, performance
Creator
bumptech
Size
96.2 MB
Stars
35K
Updated
CommitOct 19Releasev5.0.9Jul 11
Age
13y
Commits · 90 Days