Newer
Older
# BlissLauncher3
**BlissLauncher3** is a modified version of the AOSP [Launcher3](https://android.googlesource.com/platform/packages/apps/Launcher3), with features inspired from [BlissLauncher v1](https://gitlab.e.foundation/e/os/BlissLauncher/-/tree/master).
It is the default launcher for [/e/ OS](https://e.foundation/e-os/).
## Building
- Clone the repository
```git
git clone --recurse-submodules https://gitlab.e.foundation/e/os/BlissLauncher3 -b v1-u BlissLauncher3u
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
```
- 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:
```bash
# 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:
```bash
./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](https://gitlab.e.foundation/e/os/BlissLauncher/-/pipelines/latest?ref=v1-u)
- Download and install the icon mask like normal app [SquircleMask.apk](https://gitlab.e.foundation/internal/wiki/-/wikis/uploads/320461a58f097993b29772abe0d2b0b9/KGLN4.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:
```bash
adb shell pm clear com.android.launcher3
```
- Reboot
- Now it is totally ready to use and play around with!
## License
```text
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
```