დინამიური კონფიგურაცია
არსებობს სცენარები, როდესაც პროექტის გენერაციის დროს მისი დინამიურად კონფიგურირება შეიძლება დაგჭირდეთ. მაგალითად, შესაძლოა, გსურდეთ აპლიკაციის სახელის, ბანდლის იდენტიფიკატორის ან განთავსების მიზნის (deployment target) შეცვლა იმ გარემოს მიხედვით, სადაც პროექტი გენერირდება. Tuist ამას გარემოს ცვლადების მეშვეობით უზრუნველყოფს, რომლებზეც წვდომა მანიფესტის ფაილებიდან არის შესაძლებელი.
კონფიგურაცია გარემოს ცვლადების მეშვეობით#
Tuist საშუალებას გაძლევთ, კონფიგურაცია გადასცეთ გარემოს ცვლადების მეშვეობით, რომლებზეც წვდომა მანიფესტის ფაილებიდან არის შესაძლებელი. მაგალითად:
TUIST_APP_NAME=MyApp tuist generate
თუ რამდენიმე გარემოს ცვლადის გადაცემა გსურთ, უბრალოდ გამოყავით ისინი შუალედით. მაგალითად:
TUIST_APP_NAME=MyApp TUIST_APP_LOCALE=pl tuist generate
გარემოს ცვლადების წაკითხვა მანიფესტებიდან#
ცვლადებზე წვდომა შესაძლებელია ტიპის Environment გამოყენებით. ნებისმიერი ცვლადი, რომელიც ემორჩილება TUIST_XXX შეთანხმებას და განსაზღვრულია გარემოში ან გადაეცემა Tuist-ს ბრძანებების შესრულებისას, ხელმისაწვდომი იქნება ტიპის Environment მეშვეობით. აქსესორები იყენებენ ცვლადის camelCase სახელს TUIST_ პრეფიქსის გარეშე, ამიტომ TUIST_APP_NAME იკითხება როგორც Environment.appName, ხოლო TUIST_ENABLE_ANALYTICS — როგორც Environment.enableAnalytics. იმის შესამოწმებლად, ხდება თუ არა მანიფესტის შეფასება CI-ზე, გამოიყენეთ ბულეანი Environment.isCI. შემდეგი მაგალითი კითხულობს TUIST_APP_NAME-ს:
func appName() -> String {
if case let .string(environmentAppName) = Environment.appName {
return environmentAppName
} else {
return "MyApp"
}
}
ცვლადებზე წვდომა აბრუნებს ტიპის Environment.Value? ეგზემპლარს, რომელსაც შეიძლება ჰქონდეს შემდეგი მნიშვნელობები:
| შემთხვევა | აღწერა |
|---|---|
.string(String) |
გამოიყენება, როდესაც ცვლადი წარმოადგენს სტრიנגს. |
ასევე შეგიძლიათ მიიღოთ სტრიngის ან ბულეანის ტიპის Environment ცვლადი ქვემოთ განსაზღვრული დამხმარე მეთოდების გამოყენებით; ეს მეთოდები მოითხოვენ ნაგულისხმევი მნიშვნელობის გადაცემას, რათა მომხმარებელმა ყოველ ჯერზე თანმიმდევრული შედეგები მიიღოს. ეს თავიდან აგაცილებთ ზემოთ განსაზღვრული appName() ფუნქციის განსაზღვრის საჭიროებას.
Environment.appName.getString(default: "MyApp")
Environment.enableAnalytics.getBoolean(default: false)
დამატებითი გარემოს ცვლადების გადაცემა მანიფესტებში#
ნაგულისხმევად, მხოლოდ TUIST_ პრეფიქსის მქონე ცვლადები, ასევე CI და DEVELOPER_DIR, გადაეცემა ქვეპროცესს, რომელიც აფასებს Project.swift-ს, Workspace.swift-ს, Package.swift-ს და პროექტის აღწერის დამხმარეებს. ეს ინარჩუნებს გენერაციის დეტერმინისტულობას და ხელს უშლის არარელევანტური shell-ის ან CI ცვლადების მიერ მანიფესტის ქეშის გაუქმებას.
როდესაც მანიფესტს სჭირდება ისეთი ცვლადების წაკითხვა, რომლებიც თქვენს კონტროლს არ ექვემდებარება (მაგალითად, მესამე მხარის Package.swift, რომელიც უკვე კითხულობს OPENSWIFTUI_LIBRARY_TYPE-ს), განაცხადეთ ისინი Tuist.swift-ში manifestEnvironment-ის მეშვეობით გენერაციის პარამეტრებში. თითოეული ჩანაწერი არის ან ლიტერალური სახელი, ან სახელი, რომელიც ბოლოვდება *-ით პრეფიქსის შესაბამისობისთვის:
import ProjectDescription
let tuist = Tuist(
project: .tuist(
generationOptions: .options(
manifestEnvironment: [
"OPENSWIFTUI_*",
"MY_VAR",
]
)
)
)
ჩამოთვლილი ცვლადები მონაწილეობენ მანიფესტის ქეშის ჰეშში, ამიტომ მათი მნიშვნელობების ცვლილება მოსალოდნელად აუქმებს ქეშს. ჩამოუთვლელი ცვლადები რჩება დამალული მანიფესტის შეფასებისთვის.