Learn How To Add Expansion Files In Android?

As every Android developer knows that it is not possible to launch an Android app with a size greater than 100 MB on the store, this is something each developer should retain while developing an application with a large number of assets. As assets grow we look for more reliable techniques to optimize the application like using a WebP image instead of PNG or adding SVG (Vector Drawable) or eliminating unwanted resources.

Some applications demand dynamic graphics or media files or huge assets. The Android team had provided an option of expansion support. Let’s see how to implement an App expansion for an application.

Expansion Files And It’s File Type

Expansion files are utterly archived files format as Opaque Binary Blob (.obb) which we can upload once the released APK is updated on Google Play Console. There are two distinct expansion file alternatives provided by Google Android Team. Each file has a volume of around 2GB and is of any format ZIP, PDF or MP4 that can be shared.

  1. Main Expansion File is a primary alternative for additional resources required by an application.
  2. Patch Expansion File is optional and has small updates to main expansion files.

While we can make use of two alternatives as per requirements, the team has recommended making use of the Main Expansion file to deliver a primary app asset through them, and patch files should be used rarely for frequent updates.

OBB File Format

We can upload any format (MP4, ZIP, PDF) expansion file. Regardless of the uploaded file format, the Play Console will always consider them as Opaque Binary Blob (OBB). The file can be renamed in the below format


main: Specifies the file is the main file or primary

patch: Associated file for a small update to the primary file

expansion-version: Expansion version indicated the version code of the whole application which should be the same

package-name: The package name symbolizes the name of the application package given in the Android Manifest

For example, if our application version is 1, then it should be defined like this


OBB Storage Location

When an application with APK expansion is downloaded, the files are instantly stored to the internal shared folder of storage location with an obb folder inside an Android folder.


shared-storage: It is a path to shared storage space.

package-name: The package name symbolizes the name of the application package given in the Android Manifest.

For each android application, there are only single app expansion files, while the other is a patch file that supports frequent updates to main files.

Implementing Expansion File In Android

The fundamental logic is to download the Expansion file while installing an application from the Play Store. Even so, we need to add the various dependencies in the application code which will help to download the expansion file from the store.

The first and leading thing is to head toward the SDK manager and go-to tab SDK tools and download the Google Play APK Expansion Library and Google Play Licensing Library. Please see the below image

Implementing Expansion Files In Android | MindBowser
Fig 1.1 Library Dependency

The Down-loader Library

To use expansion in the application we need to import the Downloader Library as a new module. It is present inside the Android SDK under the extra package folder. Which further goes up to extras > google > market_apk_expansion > downloader_library.

Follow the below steps for adding a library to the project:

  1. Before continuing the library go-to project.properties files and remove/comment out the line


  1. File > New > New Import
  2. Browse to the downloader_library folder, press open, and import.

Market Licensing Library

The second step is to import the market licensing library from the Android SDK folder.

Follow the below steps for adding a library to the project:

  1. File > New > New Module
  1. Browse to /extras/google/market_licensing/library/ folder.
  2. Rename Module name from library to market_licensing and import it in the project.

Import zip library

This library implementation is optional. If an expansion file is in a zip package this library can be useful.

Follow the below steps for adding a library to the project:

  1. File > New > New Imports
  2. Browse to zip_files inside the SDK extras folder
  3. Import the library.


This article is helpful for understanding expansion files that help in creating gaming applications or applications having requirements of larger size images, videos or pdf files into it. We have to add the obb file created to the play console while launching the application on the play store.


Software Developer

Aishwarya is a mobile application developer with 4 years of experience. Had worked on android and react native applications. Had worked on different domain applications Like Health Care and Shift management. Worked on Wahoo-gym-connect device connectivity in the android application.

Get in touch for a detailed discussion.

Hear From Our 100+ Customers

Mindbowser helped us build an awesome iOS app to bring balance to people’s lives.


We had very close go live timeline and MindBowser team got us live a month before.

Shaz Khan
CEO, BuyNow WorldWide

They were a very responsive team! Extremely easy to communicate and work with!

Kristen M.
Founder & CEO, TotTech

We’ve had very little-to-no hiccups at all—it’s been a really pleasurable experience.

Chacko Thomas
Co-Founder, TEAM8s

Mindbowser is one of the reasons that our app is successful. These guys have been a great team.

Dave Dubier
Founder & CEO, MangoMirror

Mindbowser was very helpful with explaining the development process and started quickly on the project.

Hieu Le
Executive Director of Product Development, Innovation Lab

The greatest benefit we got from Mindbowser is the expertise. Their team has developed apps in all different industries with all types of social proofs.

Alex Gobel
Co-Founder, Vesica

Mindbowser is professional, efficient and thorough. 

MacKenzie R
Consultant at XPRIZE

Very committed, they create beautiful apps and are very benevolent. They have brilliant Ideas.

Laurie Mastrogiani
Founder, S.T.A.R.S of Wellness

MindBowser was great; they listened to us a lot and helped us hone in on the actual idea of the app.” “They had put together fantastic wireframes for us.

Bennet Gillogly
Co-Founder, Flat Earth

They're very tech-savvy, yet humble.

Uma Nidmarty
CEO, GS Advisorate, Inc.

Ayush was responsive and paired me with the best team member possible, to complete my complex vision and project. Could not be happier.

Katie Taylor
Founder, Child Life On Call

As a founder of a budding start-up, it has been a great experience working with Mindbower Inc under Ayush's leadership for our online digital platform design and development activity.

Radhika Kotwal
Founder of Courtyardly

The team from Mindbowser stayed on task, asked the right questions, and completed the required tasks in a timely fashion! Strong work team!

Michael Wright
Chief Executive Officer, SDOH2Health LLC

They are focused, patient and; they are innovative. Please give them a shot if you are looking for someone to partner with, you can go along with Mindbowser.

David Cain
CEO, thirty2give

We are a small non-profit on a budget and they were able to deliver their work at our prescribed budgets. Their team always met their objectives and I'm very happy with the end result. Thank you, Mindbowser team!!

Bart Mendel
Founder, Mindworks

Mindbowser was easy to work with and hit the ground running, immediately feeling like part of our team.

George Hodulik
CEO, Stealth Startup, Ex-Google