How do I set the default launcher in an AOSP build? How do I set the default launcher in an AOSP build? android android

How do I set the default launcher in an AOSP build?


Instead of modifying the AOSP make files (which is annoying because then you need to track your changes) it is easier to add a LOCAL_OVERRIDES_PACKAGES line to your app's make file.

For instance:

LOCAL_OVERRIDES_PACKAGES := Launcher2 Launcher3

added to your Android.mk file will ensure that those packages are not added to any build where this package is added.

Following that, you should do a

make installclean

and then start your build the same way you always make your build. The make installclean is important to remove the packages that are left behind by the previous build.

I also just found a nice answer to how to do this in another question, see:How would I make an embedded Android OS with just one app?


Unless you do the following steps, you will be prompted for selecting which home launcher you would like to choose.

If you would like to have your home launcher truly overwrite the others without having to delete the others from your build, follow these steps.

Add an override for all other home launchers on your device, to your custom home launcher's Android.mk: (You may have others to override, but here's what were included in mine)

`LOCAL_OVERRIDES_PACKAGES := Home Launcher2 Launcher3`

Add your custom home launcher application module to the list of product packages. There are multiple files that add modules to the list of product packages. They are located in...

"/your-aosp-root/build/target/product/"

The file I chose to edit and add my module to was "Core.mk".

Add your module to the product packages list:

    PRODUCT_PACKAGES += \         BasicDreams \         Browser \         Calendar \         .         .         .         MmsService \         YourModuleHere

Call this to clean out your out directory of any old modules/images(doesn't delete all of out directory):

make installclean

Call your build script


The above answer is correct. LOCAL_OVERRIDES_PACKAGES works.But to address one of the comments; I had to doLOCAL_OVERRIDES_PACKAGES := Home Launcher2 Launcher3

Home is the sample Home app which serves as Launcher if Lancher2 is also not available.

Only after removing these 3 stock launchers; was I able to see my custom launcher launch by default without any dialog box asking user to choose.

(my test OS is Android N, ymmv)