代码共享{#code-sharing} - Tuist

当我们在大型项目中使用 Xcode 时，它的一个不便之处在于，除了通过.xcconfig 文件进行构建设置外，它不允许重复使用项目的其他元素。由于以下原因，重复使用项目定义非常有用：

它简化了维护，因为变更可以在一个地方应用，而且所有项目都能自动获得变更。
它使公约的定义成为可能，新项目可以遵守这些公约。
项目的更为一致 ，因此因不一致而导致构建失败的可能性大大降低。
由于我们可以重复使用现有的逻辑，因此添加新项目变得轻而易举。

借助项目描述助手 这一概念，Tuist 可以在清单文件中重复使用代码。

[!TIP] A Tuist Unique Asset

许多组织之所以喜欢 Tuist，是因为他们从项目描述助手中看到了一个平台，平台团队可以通过这个平台编纂自己的约定，并提出自己的项目描述语言。例如，基于 YAML 的项目生成器必须提出自己的基于 YAML 的专用模板解决方案，或者迫使组织在此基础上构建自己的工具。

项目描述助手{#project-description-helpers}

项目描述助手是 Swift 文件，会被编译成一个模块ProjectDescriptionHelpers ，清单文件可以导入该模块。该模块通过收集Tuist/ProjectDescriptionHelpers 目录中的所有文件进行编译。

您可以在文件顶部添加导入语句，将它们导入清单文件：

swift

// Project.swift
import ProjectDescription
import ProjectDescriptionHelpers

ProjectDescriptionHelpers 在以下清单中提供：

Project.swift
Package.swift （仅在#TUIST 编译器标志后面）
工作区.swift

示例{#example}

下面的代码段包含一个示例，说明我们如何扩展Project 模型以添加静态构造函数，以及如何从Project.swift 文件中使用这些构造函数：

代码组

swift

import ProjectDescription

extension Project {
  public static func featureFramework(name: String, dependencies: [TargetDependency] = []) -> Project {
    return Project(
        name: name,
        targets: [
            .target(
                name: name,
                destinations: .iOS,
                product: .framework,
                bundleId: "dev.tuist.\(name)",
                infoPlist: "\(name).plist",
                sources: ["Sources/\(name)/**"],
                resources: ["Resources/\(name)/**",],
                dependencies: dependencies
            ),
            .target(
                name: "\(name)Tests",
                destinations: .iOS,
                product: .unitTests,
                bundleId: "dev.tuist.\(name)Tests",
                infoPlist: "\(name)Tests.plist",
                sources: ["Sources/\(name)Tests/**"],
                resources: ["Resources/\(name)Tests/**",],
                dependencies: [.target(name: name)]
            )
        ]
    )
  }
}

swift

import ProjectDescription
import ProjectDescriptionHelpers

let project = Project.featureFramework(name: "MyFeature")

:::

[!TIP] A Tool To Establish Conventions

请注意我们是如何通过该函数定义目标名称、捆绑标识符和文件夹结构的。