საქაღალდეების სტრუქტურა
მიუხედავად იმისა, რომ Tuist პროექტებს ხშირად Xcode პროექტების ჩასანაცვლებლად იყენებენ, მათი გამოყენება ამით არ შემოიფარგლება. Tuist პროექტები ასევე გამოიყენება სხვა ტიპის პროექტების გენერაციისთვის, როგორიცაა SPM პაკეტები, შაბლონები, პლაგინები და ამოცანები. ეს დოკუმენტი აღწერს Tuist პროექტების სტრუქტურას და მათი ორგანიზების წესებს. მოგვიანებით განვიხილავთ, თუ როგორ უნდა განვსაზღვროთ შაბლონები, პლაგინები და ამოცანები.
სტანდარტული Tuist პროექტები#
Tuist პროექტები Tuist-ის მიერ გენერირებული ყველაზე გავრცელებული პროექტის ტიპია. ისინი გამოიყენება აპლიკაციების, ფრეიმვორკების და ბიბლიოთეკების შესაქმნელად. Xcode პროექტებისგან განსხვავებით, Tuist პროექტები Swift-შია განსაზღვრული, რაც მათ უფრო მოქნილს და შენარჩუნებადს ხდის. Tuist პროექტები ასევე უფრო დეკლარატიულია, რაც მათ გაგებასა და ანალიზს ამარტივებს. ქვემოთ მოცემული სტრუქტურა ასახავს ტიპურ Tuist პროექტს, რომელიც Xcode პროექტს გენერირებს:
Tuist.swift
Tuist/
Package.swift
ProjectDescriptionHelpers/
Projects/
App/
Project.swift
Feature/
Project.swift
Workspace.swift
-
Tuist საქაღალდე: ამ საქაღალდეს ორი დანიშნულება აქვს. პირველ რიგში, ის მიუთითებს სად მდებარეობს პროექტის ფესვური. ეს საშუალებას გვაძლევს ავაგოთ გზები პროექტის ფესვთან მიმართებაში და ასევე გავუშვათ Tuist ბრძანებები პროექტის ნებისმიერი საქაღალდიდან. მეორეც, ის არის შემდეგი ფაილების კონტეინერი:
- ProjectDescriptionHelpers: ეს საქაღალდე შეიცავს Swift კოდს, რომელიც საერთოა ყველა მანიფესტის ფაილისთვის. მანიფესტის ფაილებს შეუძლიათ
import ProjectDescriptionHelpersამ საქაღალდეში განსაზღვრული კოდის გამოსაყენებლად. კოდის გაზიარება სასარგებლოა დუბლირების თავიდან ასაცილებლად და პროექტებში თანმიმდევრულობის უზრუნველსაყოფად. - Package.swift: ეს ფაილი შეიცავს Swift Package დამოკიდებულებებს, რომლებიც Tuist ინტეგრირდება Xcode პროექტებისა და სამიზნეების საშუალებით (მაგალითად, CocoaPods), რაც კონფიგურირებადსა და ოპტიმიზირებადს ხდის. მეტი ინფორმაცია აქ.
- ProjectDescriptionHelpers: ეს საქაღალდე შეიცავს Swift კოდს, რომელიც საერთოა ყველა მანიფესტის ფაილისთვის. მანიფესტის ფაილებს შეუძლიათ
-
ფესვური საქაღალდე: თქვენი პროექტის ფესვური საქაღალდე, რომელიც ასევე შეიცავს
Tuistსაქაღალდეს.- Tuist.swift: ეს ფაილი შეიცავს Tuist-ის კონფიგურაციას, რომელიც საერთოა ყველა პროექტის, სამუშაო სივრცისა და გარემოსთვის. მაგალითად, ის შეიძლება გამოყენებულ იქნას სქემების ავტომატური გენერაციის გასათიშად ან პროექტების განთავსების სამიზნის განსასაზღვრად.
- Workspace.swift: ეს მანიფესტი წარმოადგენს Xcode სამუშაო სივრცეს. ის გამოიყენება სხვა პროექტების დასაჯგუფებლად და ასევე შეუძლია დამატებითი ფაილებისა და სქემების დამატება.
- Project.swift: ეს მანიფესტი წარმოადგენს Xcode პროექტს. ის გამოიყენება პროექტში შემავალი სამიზნეებისა და მათი დამოკიდებულებების განსასაზღვრად.
ზემოთ აღწერილ პროექტთან ურთიერთობისას, ბრძანებები ელიან, რომ სამუშაო საქაღალდეში ან --path ფლაგით მითითებულ საქაღალდეში იპოვონ ან Workspace.swift, ან Project.swift ფაილი. მანიფესტი უნდა იყოს ისეთ საქაღალდეში ან მის ქვესაქაღალდეში, რომელიც შეიცავს Tuist საქაღალდეს, რაც პროექტის ფესვს წარმოადგენს.
Xcode სამუშაო სივრცეები საშუალებას იძლეოდნენ პროექტების რამდენიმე Xcode პროექტად დაყოფისთვის, რათა შემცირდეს შერწყმის კონფლიქტების ალბათობა. თუ სამუშაო სივრცეებს ამ მიზნით იყენებდით, Tuist-ში ისინი არ არის საჭირო. Tuist ავტომატურად გენერირებს სამუშაო სივრცეს, რომელიც შეიცავს პროექტსა და მისი დამოკიდებულებების პროექტებს.
Swift Package #
Tuist ასევე მხარს უჭერს SPM პაკეტის პროექტებს. თუ SPM პაკეტზე მუშაობთ, არაფრის განახლება არ დაგჭირდებათ. Tuist ავტომატურად აღიქვამს თქვენს ფესვურ Package.swift და Tuist-ის ყველა ფუნქცია ისევე მუშაობს, თითქოს ის Project.swift მანიფესტი იყოს.
დასაწყებად, გაუშვით tuist install და tuist generate თქვენს SPM პაკეტში. თქვენს პროექტს ახლა უნდა ჰქონდეს იგივე სქემები და ფაილები, რასაც ხედავდით სტანდარტულ Xcode SPM ინტეგრაციაში. თუმცა, ახლა ასევე შეგიძლიათ გაუშვათ tuist cache და მიიღოთ თქვენი SPM დამოკიდებულებებისა და მოდულების უმეტესობა წინასწარ კომპილირებული, რაც მომდევნო ბილდებს უკიდურესად სწრაფს ხდის.