Skip to content

Latest commit

 

History

History
131 lines (99 loc) · 4.71 KB

README.md

File metadata and controls

131 lines (99 loc) · 4.71 KB
Raw

使用Github Action编译Recovery

  • 支持TWRP、SHRP编译和制作

Debian (Ubuntu) 中的 Python 2 已被删除。 如果您使用的是 Android 8.1 及更低版本，请使用 Recovery Build (Legacy)

OrangeFox is here

Report script issues only, questions about your device may not be responded

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

Parameter Description

Name Description Example
MANIFEST_URL 源码地址 https://github.com/minimal-manifest-twrp/platform_manifest_twrp_aosp.git
MANIFEST_BRANCH 源码分支 twrp-12.1
DEVICE_TREE_URL 设备树地址 https://github.com/TeamWin/android_device_asus_I003D
DEVICE_TREE_BRANCH 设备树分支 android-12.1
DEVICE_PATH 设备位置 device/asus/I003D
COMMON_TREE_URL 通用设备树地址 https://github.com/TeamWin/android_device_asus_sm8250-common
COMMON_PATH 通用设备地址 device/asus/sm8250-common
DEVICE_NAME 机型名称 I003D
MAKEFILE_NAME 编译文件名 twrp_I003D
BUILD_TARGET 建立目标分区 (boot/recovery/vendorboot) recovery

How to use

For example, your username is: JohnSmith

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

image

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

image

3. Change the username and email 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

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. Select Actions Select New repository secret For the New secret name, it should be SSH_PRIVATE_KEY Paste the output from ssh_host_ed25519_key into the Value box. Then select Add secret.

Building the Recovery

9. Click 'Actions-Recovery Build'

image

10. Click 'Run workflow' and fill in according to the above 'parameter description'

image

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

编译结果

可以在以下网址下载 Release

注释

TeamWin Recovery Project: https://github.com/minimal-manifest-twrp