Pseudo Buildbot
Pseudo is more than the pseudo build bot she started off as, but she likes the
name she was given at birth, so celebrate her.
WHAT IS PSEUDO?
Pseudo is a series of scripts meant to automate an Android build for every
device your vendor supports. Pseudo supports uploading to remote servers
as well!
DEPENDENCIES
Pseudo is dependent upon a few, very vital things. The primary being that
Your Android build environment is maintained in the standard (recommended
by Google) way. Meaning you have a vendor repo with all of your custom
build/packaging scripts, overrides, etc... Pseudo will live as a sub-
project in your vendor repo (don't forget to add it to your vendors
.gitignore).
Additionally, by default, Pseudo relies on you to be using the CyanogenMod
team squisher (found here
https://github.com/CyanogenMod/android_vendor_cm/blob/ics/tools/squisher)
and the ability to 'make bacon'. However, if you do not build using this
system, or prefer making fastboot images (etc), the scripts can be easily
modified to accommodate you.
Other than that, Pseudo *should* be vendor and build independent, to the
extent of being able to work with major manufacturers build trees.
CONFIGURING PSEUDO
All you have to do to configure Pseudo to work with your vendor is to add
it to your manifest to be cloned to vendor/YOUR_VENDOR/bot/. That's it!
Additionally, if you want Pseudo to upload your builds to a remote server
you must create a file named upload in Pseudo's directory and make it
executable. Any bash script will work for it. I have left a (bad) example
as upload_example for ideas. Everything else is completely automated,
unlike other build bots where you have to configure what devices to build,
set different calls (or even individual build scripts per device!).
Pseudo uses all the information already available in the Android build
environment!
Pseudo does have some options you can call during execution they are as
follows
-c = Remove your out/ to create a clean build enviornment for you to
start off the main build with.
-o = Essential what this does is tell Pseudo to use a different vendor's
vendorsetup.sh, but not break the build automation of Pseudo. This
will most commonly be use for themers who build their themes from
source overlays.
EXAMPLE: ./vendor/aokp/bot/deploy.sh -c -o unicorns
will rm -rf out/ before the build, and use the vendorsetup found
in vendor/unicorns/vendorsetup.sh instead of vendor/aokp.
SO YOU WANT TO USE PSEUDO?
Great! That's what she's here for! I do ask though, if you find any ways of
making her better, shoot a pull request our way.
PSEUDOS FUTURE
-Add an if override for the .build_target file so user doesn't have to
build everything if they don't want to.
-More debugging options (exit if anything in the builds fail, etc.).
-Add a nightly/RC/stable toggle for the builds.
-And more!
AUTHORS OF PSEUDO
Romanbb (https://github.com/romanbb)
-Original Author and Unicorn wrangler.
KhasMek (http://github.com/KhasMek)
-Kanger of original script and maker of moar betterer.