동적 구성

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

환경 변수를 통한 구성

Tuist에서는 매니페스트 파일에서 액세스할 수 있는 환경 변수를 통해 구성을 전달할 수 있습니다. 예를 들어

TUIST_APP_NAME=MyApp tuist generate

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

TUIST_APP_NAME=MyApp TUIST_APP_LOCALE=pl tuist generate

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

변수는

`환경`

유형을 사용하여 액세스할 수 있습니다. 환경에 정의되어 있거나 명령 실행 시 Tuist에 전달된 TUIST_XXX 규칙을 따르는 모든 변수는 환경 유형을 사용하여 액세스할 수 있습니다. 다음 예는 TUIST_APP_NAME 변수에 액세스하는 방법을 보여줍니다:

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

변수에 액세스하면 다음 값 중 하나를 취할 수 있는 Environment.Value? 유형의 인스턴스가 반환됩니다:

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

아래에 정의된 도우미 메서드 중 하나를 사용하여 문자열 또는 부울 환경 변수를 검색할 수도 있으며, 이러한 메서드에는 사용자가 매번 일관된 결과를 얻을 수 있도록 기본값을 전달해야 합니다. 이렇게 하면 위에 정의된 appName() 함수를 정의할 필요가 없습니다.

String

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

Boolean

Environment.isCI.getBoolean(default: false)