项目开发

项目是一个独立的实体，包含以一组目录组织的有关您的应用程序内容的所有数据。包含元数据的.project文件与项目关联。

注意

一个项目可以包含多个世界。因此，无需为每个世界创建一个单独的项目。

在开始创建新项目之前，您应该已经安装了 SDK 。拥有所需版本的SDK后，您可以按以下方式创建一个新项目：

1. 在SDK浏览器中打开Projects标签。

   

2. 单击Create New。新的项目创建窗口将打开。

3. 定义项目的名称，选择存储项目文件的路径，指定要使用的SDK和UNIGINE Engine build 。

   

   该项目将在<project path>/<unigine_project>文件夹中创建。

4. 指定所需的应用程序和常规设置。
5. 指定要添加的资源（可选）。
6. 单击Create New Project。该项目将出现在项目列表中。

   

注意

您可以随时单击Other Actions -> Configure更改项目设置。

应用程序设置#

功能#

该项目可以创建以下功能：

Command-line Runtimes Generator	为项目启用命令行运行时生成器。
Command-line Build Tool	为项目启用命令行生成工具。
Sandworm Distributed & Headless Mode	支持在 Worker 计算机上创建所需的控制台应用程序，以便使用项目的Sandworm工具进行分布式计算和无头生成地形。
Editor Plugin Template	启用基于项目可用模板创建编辑器插件。

Plugins (0)按钮打开可用插件列表：

STEREO 3D
Oculus support (Oculus plugin)	创建具有 Oculus Rift虚拟显示支持的项目。
Dual output stereo 3D (Separate plugin)	每只眼睛输出 2张单独的图像。 注意 Separate仅支持 DirectX 11 。
Varjo support (Varjo plugin)	创建具有 Varjo输出支持的项目。
HTC Vive support (OpenVR plugin)	创建具有 HTC Vive/OpenVR输出支持的项目。
MULTI-MONITOR
3-monitor output (Surround plugin)	同时在 3个监视器上渲染应用程序。
Monitor wall (Wall plugin)	将应用程序渲染到可配置的监视器数量中。
PROJECTIONS
EasyBlend support (EasyBlend plugin)	使用EasyBlend插件创建一个项目。
Multi-projector setups (Projection plugin)	使用AppProjection插件创建一个项目。复制所有必需的文件，并生成具有相应设置的启动器。
NETWORK
ARTTracker plugin	使用 ARTTracker 插件创建一个项目。
SSLSocket plugin	使用 SSLSocket 插件创建一个项目。
Steam plugin	使用用于Steam集成的插件创建一个项目。
Syncker plugin	使用Syncker插件创建一个项目，以进行多通道渲染同步。
VRPN Client plugin	使用VRPN Client插件创建一个项目。
SPECIALS
GPU Monitor plugin	为您的项目启用 GPU频率和温度监控。
Interface plugin	使用Interface插件创建一个项目。
Kinect2 Plugin	使用 Kinect2 插件创建一个项目。
Leap Motion plugin	用Leap Motion跟踪手和手指
TeslaSuit plugin	创造感觉，追踪身体动作，用 Teslasuit捕捉用户的生物特征。
GEODETIC
Geodetics plugin	允许将GPS纬度，经度和海拔坐标转换为X, Y和Z，反之亦然的插件。

Assets#

要将现有项目添加到浏览器：

1. 单击Projects选项卡中的Add Existing。
   
2. 在打开的文件对话框窗口中，指定项目文件夹的路径，然后单击Apply。该项目将出现在项目列表中。
   

注意

如果添加的项目是在以前版本的SDK中创建的，则它将标有Upgrade标签。

需要升级的项目带有Upgrade标签：

要将项目升级到UNIGINE SDK的最新安装版本：

1. 单击项目映像上的Upgrade标签或Other Actions -> Configure。下面的表单将打开:

   

2. 选择最新安装的SDK版本，然后单击Update Configuration。
   
3. 指定将原始项目复制到的备份文件夹的路径。选中Migrate Content，然后单击UPGRADE PROJECT。
   

该项目将自动升级。您还可以通过运行升级脚本手动升级项目。在这两种情况下，将使用相同的脚本。

注意

应该使用 迁移指南 手动升级源代码。

要运行自定义设置的项目，单击 Run 按钮上的省略号:

您还可以使用在项目文件夹中默认创建的启动器：

• launch_debug —项目的调试版本的启动器。
• launch_editor-使用已加载的编辑器启动项目的启动器。

• launch_release-项目发行版本的启动器。

  注意

  要使用发布启动器，您应该先将重新配置项目到Release二进制文件。

使用自定义设置运行项目#

项目内容通过UNIGINE编辑器编辑，代码通过IDE编辑。

• 要编辑项目内容，请单击Open Editor。

  

• 要编辑源代码，请使用Open Code IDE。选择为默认的IDE将用于打开代码。

  

项目编辑工具还可以以自定义模式运行。

自定义UnigineEditor选项#

通过单击Open Editor按钮上的省略号来定制UNIGINE Editor的运行选项:

在打开的Customize UNIGINE Editor Options表单中，设置所需的值并单击Edit。

Additional arguments	启动命令行选项。
Debug	将用于项目编辑的编辑器版本（调试或发行版）。
Microprofile Enabled	启用 Microprofile 工具运行该应用程序。
Remember	指示是否记住指定的自定义设置以备将来运行。

自定义IDE选项#

您可以选择UNIGINE Engine的Development或Release版本：

• Development构建包含可用于项目开发的其他功能（Microprofile等）
• Release构建允许检查应用程序的最终性能。

默认情况下，该项目被配置为使用包含其他调试工具的 Development 引擎二进制文件。引擎的 Development 二进制文件需要一个正在运行的SDK Browser实例，就像UnigineEditor一样。

您可以通过项目文件夹中的 launch_release launch_release文件在不运行SDK Browser的情况下运行您的应用程序，但首先，您应该重新配置项目以使用 Release 二进制文件。

重新配置项目：

1. 单击 Other Actions -> Configure。

   

2. 在 Engine 下拉菜单中选择 Release 选项。

   

3. 单击配置窗口底部的 Update Configuration 按钮保存配置。

一旦项目被重新配置为 Release 版本，它就可以在没有SDK浏览器的情况下运行——运行项目文件夹中的 launch_release 文件。

Release 二进制文件应该在项目的最终构建中使用。

当点击Other Actions按钮时，有以下选项:

Configure	更改项目设置。
Open Folder	打开项目文件夹。
Delete	删除项目。

单击Other Actions -> Configure时，将打开以下表单：

通过此表单，您可以更改现有项目的设置：用于该项目的 UNIGINE Engine版本，发布应用程序的版本，坐标精度和常规设置。当您需要将现有项目升级到最新的SDK版本时，也应该使用此选项。

此外，您可以还原已损坏，丢失或错误修改的项目文件。为此，您应保持表格形式的设置不变，然后按Update Configuration按钮。在这种情况下，将还原项目的以下文件（它们将从SDK复制）：

• 二进制文件
• core.ung, editor.ung and scripts.ung
• 启动器

注意

如果更改了上面列出的某些文件，则会将.modified后缀添加到此类文件的名称。届时，SDK中的文件也将被复制。