forked from azwhikaru/Action-TWRP-Builder
-
Notifications
You must be signed in to change notification settings - Fork 2
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
1 changed file
with
50 additions
and
61 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,109 +1,96 @@ | ||
| # Use Github Action to compile Recovery | ||
| ## Automated TWRP compilation based on Github Action | ||
|
|
||
| - Support TWRP, SHRP compilation and production | ||
| ## Advertising | ||
|
|
||
| --- | ||
| 1. OrangeFox is [here](https://github.com/azwhikaru/Action-OFRP-Builder) | ||
|
|
||
| ## Python 2 in Debian (Ubuntu) has been removed. If you are working on Android 8.1 and below, use *Recovery Build (Legacy)* | ||
| ## Notice | ||
|
|
||
| --- | ||
| 1. Github Actions service is **NOT** unlimited so to avoid waste, don't use unverified source code in this, the best used to automate builds of repositories that are already stabilized | ||
|
|
||
| ## OrangeFox is [here](https://github.com/azwhikaru/Action-OFRP-Builder) | ||
| 2. Before you make any changes, make sure that the repository you are operating in belongs to you. **"Fork" if you want to commit code, otherwise use "Use this template"** | ||
|
|
||
| --- | ||
| 3. issues and Pull Requests may **NOT** get a reply. If you think is really necessary, use email on my profile to contact me | ||
|
|
||
| ## Report script issues only, questions about your device may not be responded | ||
| 4. Python 2 in Debian (Ubuntu) has been **removed**. If you are working on Android 8.1 and below, use *Recovery Build (Legacy)* | ||
|
|
||
| --- | ||
| 5. Don't ask any questions about your source code, such as | ||
| - No rule to make ... | ||
| - Image ... out of size | ||
|
|
||
| ## Thanks to | ||
| - All contributors | ||
|
|
||
| --- | ||
|
|
||
| ## Release Notes | ||
| ``` | ||
| = 2022/10/28 | ||
| - OFRP manifest is changed, so not fully support OFRP now (if you can slove this, please submit a pull request!) | ||
| = 2022/07/08 | ||
| - TWRP and TWRP-based 5.X ~ 12.X are ***ALL COMPILED SUCCESSFULLY*** | ||
| = 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 | ||
| ``` | ||
|
|
||
| ----- | ||
| All contributors | ||
|
|
||
| ## Parameter Description | ||
|
|
||
| | Name | Description | Example | | ||
| | ------------ | -------------------- | ------------ | | ||
| | `MANIFEST_URL` | Source address | https://github.com/minimal-manifest-twrp/platform_manifest_twrp_aosp.git | | ||
| | `MANIFEST_BRANCH` | Source branch | twrp-12.1 | | ||
| | `DEVICE_TREE_URL` | Device address | https://github.com/TeamWin/android_device_asus_I003D | | ||
| | `DEVICE_TREE_BRANCH` | Device branch | android-12.1 | | ||
| | `DEVICE_PATH` | Device location | device/asus/I003D | | ||
| | `COMMON_TREE_URL` | Common tree address | https://github.com/TeamWin/android_device_asus_sm8250-common | | ||
| | `COMMON_PATH` | Common tree location | device/asus/sm8250-common | | ||
| | `DEVICE_NAME` | Model name | I003D | | ||
| | `MAKEFILE_NAME` | Makefile name | twrp_I003D | | ||
| | `BUILD_TARGET` | Build Target Partition (boot/recovery/vendorboot) | recovery | | ||
| | Name | Description | Example | | ||
| | -------------------- | ------------------------------------------------- | ------------------------------------------------------------ | | ||
| | `MANIFEST_URL` | Source address | https://github.com/minimal-manifest-twrp/platform_manifest_twrp_aosp.git | | ||
| | `MANIFEST_BRANCH` | Source branch | twrp-12.1 | | ||
| | `DEVICE_TREE_URL` | Device address | https://github.com/TeamWin/android_device_asus_I003D | | ||
| | `DEVICE_TREE_BRANCH` | Device branch | android-12.1 | | ||
| | `DEVICE_PATH` | Device location | device/asus/I003D | | ||
| | `COMMON_TREE_URL` | Common tree address | https://github.com/TeamWin/android_device_asus_sm8250-common | | ||
| | `COMMON_PATH` | Common tree location | device/asus/sm8250-common | | ||
| | `DEVICE_NAME` | Model name | I003D | | ||
| | `MAKEFILE_NAME` | Makefile name | twrp_I003D | | ||
| | `BUILD_TARGET` | Build Target Partition (boot/recovery/vendorboot) | recovery | | ||
|
|
||
| ----- | ||
|
|
||
| ## How to use | ||
|
|
||
| ``` | ||
| For example, your username is: JohnSmith | ||
| ``` | ||
| #### 1. Click 'Fork' in the upper right corner of this repository | ||
|
|
||
| #### 0. If you want to commit code, click 'Fork' in the upper right corner of this repository | ||
|
|
||
|  | ||
|
|
||
| #### 1. If you just want to use it simply, click 'Use this template' in the upper right corner of this repository | ||
|
|
||
|  | ||
|
|
||
| #### 2. After waiting for the automatic redirection, you will see your own username | ||
|
|
||
|  | ||
|
|
||
| #### 3. Change the [username and email](https://github.com/CaptainThrowback/Action-Recovery-Builder/blob/main/.github/workflows/Recovery%20Build.yml#L100-L101) in the workflow to reflect your Github credentials (optional) | ||
|
|
||
| ## Setting up SSH Keys (optional) | ||
|
|
||
| #### 4. Go to Settings, then select Deploy keys and select "Add deploy key" button. | ||
|
|
||
| #### 5. On your Android device, install [Termux](https://github.com/termux/termux-app/releases) | ||
|
|
||
| #### 6. Install openssh in Termux and generate ssh keys. (Do not use passphrase for keys) | ||
|
|
||
| NOTE: When creating the deploy key for a repository like [email protected]:owner/repo.git or https://github.com/owner/repo, put that URL into the key comment. (Hint: Try ssh-keygen ... -C "[email protected]:owner/repo.git".) | ||
| owner = your Github username | ||
|
|
||
| ``` | ||
| pkg install openssh | ||
| ssh-keygen -t ed25519 -C "[email protected]:owner/Action-Recovery-Builder.git" | ||
| ``` | ||
|
|
||
| #### 7. Add the keys to your repo. In Termux, use the following commands: | ||
|
|
||
| ``` | ||
| cd /data/data/com.termux/files/usr/etc/ssh | ||
| cat ssh_host_ed25519_key.pub | ||
| ``` | ||
|
|
||
| Select and copy the key then paste in the box for Key. | ||
| You can name it whatever you choose for the title. | ||
|
|
||
| #### 8. Now to add your private ssh key. Back in Termux: | ||
|
|
||
| ``` | ||
| cat ssh_host_ed25519_key | ||
| ``` | ||
|
|
||
| Copy the output from Termux. | ||
|
|
||
| In your browser, select *Secrets* under the Security tab. | ||
|
|
@@ -114,19 +101,21 @@ cat ssh_host_ed25519_key | |
| Then select Add secret. | ||
|
|
||
| ## Building the Recovery | ||
|
|
||
| #### 9. Click 'Actions-Recovery Build' | ||
|
|
||
|  | ||
|
|
||
| #### 10. Click 'Run workflow' and fill in according to the above 'parameter description' | ||
|
|
||
|  | ||
|
|
||
| #### 11. After filling in, click 'Run workflow' to start running | ||
|
|
||
| ----- | ||
|
|
||
| ## Compilation results | ||
|
|
||
| Can be downloaded at [Release](../../releases) | ||
|
|
||
| ----- | ||
| ## Remark | ||
|
|
||
| #### TeamWin Recovery Project: https://github.com/minimal-manifest-twrp | ||
| #### SKYHAWK Recovery Project: https://github.com/SHRP/manifest | ||