მეტამონაცემების ტეგები
როდესაც პროექტები ზომითა და სირთულით იზრდება, მთელ კოდბაზასთან ერთდროულად მუშაობა შეიძლება არაეფექტური გახდეს. Tuist გთავაზობთ მეტამონაცემების ტეგებს, როგორც საშუალებას სამიზნეები ლოგიკურ ჯგუფებად დააჯგუფოთ და განვითარების დროს პროექტის კონკრეტულ ნაწილებზე ფოკუსირდეთ.
რა არის მეტამონაცემების ტეგები?#
მეტამონაცემების ტეგები არის სტრიქონული ჭდეები, რომლებიც შეგიძლიათ მიანიჭოთ თქვენი პროექტის სამიზნეებს. ისინი ემსახურებიან მარკერებს, რომლებიც საშუალებას გაძლევთ:
- დააჯგუფოთ დაკავშირებული სამიზნეები - მონიშნეთ სამიზნეები, რომლებიც ერთსა და იმავე ფუნქციას, გუნდს ან არქიტექტურულ შრეს ეკუთვნიან
- ფოკუსირება თქვენს სამუშაო სივრცეზე - წარმოქმენით პროექტები, რომლებიც მხოლოდ კონკრეტული ტეგების მქონე სამიზნეებს შეიცავენ
- ოპტიმიზაცია თქვენი სამუშაო პროცესის - იმუშავეთ კონკრეტულ ფუნქციებზე კოდბაზის შეუღებელი ნაწილების ჩატვირთვის გარეშე
- აირჩიეთ სამიზნეები, რომლებიც წყაროდ შეინარჩუნოთ - აირჩიეთ, სამიზნეების რომელი ჯგუფი გსურთ შეინარჩუნოთ წყაროდ ქეშირების დროს
ტეგები განისაზღვრება სამიზნეებზე metadata თვისების გამოყენებით და ინახება სტრიქონების მასივად.
მეტამონაცემების ტეგების განსაზღვრა#
შეგიძლიათ დაამატოთ ტეგები ნებისმიერ სამიზნეს თქვენს პროექტის მანიფესტში:
import ProjectDescription
let project = Project(
name: "MyApp",
targets: [
.target(
name: "Authentication",
destinations: .iOS,
product: .framework,
bundleId: "com.example.authentication",
sources: ["Sources/**"],
metadata: .metadata(tags: ["feature:auth", "team:identity"])
),
.target(
name: "Payment",
destinations: .iOS,
product: .framework,
bundleId: "com.example.payment",
sources: ["Sources/**"],
metadata: .metadata(tags: ["feature:payment", "team:commerce"])
),
.target(
name: "App",
destinations: .iOS,
product: .app,
bundleId: "com.example.app",
sources: ["Sources/**"],
dependencies: [
.target(name: "Authentication"),
.target(name: "Payment")
]
)
]
)
ფოკუსირება მონიშნულ სამიზნეებზე#
მას შემდეგ, რაც სამიზნეებს ტეგებს მიანიჭებთ, შეგიძლიათ გამოიყენოთ ბრძანება tuist generate, რათა შექმნათ ფოკუსირებული პროექტი, რომელიც მხოლოდ კონკრეტულ სამიზნეებს შეიცავს:
ფოკუსირება ტეგით#
გამოიყენეთ პრეფიქსი tag:, რათა წარმოქმნათ პროექტი ყველა იმ სამიზნით, რომელიც კონკრეტულ ტეგს შეესაბამება:
# Generate project with all authentication-related targets
tuist generate tag:feature:auth
# Generate project with all targets owned by the identity team
tuist generate tag:team:identity
ფოკუსირება სახელით#
ასევე შეგიძლიათ ფოკუსირდეთ კონკრეტულ სამიზნეებზე სახელის მიხედვით:
# Generate project with the Authentication target
tuist generate Authentication
როგორ მუშაობს ფოკუსირება#
როდესაც ფოკუსირდებით სამიზნეებზე:
- ჩართული სამიზნეები - თქვენს მოთხოვნას შესაბამისი სამიზნეები შედიან წარმოქმნილ პროექტში
- დამოკიდებულებები - ფოკუსირებული სამიზნეების ყველა დამოკიდებულება ავტომატურად შედის
- ტესტების სამიზნეები - ფოკუსირებული სამიზნეების ტესტების სამიზნეები შედის
- გამორიცხვა - ყველა სხვა სამიზნე გამორიცხულია სამუშაო სივრციდან
ეს ნიშნავს, რომ მიიღებთ უფრო მცირე და უკეთ მართვად სამუშაო სივრცეს, რომელიც მხოლოდ იმას შეიცავს, რაც თქვენს ფუნქციაზე მუშაობისთვის გჭირდებათ.
ტეგების სახელდების კონვენციები#
მიუხედავად იმისა, რომ ტეგად ნებისმიერი სტრიქონის გამოყენება შეგიძლიათ, თანმიმდევრული სახელდების კონვენციის დაცვა ხელს უწყობს თქვენი ტეგების ორგანიზებულად შენარჩუნებას:
// Organize by feature
metadata: .metadata(tags: ["feature:authentication", "feature:payment"])
// Organize by team ownership
metadata: .metadata(tags: ["team:identity", "team:commerce"])
// Organize by architectural layer
metadata: .metadata(tags: ["layer:ui", "layer:business", "layer:data"])
// Organize by platform
metadata: .metadata(tags: ["platform:ios", "platform:macos"])
// Combine multiple dimensions
metadata: .metadata(tags: ["feature:auth", "team:identity", "layer:ui"])
პრეფიქსების, როგორიცაა feature:, team: ან layer:, გამოყენება ამარტივებს თითოეული ტეგის დანიშნულების გაგებას და სახელდების კონფლიქტების თავიდან აცილებას.
სისტემური ტეგები#
Tuist იყენებს პრეფიქსს tuist: სისტემის მიერ მართული ტეგებისთვის. ეს ტეგები ავტომატურად ენიჭება Tuist-ის მიერ და შეიძლება გამოყენებულ იქნას ქეშის პროფილებში წარმოქმნილი კონტენტის კონკრეტული ტიპების სამიზნედ ასაღებად.
ხელმისაწვდომი სისტემური ტეგები#
| ტეგი | აღწერა |
|---|---|
tuist:synthesized |
გამოიყენება სინთეზირებული ბანდლის სამიზნეებზე, რომლებსაც Tuist ქმნის რესურსების დამუშავებისთვის სტატიკურ ბიბლიოთეკებსა და სტატიკურ ფრეიმვორქებში. ეს ბანდლები ისტორიული მიზეზების გამო არსებობს, რათა უზრუნველყონ რესურსებზე წვდომის API-ები. |
სისტემური ტეგების გამოყენება ქეშის პროფილებთან#
შეგიძლიათ გამოიყენოთ სისტემური ტეგები ქეშის პროფილებში სინთეზირებული სამიზნეების ჩასართავად ან გამოსარიცხად:
import ProjectDescription
let tuist = Tuist(
project: .tuist(
cacheOptions: .options(
profiles: .profiles(
[
"development": .profile(
.onlyExternal,
and: ["tag:tuist:synthesized"] // Also cache synthesized bundles
)
],
default: .onlyExternal
)
)
)
)
სინთეზირებული ბანდლის სამიზნეები იღებენ ყველა ტეგს თავიანთი მშობელი სამიზნისგან tuist:synthesized ტეგის მიღების გარდა. ეს ნიშნავს, რომ თუ სტატიკურ ბიბლიოთეკას მონიშნავთ feature:auth-ით, მის სინთეზირებულ რესურსების ბანდლს ექნება როგორც feature:auth, ასევე tuist:synthesized ტეგები.
ტეგების გამოყენება პროექტის აღწერის დამხმარე საშუალებებთან#
შეგიძლიათ გამოიყენოთ პროექტის აღწერის დამხმარე საშუალებები, რათა სტანდარტიზაცია მოახდინოთ იმისა, თუ როგორ ენიჭება ტეგები თქვენს პროექტში:
// Tuist/ProjectDescriptionHelpers/Project+Templates.swift
import ProjectDescription
extension Target {
public static func feature(
name: String,
team: String,
dependencies: [TargetDependency] = []
) -> Target {
.target(
name: name,
destinations: .iOS,
product: .framework,
bundleId: "com.example.\(name.lowercased())",
sources: ["Sources/**"],
dependencies: dependencies,
metadata: .metadata(tags: [
"feature:\(name.lowercased())",
"team:\(team.lowercased())"
])
)
}
}
შემდეგ გამოიყენეთ ის თქვენს მანიფესტებში:
import ProjectDescription
import ProjectDescriptionHelpers
let project = Project(
name: "Features",
targets: [
.feature(name: "Authentication", team: "Identity"),
.feature(name: "Payment", team: "Commerce"),
]
)
მეტამონაცემების ტეგების გამოყენების სარგებელი#
გაუმჯობესებული დეველოპერული გამოცდილება#
თქვენი პროექტის კონკრეტულ ნაწილებზე ფოკუსირებით, შეგიძლიათ:
- Xcode-ის პროექტის ზომის შემცირება - იმუშავეთ უფრო მცირე პროექტებთან, რომლებიც უფრო სწრაფად იხსნება და ნავიგაციაში ადვილია
- ბილდების დაჩქარება - ააწყეთ მხოლოდ ის, რაც თქვენი მიმდინარე სამუშაოსთვის გჭირდებათ
- ფოკუსის გაუმჯობესება - თავიდან აიცილეთ შეუსაბამო კოდისგან მომავალი ყურადღების გაფანტვა
- ინდექსაციის ოპტიმიზაცია - Xcode ნაკლებ კოდს ინდექსავს, რაც ავტომატურ შევსებას უფრო სწრაფს ხდის
პროექტის უკეთესი ორგანიზაცია#
ტეგები უზრუნველყოფენ თქვენი კოდბაზის ორგანიზების მოქნილ გზას:
- მრავალგანზომილებიანობა - მონიშნეთ სამიზნეები ფუნქციის, გუნდის, შრის, პლატფორმის ან ნებისმიერი სხვა განზომილების მიხედვით
- სტრუქტურული ცვლილებების გარეშე - დაამატეთ ორგანიზაციული სტრუქტურა დირექტორიების განლაგების შეცვლის გარეშე
- გადაკვეთილი საკითხები - ერთ სამიზნეს შეუძლია ეკუთვნოდეს რამდენიმე ლოგიკურ ჯგუფს
ინტეგრაცია ქეშთან#
მეტამონაცემების ტეგები უპრობლემოდ მუშაობს Tuist-ის ქეშის ფუნქციებთან:
# Cache all targets
tuist cache
# Focus on targets with a specific tag and use cached dependencies
tuist generate tag:feature:payment
საუკეთესო პრაქტიკა#
- დაიწყეთ მარტივად - დაიწყეთ ერთი ტეგირების განზომილებით (მაგ., ფუნქციები) და საჭიროებისამებრ გააფართოვეთ
- იყავით თანმიმდევრული - გამოიყენეთ იგივე სახელდების კონვენციები თქვენს ყველა მანიფესტში
- აღწერეთ თქვენი ტეგები - შეინახეთ ხელმისაწვდომი ტეგების სია და მათი მნიშვნელობები თქვენი პროექტის დოკუმენტაციაში
- გამოიყენეთ დამხმარე საშუალებები - გამოიყენეთ პროექტის აღწერის დამხმარე საშუალებები ტეგების მინიჭების სტანდარტიზაციისთვის
- პერიოდულად გადახედეთ - როგორც კი თქვენი პროექტი განვითარდება, გადახედეთ და განაახლეთ თქვენი ტეგირების სტრატეგია
დაკავშირებული ფუნქციები#
- კოდის გაზიარება - გამოიყენეთ პროექტის აღწერის დამხმარე საშუალებები ტეგების გამოყენების სტანდარტიზაციისთვის
- ქეში - გააერთიანეთ ტეგები ქეშთან ბილდის ოპტიმალური შესრულებისთვის
- შერჩევითი ტესტირება - ჩაუშვით ტესტები მხოლოდ შეცვლილი სამიზნეებისთვის