【教程】Godot4下的GDExtension与GDnative的简单使用

不错，支持

好的，现在我们来正式编写GDExtension，如果有C++IDE的话，就先创建一个动态库项目
Godot4加载GDExtension的第一步，就是运行动态库中的初始化函数，它在gdnative_interface.h定义如下：
typedef GDNativeBool (*GDNativeInitializationFunction)(
const GDNativeInterface *p_interface,
const GDNativeExtensionClassLibraryPtr p_library,
GDNativeInitialization *r_initialization);
它接收了三个参数
1.p_interface，是一个结构体，囊括了所有API函数，可以用p_interface->XXX()调用API
2.p_library，一个指向内置GDNativeExtensionClass的指针，仅用于传参
3.r_initialization，一个指向 配置信息结构体 的指针，需配置才能运行GDExtension
至于它的返回值GDNativeBool，应是指明GDExtension是否加载成功，但目前，测试返回0或1都没问题。
（函数和结构体的具体信息，请到gdnative_interface.h中查看）
在我们的项目中，先写下它：


当然，你可能会问：这个函数的名称该起什么？
回顾一下，你还记得我们的XXX.gdextension引导文件的内容吗？
对，其中configuration部分的 entry_symbol = "example_library_init" 就是指明Godot4加载GDExtension时，所要调用的函数！！！
所以将入口函数的函数名与entry_symbol所书写的保持一致就行了
然后你就可以试着编译项目了，记得使用-std=c++11 -fPIC这两个编译标识！！！
但这个GDExtension是无法正常运行的，因为我们并没有配置r_initialization(入口函数的第三个参数)的相应信息
r_initialization指向GDNativeInitialization结构体：

GDNativeInitialization结构体当中：
GDNativeInitializationLevel就是指明最小需要的层级，不同层级的加载时机是不同的
initialize和deinitialize都是指向函数，在层级加载，层级退出时被调用
注意，initialize和deinitialize函数是每个层级都公用的，所以initialize和deinitialize会被调用多次！
(注：userdata是可选的，仅方便传参，这里不赘述了)
现在我们的代码应该为：

正常加载时，你就可以在命令行输出中发现：

接着，我们来尝试着注册一个类：
首先，为了能在整个作用域中使用p_interface->XX()调用API，我们应该在文件中声明一个GDNativeInterface类型的常量，并在初始化时，给它赋值为我们接收的实际的p_interface


自定义类，我们需要配置GDNativeExtensionClassCreationInfo来描述一个类：

实际上，其中大多数都对应了gdscript的Object中的虚函数：
Variant _get ( String property ) virtual
Array _get_property_list ( ) virtual
void _init ( ) virtual
void _notification ( int what ) virtual
bool _set ( String property, Variant value ) virtual
String _to_string ( ) virtual
这里就不赘述了，其中：
reference_func和unreference_func是类被引用和解引用后的回调函数
get_virtual_func用于外部调用类中的虚函数
class_userdata也是方便传参
这之中必须填的只有三个：
create_instance_func类被创建时调用
free_instance_func类被清理时调用
object_instance_func类被绑定时调用
这里，也许你会有疑问，什么是类被绑定？
让我们回顾一下Godot的Object类型，Godot的所有类型都派生自Object类型！
而在GDExtension中，Object是一个包装类，该过程简化为：

当我们试图创建一个GDExtension中的类时，实际上引擎会先创建一个Object类型，然后引擎调用我们的create_instance_func使我们的类初始化，并执行object_instance_func，我们就可以把我们的自定义类，绑定到这个Object类型上，
这个Object类型由引擎自动管理，当它将要被free时会一起调用free_instance_func，来清理我们自己的类。
--------------------接下文-------------

官方不是说GDExtension是GDNative的继任者吗？

想问一下大佬，为什么我的gdextension里不能使用正常的结点类型作为参数。这个应该怎么去操作？

我在我的代码里写了一个返回值为void的函数，函数中没有内容，我试图将参数的类型在指针，引用等类型中切换，但是都会报错。

楼主觉得GDextension有什么优点呢?
节省编译时间吗...