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

Tuist v3-დან v4-ზე

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

ვერსიების მართვა tuistenv-ის საშუალებით ამოღებულია#

Tuist 4-მდე ინსტალაციის სკრიპტი აინსტალირებდა ინსტრუმენტს tuistenv, რომელიც ინსტალაციის დროს გადაერქმეოდა tuist-ად. ეს ინსტრუმენტი ზრუნავდა Tuist-ის ვერსიების ინსტალაციასა და აქტივაციაზე, რაც უზრუნველყოფდა დეტერმინიზმს სხვადასხვა გარემოში. Tuist-ის ფუნქციონალის შემცირების მიზნით, ჩვენ გადავწყვიტეთ tuistenv-ის ამოღება Mise-ის სასარგებლოდ — ინსტრუმენტის, რომელიც იგივე სამუშაოს ასრულებს, მაგრამ უფრო მოქნილია და სხვადასხვა ინსტრუმენტთან ერთად შეიძლება მისი გამოყენება. თუ იყენებდით tuistenv, მოგიწევთ Tuist-ის მიმდინარე ვერსიის წაშლა curl -Ls https://uninstall.tuist.io | bash-ის გაშვებით და შემდეგ მისი ინსტალაცია თქვენთვის სასურველი მეთოდით. ჩვენ მკაცრად გირჩევთ Mise-ის გამოყენებას, რადგან ის სხვადასხვა გარემოში ვერსიების დეტერმინისტულად ინსტალაციასა და აქტივაციას უზრუნველყოფს.

bash
curl -Ls https://uninstall.tuist.io | bash
Mise CI გარემოებსა და Xcode პროექტებში

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

Homebrew მხარდაჭერილია

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

init კონსტრუქტორები ამოღებულია ProjectDescription მოდელებიდან#

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

სახელდების კონვენცია

ჩვენი მიმდევარი სახელდების კონვენცია გულისხმობს მოდელის სახელის გამოყენებას სტატიკური კონსტრუქტორის სახელად. მაგალითად, Target მოდელის სტატიკური კონსტრუქტორია Target.target.

--no-cache გადაერქვა --no-binary-cache-ად#

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

tuist fetch გადაერქვა tuist install-ად#

ბრძანება tuist fetch გადავარქვით tuist install-ად, რათა შესაბამისობაში მოგვეყვანა ის ინდუსტრიულ კონვენციასთან. თუ იყენებდით tuist fetch ბრძანებას, მოგიწევთ თქვენი პროექტის განახლება tuist install ბრძანების გამოყენებისთვის.

Package.swift-ის მიღება დამოკიდებულებების DSL-ად#

Tuist 4-მდე დამოკიდებულებების განსაზღვრა შეგიძლიათ Dependencies.swift ფაილში. ამ პროპრიეტარულმა ფორმატმა დაარღვია მხარდაჭერა ისეთ ინსტრუმენტებში, როგორიცაა Dependabot ან Renovatebot, რათა დამოკიდებულებები ავტომატურად განახლებულიყო. ამასთან, მან შემოიტანა არასაჭირო შუამავლობები მომხმარებლებისთვის. ამიტომ, გადავწყვიტეთ Package.swift-ის მიღება Tuist-ში დამოკიდებულებების განსაზღვრის ერთადერთ გზად. თუ იყენებდით Dependencies.swift ფაილს, მოგიწევთ თქვენი Tuist/Dependencies.swift-ის შინაარსის გადატანა ძირში მდებარე Package.swift-ში და #if TUIST დირექტივის გამოყენება ინტეგრაციის კონფიგურაციისთვის. Swift Package დამოკიდებულებების ინტეგრაციის შესახებ მეტის წაკითხვა შეგიძლიათ აქ

tuist cache warm გადაერქვა tuist cache-ად#

მოკლე ფორმისთვის, გადავწყვიტეთ tuist cache warm ბრძანების tuist cache-ად გადაქცევა. თუ იყენებდით tuist cache warm ბრძანებას, მოგიწევთ თქვენი პროექტის განახლება tuist cache ბრძანების გამოყენებისთვის.

tuist cache print-hashes გადაერქვა tuist cache --print-hashes-ად#

გადავწყვიტეთ tuist cache print-hashes ბრძანების tuist cache --print-hashes-ად გადაქცევა, რათა ცხადი ყოფილიყო, რომ ის tuist cache ბრძანების ფლაგია. თუ იყენებდით tuist cache print-hashes ბრძანებას, მოგიწევთ თქვენი პროექტის განახლება tuist cache --print-hashes ფლაგის გამოყენებისთვის.

ქეშირების პროფილები ამოღებულია#

Tuist 4-მდე ქეშირების პროფილების განსაზღვრა შეგიძლიათ Tuist/Config.swift-ში, რომელიც შეიცავდა ქეშის კონფიგურაციას. გადავწყვიტეთ ამ ფუნქციის ამოღება, რადგან მისი გამოყენება გენერაციის პროცესში პროექტის გენერაციისთვის გამოყენებული პროფილისგან განსხვავებული პროფილით შეიძლება დაბნეულობას იწვევდეს. ამასთან, შეიძლება მომხმარებლები debug პროფილს იყენებდნენ აპლიკაციის release ვერსიის აგებისთვის, რაც მოულოდნელ შედეგებს გამოიწვევდა. მის ნაცვლად, ჩვენ შემოვიტანეთ --configuration ოფცია, რომლის გამოყენებითაც შეგიძლიათ მიუთითოთ კონფიგურაცია, რომელიც გსურთ პროექტის გენერაციისას. თუ იყენებდით ქეშირების პროფილებს, მოგიწევთ თქვენი პროექტის განახლება --configuration ოფციის გამოყენებისთვის.

--skip-cache ამოღებულია არგუმენტების სასარგებლოდ#

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

bash
tuist generate --skip-cache Foo
bash
tuist generate Foo

ხელმოწერის შესაძლებლობები ამოღებულია#

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

  • სკრიპტი, რომელიც შლის სერტიფიკატებსა და პროფილებს გასაღებით, რომელიც ან ფაილურ სისტემაშია შენახული, ან გარემოს ცვლადში, და აინსტალირებს სერტიფიკატებს keychain-ში, ხოლო პროვიზიონირების პროფილებს დირექტორიაში ~/Library/MobileDevice/Provisioning\ Profiles.
  • სკრიპტი, რომელსაც შეუძლია არსებული პროფილებისა და სერტიფიკატების აღება და მათი დაშიფვრა.
ხელმოწერის მოთხოვნები

ხელმოწერას სჭირდება, რომ საჭირო სერტიფიკატები იყოს keychain-ში, ხოლო პროვიზიონირების პროფილები — დირექტორიაში ~/Library/MobileDevice/Provisioning\ Profiles. სერტიფიკატების keychain-ში ინსტალაციისთვის შეგიძლიათ გამოიყენოთ security ბრძანების ხაზის ინსტრუმენტი, ხოლო პროვიზიონირების პროფილების სწორ დირექტორიაში დასაკოპირებლად — cp ბრძანება.

Carthage-ის ინტეგრაცია Dependencies.swift-ის საშუალებით ამოღებულია#

Tuist 4-მდე Carthage-ის დამოკიდებულებების განსაზღვრა შესაძლებელი იყო Dependencies.swift ფაილში, რომლის მიღებაც მომხმარებლებს შეეძლოთ tuist fetch ბრძანების გაშვებით. ჩვენ ასევე ვფიქრობდით, რომ ეს Tuist-ისთვის ზედმეტად ამბიციური ამოცანა იყო, განსაკუთრებით იმ პერსპექტივის გათვალისწინებით, სადაც Swift Package Manager იქნება დამოკიდებულებების მართვის სასურველი გზა. თუ Carthage-ის დამოკიდებულებებს იყენებდით, მოგიწევთ Carthage-ის პირდაპირ გამოყენება წინასწარ კომპილირებული ფრეიმვორკებისა და XCFrameworks-ის Carthage-ის სტანდარტულ დირექტორიაში ჩამოსატვირთად, შემდეგ კი ამ ბინარული ფაილების თქვენს სამიზნეებზე (TargetDependency.xcframework და TargetDependency.framework კეისების საშუალებით) მითითება.

Carthage კვლავ მხარდაჭერილია

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

ამოღებულია TargetDependency.packagePlugin API#

Tuist 4-მდე პაკეტის პლაგინის დამოკიდებულების განსაზღვრა შესაძლებელი იყო TargetDependency.packagePlugin კეისის გამოყენებით. Swift Package Manager-ის მიერ ახალი პაკეტის ტიპების შემოღების ნახვის შემდეგ, გადავწყვიტეთ API-ს იტერაციულად განვითარება უფრო მოქნილი და მომავლისთვის მზად მყოფი რამისკენ. თუ TargetDependency.packagePlugin-ს იყენებდით, მოგიწევთ TargetDependency.package-ის გამოყენება და სასურველი პაკეტის ტიპის არგუმენტად გადაცემა.

მოძველებული API-ები ამოღებულია#

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