Swift包管理: 源文件布局[翻译]

• 原文: Source Layouts@H_301_2@
• 译者: chai2010@H_301_2@

在Swift包管理工具中，swift build构建命令根据文件系统中sources目录的源代码的布局来创建目标模块。

例如，Swift源文件有以下目录布局结构：

example/
example/sources/bar.swift
example/sources/baz.swift

在example 目录运行swift build命令将生成一个静态库目标：example/.build/debug/example.a。

如果要生成多个目标文件，则需要在sources目录中创建多个子目录：

example/sources/foo/foo.swift
example/sources/bar/bar.swift

运行swift build构建命令将生成两个静态库目标：

• example/.build/debug/foo.a@H_301_2@
• example/.build/debug/bar.a@H_301_2@

要生成一个可执行的模块（而不是库），需要在模块代码所在目录添加一个@H_570_21@main.swift文件：

example/sources/foo/main.swift
example/sources/bar/bar.swift

现在运行swift build命令将生成一个可执行程序：

• example/.build/debug/foo@H_301_2@
• example/.build/debug/bar.a@H_301_2@

其中foo是一个可执行程序，bar.a是一个静态库。

其它规则

• 如果模块中有名为Tests的目录，将被当作测试模块，在运行 swift test测试的时候使用。在Manifest文件中（Package.swift文件），可以通过配置忽略 Tests目录或任意的子目录。也可以针对测试目标单独配置依赖关系，方法和普通目标类似。@H_301_2@
• 如果含有名为sources、source、srcs或src的子目录，当前目录将被当作模块处理。@H_301_2@
• 如果是单一的模块，并且代码都放在根目录的话，没有sources子目录也是可以接受的（通用适用于子目录模块）。对于简单的工程，可以用这种简单的布局规则。@H_301_2@