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

Xcode-პროექტის მიგრაცია

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

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

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

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

პროექტის საფუძვლის შექმნა#

პირველ რიგში, შექმენით თქვენი პროექტის შაბლონი შემდეგი Tuist-ფაილების გამოყენებით:

javascript
import ProjectDescription
let tuist = Tuist()
javascript
import ProjectDescription
let project = Project(
name: "MyApp-Tuist",
targets: [
/** Targets will go here **/
]
)
javascript
// swift-tools-version: 5.9
import PackageDescription
#if TUIST
import ProjectDescription
let packageSettings = PackageSettings(
// Customize the product types for specific package product
// Default is .staticFramework
// productTypes: ["Alamofire": .framework,]
productTypes: [:]
)
#endif
let package = Package(
name: "MyApp",
dependencies: [
// Add your own dependencies here:
// .package(url: "https://github.com/Alamofire/Alamofire", from: "5.0.0"),
// You can read more about dependencies here: https://tuist.dev/en/docs/guides/features/projects/dependencies
]
)

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

პროექტის სახელი -Tuist სუფიქსით

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

Tuist-პროექტის აგება და ტესტირება CI-ში#

იმის უზრუნველსაყოფად, რომ თითოეული ცვლილების მიგრაცია ვალიდურია, რეკომენდებულია გააფართოვოთ თქვენი უწყვეტი ინტეგრაცია (CI) ისე, რომ ააწყოთ და შეამოწმოთ Tuist-ის მიერ თქვენი მანიფესტის ფაილიდან გენერირებული პროექტი:

bash
tuist install
tuist generate
xcodebuild build {xcodebuild flags} # or tuist test

პროექტის აგების პარამეტრების ამოღება .xcconfig ფაილებში#

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

bash
mkdir -p xcconfigs/
tuist migration settings-to-xcconfig -p MyApp.xcodeproj -x xcconfigs/MyApp-Project.xcconfig

შემდეგ განაახლეთ თქვენი Project.swift ფაილი ისე, რომ მიუთითებდეს ახლად შექმნილ .xcconfig ფაილზე:

swift
import ProjectDescription
let project = Project(
name: "MyApp",
settings: .settings(configurations: [
.debug(name: "Debug", xcconfig: "./xcconfigs/MyApp-Project.xcconfig"),
.release(name: "Release", xcconfig: "./xcconfigs/MyApp-Project.xcconfig"),
]),
targets: [
/** Targets will go here **/
]
)

შემდეგ გააფართოვთ თქვენი უწყვეტი ინტეგრაციის (CI) პაიპლაინი ისე, რომ შეასრულოს შემდეგი ბრძანება და უზრუნველყოს, რომ აგების პარამეტრების ცვლილებები პირდაპირ .xcconfig ფაილებში ხდება:

bash
tuist migration check-empty-settings -p Project.xcodeproj

პაკეტის დამოკიდებულებების ამოღება#

ამოიღეთ თქვენი პროექტის ყველა დამოკიდებულება Tuist/Package.swift ფაილში:

swift
// swift-tools-version: 5.9
import PackageDescription
#if TUIST
import ProjectDescription
let packageSettings = PackageSettings(
// Customize the product types for specific package product
// Default is .staticFramework
// productTypes: ["Alamofire": .framework,]
productTypes: [:]
)
#endif
let package = Package(
name: "MyApp",
dependencies: [
// Add your own dependencies here:
// .package(url: "https://github.com/Alamofire/Alamofire", from: "5.0.0"),
// You can read more about dependencies here: https://tuist.dev/en/docs/guides/features/projects/dependencies
.package(url: "https://github.com/onevcat/Kingfisher", .upToNextMajor(from: "7.12.0"))
]
)
პროდუქტის ტიპები

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

მიგრაციის თანმიმდევრობის განსაზღვრა#

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

bash
tuist migration list-targets -p Project.xcodeproj

დაიწყეთ სამიზნეების მიგრაცია სიის თავიდან, რადგან ისინი არიან ისინი, ვინზეც ყველაზე მეტად არიან დამოკიდებულნი.

სამიზნეების მიგრაცია#

გადაიტანეთ სამიზნეები ერთ-ერთად. რეკომენდებულია თითოეული სამიზნისთვის pull request-ის გაკეთება, რათა უზრუნველყოთ, რომ ცვლილებები განიხილება და შემოწმდება მათ შერწყმამდე.

სამიზნის აგების პარამეტრების ამოღება .xcconfig ფაილებში#

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

bash
tuist migration settings-to-xcconfig -p MyApp.xcodeproj -t TargetX -x xcconfigs/TargetX.xcconfig

სამიზნის განსაზღვრა Project.swift ფაილში#

განსაზღვრეთ სამიზნე Project.targets-ში:

swift
import ProjectDescription
let project = Project(
name: "MyApp",
settings: .settings(configurations: [
.debug(name: "Debug", xcconfig: "./xcconfigs/Project.xcconfig"),
.release(name: "Release", xcconfig: "./xcconfigs/Project.xcconfig"),
]),
targets: [
.target(
name: "TargetX",
destinations: .iOS,
product: .framework, // or .staticFramework, .staticLibrary...
bundleId: "dev.tuist.targetX",
sources: ["Sources/TargetX/**"],
dependencies: [
/** Dependencies go here **/
/** .external(name: "Kingfisher") **/
/** .target(name: "OtherProjectTarget") **/
],
settings: .settings(configurations: [
.debug(name: "Debug", xcconfig: "./xcconfigs/TargetX.xcconfig"),
.release(name: "Release", xcconfig: "./xcconfigs/TargetX.xcconfig"),
])
),
]
)
ტესტების სამიზნეები

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

სამიზნის მიგრაციის ვალიდაცია#

შეასრულეთ tuist generate, შემდეგ xcodebuild build, რათა უზრუნველყოთ პროექტის აწყობა, და tuist test, რათა უზრუნველყოთ ტესტების წარმატებით გავლა. დამატებით, შეგიძლიათ გამოიყენოთ xcdiff გენერირებული Xcode-პროექტის არსებულთან შესადარებლად, რათა უზრუნველყოთ, რომ ცვლილებები სწორია.

გამეორება#

გაიმეორეთ, სანამ ყველა სამიზნე სრულად არ გადაიტანება. როგორც კი დაასრულებთ, რეკომენდებულია განაახლოთ თქვენი CI და CD პაიპლაინები, რათა ააწყოთ და შეამოწმოთ პროექტი tuist generate-ის გამოყენებით, შემდეგ xcodebuild build და tuist test.

პრობლემების გადაჭრა#

კომპილაციის შეცდომები გამოტოვებული ფაილების გამო.#

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