Howto troubleshoot issues with the easy-installer

General hints

Please specify operating system and phone model

In case you ask for help, please specify which operating system you are using and whether you try to install on FP3 or FP3+. If it’s an FP3, please also specify if you’ve done the update to Android 10 or if you’re still on Android 9.

Where to find the log

The installer creates a log file with a randomly generated name (e.g. 45761d08-711f-435a-881d-a236949654bb.log) that might contain useful information if something doesn’t work as expected.

Location of the log file:

  • Linux: ~/snap/easy-installer/common
  • Windows: %LOCALAPPDATA%\easy-installer

Problems running the installer

Unable to open DISPLAY (on Linux)

This happens when the installer is run on wayland. It should work in an xorg session. See: Running Easy Installer

The full error looks like this:

    Exception in thread "main" java.lang.reflect.InvocationTargetException
	at java.base/jdk.internal.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
	at java.base/jdk.internal.reflect.NativeMethodAccessorImpl.invoke(Unknown Source)
	at java.base/jdk.internal.reflect.DelegatingMethodAccessorImpl.invoke(Unknown Source)
	at java.base/java.lang.reflect.Method.invoke(Unknown Source)
	at java.base/sun.launcher.LauncherHelper$FXHelper.main(Unknown Source)
Caused by: java.lang.UnsupportedOperationException: Unable to open DISPLAY
	at javafx.graphics/com.sun.glass.ui.gtk.GtkApplication.lambda$new$6(Unknown Source)
	at java.base/java.security.AccessController.doPrivileged(Native Method)
	at javafx.graphics/com.sun.glass.ui.gtk.GtkApplication.<init>(Unknown Source)
	at javafx.graphics/com.sun.glass.ui.gtk.GtkPlatformFactory.createApplication(Unknown Source)
	at javafx.graphics/com.sun.glass.ui.Application.run(Unknown Source)
	at javafx.graphics/com.sun.javafx.tk.quantum.QuantumToolkit.startup(Unknown Source)
	at javafx.graphics/com.sun.javafx.application.PlatformImpl.startup(Unknown Source)
	at javafx.graphics/com.sun.javafx.application.PlatformImpl.startup(Unknown Source)
	at javafx.graphics/com.sun.javafx.application.LauncherImpl.startToolkit(Unknown Source)
	at javafx.graphics/com.sun.javafx.application.LauncherImpl.launchApplicationWithArgs(Unknown Source)
	at javafx.graphics/com.sun.javafx.application.LauncherImpl.launchApplication(Unknown Source)
	... 5 more

Installer hangs after unlock instructions in “Start device in Fastboot mode” (on Windows)

If detection of the phone in fastboot mode fails on Windows (also when a manual fastboot devices doesn’t see the phone) you might have to install extra drivers.

For detailed instructions (incl. Screenshots) see FP3+ no USB conection via fastboot, unlocking bootloader not possible

Problems compiling the installer

$JAVA_HOME not set

To compile the easy-installer the $JAVA_HOME environment variable needs to be set. See Can't compile easy installer

The error message is not very helpful in this case, it just outputs the following:

./gradlew dist

[...]

> Task :prepareMergedJarsDir FAILED
:prepareMergedJarsDir (Thread[Task worker for ':',5,main]) completed. Took 0.0 secs.

FAILURE: Build failed with an exception.

* What went wrong:
Execution failed for task ':prepareMergedJarsDir'.
> No value has been specified for this provider.

To see a more detailed compile log, execute

./gradlew dist --debug --stacktrace
3 Likes

Hi,
when will be the next /e/installer release ?

Edit : i mean with more devices

The easy installer is open for developers from the community to update. If there are users who would want to upgrade the Easy Installer they are welcome to modify the code.

The documentation to get someone started adding new devices is at: https://gitlab.e.foundation/e/tools/easy-installer/-/wikis/home

If you want a rough breakdown of the steps involved, see