You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Samsung | Galaxy S9 | starlte | | under development
36
37
Google | Pixel 3a | sargo | sargo | tested
38
+
Google | Pixel 4a | sunfish | sunfish | planned
37
39
Sony | Xperia Z | yuga | C6603 | tested
38
40
Sony | Xperia Z3 | z3 | | under development
39
41
Sony | Xperia ZX | kagura | | planned
40
42
Fairphone | Fairphone 2 | FP2 | | under development
43
+
Fairphone | Fairphone 3 | FP3 | | planned
41
44
Xiaomi | Mi 9 Lite | pyxis | | planned
45
+
Motorola | Moto G5 | cedric | | planned
46
+
LG | G7 Thinq | judyln | | planned
42
47
43
48
44
49
## Usage
@@ -52,7 +57,7 @@ Currently, only linux is supported.
52
57
53
58
## Run OpenAndroidInstaller for development
54
59
55
-
Currently development is only supported on Ubunut Linux. MacOS should also work fine.
60
+
Currently development is only supported on Ubuntu Linux. MacOS should also work fine.
56
61
57
62
1. Clone the main branch of this repository
58
63
2. Run `make install` to install poetry to manage python and install the requirend dependencies like adb, fastboot and heimdall.
@@ -77,11 +82,18 @@ Every step in the config file corresponds to one view in the application. These
77
82
-`<image>`: The path of the image file.
78
83
-`<recovery>`: The path of the recovery file.
79
84
-`<inputtext>`: Text from the user input from `call_button_with_input` views.
80
-
-`img`: Display an image on the left pane of the step view. Images are loaded from `openandroidinstaller/assets/imgs/`.
85
+
-`img`: [OPTIONAL]Display an image on the left pane of the step view. Images are loaded from `openandroidinstaller/assets/imgs/`.
81
86
-`allow_skip`: [OPTIONAL] boolean; If a skip button should be displayed to allow skipping this step. Can be useful when the bootloader is already unlocked.
82
87
83
-
After you created a config file, you can open a pull request to make the file available to other users. The file should be named after device name output by `adb shell dumpsys bluetooth_manager | grep 'name:' | cut -c9-` when the devices is connected to the computer. Please also add the device to the supported devices table above.
88
+
The file should be named after device name output by `adb shell getprop | grep ro.poroduct.device` when the devices is connected to the computer. You can also get the device code by connecting the device to the computer and run OpenAndroidInstaller to detect the device.
84
89
90
+
To test your config file with the executable without using the developer setup, place it in the same directory as the executable. There it will be detected by name.
91
+
After you created a config file and it works fine, you can open a pull request to make the file available to other users. Please also add the device to the supported devices table above.
92
+
93
+
#### On unlocking the bootloader
94
+
Some devices with require manual steps to unlock the bootloader. In general you will need to create an account at a vendor website and receive some code from there. OpenAndroidInstaller will try to guide you as far as possible. These vendors include *Sony, Motorola, Xiaomi* among others.
95
+
96
+
Other phone vendors stops allowing to unlock the bootloader all together. There is nothing to be done if you didn't unlock your device in time. These vendors include *Huawei and LG* among others. Support for these vendors will always be very limited.
0 commit comments