Skip to content

Instantly share code, notes, and snippets.

@cunneen

cunneen/Readme.md

Last active April 11, 2025 11:11
Show Gist options
  • Save cunneen/1c0d9717f8ce5ea76900ba32fa037047 to your computer and use it in GitHub Desktop.
Save cunneen/1c0d9717f8ce5ea76900ba32fa037047 to your computer and use it in GitHub Desktop.
Download ZIP
Install Open GApps In Android Emulator
Raw
Readme.md

Introduction

This works to install Open GApps into the Android Emulator, working around the issue where the system partition is too small.

With it, I can get Google Play installing into the emulator. Tested on KitKat (API 19), Lollipop (API 21) and Oreo (API 27).

It's tested on MacOS.

Instructions

  1. Ensure you have unzip, lzip, tar, emulator and adb in your PATH.
  2. From Android Studio (v3.0.1) create a new Android Virtual Device (AVD). For example:
    1. Tools -> Android -> AVD Manager
    2. Create Virtual Device...
    3. Phone -> Nexus 5
    4. x86 Images -> Lollipop -> Marshmallow (API 23 x86_64) (Download if necessary)
    5. Give the AVD a name ("Nexus 5 Marshmallow API 23 x86_64")
    6. Choose "Show Advanced Settings...". Give the AVD at least 1536MB Internal Storage, and 512MB SD Card
    7. Finish
  3. Download the appropriate Open GApps file from opengapps.org (x86_64 / 6.0 / micro)
  4. Save the open_gapps_install_script.sh into the same folder, and give it executable permission: 
    chmod 755 open_gapps_install_script.sh
  5. Run the open_gapps_install_script.sh with the Open GApps file as the first argument; e.g. 
    open_gapps_install_script.sh open_gapps-x86_64-6.0-micro-20180123.zip
  6. When prompted for an AVD, copy the appropriate AVD name and paste it. Press Enter.
  7. Wait for the emulator to boot fully, then press Enter.
  8. Once the script tells you to "Restart android in your emulator", hold down the virtual power button to shutdown.
  9. Manually start the emulator again (press the 'play' button in Android Studio's AVD Manager).
  10. In the emulator, open the Google app and sign in with your google account.
  11. Shut down the emulator and start it again.

A sample transcript follows.

Sample Transcript

$ ./open_gapps_install_script.sh open_gapps-x86_64-6.0-micro-20180123.zip 
Archive:  open_gapps-x86_64-6.0-micro-20180123.zip
signed by SignApk
 extracting: /tmp/gapps_installer/Core/configupdater-all.tar.lz  
 extracting: /tmp/gapps_installer/Core/defaultetc-common.tar.lz  
 extracting: /tmp/gapps_installer/Core/defaultframework-common.tar.lz  
 extracting: /tmp/gapps_installer/Core/gmscore-x86_64.tar.lz  
 extracting: /tmp/gapps_installer/Core/googlebackuptransport-all.tar.lz  
 extracting: /tmp/gapps_installer/Core/googlecontactssync-all.tar  
 extracting: /tmp/gapps_installer/Core/googlefeedback-all.tar.lz  
 extracting: /tmp/gapps_installer/Core/googleonetimeinitializer-all.tar.lz  
 extracting: /tmp/gapps_installer/Core/googlepartnersetup-all.tar.lz  
 extracting: /tmp/gapps_installer/Core/gsfcore-all.tar.lz  
 extracting: /tmp/gapps_installer/Core/gsflogin-all.tar.lz  
 extracting: /tmp/gapps_installer/Core/setupwizarddefault-all.tar.lz  
 extracting: /tmp/gapps_installer/Core/setupwizardtablet-all.tar.lz  
 extracting: /tmp/gapps_installer/Core/vending-x86_64.tar.lz  
Which AVD?
Nexus_5X_Oreo_8.1_API_27
Nexus_5_KitKat_API_19_32-bit_x86
Nexus_5_Lollipop_API_22_32-bit
Nexus_5_Marshmallow_API_23_x86_64

>Nexus_5_Marshmallow_API_23_x86_64

determining location of system.img file for Nexus_5_Marshmallow_API_23_x86_64 .../Users/mikecunneen/Library/Android/sdk/system-images/android-23/google_apis/x86_64/
copying, checking and resizing system.img for Nexus_5_Marshmallow_API_23_x86_64
copying encryptionkey.img ...
e2fsck 1.42.13 (17-May-2015)
Pass 1: Checking inodes, blocks, and sizes
Pass 2: Checking directory structure
Pass 3: Checking directory connectivity
Pass 4: Checking reference counts
Pass 5: Checking group summary information
system: 1958/98304 files (0.0% non-contiguous), 358163/393216 blocks
resize2fs 1.42.13 (17-May-2015)
Resizing the filesystem on /Users/mikecunneen/.android/avd/Nexus_5_Marshmallow_API_23_x86_64.avd/system.img to 524288 (4k) blocks.
The filesystem on /Users/mikecunneen/.android/avd/Nexus_5_Marshmallow_API_23_x86_64.avd/system.img is now 524288 (4k) blocks long.

starting Nexus_5_Marshmallow_API_23_x86_64

Press enter when the emulator has booted...

adbd is already running as root
remount succeeded
etc/: 11 files pushed. 3.8 MB/s (58819 bytes in 0.015s)
framework/: 3 files pushed. 34.8 MB/s (212217 bytes in 0.006s)
app/: 1 file pushed. 81.9 MB/s (284795 bytes in 0.003s)
priv-app/: 9 files pushed. 188.1 MB/s (93280033 bytes in 0.473s)
restart android in your emulator
done.
Raw
open_gapps_install_script.sh
#!/usr/bin/env bash
ZIPFILE=${1}
USAGESTRING="Usage: ${0} open_gapps_zip_file.zip";
TEMPDIR=/tmp/gapps_installer
if [ $# -lt 1 ]; then
echo ${USAGESTRING};
exit 1;
fi
if [ ! -f ${ZIPFILE} ]; then
echo ${USAGESTRING};
exit 2;
fi
if [ ! ${ANDROID_HOME} ]; then
echo "ANDROID_HOME is not set"
exit 3;
fi
if [ ! -d ${ANDROID_HOME} ]; then
echo "ANDROID_HOME is not valid"
exit 4;
fi
rm -rf ${TEMPDIR} && mkdir -p ${TEMPDIR}
unzip ${ZIPFILE} 'Core/*' -d ${TEMPDIR}
cd ${TEMPDIR}
rm Core/setup*
lzip -d Core/*.lz
for f in $(ls Core/*.tar); do
tar -x --strip-components 2 -f $f
done
echo "Which AVD?"
emulator -list-avds
echo -en "\n>"
read AVD
echo -en "\ndetermining location of system.img file for ${AVD} ..."
IMAGE_SYSDIR=`grep "image.sysdir.1" ${HOME}/.android/avd/${AVD}.avd/config.ini | cut -f2 -d"="`
echo "${ANDROID_HOME}/${IMAGE_SYSDIR}"
echo "copying, checking and resizing system.img for ${AVD}"
cp "${ANDROID_HOME}/${IMAGE_SYSDIR}/system.img" "${HOME}/.android/avd/${AVD}.avd/system.img"
if [ -f "${ANDROID_HOME}/${IMAGE_SYSDIR}/encryptionkey.img" ]; then
echo "copying encryptionkey.img ..."
cp "${ANDROID_HOME}/${IMAGE_SYSDIR}/encryptionkey.img" "${HOME}/.android/avd/${AVD}.avd/encryptionkey.img"
fi
"${ANDROID_HOME}/emulator/bin64/e2fsck" -f "${HOME}/.android/avd/${AVD}.avd/system.img"
"${ANDROID_HOME}/emulator/bin64/resize2fs" "${HOME}/.android/avd/${AVD}.avd/system.img" 3072M
echo "starting ${AVD}"
${ANDROID_HOME}/tools/emulator -netdelay none -netspeed full -avd ${AVD} -partition-size 1024 -writable-system > /dev/null 2>&1 &
read -rsp $'\nPress enter when the emulator has booted...\n\n'
adb root
adb remount
adb push etc /system
adb push framework /system
adb push app /system
adb push priv-app /system
sleep 5
# adb reboot system
# adb -e emu kill
echo "Restart android in your emulator"
echo "done."
@rhonyabdullah
Copy link

@cunneen @tenzap
Anyone, need your help here:

The script above is obsolete, I'm try to fix it but still having some error:

My setup:

The error says:

copying encryptionkey.img ...
e2fsck 1.42.13 (17-May-2015)
ext2fs_open2: Bad magic number in super-block
/Users/myusername/Library/Android/sdk/emulator/bin64/e2fsck: Superblock invalid, trying backup blocks...
/Users/myusername/Library/Android/sdk/emulator/bin64/e2fsck: Bad magic number in super-block while trying to open /Users/myusername/.android/avd/Pixel_5_API_30.avd/system.img

The superblock could not be read or does not describe a valid ext2/ext3/ext4
filesystem.  If the device is valid and it really contains an ext2/ext3/ext4
filesystem (and not swap or ufs or something else), then the superblock
is corrupt, and you might try running e2fsck with an alternate superblock:
    e2fsck -b 8193 <device>
 or
    e2fsck -b 32768 <device>

resize2fs 1.42.13 (17-May-2015)
/Users/myusername/Library/Android/sdk/emulator/bin64/resize2fs: Bad magic number in super-block while trying to open /Users/myusername/.android/avd/Pixel_5_API_30.avd/system.img
Couldn't find valid filesystem superblock.
starting Pixel_5_API_30

Press enter when the emulator has booted...    <-- the emulator actually **not** started

Here is my updated script

#!/usr/bin/env bash
ZIPFILE=${1}
USAGESTRING="Usage: ${0} open_gapps_zip_file.zip";
TEMPDIR=/tmp/gapps_installer

if [ $# -lt 1 ]; then
  echo ${USAGESTRING};
  exit 1;
fi

if [ ! -f ${ZIPFILE} ]; then
  echo ${USAGESTRING};
  exit 2;
fi

if [ ! ${ANDROID_HOME} ]; then
  echo "ANDROID_HOME is not set"
  exit 3;
fi

if [ ! -d ${ANDROID_HOME} ]; then
  echo "ANDROID_HOME is not valid"
  exit 4;
fi

rm -rf ${TEMPDIR} && mkdir -p ${TEMPDIR}
unzip ${ZIPFILE} 'Core/*' -d ${TEMPDIR}
cd ${TEMPDIR}
rm Core/setup*

# file zip extension is changed
#lzip -d Core/*.lz
#for f in $(ls Core/*.tar); do
#  tar -x --strip-components 2 -f $f

for f in Core/*.tar.xz; do
  [ -f "$f" ] || continue
  echo "Extracting $f..."
  tar -xJf "$f" --strip-components=2

done

echo "Which AVD?"
emulator -list-avds
echo -en "\n>"
read AVD

echo -en "\ndetermining location of system.img file for ${AVD} ..."
#IMAGE_SYSDIR=`grep "image.sysdir.1" ${HOME}/.android/avd/${AVD}.avd/config.ini | cut -f2 -d"="`
IMAGE_SYSDIR=$(grep "image.sysdir.1" "${HOME}/.android/avd/${AVD}.avd/config.ini" | cut -f2 -d"=" | sed 's/^[[:space:]]*//')
echo "${ANDROID_HOME}/${IMAGE_SYSDIR}"

echo "copying, checking and resizing system.img for ${AVD}"
cp "${ANDROID_HOME}/${IMAGE_SYSDIR}system.img" "${HOME}/.android/avd/${AVD}.avd/system.img"
if [ -f "${ANDROID_HOME}/${IMAGE_SYSDIR}encryptionkey.img" ]; then
  echo "copying encryptionkey.img ..."
  cp "${ANDROID_HOME}/${IMAGE_SYSDIR}encryptionkey.img" "${HOME}/.android/avd/${AVD}.avd/encryptionkey.img"
fi
"${ANDROID_HOME}/emulator/bin64/e2fsck" -f "${HOME}/.android/avd/${AVD}.avd/system.img"
"${ANDROID_HOME}/emulator/bin64/resize2fs" "${HOME}/.android/avd/${AVD}.avd/system.img" 3072M

echo "starting ${AVD}"

${ANDROID_HOME}/tools/emulator -netdelay none -netspeed full -avd ${AVD} -partition-size 1024 -writable-system > /dev/null 2>&1 &

read -rsp $'\nPress enter when the emulator has booted...\n\n'

adb root
adb remount
adb push etc /system
adb push framework /system
adb push app /system
adb push priv-app /system

sleep 5
# adb reboot system
# adb -e emu kill
echo "Restart android in your emulator"
echo "done."

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment