동적 구성

프로젝트 생성 시점에 동적으로 구성해야 하는 경우가 있습니다. 예를 들어, 프로젝트가 생성되는 환경에 따라 앱 이름, 번들 식별자 또는 배포 대상을 변경할 수 있습니다. Tuist는 매니페스트 파일에서 접근할 수 있는 환경 변수를 통해 이를 지원합니다.

환경 변수를 통한 구성#

Tuist는 매니페스트 파일에서 접근할 수 있는 환경 변수를 통해 구성 값을 전달할 수 있게 해줍니다. 예를 들면 다음과 같습니다:

bash

TUIST_APP_NAME=MyApp tuist generate

여러 환경 변수를 전달하려면 공백으로 구분하면 됩니다. 예를 들면 다음과 같습니다:

bash

TUIST_APP_NAME=MyApp TUIST_APP_LOCALE=pl tuist generate

매니페스트에서 환경 변수 읽기#

변수는 Environment 타입을 사용해 접근할 수 있습니다. 환경에서 정의되거나 명령 실행 시 Tuist에 전달된 TUIST_XXX 규칙을 따르는 모든 변수는 Environment 타입을 사용해 접근할 수 있습니다. 다음 예시는 TUIST_APP_NAME 변수에 접근하는 방법을 보여줍니다:

swift

func appName() -> String {
    if case let .string(environmentAppName) = Environment.appName {
        return environmentAppName
    } else {
        return "MyApp"
    }
}

변수에 접근하면 Environment.Value? 타입의 인스턴스를 반환하며, 이는 다음 값 중 하나를 가질 수 있습니다:

케이스	설명
`.string(String)`	변수가 문자열을 나타낼 때 사용됩니다.

아래에 정의된 헬퍼 메서드 중 하나를 사용하여 문자열 또는 불리언 Environment 변수를 가져올 수도 있습니다. 이러한 메서드는 사용자가 매번 일관된 결과를 얻을 수 있도록 기본값을 전달해야 합니다. 이렇게 하면 위에서 정의한 appName() 함수를 별도로 정의할 필요가 없습니다.

swift

Environment.appName.getString(default: "TuistServer")

swift

Environment.isCI.getBoolean(default: false)

기본적으로 TUIST_ 접두사가 붙은 변수와 CI, DEVELOPER_DIR만 Project.swift, Workspace.swift, Package.swift 및 프로젝트 설명 헬퍼를 평가하는 하위 프로세스로 전달됩니다. 이로 인해 생성 과정이 결정적으로 유지되며, 관련 없는 셸 또는 CI 변수가 매니페스트 캐시를 무효화하는 것을 방지합니다.

매니페스트가 제어 범위에 있지 않은 변수를 읽어야 할 때(예: 이미 OPENSWIFTUI_LIBRARY_TYPE를 읽는 서드파티 Package.swift)에는 생성 옵션의 manifestEnvironment를 통해 Tuist.swift에 해당 변수를 선언하세요. 각 항목은 리터럴 이름이거나, 접두사 매칭을 위해 *로 끝나는 이름입니다:

swift

import ProjectDescription

let tuist = Tuist(
    project: .tuist(
        generationOptions: .options(
            manifestEnvironment: [
                "OPENSWIFTUI_*",
                "MY_VAR",
            ]
        )
    )
)

목록에 포함된 변수는 매니페스트 캐시 해시에 포함되므로, 값이 변경되면 예상대로 캐시가 무효화됩니다. 목록에 포함되지 않은 변수는 매니페스트 평가에서 숨겨진 상태로 유지됩니다.

동적 구성

환경 변수를 통한 구성#

매니페스트에서 환경 변수 읽기#

매니페스트로 추가 환경 변수 전달하기#