BlissLauncher3

BlissLauncher3 is a modified version of the AOSP Launcher3, with features inspired from BlissLauncher v1.

It is the default launcher for /e/ OS.

Building

• Clone the repository

  git clone --recurse-submodules https://gitlab.e.foundation/e/os/BlissLauncher3 -b v1-u BlissLauncher3u
  

• To build this project, we need the following jars inside the prebuilts folder from our AOSP build directory:

  • framework-14.jar: out/soong/.intermediates/frameworks/base/framework/android_common/turbine-combined/framework.jar

  • We need to build the Launcher3QuickStepLib module using m Launcher3QuickStepLib and then copy the jar from the following directory:

    • classes.jar: out/target/common/obj/JAVA_LIBRARIES/Launcher3QuickStepLib_intermediates/classes.jar

• Now we need to run two tasks to generate the proper jars:

  # Unzip the classes.jar file
  ./gradlew unzipJar
  
  # Generate the final jar for Quickstep
  ./gradlew makeReleaseJar

• Launch Android Studio and Import the project

• Build the project through the IDE or run the following command:

  ./gradlew assembleBlissWithQuickstepDebug

Installing

• Below conditions are required to install the app:

  • User should be on Android 14 /e/OS or LineageOS
  • Rom should be signed with test keys

• Download and install the APK like any other normal app from the pipeline

• Download and install the icon mask like normal app SquircleMask.apk

• Go to Settings > Apps > Default apps > Launcher and change launcher to Blisslauncher (with green icon)

• It will open a page about Usage access. Allow the new BlissLauncher (Permit usage access)

• Go to Settings > Display > Icon Shape > Select Squircle

• Clear the data of Blisslauncher3 manually through settings or run the command through adb:

  adb shell pm clear com.android.launcher3

• Reboot

• Now it is totally ready to use and play around with!

License

Copyright © MURENA SAS 2024.

All rights reserved. This program and the accompanying materials
are made available under the terms of the GNU Public License v3.0
which accompanies this distribution, and is available at
http://www.gnu.org/licenses/gpl.html