Skia4Delphi 项目使用说明

Skia4Delphi 项目使用说明

1. 项目目录结构及介绍

Skia4Delphi 是一个基于 Google 的 Skia 图形库的跨平台 2D 图形 API，适用于 Delphi 平台。项目的目录结构如下：

skia4delphi/
├── .github/                # GitHub 相关文件
├── Assets/                 # 资源文件
├── Benchmark/              # 性能测试相关文件
├── Binary/                 # 编译后的二进制文件
├── Documents/              # 文档资料
├── Externals/              # 外部依赖库
├── Packages/               # Delphi 包文件
├── Samples/                # 示例代码
├── Source/                 # 源代码
├── Tests/                  # 测试文件
├── Tools/                  # 工具相关文件
├── .gitattributes
├── .gitignore
├── .gitmodules
├── LICENSE                 # 项目许可证
├── README.md               # 项目说明文件

• .github/: 包含 GitHub Actions 工作流等 GitHub 相关配置。
• Assets/: 存放项目使用的一些资源文件，如图片、SVG 文件等。
• Benchmark/: 包含性能测试相关的代码和资源。
• Binary/: 存放编译后的二进制文件。
• Documents/: 包含项目文档资料。
• Externals/: 包含项目依赖的外部库。
• Packages/: 包含 Delphi 的包文件，用于安装和管理。
• Samples/: 包含使用 Skia4Delphi 的示例代码。
• Source/: 包含 Skia4Delphi 的源代码。
• Tests/: 包含单元测试和集成测试代码。
• Tools/: 包含项目开发中使用的工具脚本等。
• .gitattributes: 定义 Git 仓库的属性。
• .gitignore: 定义 Git 忽略文件列表。
• .gitmodules: 定义 Git 子模块配置。
• LICENSE: 项目使用的许可证文件。
• README.md: 项目的基本介绍和使用说明。

2. 项目的启动文件介绍

项目的启动文件主要是 Samples 目录下的示例代码。以 FmxFPS 为例，这个示例演示了如何使用 Skia4Delphi 替代 FireMonkey 的默认渲染引擎。

在 FmxFPS 目录中，通常会有一个 FmxFPS.dpr 文件，这是 Delphi 的项目文件，用于编译和运行示例。

program FmxFPS;

{$APPTYPE CONSOLE}

uses
  ...
  System.Skia;
  
begin
  // 示例代码逻辑
end.

这个文件会引入 Skia4Delphi 的单元，并包含创建 Skia 表面和绘制图形的代码。

3. 项目的配置文件介绍

项目的配置文件主要包括 Source 目录中的源代码文件和 Packages 目录中的 Delphi 包文件。

• 源代码文件: 在 Source 目录中，包含了 Skia4Delphi 库的所有 Delphi 单元文件，这些文件定义了 Skia 库的接口和实现。
• Delphi 包文件: 在 Packages 目录中，包含了用于在 Delphi IDE 中安装 Skia4Delphi 库的 .dpk 文件。使用 Delphi 的 GetIt 包管理器或手动安装这些包文件可以将 Skia4Delphi 集成到 Delphi IDE 中。

项目的配置通常在 Delphi IDE 中通过项目选项进行，如设置编译器选项、包含的单元等。具体的配置方法可以在项目的文档中找到详细的说明。