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:
Fixes:
- Fairphone3 now uses flashing unlock to unlock the bootloader
- fix bootloader unlock issue with fastboot
Features:
- Disable callbutton while command is running; clean error text at retry
- another steptype for requirements and get them from config.
- restructure welcome page to make it better
- a bit more default pictures for steps
- let advanced view toggle in every step independently
- Enable copy_partitions sideloading
Chores:
- Major refactoring of views
- test search device function in tooling
- refactor call_to_phone method
- refactored terminal box
- test for TerminalBox
11 New devices:
- Motorola moto g7 power (ocean)
- Motorola moto g5 (cedric)
- Samsung Galaxy Note 9 (crownlte)
- Samsung Galaxy Note 10 (d1)
- oneplus 6
- oneplus 6T
- oneplus 7
- oneplus 7 Pro
- oneplus 7T
- oneplus 7T Pro
- OnePlus Nord N200
OnePlus | 7T Pro | [hotdog](https://wiki.lineageos.org/devices/hotdog/) | | tested
66
+
OnePlus | Nord N200 | [dre](https://wiki.lineageos.org/devices/dre/) | | tested
61
67
OnePlus | 9 | lemonade | | under development
62
68
63
69
@@ -105,11 +111,13 @@ Every step in the config file corresponds to one view in the application. These
105
111
-`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.
106
112
-`link_button_with_confirm`: Display a button that opens a browser with a given link, confirm afterwards. Link is given in `link`.
107
113
-`content`: str; The content text displayed alongside the action of the step. Used to inform the user about whats going on.
108
-
-`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`.
114
+
-`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`, `adb_twrp_copy_partitions`, `fastboot_flash_recovery`, `fastboot_unlock_with_code`, `fastboot_unlock`, `fastboot_oem_unlock`, `fastboot_get_unlock_data`, `fastboot_reboot`, `heimdall_flash_recovery`.
109
115
-`img`: [OPTIONAL] Display an image on the left pane of the step view. Images are loaded from `openandroidinstaller/assets/imgs/`.
110
116
-`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.
111
117
-`link`: [OPTIONAL] Link to use for the link button if type is `link_button_with_confirm`.
112
118
119
+
You can also use the `requirements` field in the yaml, to specify `firmware` or `android` version requirements. The user will then be prompted if these requirements are satisfied.
120
+
113
121
### How to build the application for your platform
114
122
115
123
The executables for the OpenAndroidInstaller are build with [pyinstaller](https://pyinstaller.org/en/stable/index.html). You can create builds for MacOS or Linux with `make build-app`. For Windows the paths need to be modified. For now, you can have a look [here](https://github.com/openandroidinstaller-dev/openandroidinstaller/blob/v0.1.2-alpha/.github/workflows/manual-build-windows.yml#L22) on how it's done.
@@ -128,6 +136,7 @@ Other phone vendors stops allowing to unlock the bootloader all together. There
128
136
- The [Android SDK Platform Tools](https://developer.android.com/studio/releases/platform-tools) (such as adb and fastboot) are [Apache](https://android.googlesource.com/platform/system/adb/+/refs/heads/master/NOTICE)-licensed universal Android utilities
129
137
-[Heimdall](https://gitlab.com/BenjaminDobell/Heimdall/) is an [MIT](https://gitlab.com/BenjaminDobell/Heimdall/-/blob/master/LICENSE)-licensed replacement for the leaked ODIN tool to flash Samsung devices.
130
138
-[libusb-1.0](https://github.com/libusb/libusb) is a [LGPL-2.1](https://github.com/libusb/libusb/blob/master/COPYING)-licensed library for USB device access from Linux, macOS, Windows and others.
139
+
-[copy-partitions-20220613-signed.zip](https://mirrorbits.lineageos.org/tools/copy-partitions-20220613-signed.zip) The copy-partitions script was created by LineageOS developer erfanoabdi and filipepferraz and released under LGPL. It is used when the partitions need to be copied before flashing.
As a first step, you need to unlock the bootloader of your device. A bootloader is the piece of software, that tells your phone
11
+
how to start and run an operating system (like Android). You need to boot into fastboot mode by pressing the 'Confirm and run' button. Then continue.
12
+
- type: call_button
13
+
command: fastboot_get_unlock_data
14
+
content: >
15
+
Now you need to get your device ID to get an unlock code from Motorola. Press 'Confirm and run' to get the ID. (You need to toggle 'Advanced Output' here to see it.)
16
+
Copy it to a separate file to use it in the next step.
17
+
- type: link_button_with_confirm
18
+
content: >
19
+
Click on the button to open the instructions on Motorola's official unlocking website to generate an unlock code for your bootloader.
20
+
Copy the code from the last step to the website and follow the instructions there. Then continue here.
content: Connect the device to your PC via USB. And confirm to continue.
24
+
- type: call_button_with_input
25
+
content: >
26
+
Use your code to unlock the bootloader of your device. Type in the full 21 character code you received by email (Example: 5RTSQCYL7ZJKL4NN35MY). Then confirm an run. Afterwards you can continue.
27
+
command: fastboot_unlock_with_code
28
+
- type: call_button_with_input
29
+
content: >
30
+
You need to perform the last command again, so reenter the code and run again. Afterwards you can continue.
31
+
command: fastboot_unlock_with_code
32
+
- type: call_button
33
+
content: >
34
+
Press the button to reboot. Since the device resets completely, you will need to re-enable USB debugging to continue.
35
+
Connect your device to your PC via USB. Then confirm here to continue.
36
+
command: fastboot_reboot
37
+
flash_recovery:
38
+
- type: call_button
39
+
content: >
40
+
Now you need to flash a custom recovery system on the phone. A recovery is a small subsystem on your phone, that manages updating,
41
+
adapting and repairing of the operating system.
42
+
Make sure your device is turned on. You need to reboot into the bootloader again by pressing 'Confirm and run' here. Then continue.
43
+
command: adb_reboot_bootloader
44
+
- type: call_button
45
+
content: Flash a custom recovery (temporarily) by pressing 'Confirm and run'. Once it's done continue.
46
+
command: fastboot_flash_recovery
47
+
install_os:
48
+
- type: call_button
49
+
content: >
50
+
In this last step, you finally flash the selected OS image.
51
+
Wait until the TWRP screen appears. Then run the command.
52
+
This step will format your phone and wipe all the data. It will also remove encryption and delete all files stored
53
+
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.
As a first step, you need to boot into the bootloader. A bootloader is the piece of software,
13
+
that tells your phone who to start and run an operating system (like Android). Your device should be turned on.
14
+
Then press 'Confirm and run' to reboot into the bootloader. Continue once it's done.
15
+
command: adb_reboot_download
16
+
- type: call_button
17
+
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.
18
+
command: heimdall_flash_recovery
19
+
- type: confirm_button
20
+
img: samsung-buttons.png
21
+
content: >
22
+
Unplug the USB cable from your device. Then manually reboot into recovery by pressing the *Volume Down* + *Bixby* for 8~10 seconds
23
+
until the screen turns black & release the buttons immediately when it does, then boot to recovery with the device powered off,
24
+
hold *Volume Up* + *Bixby* + *Power button*.
25
+
install_os:
26
+
- type: call_button
27
+
content: >
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.
As a first step, you need to boot into the bootloader. A bootloader is the piece of software,
13
+
that tells your phone who to start and run an operating system (like Android). Your device should be turned on.
14
+
Then press 'Confirm and run' to reboot into the bootloader. Continue once it's done.
15
+
command: adb_reboot_download
16
+
- type: call_button
17
+
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.
18
+
command: heimdall_flash_recovery
19
+
- type: confirm_button
20
+
img: samsung-buttons.png
21
+
content: >
22
+
Unplug the USB cable from your device. Then manually reboot into recovery by pressing the *Volume Down* + *Bixby* for 8~10 seconds
23
+
until the screen turns black & release the buttons immediately when it does, then boot to recovery with the device powered off,
24
+
hold *Volume Up* + *Bixby* + *Power button*.
25
+
install_os:
26
+
- type: call_button
27
+
content: >
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.
0 commit comments