picasso README

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

Picasso

Attention: This library is deprecated. Please use alternatives like Coil for future projects, and start planning to migrate existing projects, especially if they rely on Compose UI. Existing versions will continue to function, but no new work is planned. While some changes may land in the repo as we support internal legacy usage and migration, there will be no more public releases to Maven Central.

Thank you to all who used and/or contributed to Picasso over its decade of image loading.

A powerful image downloading and caching library for Android

For more information please see the website

Download

Download the latest AAR from Maven Central or grab via Gradle:

implementation 'com.squareup.picasso:picasso:2.8'

or Maven:

<dependency>
  <groupId>com.squareup.picasso</groupId>
  <artifactId>picasso</artifactId>
  <version>2.8</version>
</dependency>

Snapshots of the development version are available in Sonatype's snapshots repository.

Picasso requires at minimum Java 8 and API 21.

ProGuard

If you are using ProGuard you might need to add OkHttp's rules: https://github.com/square/okhttp/#r8--proguard

License

Copyright 2013 Square, Inc.

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   https://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

picasso (square/picasso)

Searching Database…

18.8K ·GitHub
Picasso
What is this?Picasso is an image downloading and caching library for Android, built by Square to simplify loading images from network, resources, or disk into views.
Is it a library or a standalone app?It is a library you add to an Android app via Gradle or Maven, not a standalone application.
How do I add it to my Android project?Download the latest AAR from Maven Central, or add it as a Gradle or Maven dependency.
What minimum Java and Android API version does it need?Picasso requires at minimum Java 8 and Android API level 21.
Is this library still being actively developed?No. Picasso is deprecated, there will be no more public releases to Maven Central, and the author recommends migrating to an alternative like Coil, especially for Compose UI projects.
Will my existing app break if it already uses Picasso?No, existing versions will continue to function, but you should not plan new feature work or releases around it.
Does this only work on Android?Yes, it is specifically an Android library.
Do I need to configure anything special for ProGuard?Yes, if you use ProGuard you may need to add OkHttp's ProGuard rules, since Picasso relies on OkHttp under the hood.
Why is it deprecated instead of just unmaintained silently?Square explicitly announced the deprecation in the README to redirect new and existing projects toward actively maintained alternatives like Coil, particularly for Compose-based UIs.
Should I start a new project with Picasso today?No, given the explicit deprecation notice, new projects should use an actively maintained alternative such as Coil instead.
What are similar projects?Android-Universal-Image-Loader, fresco, GSYVideoPlayer, uamp, glide, CircleImageView, uCrop, material-dialogs
Which topics is it in?image, caching, mobile-development, kotlin, deprecated, java, mobile, android, apache-2.0, library
Creator
square
Size
5.6 MB
Stars
18.8K
Updated
CommitNov 06Release2.8Aug 10
Age
13y
Commits · 90 Days