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

ააწყვეთ და გააზიარეთ Android აპლიკაციები და ნატიური კომანდური ხაზის ინსტრუმენტები პირდაპირ Gradle-დან. დაიწყეთ <.localized_link href="/guides/get-started/gradle-project">Gradle პროექტის სახელმძღვანელოთი</.localized_link> პროექტის დასაკავშირებლად და ავტორიზაციისთვის.

## Android აპლიკაციები

```bash
./gradlew :app:tuistShareDebug
```

`dev.tuist` პარამეტრების პლაგინი რეგისტრირებს `tuistShare<Variant>` ამოცანას თითოეული აპლიკაციის ვარიანტისთვის Android Gradle Plugin-დან (8.8.2 ან უფრო გვიანი). შეცვალეთ `app` და `Debug` თქვენი აპლიკაციის მოდულითა და ვარიანტით, მაგალითად `:app:tuistShareDemoDebug` პროდუქტის ფლეივორისთვის. ამოცანა ქმნის APK-ს Gradle-ის მიერ განცხადებული არტეფაქტის დამოკიდებულებების მეშვეობით მის გამოქვეყნებამდე. ის ასევე მუშაობს, როდესაც ბილდის გამონატანები აქტუალურია ან აღდგენილია ბილდის ქეშიდან.

მხარდაჭერილია მხოლოდ ერთი, ხელმოწერილი, უნივერსალური აპლიკაციის APK. Android-ის debug ვარიანტი ჩვეულებრივ იყენებს debug ხელმოწერის გასაღებს; release ვარიანტებს სჭირდებათ თქვენი საკუთარი ხელმოწერის კონფიგურაცია. ამოცანა ამოწმებს APK ხელმოწერას ავტორიზაციამდე ან ატვირთვამდე. ხელმოუწერელი, არასწორი, ინსტრუმენტული და გაყოფილი APK-ები უარყოფილია. ბიბლიოთეკის მოდულები, ტესტის APK-ები და Android App Bundles (`.aab`) არ არის გამოქვეყნების სამიზნეები.

## ნატიური კომანდური ხაზის ინსტრუმენტები

პროექტები, რომლებიც იყენებენ Gradle-ის `cpp-application` ან `swift-application` პლაგინს, იღებენ გაზიარების ამოცანას თითოეული ნატიური ბინარისთვის:

```bash
./gradlew :app:tuistShareMainDebug
```

ამოცანა ქმნის და აფუთებს დაინსტალირებულ დისტრიბუციას, მათ შორის მის ლაუნჩერსა და შესრულების ბიბლიოთეკებს. გამოიყენეთ `tuistShareMainRelease` release ბინარისთვის. პროექტებს, რომლებიც რამდენიმე მანქანას ემიზნებიან, აქვთ ამოცანა თითოეული ბინარისთვის; გაუშვით `./gradlew :app:tasks --all` მათი სახელების საპოვნელად.

მხარდაჭერილია ნატიური macOS და Linux შესრულებადი ფაილები arm64 ან x86_64-ისთვის. ააწყვეთ სამიზნე პლატფორმაზე თქვენი Gradle პლაგინისთვის საჭირო ინსტრუმენტთა ჯაჭვით. JVM აპლიკაციები და მათი გენერირებული ლაუნჩერის სკრიპტები არ არის მხარდაჭერილი ამ ინტეგრაციის მიერ.

## გამოქვეყნების ქცევა

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

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

## CI და ტრეკები

დააკონფიგურირეთ <.localized_link href="/guides/integrations/continuous-integration">CI ავტორიზაცია</.localized_link> იმავე კრედენციალებით, რომლებსაც იყენებთ პლაგინის სხვა ავტორიზებულ ფუნქციებისთვის, შემდეგ მოითხოვეთ გამოქვეყნება ცალსახად:

```bash
./gradlew :app:tuistShareDebug --track nightly
```

დაამატეთ `--track nightly` ნატიურ გაზიარების ამოცანას იმავე გზით. ამოცანები იყენებენ კონფიგურირებულ Tuist პროექტს, სერვერის URL-სა და პროქსის პარამეტრებს. პრევიუს გამოქვეყნება ყოველთვის მოითხოვს ავტორიზაციას. Git რევიზიის მეტამონაცემები, გამოშვების შენიშვნები და ავტომატური pull-request კომენტარები არ არის მიმაგრებული ამ ამოცანების მიერ.

არტეფაქტების გამოქვეყნებები იწურება 30 დღის შემდეგ hosted Tuist-ზე. Self-hosted ინსტანციები იყენებენ `TUIST_APP_PREVIEW_RETENTION_DAYS`; მისი დაუყენებლობა თიშავს ვადას ამ ოჯახისთვის. ვადაგასული გამოქვეყნებები ვერ აღდგება იმავე განზრახვის განმეორებით.

## არსებული APK-ის გაზიარება

APK-ისთვის, რომელიც აწყობილია ამ სამუშაო ნაკადის გარეთ, ან legacy ატვირთვის ნაკადთან გამოშვების შენიშვნების ჩასართავად, CLI კვლავ ხელმისაწვდომია:

```bash
tuist share app/build/outputs/apk/debug/app-debug.apk \
  --track nightly --release-notes "Improve checkout"
```

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

## ტრეკები 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"
}
```

