Skip to content

Commit 3666955

Browse files
authored
Improve build quality (#24)
- Add more binaries to the builds - Update contribution guidelines - Use a proper build script - Clean-up unused scripts
2 parents c24d795 + 26438ed commit 3666955

File tree

5 files changed

+20
-93
lines changed

5 files changed

+20
-93
lines changed

.github/workflows/manual-build-windows.yml

Lines changed: 0 additions & 28 deletions
This file was deleted.

.github/workflows/manual-build.yml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ jobs:
1010
strategy:
1111
fail-fast: false
1212
matrix:
13-
os: ['ubuntu-latest', 'macos-latest']
13+
os: ['ubuntu-latest', 'macos-latest', 'windows-latest']
1414

1515
steps:
1616
- uses: actions/checkout@v2
@@ -19,7 +19,7 @@ jobs:
1919
python-version: 3.9
2020
- run: pip install -r requirements.txt
2121
- run: python scripts/download-tools.py
22-
- run: pyinstaller openandroidinstaller/openandroidinstaller.py --noconsole --noconfirm --onefile --icon "openandroidinstaller/assets/favicon.ico" --add-data "openandroidinstaller/assets:assets" --add-binary "openandroidinstaller/bin/adb:bin" --add-binary "openandroidinstaller/bin/fastboot:bin" --add-binary "openandroidinstaller/bin/heimdall:bin" --windowed
22+
- run: python scripts/build.py
2323
# Optionally verify that it works (provided that it does not need user interaction)
2424
#- run: ./dist/your-code/your-code
2525
- uses: actions/upload-artifact@v3

Makefile

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ app:
1515
poetry run python openandroidinstaller/openandroidinstaller.py
1616

1717
build-app:
18-
poetry run pyinstaller openandroidinstaller/openandroidinstaller.py --noconsole --noconfirm --onefile --icon "openandroidinstaller/assets/favicon.ico" --add-data "openandroidinstaller/assets:assets" --add-binary "openandroidinstaller/bin/adb:bin" --add-binary "openandroidinstaller/bin/fastboot:bin" --add-binary "openandroidinstaller/bin/heimdall:bin" --windowed
18+
poetry run python scripts/build.py
1919

2020
clean-build:
2121
rm -rf build/ dist/

README.md

Lines changed: 17 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -57,7 +57,7 @@ Linux is currently the best supported platform (tested with Ubuntu 20.04 LTS). W
5757

5858
## Run OpenAndroidInstaller for development
5959

60-
Currently development is only supported on Ubuntu Linux. MacOS should also work fine.
60+
Currently development is only supported on Ubuntu Linux. MacOS and Windows should also work fine. You might need to install additional USB-drivers on Windows.
6161

6262
1. Clone the main branch of this repository
6363
2. Run `make poetry` and `make install` to install poetry to manage python and install the required dependencies like adb, fastboot and heimdall.
@@ -66,7 +66,14 @@ Currently development is only supported on Ubuntu Linux. MacOS should also work
6666

6767
## Contributing
6868

69-
### Contribute your own installation configurations
69+
All kinds of contributions are welcome. These include:
70+
- Fix and improve texts in configs and in the application.
71+
- Test the tool for a supported device.
72+
- Create a config for a new device.
73+
- Test the application on your computer.
74+
- Contribute an application build for a new platform.
75+
76+
### How to contribute your own installation configurations
7077

7178
If you want to use the tool for a non-supported smartphone, the fastest way is to adapt an [existing config file](https://github.com/openandroidinstaller-dev/openandroidinstaller/tree/main/openandroidinstaller/assets/configs).
7279

@@ -92,7 +99,15 @@ The file should be named after device name output by `adb shell getprop | grep r
9299
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.
93100
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.
94101

102+
### How to build the application for your platform
103+
104+
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.
105+
106+
If you build the application for your platform and want to contribute the build, please reach out to me.
107+
95108
#### On unlocking the bootloader
109+
Devices by *Samsung*, *Google* and *Fairphone* make it fairly easy to unlock the bootloader and receive good support in the installer.
110+
96111
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.
97112

98113
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.

scripts/check-image-for-device.py

Lines changed: 0 additions & 60 deletions
This file was deleted.

0 commit comments

Comments
 (0)