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
This PR adds:
- Simplify config files
- Popup enabled again
- Make enabeling developer options clearer, better design hierarchy
- Use twrp scripting
- Use specific functions to run commands with tools
- Write logs to file
Copy file name to clipboardExpand all lines: README.md
+3-7Lines changed: 3 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -45,8 +45,8 @@ Sony | Xperia Z | yuga | C6603 | tested
45
45
Sony | Xperia Z3 | z3 | | under development
46
46
Sony | Xperia ZX | kagura | | planned
47
47
Fairphone | Fairphone 2 | FP2 | | under development
48
-
Fairphone | Fairphone 3 | FP3 | | under development
49
-
Motorola | Moto G5 | cedric | | planned
48
+
Fairphone | Fairphone 3 | FP3 | | tested
49
+
Motorola | moto G5 | cedric | | planned
50
50
Motorola | moto g7 power | ocean | | under development
51
51
52
52
@@ -87,18 +87,14 @@ If you want to use the tool for a non-supported smartphone, the fastest way is t
87
87
#### Content of a config file
88
88
89
89
Every step in the config file corresponds to one view in the application. These steps should contain the following fields:
90
-
-`title`: str; Describing the overall goal of the step. Will be displayed in the header of the view.
91
90
-`type`: str; Corresponds to the type of view to generate. There are the following options:
92
91
-`text`: Just display the text given in content.
93
92
-`confirm_button`: Display the content, as well as a button to allow the user to go to the next step.
94
93
-`call_button`: Display the content text and a button that runs a given command. After the command is run, a confirm button is displayed to allow the user to move to the next step.
95
94
-`call_button_with_input`: Display the content text, an input field and a button that runs a given command. The inputtext, can be used in the command by using the `<inputtext>` placeholder in the command field. After the command is run, a confirm button is displayed to allow the user to move to the next step.
96
95
-`link_button_with_confirm`: Display a button that opens a browser with a given link, confirm afterwards. Link is given in `link`.
97
96
-`content`: str; The content text displayed alongside the action of the step. Used to inform the user about whats going on.
98
-
-`command`: [ONLY for call_button* steps] str; This is a terminal command run in a shell. (For example fastboot or adb). There are three types of placeholders supported, that will be filled by the tool as soon as information is given.
99
-
-`<image>`: The path of the ROM image file.
100
-
-`<recovery>`: The path of the recovery file.
101
-
-`<inputtext>`: Text from the user input from `call_button_with_input` views.
97
+
-`command`: [ONLY for call_button* steps] str; The command to run. One of `adb_reboot`, `adb_reboot_bootloader`, `adb_reboot_download`, `adb_sideload`, `adb_twrp_wipe_and_install`, `fastboot_flash_recovery`, `fastboot_unlock_with_code`, `fastboot_unlock`, `fastboot_oem_unlock`, `fastboot_reboot`, `heimdall_flash_recovery`.
102
98
-`img`: [OPTIONAL] Display an image on the left pane of the step view. Images are loaded from `openandroidinstaller/assets/imgs/`.
103
99
-`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.
104
100
-`link`: [OPTIONAL] Link to use for the link button if type is `link_button_with_confirm`.
content: Press 'Confirm and run' to reboot into the bootloader.
16
+
command: adb_reboot_bootloader
17
+
- type: confirm_button
18
+
content: >
19
+
Select 'Restart bootloader' on your smartphone screen by pressing the volume button and the confirm by pushing the power button.
20
+
Then press 'Confirm and continue' here.
21
+
- type: call_button
22
+
content: In this step you actually unlock the bootloader. Just press 'Confirm and run' here. Once it's done, press continue here.
23
+
command: fastboot_oem_unlock
24
+
- type: confirm_button
25
+
content: >
26
+
Follow the instructions on the Fairphone screen. This command will wipe all the personal data on your phone.
27
+
- type: call_button
28
+
content: To finish the unlocking, the phone needs to reboot. Just press 'Confirm and run' here to reboot. Then continue.
29
+
command: fastboot_reboot
30
+
- type: confirm_button
31
+
content: The bootloader is now unlocked. Since the device resets completely, you will need to re-enable USB debugging to continue.
13
32
flash_recovery:
14
-
- title: "Flash a custom recovery"
15
-
type: confirm_button
33
+
- type: confirm_button
16
34
content: >
17
35
Now you need to flash a custom recovery system on the phone. A recovery is a small subsystem on your phone, that manages updating,
18
36
adapting and repairing of the operating system.
19
-
- title: "Flash a custom recovery"
20
-
type: call_button
37
+
- type: call_button
21
38
content: Turn on your device. Once the device is fully booted, you need to reboot into the bootloader again by pressing 'Confirm and run' here. Then continue.
22
-
command: "adb reboot bootloader"
23
-
- title: "Flash a custom recovery"
24
-
type: call_button
39
+
command: adb_reboot_bootloader
40
+
- type: call_button
25
41
content: Once the device is in fastboot mode, flash the custom recovery (temporarily) by pressing 'Confirm and run'. Once it's done continue.
26
-
command: "fastboot flash boot <recovery>"
27
-
- title: "Flash temporary recovery"
28
-
type: confirm_button
42
+
command: fastboot_flash_recovery
43
+
- type: confirm_button
29
44
content: >
30
45
Now reboot into recovery to verify the installation. Do not reboot into the existing OS, since it will overwrite the recovery you just installed!
31
46
With the device powered off, hold 'Volume Up + Power'. Release when boot logo appears.
32
47
install_os:
33
-
- title: "Flash LineageOS"
34
-
type: confirm_button
48
+
- type: confirm_button
35
49
content: >
36
50
Now tap 'Factory Reset', then 'Format data / Factory reset' on your phone screen and continue with the formatting process.
37
51
This will remove encryption and delete all files stored in the internal storage, as well as format your cache partition (if you have one).
38
-
- title: "Flash LineageOS"
39
-
type: confirm_button
40
-
content: Return to the main menu on the phone.
41
-
- title: "Flash LineageOS"
42
-
type: confirm_button
43
-
content: On the device, select “Apply Update”, then “Apply from ADB” to begin sideload. Then confirm here.
44
-
- title: "Flash LineageOS"
45
-
type: call_button
52
+
- type: confirm_button
53
+
content: >
54
+
Return to the main menu on the phone by pressing the back button.
55
+
On the device, select “Apply Update”, then “Apply from ADB” to begin sideload. Then confirm here.
56
+
- type: call_button
46
57
content: >
47
58
Now it's time to flash the LineageOS image. Don't remove the USB-Cable and press 'Confirm and run' to start!
48
59
This might take a while. Confirm after it's done.
49
-
command: "adb sideload <image>"
50
-
- title: "Flash LineageOS"
51
-
type: confirm_button
60
+
command: adb_sideload
61
+
- type: confirm_button
52
62
content: Flashing finished. Now press 'back' (arrow) and then 'Reboot system now' on the phone screen to finish the installation. Then confirm here.
Unplug the USB cable from your device. Then manually reboot into recovery by pressing the *Volume Down* + *Power buttons* for
26
23
8~10 seconds until the screen turns black & release the buttons immediately when it does, then boot to recovery with the device powered off,
27
-
hold *Volume Up* + *Home* + *Power*.
24
+
hold *Volume Up* + *Home* + *Power*. Confirm when the recovery screen appears.
28
25
install_os:
29
-
- title: "Flash LineageOS"
30
-
type: confirm_button
26
+
- type: call_button
31
27
content: >
32
-
Now swipe right to allow modifications then tap 'Wipe' on your phone. Next tap 'Format Data' and follow
33
-
the instructions on your phone to continue with the formatting process. This will remove encryption and delete all files stored
34
-
in the internal storage. Confirm to continue once you are done.
35
-
- title: "Flash LineageOS"
36
-
type: confirm_button
37
-
content: >
38
-
Return to the previous menu on your phone by going back two times.
39
-
Them tap 'Advanced Wipe', and select the 'Cache' and 'System' partitions and then 'Swipe to Wipe'.
40
-
Confirm to continue once you are done.
41
-
- title: "Flash LineageOS"
42
-
type: confirm_button
43
-
content: >
44
-
Now connect the phone to the computer again with the USB-cable. On the device, go back three times and select “Advanced”,
45
-
then “ADB Sideload”. Select 'Wipe cache' and 'Wipe dalvik cache', then swipe to begin sideload. Then confirm here.
46
-
- title: "Flash LineageOS"
47
-
type: call_button
48
-
content: >
49
-
Now it's time to flash the LineageOS image. Don't remove the USB-Cable and press 'Confirm and run' to start!
50
-
This might take a while. Confirm after it's done.
51
-
command: "adb sideload <image>"
52
-
- title: "Reboot into LineageOS"
53
-
type: call_button
54
-
content: As a final step, reboot into LineageOS to finish the installation by pressing the button.
55
-
command: "adb reboot"
28
+
In the next steps, you finally flash the selected OS image.
29
+
Connect your device with your computer with the USB-Cable.
30
+
This step will format your phone and wipe all the data. It will also remove encryption and delete all files stored
31
+
in the internal storage. Then the OS image will be installed. Confirm to run. This might take a while. At the end your phone will boot into the new OS.
Copy file name to clipboardExpand all lines: openandroidinstaller/assets/configs/a5xelte.yaml
+11-34Lines changed: 11 additions & 34 deletions
Original file line number
Diff line number
Diff line change
@@ -5,49 +5,26 @@ metadata:
5
5
steps:
6
6
unlock_bootloader:
7
7
flash_recovery:
8
-
- title: "Boot into bootloader"
9
-
type: call_button
8
+
- type: call_button
10
9
content: >
11
10
As a first step, you need to boot into the bootloader. A bootloader is the piece of software,
12
11
that tells your phone who to start and run an operating system (like Android). Your device should be turned on.
13
12
Then press 'Confirm and run' to reboot into the bootloader. Continue once it's done.
14
-
command: "adb reboot download"
15
-
- title: "Flash custom recovery"
16
-
type: call_button
13
+
command: adb_reboot_download
14
+
- type: call_button
17
15
content: In this step, you need to flash a custom recovery on your device. Press 'Confirm and run' to start the process. Confirm afterwards to continue.
Unplug the USB cable from your device. Then manually reboot into recovery by pressing the *Volume Down* + *Power buttons* for 8~10 seconds
24
21
until the screen turns black & release the buttons immediately when it does, then boot to recovery with the device powered off,
25
22
hold *Volume Up* + *Home* + *Power button*.
26
23
install_os:
27
-
- title: "Flash LineageOS"
28
-
type: confirm_button
24
+
- type: call_button
29
25
content: >
30
-
Now swipe right to allow modifications then tap 'Wipe' on your phone.
31
-
Next tap 'Format Data' and follow the instructions on your phone to continue with the formatting process.
32
-
This will remove encryption and delete all files stored in the internal storage. Confirm to continue once you are done.
33
-
- title: "Flash LineageOS"
34
-
type: confirm_button
35
-
content: >
36
-
Return to the previous menu on your phone by going back two times.
37
-
Them tap 'Advanced Wipe', and select the 'Cache' and 'System' partitions and then 'Swipe to Wipe'.
38
-
Confirm to continue once you are done.
39
-
- title: "Flash LineageOS"
40
-
type: confirm_button
41
-
content: >
42
-
Now connect the phone to the computer again with the USB-cable. On the device, go back three times and select “Advanced”,
43
-
then “ADB Sideload”. Select 'Wipe cache' and 'Wipe dalvik cache', then swipe to begin sideload. Then confirm here.
44
-
- title: "Flash LineageOS"
45
-
type: call_button
46
-
content: >
47
-
Now it's time to flash the LineageOS image. Don't remove the USB-Cable and press 'Confirm and run' to start!
48
-
This might take a while. Confirm after it's done.
49
-
command: "adb sideload <image>"
50
-
- title: "Reboot into LineageOS"
51
-
type: call_button
52
-
content: As a final step, reboot into LineageOS to finish the installation by pressing the button.
53
-
command: "adb reboot"
26
+
In the next steps, you finally flash the selected OS image.
27
+
Connect your device with your computer with the USB-Cable.
28
+
This step will format your phone and wipe all the data. It will also remove encryption and delete all files stored
29
+
in the internal storage. Then the OS image will be installed. Confirm to run. This might take a while. At the end your phone will boot into the new OS.
0 commit comments