go语言编译/调用so

创建时间: 2024-10-24 11:13:09修改时间: 2024-10-24 13:12:23

so的介绍

so的中文名是linux动态链接库,与之对应的是windows的DLL文件。简单来说就是别的语言可以编译成so然后让别的语言来调用。在这里得说明一下就是由于目前的大多数操作系统底层都是使用c语言来编写的。然而c语言的二进制文件的调用遵循着ABI(Application Binary Interface)所以,别的语言无论是编译成so还是调用so都需要遵守C语言的ABI规范。

使用go编译so

下面是准备需要编译成so的go语言源文件 main.go

package main

import "C"
import "fmt"

//export Add
func Add(a, b C.int) C.int {
	var c C.int = a + b
	return c
}


//export HelloWorld
func HelloWorld(str *C.char) *C.char{
	fmt.Println(C.GoString(str))
	return str
}

func main(){
	
}

上述代码我们可以看到在每个函数的前面我们需要写上一个 //export [函数名字] 的注释,这个注释是属于cgo的,目的是告诉编译器,在编译的时候函数准循c语言ABI规范。下面我们来将上述代码进行编译。使用如下编译命令:

go build -buildmode=c-shared -o libtest.so

运行上述命令后编译器将会生成一个libtest.so的文件以及libtest.h的头文件(该头文件描述来so文件的函数)使用别的变成语言即可调用该so文件中的函数

使用go调用so

在go语言中,要想通过ABI来调用别的程序的函数还是需要与cgo进行交涉。所以在本案例中使用上述编译好的so文件,来进行讲解 下面是调用so的示例代码:

package main

/*
#cgo LDFLAGS: ./libtest.so
#include <stdlib.h>
#include "./libtest.h"
*/
import "C"
import (
	"fmt"
	"unsafe"
)

func main() {
	fmt.Println(C.Add(1, 2))

	cStr := C.HelloWorld(C.CString("hhhh"))

	// 转换为 Go 字符串并打印
	fmt.Println(C.GoString(cStr))

	C.free(unsafe.Pointer(cStr)) // 释放内存
}

在cgo的等一行中我们用#cgo LDFLAGS: ./libtest.so来指定需要调用的so文件,然后我们在头中加入来#include "./libtest.h"这个是引入我们刚刚编译好的so文件生成的头文件,来告诉cgo我们的so文件中存在什么函数。值得注意的是我们中cgo中加入来#include <stdlib.h>这个头文件,因为c语言的释放内存操作是需要引入stdilb,h这个函数的。否则我们无法使用C.free这个函数。有关cgo请参阅go语言的官方博客https://go.dev/blog/cgo