BuildDroid

An opensource tool to build Android ROMs on Crave. If you have better name for this script, let me know!

Warning

Forking this repository is not recommended as its content frequently changes; instead, please refer to the instructions below. You don't need to fork it.

How to start

Connect to crave devspace, create your project (crave clone list and crave clone create "my_first_build" --projectID XX) and run crave ssh.
Create an empty file with name config.ini, then put #!/bin/bash at start of the file. (nano config.ini) After that, add some variables.
Example config.ini file can be found here
When you'll be ready, simply run exit and:
crave run --no-patch -- "curl https://raw.githubusercontent.com/wojtekojtek/builddroid/refs/heads/main/builddroid.sh | bash"
If you ran all commands correctly, you should see "Waiting for build id:XXXXX to start...". You can close your terminal now. Check results on crave.

Variables

There are 30 variables, only 3 are required to build custom ROM.

Required variables

• codename - your device's codename
  
• lunch - type of android build: user, userdebug or eng
  
• manifest - link to your manifest with trees, fill this or trees
  
• trees - all your device-related repositories, fill this or manifest
  

Signing

• sign - set to true or false
  
• keys - directory with keys
  

Uploading

• server - SourceForge, BashUpload, PixelDrain. Only these are supported.
  
• sfproject - project name if you're using SourceForge
  
• sfdir - directory to upload to, if you're using SourceForge
  
• sfuser - SourceForge username
  
• ssh - auth file name if you're using SourceForge, read more here. don't use passphrase!
  

OTA

For now, only GitHub is supported.

• ota - set to true or false
  
• githubota - repo with OTA jsons, in format: "username/repo"
  
• url - url to raw json OTA file
  
• jsonversion - version of the rom
  
• jsonromtype - type of build
  
• downloadurl - custom url to download, leave empty if you're using server
  
• gitemail - public github email
  
• gituser - github username
  
• gitbranch - ota repo branch, leave "main" if you aren't using different branch
  

Status

• telegram - send info to telegram, set to true or false
  
• chat_id - telegram chat id
  
• private_chat_id - to send BashUpload download link (because the file can be downloaded only once). you can use chat_id
  
• console - if true, will show messages printed by this script
  
• quiet - if true, hide repo tool, github, and other's output, it doesn't hide script output and build logs
  
• user_id - your telegram user ID, allows you to kill build task through telegram (/kill)

Secrets

• githubtoken - for uploading ota jsons
  
• telegramtoken - required if you want to send info about building to telegram
  
• pixeldraintoken - if you are uploading to pixeldrain, fill this too!
  

Unsupported ROMs (only for crave)

• unsupported - put repo init command here to sync unsupported by crave rom
  

Build settings

• cleanbuild - set to true only if you got permission and you need to