# Xcode-ის პრივიუები

ააწყვეთ თქვენი აპლიკაცია, შემდეგ გამოიყენეთ `tuist share`, რათა გამოაქვეყნოთ ის თქვენს Tuist-ის პროექტში. ჯერ დააკავშირეთ თქვენი პროექტი <.localized_link href="/guides/get-started/existing-xcode-project">არსებული Xcode-ის პროექტის</.localized_link> ან <.localized_link href="/guides/get-started/generated-xcode-project">გენერირებული პროექტის</.localized_link> სახელმძღვანელოს მიხედვით.

## აწყობა და გაზიარება

Tuist-ით გენერირებული პროექტისთვის:

```bash
tuist generate App
tuist xcodebuild build -scheme App -workspace App.xcworkspace \
  -configuration Debug -sdk iphonesimulator
tuist share App
```

არსებული Xcode-ის პროექტისთვის:

```bash
tuist xcodebuild build -scheme App -project App.xcodeproj \
  -configuration Debug -sdk iphonesimulator
tuist share App --configuration Debug --platforms iOS
```

ჩაანაცვლეთ სქემის, პროექტის და სამუშაო სივრცის სახელები თქვენი მონაცემებით. Release აწყობის გასაზიარებლად, აწყობისას გამოიყენეთ `-configuration Release`, ხოლო გაზიარებისას — `--configuration Release`.

## ფიზიკური მოწყობილობები

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

```bash
tuist xcodebuild build -scheme App -project App.xcodeproj \
  -configuration Debug -destination 'generic/platform=iOS'
tuist share App --configuration Debug --platforms iOS
```

ასევე შეგიძლიათ გააზიაროთ უკვე ექსპორტირებული IPA:

```bash
tuist share App.ipa
```

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

## CI და აწყობის ნომრები

გამოიყენეთ თქვენი არსებული <.localized_link href="/guides/integrations/continuous-integration">CI აუთენტიკაცია</.localized_link> და გახადეთ `CFBundleVersion` უნიკალური ყოველი ახალი აწყობისთვის. მაგალითად, გამოიყენეთ GitHub Actions-ის <code v-pre>${{ github.run_number }}</code>. იგივე ბინარული ფაილისა და აწყობის ნომრის ხელახლა ატვირთვა `tuist share`-ის მეშვეობით ვერ ხერხდება და არ ქმნის დუბლიკატს.

```bash
tuist share App --track beta --release-notes "Fix sign-in"
```

გამოქვეყნებული აწყობების გაშვების, წვდომის, ტრეკების და README ბეჯების შესახებ იხილეთ <.localized_link href="/guides/features/previews#run-a-preview">პრივიუს გაშვება</.localized_link>.

## ტრეკები tuist share-ით {#share-tracks}

ნაკადებისთვის, რომლებიც აქვეყნებენ `tuist share`-ით, გამოიყენეთ `--track` ტრეკის არჩევას:

```bash
tuist share App --track beta
tuist share App --track nightly
```

## გამოშვების შენიშვნები {#release-notes}

გამოიყენეთ ტრეკები გარემოს ჯგუფებისთვის და გამოშვების შენიშვნები ცალკეული ბილდის მიზნით:

```bash
tuist share App --track QA --release-notes "Fix sign-in and improve the checkout flow"
```

ჩაანაცვლეთ `App` თქვენი აპლიკაციის სახელით, ფაილის გზით ან შესრულებადი დისტრიბუციით და მისი `--executable` ოფციით. გამოშვების შენიშვნები არის სურვილისამებრ ჩვეულებრივი ტექსტი, 10 000 სიმბოლომდე. პირველი არაცარიელი ხაზი ჩანს ერთხაზიან ფრაგმენტად ნახვის სიაში, რათა ბილდის ნომრები და სხვა იდენტიფიცირების ინფორმაცია ერთი შეხედვით იყოს ხილული. გრძელი ხაზები იკვეცება; სრული შენიშვნები ჩანს დეტალურ გვერდებზე. ძებნა ემთხვევა საჩვენებელ სახელებს და სრულ გამოშვების შენიშვნებს, მათ შორის ხაზებს, რომლებიც ფრაგმენტში არ ჩანს. მრავალხაზიანი შენიშვნები მხარდაჭერილია, მაგალითად `--release-notes "$(< release-notes.txt)"`. ისინი არ ცვლიან აპლიკაციის საჩვენებელ სახელს ან მის ტრეკს.

### თავსებადობა {#preview-metadata-compatibility}

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

თვითმასპინძელ განლაგებებს სჭირდება სერვერის ვერსია, რომელიც მხარს უჭერს გამოშვების შენიშვნებს და ტრეკის ფილტრაციას, განახლებულ კლიენტთან ერთად. ძველი სერვერები იგნორირებენ შენიშვნებს. სიის ბოლო წერტილების ტრეკისა და ძებნის ფილტრებისთვის იხილეთ [API-ის ცნობარი](https://tuist.dev/api/docs).

## მოთხოვნების/შერწყმის მოთხოვნების კომენტარები {#pullmerge-request-comments}

> [!WARNING]
> **Git forge-ის ინტეგრაცია აუცილებელია**
>
> ავტომატური მოთხოვნების/შერწყმის მოთხოვნების კომენტარების მისაღებად, დააკავშირეთ თქვენი <.localized_link href="/guides/server/accounts-and-projects">დაშორებული პროექტი</.localized_link> Git forge-თან: <.localized_link href="/guides/integrations/gitforge/github">GitHub</.localized_link>, <.localized_link href="/guides/integrations/gitforge/origin">Cursor Origin</.localized_link> ან <.localized_link href="/guides/integrations/gitforge/entire">Entire</.localized_link>.

როდესაც თქვენი Tuist პროექტი დაკავშირებულია თქვენს Git პლატფორმასთან, დაამატეთ <.localized_link href="/cli/share">`tuist share`</.localized_link> CI-ში აპლიკაციის წარმატებული აგების შემდეგ. Tuist პირდაპირ გამოაქვეყნებს ნახვის ბმულს თქვენს მოთხოვნებში/შერწყმის მოთხოვნებში, რათა შემმოწმებლებმა შეძლონ ტესტირება ადგილობრივად აგების გარეშე:

![GitHub აპლიკაციის კომენტარი Tuist Preview ბმულით](/images/guides/features/github-app-with-preview.png)

## ავტომატიზაციები {#automations}

გამოიყენეთ `--json` JSON გამოტანის მისაღებად `tuist share`-დან:

```bash
tuist share --json
```

გამოიყენეთ შედეგი მორგებული ავტომატიზაციებისთვის, როგორიცაა Slack-ის შეტყობინების გამოქვეყნება CI-დან. `url` გასაღები შეიცავს სრულ ნახვის ბმულს; `qrCodeURL` მიუთითებს QR კოდის გამოსახულებაზე ნახვის მოწყობილობაზე გასახსნელად:

```json
{
  "id": 1234567890,
  "url": "https://tuist.dev/preview/1234567890",
  "qrCodeURL": "https://tuist.dev/preview/1234567890/qr-code.svg"
}
```


მიმღებებს შეუძლიათ გამოიყენონ <.localized_link href="/guides/features/previews/run/macos">Tuist macOS აპლიკაცია</.localized_link> ან <.localized_link href="/guides/features/previews/run/ios">iPhone აპლიკაცია</.localized_link> აწყობის სისტემასთან ინტეგრაციისგან დამოუკიდებლად. iPhone-ის სახელმძღვანელო ასევე მოიცავს <.localized_link href="/guides/features/previews/run/ios#in-app-update-notifications">აპლიკაციაში განახლების შეტყობინებებს</.localized_link> Tuist SDK-ით.
