godot-sdk-integrations / godot-ios-plugins

MIT License
141 stars 54 forks source link
godot godot-plugin

Godot iOS plugins

master branch is the current development branch and can introduce breaking changes to plugin's public interface. 3.3 branch's aim is to provide same public interface as it was before the switch to new iOS plugin system.

Note: iOS plugins are only effective on iOS (either on a physical device or in the Xcode simulator). Their singletons will not be available when running the project from the editor, so you need to export your project to test your changes.

Instructions

git clone --recursive https://github.com/godotengine/godot-ios-plugins.git

You might have to the update godot submodule in case you require latest (unreleased) Godot changes. To do this, run:

cd godot
git fetch
git checkout origin/<branch you want to use>
git clone https://github.com/godotengine/godot-ios-plugins.git

Then place the extracted Godot headers in the godot/ directory. If you choose this option, you can skip next the step which generates Godot headers.

For Godot 3.x:

scons platform=iphone target=debug

For Godot 4.x:

scons platform=ios target=debug

You don't have to wait for full engine compilation, as header files are generated first. Once the actual compilation starts, you can stop this command by pressing Ctrl + C.

scons target=<debug|release|release_debug> arch=<arch> simulator=<no|yes> plugin=<plugin_name> version=<3.x|4.0>

Note: Godot's official debug export templates are compiled with the release_debug target, not the debug target.

Building a .a library

Building a .xcframework library

Documentation

Each plugin provides a README.md file which contains documentation and examples.