定义数据源

要在您的 Kanzi 应用程序中使用来自外部数据源的数据：

1. 在 Kanzi Engine 插件中定义您的数据源。You can use Kanzi to create a data source for any data format. 请参阅定义数据源。
2. 在您的 Kanzi Studio 工程中，使用定义了您的数据源的数据源插件。请参阅应用数据源插件。

要了解如何在您的 Kanzi Studio 工程中使用数据源，请参阅 使用数据源。

定义数据源

You can use Kanzi to create a data source for any data format.

要定义数据源：

1. 在 Kanzi Studio 中，创建一个新工程，然后在新建工程 (New Project) 窗口中将模板 (Template) 设置为含数据源插件的应用程序 (Application with data source plugin) 模板。
   
   
   

Kanzi 在 <KanziWorkspace>/Projects/<ProjectName>/Tool_project 目录中创建 Kanzi Studio 工程，并在 <KanziWorkspace>/Projects/<ProjectName>/Application 中创建工程的 Visual Studio 解决方案的结构：

• bin 目录包含工程的二进制文件和配置文件。
• configs 目录包含不同平台的配置文件。Kanzi 默认为几个不同的平台创建配置文件。适用于开发 Kanzi 应用程序的推荐平台是 Microsoft Visual Studio。请参阅 部署 Kanzi 应用程序。
• src 包含您的工程的源代码。
2. 在 Visual Studio 中，打开存储在 <ProjectName>/Application/configs/platforms/win32 中的解决方案。解决方案包含两个工程：
   • <ProjectName> 工程。定义此工程中的数据源。如果要构建空模板工程，您要创建一个数据源，以便您可用它在 Kanzi Studio 工程中创建数据源，但这类数据源没有任何功能。如果只为定义数据源而创建了工程，您只能将工程用在 Visual Studio 解决方案中。
   • <ProjectName>_executable 工程。在工程中定义 Kanzi 应用程序的逻辑。
   
3. 定义您的数据源。确保您还定义了如何在数据源中重新加载数据。
   要获得有关如何定义数据源的示例，请参阅 教程：从数据源获取应用程序数据。
4. 为您的 Visual Studio 版本选择其中一个 DLL 解决方案配置。
   开发时选择其中一个调试 DLL 配置。准备好创建产品版本后，选择其中一个发布 DLL 配置。
   例如，选择 GL_vs2015_Release_DLL 配置。
   
5. 在 Visual Studio 中右键点击您定义了数据源的工程，然后选择构建 (Build)。
   Visual Studio 将您的插件构建到 .dll 中，并将其保存在 <ProjectName>/Application/lib/<PlatformName>/<ConfigurationName> 目录中。
   如果使用插件的 Kanzi Studio 工程已打开，您应在 Kanzi Studio 中选择预览 (Preview) > 退出预览 (Exit Preview) 后才能开始在 Visual Studio 中构建插件 .dll。
   

应用数据源插件

准备好您的数据源插件之后，您必须在 Kanzi Studio 工程中启用它，或者将插件导入到另一个要使用同一类型的数据源的 Kanzi Studio 工程中。

要定义数据源，请参阅 定义数据源。

要在您的 Kanzi Studio 工程中应用数据源插件：

• 如果正在使用您为了定义数据源而创建的那个 Kanzi Studio 工程：
  1. 在 Kanzi Studio 中的素材库 (Library) > Kanzi Engine 插件 (Kanzi Engine Plugins) 中，右键点击您在 Visual Studio 中定义和构建的数据源插件，然后选择更新 Kanzi Engine 插件 (Update Kanzi Engine Plugin)。
     每次您在 Visual Studio 中更改插件源代码并构建插件时，都必须更新插件元数据。
     您在素材库 (Library) 中更新插件元数据并选择插件后，在属性 (Properties) 中元数据上次读取自 (Metadata Last Read From) 属性会显示加载哪个插件 .dll 文件Kanzi Studio 并从中读取元数据。
     
  2. 在素材库 (Library) > Kanzi Engine 插件 (Kanzi Engine Plugins) 中选择插件，并确保在属性 (Properties) 中启用已启用 (Is Enabled) 属性。
     
     建议

     使用 已启用 (Is Enabled) 属性启用或禁用工程中的任何 Kanzi Engine 插件。

• 在想要使用您用于定义数据源的插件的任何其他 Kanzi Studio 工程中：
  1. 在 Kanzi Studio 中，创建一个新工程，然后在新建工程 (New Project) 窗口中选择应用程序 (Application)、含数据源插件的应用程序 (Application with data source plugin) 或含 Kanzi Engine 插件的应用程序 (Application with Kanzi Engine plugin) 工程模板。
  2. 在 Visual Studio 中，打开存储在 <ProjectName>/Application/configs/platforms/win32 中的解决方案，并从用于定义您要使用的数据源插件的那个 Kanzi 工程中导入 Visual Studio 工程。
  3. 为您的 Visual Studio 版本选择其中一个 DLL 解决方案配置。
     开发时选择其中一个调试 DLL 配置。准备好创建产品版本后，选择其中一个发布 DLL 配置。
     例如，选择 GL_vs2015_Release_DLL 配置。
     
  4. 在 Visual Studio 中右键点击您定义了数据源的工程，然后选择构建 (Build)。
     Visual Studio 将您的插件构建到 .dll 中，并将其保存在 <ProjectName>/Application/lib/<PlatformName>/<ConfigurationName> 目录中。
     如果使用插件的 Kanzi Studio 工程已打开，您应在 Kanzi Studio 中选择预览 (Preview) > 退出预览 (Exit Preview) 后才能开始在 Visual Studio 中构建插件 .dll。
     
  5. 在素材库 (Library) 中右键点击Kanzi Engine 插件 (Kanzi Engine Plugins) 并选择导入 Kanzi Engine 插件 (Import Kanzi Engine Plugin)。
     
  6. 选择用于定义您的数据源的插件 .dll，然后点击 打开 (Open)。
  7. 在素材库 (Library) > Kanzi Engine 插件 (Kanzi Engine Plugins) 中选择插件，并确保在属性 (Properties) 中启用已启用 (Is Enabled) 属性。
     
     建议

     使用 已启用 (Is Enabled) 属性启用或禁用工程中的任何 Kanzi Engine 插件。

另请参阅

使用数据源

教程：从数据源获取应用程序数据