Skip to content

Commit f4059de

Browse files
tsterbaktsterbak
authored
Design improvements (#5)
- Add a progressbar and some padding - Style the app a bit more, add icons and banner - Add config for sony xperia z and run black - Start working on sony xperia z - Enable skip on some installation steps
2 parents a45eeaf + 1b6e9e9 commit f4059de

File tree

12 files changed

+584
-168
lines changed

12 files changed

+584
-168
lines changed

‎README.md‎

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -21,6 +21,20 @@
2121
</p>
2222
</div>
2323

24+
25+
## Warning: Unlocking the bootloader will erase all data on your device!
26+
This also includes your DRM keys, which are stored in the Trim Area partition (also called TA).
27+
Before proceeding, ensure the data you would like to retain is backed up to your PC and/or your Google account, or equivalent. Please note that OEM backup solutions like Samsung and Motorola backup may not be accessible from LineageOS once installed.
28+
If you wish to backup the TA partition first, you can find tutorials related to your device on the internet.
29+
30+
## Officially supported devices
31+
Vendor | Device Name | CodeName | Models | Status
32+
---|---|---|---|---
33+
Samsung | Galaxy A3 2017 | a3y17lte | SM-A320FL | tested
34+
Samsung | Galaxy A5 2016 | a5xelte | | under development
35+
Google | Pixel 3a | sargo | sargo | tested
36+
Sony | Xperia Z | yuga | | tested
37+
2438
## Installation
2539

2640
1. Download the AppImage, .exe or appropriate file for your OS.

‎openandroidinstaller/assets/configs/Pixel 3a.yaml‎

Lines changed: 59 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,59 @@
1+
steps:
2+
- title: "Unlock the bootloader"
3+
type: confirm_button
4+
content: "Turn on your device and wait until its fully booted."
5+
- title: "Unlock the bootloader"
6+
type: call_button
7+
content: "Reboot into bootloader"
8+
command: "adb reboot bootloader"
9+
- title: "Unlock the bootloader"
10+
type: confirm_button
11+
content: "Select 'Restart bootloader' on your smartphone screen. Then confirm"
12+
- title: "Unlock the bootloader"
13+
type: call_button
14+
content: "Unlock the bootloader now:"
15+
command: "fastboot flashing unlock"
16+
allow_skip: True
17+
- title: "Unlock the bootloader"
18+
type: confirm_button
19+
content: "At this point the device may display on-screen prompts which will require interaction to continue the process of unlocking the bootloader. Please take whatever actions the device asks you to to proceed."
20+
- title: "Unlock the bootloader"
21+
type: call_button
22+
content: "Reboot the phone"
23+
command: "fastboot reboot"
24+
- title: "Unlock the bootloader"
25+
type: confirm_button
26+
content: "The bootloader is now unlocked. Since the device resets completely, you will need to re-enable USB debugging to continue."
27+
- title: "Flash custom recovery"
28+
type: call_button
29+
content: "Once the device is fully booted, reboot into bootloader"
30+
command: "adb reboot bootloader"
31+
- title: "Flash custom recovery"
32+
type: confirm_button
33+
content: "Select 'Restart bootloader' on your smartphone screen. Then confirm"
34+
- title: "Flash custom recovery"
35+
type: call_button
36+
content: "Flash custom recovery (temporarily)"
37+
command: "fastboot flash boot <recovery>"
38+
- title: "Flash LineageOS"
39+
type: confirm_button
40+
content: "Select 'Recovery Mode' on your smartphone screen. Then confirm"
41+
- title: "Flash LineageOS"
42+
type: confirm_button
43+
content: "Now tap Factory Reset, then Format data / factory reset and continue with the formatting process. This will remove encryption and delete all files stored in the internal storage, as well as format your cache partition (if you have one)."
44+
- title: "Flash LineageOS"
45+
type: confirm_button
46+
content: "Return to the main menu."
47+
- title: "Flash LineageOS"
48+
type: confirm_button
49+
content: "On the device, select “Apply Update”, then “Apply from ADB” to begin sideload. Then confirm here"
50+
- title: "Flash LineageOS"
51+
type: call_button
52+
content: "Flash lineageOS image. Don't remove the USB-Cable!"
53+
command: "adb sideload <image>"
54+
- title: "Flash LineageOS"
55+
type: confirm_button
56+
content: "Flashing finished. Now press 'back' (arrow) and then 'Reboot system now' to finish the installation."
57+
- title: "Successfully finished flashing"
58+
type: text
59+
content: "Have fun with LineageOS!"

‎openandroidinstaller/assets/configs/Samsung Galaxy A3 2017.yaml‎

Lines changed: 3 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,4 @@
11
steps:
2-
- title: "Unlock the bootloader"
3-
type: confirm_button
4-
content: "Turn on developer options and OEM Unlock on your phone."
52
- title: "Boot into recovery"
63
type: confirm_button
74
content: "Turn on your device and wait until its fully booted."
@@ -12,7 +9,7 @@ steps:
129
- title: "Boot into recovery"
1310
type: call_button
1411
content: "Flash custom recovery"
15-
command: "heimdall flash --no-reboot --RECOVERY recovery"
12+
command: "heimdall flash --no-reboot --RECOVERY <recovery>"
1613
- title: "Boot into recovery"
1714
type: confirm_button
1815
content: "Unplug the USB cable from your device. Manually reboot into recovery. Press the Volume Down + Power buttons for 8~10 seconds until the screen turns black & release the buttons immediately when it does, then boot to recovery with the device powered off, hold Volume Up + Home + Power."
@@ -28,8 +25,8 @@ steps:
2825
- title: "Flash LineageOS"
2926
type: call_button
3027
content: "Flash lineageOS image. Don't remove the USB-Cable!"
31-
command: "adb sideload image"
32-
- title: "Boot into recovery"
28+
command: "adb sideload <image>"
29+
- title: "Reboot"
3330
type: call_button
3431
content: "Reboot into OS"
3532
command: "adb reboot"

‎openandroidinstaller/assets/configs/Xperia Z.yaml‎

Lines changed: 58 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,58 @@
1+
steps:
2+
- title: "Unlock the bootloader"
3+
type: confirm_button
4+
content: "On the device, dial *#*#7378423#*#* (*#*#SERVICE#*#*) to launch the service menu."
5+
- title: "Unlock the bootloader"
6+
type: confirm_button
7+
content: "Go to service info > configuration and check rooting status – you can only continue if it says Bootloader unlock allowed: Yes."
8+
- title: "Unlock the bootloader"
9+
type: confirm_button
10+
content: "Connect the device to your PC via USB."
11+
- title: "Unlock the bootloader"
12+
type: call_button
13+
content: "Unlock the bootloader"
14+
command: "adb reboot bootloader"
15+
- title: "Unlock the bootloader"
16+
type: confirm_button
17+
content: "Follow the instructions on Sonys official unlocking website to generate an unlock code for your bootloader. https://developer.sonymobile.com/unlockbootloader/unlock-yourboot-loader/"
18+
- title: "Unlock the bootloader"
19+
type: call_button_with_input
20+
content: "Use your code to unlock the bootloader of your device:"
21+
command: "fastboot oem unlock <inputtext>"
22+
allow_skip: True
23+
- title: "Flash temporary recovery"
24+
type: confirm_button
25+
content: "Since the device resets completely, you will need to re-enable USB debugging to continue. Connect your device to your PC via USB."
26+
- title: "Flash temporary recovery"
27+
type: call_button
28+
content: "Reboot into bootloader"
29+
command: "adb reboot bootloader"
30+
allow_skip: True
31+
- title: "Flash temporary recovery"
32+
type: call_button
33+
content: "Flash recovery image"
34+
command: "fastboot flash boot <recovery>"
35+
- title: "Flash LineageOS"
36+
type: call_button
37+
content: "Boot into recovery"
38+
command: "fastboot reboot"
39+
- title: "Flash LineageOS"
40+
type: confirm_button
41+
content: "Now tap 'Wipe'. Then tap 'Format Data' and continue with the formatting process. This will remove encryption and delete all files stored in the internal storage."
42+
- title: "Flash LineageOS"
43+
type: confirm_button
44+
content: "Return to the previous menu and tap 'Advanced Wipe', then select the 'Cache' and 'System' partitions and then 'Swipe to Wipe'."
45+
- title: "Flash LineageOS"
46+
type: confirm_button
47+
content: "On the device, go back and select “Advanced”, “ADB Sideload”, then swipe to begin sideload. Then confirm here"
48+
- title: "Flash LineageOS"
49+
type: call_button
50+
content: "Flash lineageOS image. Don't remove the USB-Cable!"
51+
command: "adb sideload <image>"
52+
- title: "Reboot"
53+
type: call_button
54+
content: "Reboot into OS"
55+
command: "adb reboot"
56+
- title: "Successfully finished flashing"
57+
type: text
58+
content: "Have fun with LineageOS!"

‎openandroidinstaller/installer_config.py‎

Lines changed: 12 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -3,17 +3,23 @@
33
from typing import List
44

55

6-
class Step():
7-
8-
def __init__(self, title: str, type: str, content: str, command: str=None):
6+
class Step:
7+
def __init__(
8+
self,
9+
title: str,
10+
type: str,
11+
content: str,
12+
command: str = None,
13+
allow_skip: bool = False,
14+
):
915
self.title = title
1016
self.type = type
1117
self.content = content
1218
self.command = command
19+
self.allow_skip = allow_skip
1320

1421

15-
class InstallerConfig():
16-
22+
class InstallerConfig:
1723
def __init__(self, steps: List[Step]):
1824
self.steps = steps
1925

@@ -27,4 +33,4 @@ def from_file(cls, path):
2733
print(exc)
2834

2935
steps = [Step(**raw_step) for raw_step in raw_steps]
30-
return cls(steps)
36+
return cls(steps)

0 commit comments

Comments
 (0)