版本

menu_open
Wwise SDK 2021.1.14
使用 Premake 配置工程

premake 命令会生成供 build 命令用来构建插件的解决方案。new 命令生成的默认 Premake 配置文件只需稍作修改便可用于所要创建的插件。注意不可直接修改生成的解决方案,因为再次调用 premake 命令会覆盖针对这些文件所作的全部修改。正确的做法是修改 Premake 配置文件。此配置文件存放在插件的根目录下,名为 PremakePlugin.lua

我们来看下 PremakePlugin.lua,注意它被分成了以下三个相似的部分。每个部分包含一个表格,里面设有多个字符串列表,用于配置如何生成解决方案:

  • Plugin.sdk.static 表格用于配置静态 SDK 插件。
  • Plugin.sdk.shared 表格用于配置共享 SDK 插件,并链接静态 SDK 插件(由 premake 脚本在后台完成)。
  • Plugin.authoring 表格用于配置设计工具插件,并链接静态 SDK 插件

有关如何填充每个列表的详细信息,请参阅 Premake 文档:

在创建插件工程后,须从工程文件夹内调用 premake 等其他命令。下面展示了如何在当前操作系统上为设计工具平台生成解决方案:

cd MyNewFX
python "%WWISEROOT%/Scripts/Build/Plugins/wp.py" premake Authoring

可用平台包括:

Android, Authoring, Authoring_Windows, Authoring_Linux, Authoring_Mac, WinGC, GGP, XboxOneGC, iOS, Linux, LinuxAuto, Mac, NX, PS4, PS5, QNX, tvOS, UWP_vc140, UWP_vc150, UWP_vc160, Windows_vc140, Windows_vc150, Windows_vc160, XboxOne, XboxSeriesX

在生成解决方案时,请参阅 针对不同的 Wwise 平台构建工程 章节来构建插件并将其安装到 Wwise 安装目录下。

静态 Authoring 配置

即便没有包含在生成的 PremakePlugin.lua 文件中,也会提供一个可选的 Plugin.sdk.authoringstatic 表格。该表格专门用于特定的用例,可为链接设计工具插件的静态 SDK 插件提供不同的配置。这里的示例展示了如何重复使用相同的 SDK 插件代码,并通过 FOR_AUTHORING 编译器进行如下定义:

Plugin.sdk.staticauthoring = {}
-- SDK STATIC AUTHORING PLUGIN SECTION
Plugin.sdk.staticauthoring.includedirs = Plugin.sdk.static.includedirs
Plugin.sdk.staticauthoring.files = Plugin.sdk.static.files
Plugin.sdk.staticauthoring.excludes = Plugin.sdk.static.excludes
Plugin.sdk.staticauthoring.links = Plugin.sdk.static.links
Plugin.sdk.staticauthoring.libdirs = Plugin.sdk.static.libdirs
Plugin.sdk.staticauthoring.defines = table.join(Plugin.sdk.static.defines, { "FOR_AUTHORING" })

高级 Premake 配置

从以下示例可以看出工程的配置非常简单,因为大部分 Premake 代码都隐藏在了配置表中。若要实施更为高级的配置,请将 custom 字段添加到以下相应配置部分:

Plugin.sdk.static.custom = function()
-- put your Premake code here
end
Plugin.sdk.shared.custom = function()
-- put your Premake code here
end
Plugin.authoring.custom = function()
-- 在此插入 Premake 代码
end

下一章节:针对不同的 Wwise 平台构建工程


此页面对您是否有帮助?

需要技术支持?

仍有疑问?或者问题?需要更多信息?欢迎联系我们,我们可以提供帮助!

查看我们的“技术支持”页面

介绍一下自己的项目。我们会竭力为您提供帮助。

来注册自己的项目,我们帮您快速入门,不带任何附加条件!

开始 Wwise 之旅