Szablony

W projektach o ustalonej architekturze programiści mogą chcieć uruchomić nowe komponenty lub funkcje, które są spójne z projektem. Dzięki tuist scaffold można generować pliki z szablonu. Możesz zdefiniować własne szablony lub użyć tych, które są dostarczane z Tuist. Oto kilka scenariuszy, w których rusztowanie może być przydatne:

• Utwórz nową funkcję o określonej architekturze: tuist scaffold viper --name MyFeature.
• Tworzenie nowych projektów: tuist scaffold feature-project --name Home

BEZ OPINII

Tuist nie ma zdania na temat zawartości szablonów i tego, do czego ich używasz. Wymagane jest jedynie, aby znajdowały się one w określonym katalogu.

Definiowanie szablonu

Aby zdefiniować szablony, można uruchomić

`tuist edit`, a następnie utworzyć katalog o nazwie name_of_template

w Tuist/Templates, który reprezentuje szablon. Szablony wymagają pliku manifestu, name_of_template.swift który opisuje szablon. Jeśli więc tworzysz szablon o nazwie framework, powinieneś utworzyć nowy katalog framework w Tuist/Templates z plikiem manifestu o nazwie framework.swift, który może wyglądać następująco:

import ProjectDescription

let nameAttribute: Template.Attribute = .required("name")

let template = Template(
    description: "Custom template",
    attributes: [
        nameAttribute,
        .optional("platform", default: "ios"),
    ],
    items: [
        .string(
            path: "Project.swift",
            contents: "My template contents of name \(nameAttribute)"
        ),
        .file(
            path: "generated/Up.swift",
            templatePath: "generate.stencil"
        ),
        .directory(
            path: "destinationFolder",
            sourcePath: "sourceFolder"
        ),
    ]
)

Korzystanie z szablonu

Po zdefiniowaniu szablonu możemy go użyć z poziomu polecenia scaffold:

tuist scaffold name_of_template --name Name --platform macos

:: info

Ponieważ platforma jest opcjonalnym argumentem, możemy również wywołać polecenie bez argumentu --platform macos.

:::

Jeśli .string i .files nie zapewniają wystarczającej elastyczności, można wykorzystać język szablonów Stencil poprzez przypadek .file. Oprócz tego można również użyć dodatkowych filtrów zdefiniowanych tutaj.

Używając interpolacji ciągów znaków, \(nameAttribute) powyżej zostałoby rozwiązane jako . Jeśli chcesz użyć filtrów Stencil w definicji szablonu, możesz użyć tej interpolacji ręcznie i dodać dowolne filtry. Na przykład, można użyć { { nazwa | małe litery } } zamiast \(nameAttribute), aby uzyskać wartość atrybutu name pisaną małymi literami.

Można również użyć .directory, który daje możliwość kopiowania całych folderów do podanej ścieżki.

POMOCNICY W OPISIE PROJEKTU

Szablony obsługują użycie

pomocników opisu projektu w celu ponownego wykorzystania kodu między szablonami.