Leaf-Server官方教程：Leaf安装搭建与模块运行

Posted 2021-09-07 Kaitiren

Leaf 框架配置(windos os / mac os)

Go IDE: (windos / mac)

windows os: 

Goland 下载地址与安装: 

https://download.csdn.net/download/Kaitiren/19427755 

 

mac os: 

下载安装地址: 

https://download.csdn.net/download/Kaitiren/19427964

 

 

 

GO SDK下载连接: 

建议下载最较新的稳定版本开发: 

https://studygolang.com/dl

 

 

Leaf-Server FrameWork部署: 

 leaf-server framework 下载地址: 

https://download.csdn.net/download/Kaitiren/19427697

Leaf-Server FrameWork部署: 

websocket: github.comgorillawebsocket.zip

leaf: leaf-master.zip

leafserver游戏服务器框架: leafserver-master.zip

mysql数据库: mysql-master.zip

go数据库操作库: sqlx-master.zip

 

 

Leaf 源码概览

• leaf/chanrpc 提供了一套基于 channel 的 RPC 机制，用于游戏服务器模块间通讯
• leaf/db 数据库相关，目前支持 MongoDB
• leaf/gate 网关模块，负责游戏客户端的接入
• leaf/go 用于创建能够被 Leaf 管理的 goroutine
• leaf/log 日志相关
• leaf/network 网络相关，使用 TCP 和 WebSocket 协议，可自定义消息格式，默认 Leaf 提供了基于 protobuf 和 JSON 的消息格式
• leaf/recordfile 用于管理游戏数据
• leaf/timer 定时器相关
• leaf/util 辅助库

   

 

 

Leaf 的模块机制:

一个 Leaf 开发的游戏服务器由多个模块组成（例如 LeafServer），模块有以下特点：

• 每个模块运行在一个单独的 goroutine 中
• 模块间通过一套轻量的 RPC 机制通讯（leaf/chanrpc）Leaf 不建议在游戏服务器中设计过多的模块。

游戏服务器在启动时进行模块的注册：

leaf.Run(
game.Module,
gate.Module,
login.Module,
)

 

这里按顺序注册了 game、gate、login 三个模块。每个模块都需要实现接口：

type Module interface {
OnInit()
OnDestroy()
Run(closeSig chan bool)
}

 

Leaf 首先会在同一个 goroutine 中按模块注册顺序执行模块的 OnInit 方法，等到所有模块 OnInit 方法执行完成后则为每一个模块启动一个 goroutine 并执行模块的 Run 方法。最后，游戏服务器关闭时（Ctrl + C 关闭游戏服务器）将按模块注册相反顺序在同一个 goroutine 中执行模块的 OnDestroy 方法。

 

 

使用 Leaf 开发游戏服务器

LeafServer 是一个基于 Leaf 开发的游戏服务器，我们以 LeafServer 作为起点。

获取 LeafServer：

git clone https://github.com/name5566/leafserver

设置 leafserver 目录到 GOPATH 环境变量后获取 Leaf：

go get github.com/name5566/leaf

编译 LeafServer：

go install server

如果一切顺利，运行 server 你可以获得以下输出：

2021/06/07 15:05:58 [release] Leaf 1.1.3 starting up

敲击 Ctrl + C 关闭游戏服务器，服务器正常关闭输出：

2021/06/07 15:06:11 [release] Leaf closing down (signal: interrupt)

=======================================================================================

Kaitiren博客全栈开发技术博客:

https://kaitiren.blog.csdn.net/

 

Go 服务器开发(从零开始学习 基础篇):

https://blog.csdn.net/kaitiren/category_10696929.html

 

Go LeafServer 游戏服务器(完结篇):

https://blog.csdn.net/kaitiren/category_11098695.html