Blitz/Blitz3
3
0
Fork 0
generated from Persson-dev/Godot-Xmake
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

update README

Browse Source
This commit is contained in:
Simon Pribylski
2024-08-11 19:15:56 +02:00
parent f1fed86329
commit 9176aee8b6
1 changed files with 11 additions and 39 deletions
Download Patch File Download Diff File Expand all files Collapse all files

48
README.md
View File

@@ -1,7 +1,6 @@
# Blitz3
This project is used to compile a GDExtension (godot engine cpp extension), and try to use xmake to manage the project.
Forked from [Github](https://github.com/chaosddp/gdextension-cpp-xmake-template)
The best FPS you've ever seen !
## Install xmake
@@ -9,54 +8,27 @@ Install xmake from [here](https://xmake.io/#/guide/installation).
## How to use
You must have godot in your path
First modify the *xmake.lua* to change the project name, and other configurations as needed.
```lua
-- project name, this will be the output shared library name
PROJECT_NAME = "gdexample"
-- project version
VERSION = "0.0.1"
-- where is the godot project saved, default is "demo"
GODOT_PROJECT_FOLDER = "demo"
-- where to save the export project, default is "publish"
PUBLISH_FOLDER = "publish"
```
After change the configurations, you can run the following commands to build, run and export.
You must have [godot](https://godotengine.org/) in your path
```sh
# 1. gen gdextension file (only once)
xmake gengdextension
# 1. build the project
xmake f -m debug && xmake
# 2. build the project
xmake
# 3. open the editor at least once (works only in debug mode)
# 2. open the editor at least once
xmake run Editor
# 4. run the demo (works only in debug mode)
# 3. run the demo
xmake run
# 5. export the project, the executable will be under "publish" folder by default
# 4. export the project, the executable will be under "publish" folder by default
xmake p
# 6. clean the build and publish
# 5. clean the build and publish
xmake clean
# 7. generate a class that inherits from godot class, like Sprite2D
# 6. generate a class that inherits from godot class, like Sprite2D
# by default the generated files will save under "src" folder, you can change it by -d folder/under/src
xmake ext-class -n MySprite2D -b Sprite2D -s myexample1 -d sample
```
For better support in vscode, you can use command "Xmake: UpdateIntellisense" to generate *compile_commands.json*, then update "compileCommands" field in *c_cpp_properties.json* to point to the file.
NOTE: not tested on other platforms except windows and linux.