Skip to content

EAZYBLACK/Action-Recovery-Builder

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Use Github Actions to compile Custom Recovery

Supports TWRP, OrangeFox, PBRP & SHRP compilation and production

Release Notes

= 2024-03-05
- [TWRP, OrangeFox] Allow non-Github/Gitlab remotes for AOSP device trees

= 2024-02-23
- [OrangeFox] Add input field for additional/optional flags
- [OrangeFox] Add fixes for some unique device trees

= 2024-02-17
- Add PBRP support
- Add SHRP support
- Update README to support all branches

= 2024-02-16
- Remove requirement to set git credentials
- Fix OrangeFox build

= 2024-02-16
- Clarify options in README

= 2024-02-15
- Add option to include recovery installer

= 2024-02-12
- Split custom builds into separate branches (TWRP is default, others are WIP)
- Simplify manifest branch selection and remove URL input
- Remove SSH support

= 2024/02/11
- Fix support for dependencies in AOSP trees
- Increase swap size for kernel inline builds
- Remove common tree input fields (not needed)
- OrangeFox not presently supported due to script-based sync methods

= 2023/11/28
- Add support to repopick patches from Gerrit

= 2023/10/31
- Fix build with Omni manifests
- 5.1 branch no longer supported

= 2023/07/21
- Update to ubuntu-20.04
- May not work on older twrp branches

= 2022/07/06
- Add support for 5.1 branch

= 2022/07/05
- Updated to work with trees back to 6.0
- Add conditionals to include common trees for syncing
- Update README for SSH keys

= 2022/07/04
- Updated to work with Android 12.1 AOSP minimal TWRP manifest

= 2022/05/29
- Should work correctly with Android 11 based source code

= 2022/02/03
- Due to the hardware resource limitation of GitHub action, this version cannot be compiled based on AOSP and other source codes of Android 11 and above. If necessary, please use local compilation

= 2021/10/29: 
- Refactored version 2.0
- Completely reconstruct the use logic to reduce the difficulty of use
- Optimize the parameter transfer part, now you can run multiple Workers at the same time
- TWRP compilation test passed
- OFRP compilation test passed
- SHRP compile test passed

Parameter Description

(not all branches require/support all of the below fields)

Name Description Example
MANIFEST_BRANCH Source branch 12.1
DEVICE_TREE_URL Device tree address https://github.com/TeamWin/android_device_asus_I003D
DEVICE_TREE_BRANCH Device branch that you want to use for build (typically corresponds to the manifest branch) android-12.1
DEVICE_PATH Device tree location for syncing, relative to workspace root (usually listed as "LOCAL_PATH" or "DEVICE_PATH" in BoardConfig.mk) device/asus/I003D
DEVICE_NAME Model name (same as twrp_<DEVICE_NAME>.mk from device tree) I003D
DEVICE_MAKEFILE Name of device-specific makefile from tree (format: <PREFIX>_<DEVICE_NAME>) twrp_I003D
REPOPICK_PATCHES (Optional) Gerrit patches to include in build (space separated) - if you don't know what this means, then leave blank 1245 1437
BUILD_TARGET Build Target Partition (boot/recovery/vendor_boot) recovery
RECOVERY_INSTALLER Include recovery installer zip no
OPTIONAL_FLAGS Additional/custom build commands should be entered here export FOX_VIRTUAL_AB_DEVICE=1

Usage Instructions

For example, your username is: Run-114514

1. Click 'Fork' in the upper right corner of this repo

2. After waiting for the automatic redirection, you will see your own username

Building the Recovery

3. Click 'Actions-Recovery Build'

4. Click 'Run workflow', choose the branch for the recovery that you want to build, and fill in according to the above 'Parameter Description'

5. After filling in, click 'Run workflow' to start running


Compilation results

Can be downloaded at Release


Reference

SKYHAWK Recovery Project: https://github.com/SHRP/manifest.git

About

Build Recovery for Android with GitHub Workflow

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Shell 100.0%