概要

  归档文件目前存放于以下位置:

注意 作为归档的压缩包文件一般统一使用 7z ,但不同的归档使用不同的压缩算法和选项,对系统资源要求不尽相同。作为极端情况,V0.6 后的 doc 下的压缩包使用具有 1.5GiB 字典的 PPMd 达到约 5% 的压缩比,这一般也要求解压缩时需预留 20 倍压缩包大小的空余空间,以及 1.5GiB 空余(物理)内存

命名规约

  文件名使用 [平台环境标识-]包名-版本[-配置].后缀 。“[]”中为可选项。特定平台的目录名可参照此规约。

  对于二进制文件和库文件,平台环境标识使用目标三元组分类:archc-OS-toolchain ;不限定体系结构的使用 "any" 。

  发布时若文件没有更新,则不另行更新版本。若某个包不存在预期的版本,尝试使用之前最近的版本代替。

顶级目录结构

  • src 可用于直接构建的源代码(包括外部依赖项的二进制库文件)包
  • example 示例代码
  • doc 文档(打包的 Doxygen 文档)
  • any 体系结构中立的文件(头文件和数据文件)
  • arm-ds-eabi DS 平台文件
  • i686-w64-mingw32 Win32 平台文件
  • arm-linux-androideabi Android ARM 平台文件
  • x86_64-linux-gnu Linux x64 平台文件

注意 因为包含所有平台的库文件过大且文件重复,考虑到存储和传输开销,V0.9 起不提供 YSLib 整体的源代码包(位于 src)。请直接参照获取源代码中的来源,同步版本库或下载源代码,再下载所需平台的外部依赖项的归档文件,并按开发说明存储到相应位置。Sysroot 归档中仍包含对应的外部依赖项。

包概要

以下为各个具体体系结构目录下的包的概要(并不一定保证每个体系结构具有所有这些包)。

  • External 外部依赖项
  • Sysroot 打包的 Sysroot 文件
  • YSTest YSTest 二进制文件
  • YDE 二进制文件

  内容详见以下二进制文件说明。

  以下为 any 目录下的包的概要。

  • yslib-data YSLib 运行时依赖的数据文件,参见运行说明
  • ybase-header YBase 头文件
  • yframework-header YFramework 头文件

V0.6 起不单独提供头文件,可使用源代码包或 Sysroot 包代替。

  此外,源代码包名以 -src 为后缀,在 src 目录下;而 Doxygen-html 是通过 Doxygen 生成的 HTML/XHTML 文档的包名,在 doc 目录下。

二进制文件说明

  Beta 阶段前,二进制文件不用于对所有被支持的平台提供完整可用的环境。

  除以下另行指定,V0.6(build 600) 起,仅第一类支持(支持等级详见 YSLib 项目文档 doc/ProjectRules.txt )且具有 Sysroot 的平台配置提供完整的二进制文件,包括库和示例项目等。

External

  单独构建外部依赖项,一般是二进制库文件。对所有支持的平台提供。

  V0.6(build 600) 起版本库中不再保持二进制文件。源代码包 src-*.7z 中包括已经编译的外部依赖项。此外,各个平台目录下的 External-*.7z 单独对依赖项打包,可参照前文中的位置自行放置。

Sysroot

  自 build 600 起提供在 release 配置下构建部署的 MinGW Sysroot ,包名为 Sysroot

  因为归档文件限制,符号链接压缩为空文件。如需使用符号链接位置的库,可以手动恢复,流程参见构建脚本

YSTest

  源代码中默认构建的测试用示例项目,按内容命名为 YReader 。

YDE

  自 build 600 起提供 release 配置下在 Sysroot 上构建的 YDE 合集,包名为 YDE

  其中的可执行文件依赖 YBase 和 YFramework 动态库。

构建环境

  这里提供了 YSLib 历史和当前版本使用的构建环境相关的归档,其中 YSLib 目录即上述发布仓库。

基本环境和工具链

  仅提供宿主环境操作系统为 Windows 的二进制文件。

  这些资源仅作为存档以重现历史版本的构建。一般开发建议首先尝试使用最新版本的构建环境。

MinGW32 目标和宿主环境

DS

Android

Linux

文档工具

外部依赖项的源代码