Image Caching using FFImageLoading

[Samsung Newsroom]

When you want to use the internet image in your application, you would be worrying about the slow image loading or the load failure caused by the network issues. In this scenario, it would be really good idea to show the default temporal image until the actual image is successfully loaded and ready to be displayed. Also reusing the image data which has been downloaded can make displaying image very fast.

FFImageLoading is the library including all those cool features and helping you to load images quick and easy.

What is FFImageLoading - Fast & Furious Image Loading

Library to load images quickly & easily on Xamarin.iOS, Xamarin.Android, Xamarin.Forms, Xamarin.Mac / Xamarin.Tizen and Windows (UWP, WinRT).

Features (support on Tizen)

• Configurable disk and memory caching
• Multiple image views using the same image source (url, path, resource) will use only one bitmap which is cached in memory (less memory usage)
• Deduplication of similar download/load requests. (If 100 similar requests arrive at same time then one real loading will be performed while 99 others will wait).
• Error and loading placeholders support
• Images can be automatically downsampled to specified size (less memory usage)
• SVG support
• Image loading Fade-In animations support
• Can retry image downloads (RetryCount, RetryDelay)

Getting started

Let's use Fast & Furious Image on your Application

Install the FFImageloading package

nuget.exe

nuget.exe install Xamarin.FFImageLoading.Forms

.NET CLI

dotnet add package Xamarin.FFImageLoading.Forms

Package reference

<PackageReference Include="Xamarin.FFImageLoading.Forms" Version="2.4.11.982" />

Initialize FFImageLoading

To use FFImageLoading, initialize library for tizen platform and setup various options

var app = new Program();
Forms.Init(app);
// Initialize FFImageLoading with FormsApplication object
FFImageLoading.Forms.Platform.CachedImageRenderer.Init(app);

Setup options on startup time

If you want to handle events from CachedImage object on your app code, you need to set ExecuteCallbacksOnUIThread property to true

protected override void OnCreate()
{
    base.OnCreate();
    var config = new FFImageLoading.Config.Configuration
    {
        ExecuteCallbacksOnUIThread = true,
    };
    FFImageLoading.ImageService.Instance.Initialize(config);
    LoadApplication(new App());
}

CachedImage

CachedImage provides a main functionality of FFImageLoading including cached image loading. A usage is very simmilar with the original Image class of Xamarin.Forms.

<?xml version="1.0" encoding="utf-8" ?>
<ContentPage xmlns="http://xamarin.com/schemas/2014/forms"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             xmlns:ff="clr-namespace:FFImageLoading.Forms;assembly=FFImageLoading.Forms"
             x:Class="CachedImageSample.MainPage">
    <ContentPage.Content>
        <StackLayout>
            <ff:CachedImage LoadingPlaceholder="loading.jpg"
             Source="http://i.imgur.com/gkVgpL1.jpg"/>
        </StackLayout>
    </ContentPage.Content>
</ContentPage> 

var image = new CachedImage
{
    LoadingPlaceholder = "loading.jpg",
    Source = "http://i.imgur.com/gkVgpL1.jpg"
};

Useful properties

Property	Description
LoadingPlaceholder	If set, a loading placeholder is shown while loading. It supports UriImageSource, FileImageSource and StreamImageSource.
ErrorPlaceholder	If set, an error placeholder is shown when error occurs while loading image. It supports UriImageSource, FileImageSource and StreamImageSource.
RetryCount (int, default: 3)	If image download failed, or something wrong happened, it can be automatically retried. Defines retries count.
RetryDelay (int, default: 250)	If image download failed, or something wrong happened, it can be automatically retried. Defines retry delay.
CacheDuration (Timespan, default: TimeSpan.FromDays(90))	Defines how long file cache of downloaded image is valid.

Clear cache on the memory and disk

If there is not enough memory on a device, you need to suppress memory usage in your app, FFImageLoading provides a way to clear cache on the memory.

// Provided in `CoreApplication`, it is the best place to clear memory cache
protected override void OnLowMemory(LowMemoryEventArgs e)
{
    FFImageLoading.ImageService.Instance.InvalidateMemoryCache();
}

You can also clear cache on the disk.

FFImageLoading.ImageService.Instance.InvalidateDiskCacheAsync();

The Best usage of CachedImage

CachedImage works best when it is used in CollectionView, because CollectionView unloads a view that is out of sight and reloads when it comes back to the sight. Once image source is loaded, it shows really quick.

Privileges

If image from internet is not shown, check your app's privilege, it needs internet privilege.

In the tizen-manifest.xml file:

• To access the Internet, declare http://tizen.org/privilege/internet

Links

• Project site
• API Reference
• Tizen Sample

View the full blog at its source