Difference between revisions of "Making a Plugin"

From GiderosMobile
(Created page with "The Gideros plugin system is used primarily to extend the functionality of the Gideros API, for example by writing a plugin that provides Lua bindings to an existing native li...")
 
(10 intermediate revisions by 3 users not shown)
Line 1: Line 1:
The Gideros plugin system is used primarily to extend the functionality of the Gideros API, for example by writing a plugin that provides Lua bindings to an existing native library. Although Gideros is open source, the plugin system keeps the size of the core lean and mean by allowing users to choose which plugins to export with which project. Here we'll walk through the process of creating a plugin.
+
===Lua based plugins===
 +
If your plugin is 100% Lua code then you can easily make it into a plugin.
  
To start writing a plugin you need to first get your Gideros native development environment set up, by following [[Special:MyLanguage/Compiling Gideros Source|Compiling Gideros Source]]. You can start off with just the Desktop target, so only really need Qt and Git (and MSYS2 on Windows). But following through the instructions there will allow you to create and build plugins for all Gideros export targets.
+
Just create a folder based on the name of the plugin and add a file (also based on the plugin name) with the extension .gplugin .
  
<div class="noautonum">__TOC__</div>
+
The contents of the file should look like this:
 +
 
 +
<pre>
 +
<plugin name="My plugin name" description="What my plugin does!">
 +
<target name="APK,iOS,Html5,WinRT,Windows,MacOSX,Win32"></target>
 +
</plugin>
 +
</pre>
 +
 
 +
Also add a sub-folder called 'luaplugin' to your folder, put your Lua files in there.  These will be automatically added to a project that adds your plugin.  You can run them by using the Lua 'require' command.
 +
 
 +
You can test them as userplugins (click add plugin, then click user plugins o find where to add them) then possibly submit them using github to include in the distribution.  If you do submit them for inclusion then please try make the name of the plugin unique to avoid confusion with other similar plugins - eg don't call it UI, but rather give it a name like razorUI ...
 +
 
 +
===[[Extend_your_application_with_plugins|Extend your application with plugins]]===

Revision as of 20:42, 23 December 2019

Lua based plugins

If your plugin is 100% Lua code then you can easily make it into a plugin.

Just create a folder based on the name of the plugin and add a file (also based on the plugin name) with the extension .gplugin .

The contents of the file should look like this:

<plugin name="My plugin name" description="What my plugin does!">
 <target name="APK,iOS,Html5,WinRT,Windows,MacOSX,Win32"></target>
</plugin>

Also add a sub-folder called 'luaplugin' to your folder, put your Lua files in there. These will be automatically added to a project that adds your plugin. You can run them by using the Lua 'require' command.

You can test them as userplugins (click add plugin, then click user plugins o find where to add them) then possibly submit them using github to include in the distribution. If you do submit them for inclusion then please try make the name of the plugin unique to avoid confusion with other similar plugins - eg don't call it UI, but rather give it a name like razorUI ...

Extend your application with plugins