🕹️ 创建项目
创建项目
概述
每一个项目一般会以一个独立文件夹的形式存放于引擎根目录下,而每一个项目的文件夹,我们称之为资产库。利用引擎提供的“创建资产库”工具,可以帮开发者创建最小项目资产库,其中包含许多必要的批处理工具,比如:引擎启动、关闭、生成SDK等。
什么是资产库?
所谓资产库,即是一个新的项目的所有数据、脚本代码、资源等存储的地方,而这个地方就是一个文件夹,该文件夹一般可以放置在引擎根目录下(与kbe、docs文件夹同级)。Tips:
资产库文件夹也可以放置在其他地方,不过需要修改启动脚本中环境变量,在进阶教程中会进行阐述。
新建项目资产库
那我们来创建一个自己的项目资产库吧,首先,我们来看一下安装好的引擎的根目录下文件夹结构:

在引擎根目录下,我们看到当前选中的“new_assets.bat”即是“创建资产库”的批处理工具。双击运行,等待片刻后如下图,新建出了server_assets文件夹:

Tips:
Linux用户可运行对应的“new_assets.sh”版本。
接着,我们把该文件夹重命名为“getstarted_assets”,作为本教程的资产库。

好了,我们已经创建好一个自己的资产库了。
注意:
本教程的后面内容中会以{项目资产库}
的符号来表示该资产库。
文件夹结构
开发者肯定对刚才复制出来的getstarted_assets(最小项目资产库)的文件夹感到一些困惑,这节帮大家简单的解释一下。

res: 放置一些资源(如地图资源, res/spaces目录下)以及当前项目的服务器配置(res/server目录下);
scripts: 脚本的文件夹,所有脚本开发都在该文件夹下进行,如下图:

从上到下分别是:
base: Baseapp上的脚本存放位置
bots: Bot机器人的脚本存放位置
cell: Cellapp上的脚本存放位置
common: 脚本开发中共用的一些模块的存放位置,如Functor、KBEDebug等工具模块
data: 存放数据的位置,比如策划配置好的表格等(一般是py文件,而非excel文件),可以在脚本开发时快速获取到对应的数据对象
db: DBMgr上的脚本存放位置
entity_defs: Entity的配置文件存放位置
interface: 第三方接口服务器的脚本存放位置
logger: 日志服务器的脚本
login: Loginapp的脚本存放位置
user_type: 用户自定义的数据类型的实现脚本的存放位置
entities.xml: Entity实体声明文件,用到的Entity需要在此进行声明,否则无法使用
恭喜你完成了项目的创建!
创建完项目工程,让我们开始动手,创建第一个Entity实体吧。