This repository has been archived on 2024-11-15. You can view files and clone it, but cannot push or open issues or pull requests.
build-godot-action/ReadMe.md
2020-05-03 22:04:59 -04:00

68 lines
1.5 KiB
Markdown

![Release Version](https://img.shields.io/github/v/release/josephbmanley/build-godot-action) ![Test Action](https://github.com/josephbmanley/build-godot-action/workflows/Test%20Action/badge.svg)
# Build Godot Project
This action builds the godot project in your `$GITHUB_WORKSPACE`, so that you can easily automate builds.
## Usage
This action will create a `build` folder an outputed build. You must have the export preset configured for the target platform to successfully export.
Example:
```yaml
steps:
- uses: josephbmanley/build-godot-action@[VERSION]
with:
name: godot-project
preset: HTML5
```
### Inputs
#### name **required**
The name of the exported package/binary
#### preset **required**
The name of the preset found in `export_presets.cfg` you would like to build.
#### subdirectory
*Optional*
The subdirectory in the `build` folder to output build to, can be useful for self packaging.
#### package
*Optional*
Boolean value, when set to true, builds artficat zip file.
#### projectDir
*Optional*
Directory in workspace containing your godot project.
#### debugMode
*Optional*
Boolean value, when set to true, runs export in debug mode.
### Outputs
#### build
The location the outputed build is placed relative to GitHub Workspace.
#### artifact
The location the outputed artifact is placed relative to GitHub Workspace.
## Credits
This action uses the [godot-ci](https://github.com/aBARICHELLO/godot-ci) docker image from [BARICHELLO](https://github.com/aBARICHELLO)