The all-in-one Sailfish OS local development bootstrapping script.
In case you haven't already, you should configure git with the basics:
git config --global user.name "Your Name"
git config --global user.email "[email protected]"
git config --global color.ui "auto"
Then get sfbootstrap
:
git clone https://github.com/JamiKettunen/sfbootstrap.git
cd sfbootstrap
# to choose your device interactively:
./sfbootstrap.sh init
# or if you know it's name already:
./sfbootstrap.sh init vendor-device
# if you're interested about the port details:
./sfbootstrap.sh status
./sfbootstrap.sh chroot setup
./sfbootstrap.sh sync
./sfbootstrap.sh build hal
./sfbootstrap.sh build packages
With that the created images
directory should have the Sailfish OS artifacts for your chosen device :)
Start with ./sfbootstrap.sh init
and look at the other functions and arguments available under ./sfbootstrap.sh
etc. while following the usual HADK and potential FAQ steps.
For documentation on env.sh variables and whatnot feel free to look at the sfbootstrap wiki!
There are a few configurable (set outside the script in env) variables that can be used by sfbootstrap
:
SUDO
: Superuser permission elevation program when not running as root, defaults tosudo
SFB_DEBUG
: Numeric boolean to enable debugging, defaults to0
SFB_COLORS
: Numeric boolean to enable colored output, defaults to1
SFB_JOBS
: Numeric amount of sync and build jobs, defaults to all available CPU threadsSFB_ROOT
: Path to runtime root directory, defaults to script execution directoryPLATFORM_SDK_ROOT
: Directory path all chroots, defaults to$SFB_ROOT/chroot
If you're interested in scripting, any of the sfb_
-prefixed functions can be executed via the sfbootstrap
script when passed as arguments; for example ./sfbootstrap.sh manual_hybris_patches_applied
can be used to check if hybris-patches are applied in the local tree.
~/.gitconfig
(reused forrepo
in HA build chroot for automation etc.)