Getting Started with Fresco

First, add Fresco to your build.gradle as shown in the Remarks section:

If you need additional features, like animated GIF or WebP support, you have to add the corresponding Fresco artifacts as well.

Fresco needs to be initialized. You should only do this 1 time, so placing the initialization in your Application is a good idea. An example for this would be:

public class MyApplication extends Application {

@Override public void onCreate() { super.onCreate(); Fresco.initialize(this); }

}

If you want to load remote images from a server, your app needs the internt permission. Simply add it to your AndroidManifest.xml:

<uses-permission android:name="android.permission.INTERNET" />

Then, add a SimpleDraweeView to your XML layout. Fresco does not support wrap_content for image dimensions since you might have multiple images with different dimensions (placeholder image, error image, actual image, …).

So you can either add a SimpleDraweeView with fixed dimensions (or match_parent):

<com.facebook.drawee.view.SimpleDraweeView

android:id=”@+id/my_image_view” android:layout_width=“120dp” android:layout_height=“120dp” fresco:placeholderImage=”@drawable/placeholder” />

Or supply an aspect ratio for your image:

<com.facebook.drawee.view.SimpleDraweeView

android:id=”@+id/my_image_view” android:layout_width=“120dp” android:layout_height=“wrap_content” fresco:viewAspectRatio=“1.33” fresco:placeholderImage=”@drawable/placeholder” />

Finally, you can set your image URI in Java:

SimpleDraweeView draweeView = (SimpleDraweeView) findViewById(R.id.my_image_view);
draweeView.setImageURI("http://yourdomain.com/yourimage.jpg");

That’s it! You should see your placeholder drawable until the network image has been fetched.