გადადით შინაარსზე

კოდის გაზიარება

Xcode-ის ერთ-ერთი უხერხულობა დიდ პროექტებთან მუშაობისას არის ის, რომ ის არ იძლევა პროექტის ელემენტების ხელახლა გამოყენების საშუალებას, გარდა აგების პარამეტრებისა, .xcconfig ფაილების მეშვეობით. პროექტის განსაზღვრებების ხელახლა გამოყენება სასარგებლოა შემდეგი მიზეზების გამო:

  • ამარტივებს მომსახურებას, რადგან ცვლილებები შეიძლება განხორციელდეს ერთ ადგილას და ყველა პროექტი ავტომატურად მიიღებს ამ ცვლილებებს.
  • საშუალებას იძლევა განისაზღვროს კონვენციები, რომლებსაც ახალი პროექტები შეუძლიათ დაემორჩილონ.
  • პროექტები უფრო თანმიმდევრულია და, შესაბამისად, თანმიმდევრულობის ნაკლებობის გამო აგების ჩავარდნის ალბათობა მნიშვნელოვნად მცირდება.
  • ახალი პროექტების დამატება მარტივ ამოცანად იქცევა, რადგან შეგვიძლია არსებული ლოგიკის ხელახლა გამოყენება.

Tuist-ში კოდის ხელახლა გამოყენება მანიფესტის ფაილებში შესაძლებელია პროექტის აღწერის დამხმარეების კონცეფციის წყალობით.

Tuist-ის უნიკალური უპირატესობა

ბევრ ორგანიზაციას მოსწონს Tuist, რადგან ისინი პროექტის აღწერის დამხმარეებში ხედავენ პლატფორმას, რომლითაც პლატფორმის გუნდებს შეუძლიათ საკუთარი კონვენციების კოდირება და პროექტების აღწერისთვის საკუთარი ენის შექმნა. მაგალითად, YAML-ზე დაფუძნებულ პროექტების გენერატორებს უნდა შეიმუშაონ საკუთარი YAML-ზე დაფუძნებული პროპრიეტარული შაბლონიზაციის გადაწყვეტა, ან აიძულონ ორგანიზაციები, თავიანთი ინსტრუმენტები ამაზე ააშენონ.

პროექტის აღწერის დამხმარეები#

პროექტის აღწერის დამხმარეები არის Swift ფაილები, რომლებიც კომპილირდება ProjectDescriptionHelpers მოდულად, რომლის იმპორტირებაც მანიფესტის ფაილებს შეუძლიათ. მოდული კომპილირდება Tuist/ProjectDescriptionHelpers დირექტორიაში არსებული ყველა ფაილის შეკრებით.

შეგიძლიათ მათი იმპორტირება თქვენს მანიფესტის ფაილში ფაილის თავში import განცხადების დამატებით:

swift
// Project.swift
import ProjectDescription
import ProjectDescriptionHelpers

ProjectDescriptionHelpers ხელმისაწვდომია შემდეგ მანიფესტებში:

  • Project.swift
  • Package.swift (მხოლოდ #TUIST კომპილატორის დროშის უკან)
  • Workspace.swift

მაგალითი#

ქვემოთ მოყვანილ სნიპეტებში ნაჩვენებია მაგალითი, თუ როგორ ვაფართოებთ 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)]
)
]
)
}
}
კონვენციების დასამყარებელი ინსტრუმენტი

ყურადღება მიაქციეთ, როგორ განვსაზღვრავთ ფუნქციის მეშვეობით კონვენციებს სამიზნეების სახელების, ბანდლის იდენტიფიკატორისა და საქაღალდეების სტრუქტურის შესახებ.