- Select manual -
Bob the builder
Bob is a command line tool for building Defold projects outside of the normal editor workflow.
Bob is able to build data (corresponding to the build step of selecting the editor menu item Project ▸ Build And Launch), create data archives and create standalone, distributable application bundles (corresponding to the editor menu item Project ▸ Bundle ▸ … options)
Bob is distributed as a Java JAR archive containing everything needed to build. You find the latest bob.jar distribution at http://d.defold.com. Select a release, then download bob/bob.jar. To run the Bob tool, you need Java 8 installed on your computer. You can download a version of Java from https://www.java.com.
Bob is run from a shell or from the command line by invoking
java.exe on Windows) and providing the bob java archive as argument:
$ java -jar bob.jar --help usage: bob [options] [commands] -a,--archive Build archive --binary-output <arg> Location where built engine binary will be placed. Default is "<build-output>/<platform>/" -bo,--bundle-output <arg> Bundle output directory -br,--build-report <arg> Filepath where to save a build report as JSON -brhtml,--build-report-html <arg> Filepath where to save a build report as HTML --build-server <arg> The build server (when using native extensions) -ce,--certificate <arg> Certificate (Android) -d,--debug Use debug version of dmengine (when bundling) --defoldsdk <arg> What version of the defold sdk (sha1) to use -e,--email <arg> User email -h,--help This help message -i,--input <arg> Source directory. Default is current directory --identity <arg> Sign identity (iOS) -k,--keep-unused Keep unused resources in archived output -l,--liveupdate <arg> yes if liveupdate content should be published -mp,--mobileprovisioning <arg> mobileprovisioning profile (iOS) -o,--output <arg> Output directory. Default is "build/default" -p,--platform <arg> Platform (when bundling) -pk,--private-key <arg> Private key (Android) -r,--root <arg> Build root directory. Default is current directory -tc,--texture-compression <arg> Use texture compression as specified in texture profiles (boolean) -u,--auth <arg> User auth token -v,--verbose Verbose output
- Delete built files in the build directory.
- Delete all files in the build directory.
- Builds all project data. Add the “–archive” option to build a data archive file (“game.darc” in the build directory).
- Creates a platform specific application bundle. Bundling requires that a built archive is present (
--archiveoption) and that a target platform is specified (with the
--platformoption). Bob creates the bundle in the output directory unless a different directory is specified with the
--bundle-outputoption. The bundle is named according to the project name setting in game.project.
- Resolve all external library dependencies.
- Mac OSX
- Mac OSX 64 bit
By default, Bob looks in the current directory for a project to build. If you change the current dir to a Defold project and invoke bob, it builds the data for the project in the default output directory build/default.
$ cd /Applications/Defold-beta/branches/14/4/main $ java -jar bob.jar 100% $
You can string commands together to perform a sequence of tasks in one go. The following example resolves libraries, wipes the build directory, builds archive data and bundles an OSX application (named My Game.app):
$ java -jar bob.jar --archive --platform x86-darwin resolve distclean build bundle 100% $ ls -al build/default/ total 70784 drwxr-xr-x 13 sicher staff 442 1 Dec 10:15 . drwxr-xr-x 3 sicher staff 102 1 Dec 10:15 .. drwxr-xr-x 3 sicher staff 102 1 Dec 10:15 My Game.app drwxr-xr-x 8 sicher staff 272 1 Dec 10:15 builtins -rw-r--r-- 1 sicher staff 140459 1 Dec 10:15 digest_cache drwxr-xr-x 4 sicher staff 136 1 Dec 10:15 fonts -rw-r--r-- 1 sicher staff 35956340 1 Dec 10:15 game.darc -rw-r--r-- 1 sicher staff 735 1 Dec 10:15 game.projectc drwxr-xr-x 223 sicher staff 7582 1 Dec 10:15 graphics drwxr-xr-x 3 sicher staff 102 1 Dec 10:15 input drwxr-xr-x 20 sicher staff 680 1 Dec 10:15 logic drwxr-xr-x 27 sicher staff 918 1 Dec 10:15 sound -rw-r--r-- 1 sicher staff 131926 1 Dec 10:15 state $