4min read

Implementing a high-performance image manager for iOS

One of the most often performed tasks in mobile applications is the on-demand download of images. A ideal solution would deliver images as fast as possible (“under the finger”) and cache aggressively to reduce network usage. Interestingly, Apple only provides very simple (yet performant) base components in the iOS SDK. Leaving the assembly of a working solution to the developer. As our experience shows, it’s not a simple task. We accepted the challenge. The result is our freshly open-sourced PLImageManager which handles all the hard parts of downloading images the right way, including caching, multi- thread download and canceling. Read on, for some of our considerations.

“Single request at a time” queue

A very common solution is to put both the cache query and network download code into a single task (e.g. NSOperation or GCD) and execute them in FIFO order one at a time. The beauty of it lies in it’s simplicity. On the other hand, it’s struggles from problems typical for queue systems.

Lets consider a common real-life situation: a list of posts with thumbnail images. Every time a row gets displayed, a request is ordered for a image. Scrolling quickly, can result in a very long queue. As a result, very long load delays are to be expected. To mitigate, a request-canceling mechanism can be introduced. Images for disappearing rows would no longer take up a place in the queue.

As a side effect of using FIFO, we get request-duplication handling for free. The first request for a image will download and place it in the cache. Following requests will return just after the cache query.

“Multiple request at a time” queue

The “single request at a time” solution degrades with increasing image sizes and slower networks. In both cases this can be traced back to a increase in time the queue gets blocked, waiting for a download to complete. Increasing the number of concurrent tasks seems a viable solution. But concurrent- download doesn’t come without a cost.

Firstly, request-duplication needs a little bit more attention. For example: issuing two requests for the same image, now involves the possibility of both being executed at the same time. As a result both will start a download, and place the result into the cache. Two viable solutions exists: requests can be aggregate into a single tasks, or they can be forced not to operate in parallel. In both cases it will be harder to implement canceling.

Secondly, as our experience shows, performing multiple IO requests to flash at once is not a good idea. Even on background threads. We noticed that it does influence the main/UI thread performance. This is visible for example when scrolling. To gain control of the situation separating the IO load/storage and network access code into smaller subtasks is required. This again introduces more complexity for request-duplication and canceling mechanisms.

All of the above leave a programmer with two rather unpleasant options. To invest a lot of effort into making all concurrent-download, canceling and request-duplication working, or stick to a simpler less performant solution.


Following the DRY (Don’t Repeat Yourself) approach: the harder a task is to do, the more effort should be taken into doing it only once and properly. And thats exactly what we did at Polidea. PLImageManager source, test and example is now available from our Github account. Like all our open-source components, it’s under a BSD-like license. It has the following characteristics:

  • two level cache - we utilize NSCache for in-memory and flash file storage in temporary directories for caching. This allows the system to handle the nasty low-memory situations for us
  • single callback mechanism - no matter from where the manager gets the image, it will be delivered using a single callback mechanism
  • fast requests - In case the image was stored in memory, the callback will fire synchronously. If not, all the operations will be performed in background tasks, firing the callback asynchronously when ready. In both cases the request call will return almost instantly, ensuring your UI thread doesn’t get blocked
  • anti-duplication mechanism - all requests for a single image happening at the same time will be handled together
  • canceling - a per-request cancel mechanism ensures that as long as there are interested consumers for a image, it will be downloaded. On the other hand, images that were requested, but are no longer needed can be prevented from blocking the queue
  • easy integration and customisability - by externalising use-case specific tasks by means of a provider pattern, PLImageManager can work with the network library of your choice. For convenience, a standard provider using NSUrlRequest is also included



PLURLImageProvider * provider = [PLURLImageProvider new];
PLImageManager * manager = [[PLImageManager alloc] initWithProvider:provider];


[manager imageForIdentifier:@””
                placeholder:[UIImage imageNamed:@”placeholder”
                   callback:^(UIImage *image, BOOL isPlaceholder) {
    //consume the image here

A more sophisticated example demonstrating the use of canceling is bundled with the project.

PLImageManager on GitHub


AntoniPrincipal Software Engineer


Sign in and expect sharp insights, recommendations, ebooks and fascinating project stories delivered to your inbox

The controller of the personal data that you are about to provide in the above form will be Polidea sp. z o.o. with its registered office in Warsaw at ul. Przeskok 2, 00-032 Warsaw, KRS number: 0000330954, tel.: 0048 795 536 436, email: (“Polidea”). We will process your personal data based on our legitimate interest and/or your consent. Providing your personal data is not obligatory, but necessary for Polidea to respond to you in relation to your question and/or request. If you gave us consent to call you on the telephone, you may revoke the consent at any time by contacting Polidea via telephone or email. You can find detailed information about the processing of your personal data in relation to the above contact form, including your rights relating to the processing, HERE.

Data controller:

The controller of your personal data is Polidea sp. z o.o. with its registered office in Warsaw at ul. Przeskok 2, 00-032 Warsaw, KRS number: 0000330954, tel.: [0048795536436], email: [] (“Polidea”)

Purpose and legal bases for processing:


Used abbreviations:

GDPR – Regulation (EU) 2016/679 of the European Parliament and of the Council of 27 April 2016
on the protection of natural persons with regard to the processing of personal data and on the free movement
of such data, and repealing Directive 95/46/EC (General Data Protection Regulation)

ARES – Polish Act on Rendering Electronic Services dated 18 July 2002

TL – Polish Telecommunications Law dated 16 July 2004

1)        sending to the given email address a newsletter including information on Polidea’s new projects, products, services, organised events and/or general insights from the mobile app business world |art. 6.1 a) GDPR, art. 10.2 ARES and art. 172.1 TL (upon your consent)

Personal data:name, email address

2)       statistical, analytical and reporting purposes |art. 6. 1 f) GDPR (based on legitimate interests pursued by Polidea, consisting in analysing the way our services are used and adjusting them to our clients’ needs, as well as developing new services)

Personal data:name, email address

Withdrawal of consent:

You may withdraw your consent to process your personal data at any time.

Withdrawal of the consent is possible solely in the scope of processing performed based on the consent. Polidea is authorised to process your personal data after you withdraw your consent if it has another legal basis for the processing, for the purposes covered by that legal basis.

Categories of recipients:

Your personal data may be shared with:

1)       authorised employees and/or contractors of Polidea

2)       persons or entities providing particular services to Polidea (accounting, legal, IT, marketing and advertising services) – in the scope required for those persons or entities to provide those services to Polidea


Retention period:

1)       For the purpose of sending newsletter to the given email address – for as long as the relevant consent is not withdrawn

2)       For statistical, analytical and reporting purposes – for as long as the relevant consent is not withdrawn

Your rights:


Used abbreviation:

GDPR – Regulation (EU) 2016/679 of the European Parliament and of the Council of 27 April 2016
on the protection of natural persons with regard to the processing of personal data and on the free movement
of such data, and repealing Directive 95/46/EC (General Data Protection Regulation)

According to GDPR, you have the following rights relating to the processing of your personal data, exercised by contacting Polidea via [e-mail, phone].

1)       to access to your personal data (art. 15 GDPR) by requesting sharing and/or sending a copy of all your personal data processed by Polidea

2)       to request rectification of inaccurate personal data
(art. 16 GDPR) by indicating the data requiring rectification

3)       to request erasure of your persona data (art. 17 GDPR); Polidea has the rights to refuse erasing the personal data in specific circumstances provided by law

4)       to request restriction of processing of your personal data (art. 18 GDPR) by indicating the data which should be restricted

5)       to move your personal data (art. 20 GDPR) by requesting preparation and transfer by Polidea of the personal data that you provided to Polidea to you or another controller in a structured, commonly used machine-readable format

6)       to object to processing your personal data conducted based on art. 6.1 e) or f) GDPR, on grounds relating to your particular situation (art. 21 GDPR)

7)       to lodge a complaint with a supervisory authority,
in particular in the EU member state of your habitual residence, place of work or place of the alleged infringement if you consider that the processing
of personal data relating to you infringes the GDPR
(art. 77.1 GDPR)

No obligation to provide data:

Providing your personal data is not obligatory, but necessary for Polidea to provide you the newsletter service

Refusal to provide the above data will result in inability to receive the newsletter service.


In the process of providing the newsletter service, we make decisions in an automated way, including profiling, based on the data you provide.


“Profiling” means automated processing of personal data consisting of the use of your personal data to evaluate certain personal aspects relating to you, in particular to analyze or predict aspects concerning your personal preferences and interests.


The automated decisions are taken based on the analysis of clicked and viewed content. They affect the targeting of specific newsletter content to selected users registered to receive the newsletter service, based on the anticipated interests of the recipient.