# კოდის გაზიარება {#code-sharing}

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

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

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

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


## პროექტის აღწერის დამხმარეები {#project-description-helpers}

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

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

```swift
// Project.swift
import ProjectDescription
import ProjectDescriptionHelpers
```

`ProjectDescriptionHelpers` ხელმისაწვდომია შემდეგ მანიფესტებში:
- `Project.swift`
- `Package.swift` (მხოლოდ `#TUIST` კომპილატორის დროშის უკან)
- `Workspace.swift`

## მაგალითი {#example}

ქვემოთ მოყვანილ სნიპეტებში ნაჩვენებია მაგალითი, თუ როგორ ვაფართოებთ `Project` მოდელს სტატიკური კონსტრუქტორების დასამატებლად და როგორ ვიყენებთ მათ `Project.swift` ფაილიდან:

::: code-group
```swift [Tuist/Project+Templates.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)]
            )
        ]
    )
  }
}
```

```swift {2} [Project.swift]
import ProjectDescription
import ProjectDescriptionHelpers

let project = Project.featureFramework(name: "MyFeature")
```
<!-- -->
:::

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