# Installing Element X Android from a Github Release.
# Installing Element X Android from a Github Release
This document explains how to install Element X Android from a Github Release.
@ -12,9 +12,18 @@ This document explains how to install Element X Android from a Github Release.
@@ -12,9 +12,18 @@ This document explains how to install Element X Android from a Github Release.
## Requirements
The Github release will contain an Android App Bundle (with `aab` extension) file, and not APKs like on the Element Android project. So there is some steps to perform to generate and signed the APKs from the App Bundle. The generated APKs will then be selected depending on your phone configuration to be installed on a device (emulator or real device).
The Github release will contain an Android App Bundle (with `aab` extension) file, unlike in the Element Android project where releases directly provide the APKs. So there are some steps to perform to generate and sign App Bundle APKs. An APK suitable for the targeted device will then be generated.
The easiest way to do that is to use the debug signature that is shared between the developers and stored in the project. So we recommend to checkout the project first. Android Studio is not required, you can use the command line.
The easiest way to do that is to use the debug signature that is shared between the developers and stored in the Element X Android project. So we recommend to clone the project first, to be able to use the debug signature it contains. But note that you can use any other signature. You don't need to install Android Studio, you will only need a shell terminal.
@ -50,6 +59,6 @@ That's it, the application should be installed on your device, you can start it
@@ -50,6 +59,6 @@ That's it, the application should be installed on your device, you can start it
If the application was already installed on your phone, there are several cases:
- it was installed from the PlayStore, you will have to uninstall it first, because the signature will not match.
- it was installed from the PlayStore, you will have to uninstall it first because the signature will not match.
- it was installed from a previous GitHub release, this is like an application upgrade, so no need to uninstall the existing app.
- it was installed from a more recent GitHub release, you will have to uninstall it first.