# Gradle ტესტების ანალიტიკა {#gradle-test-insights}

> [!IMPORTANT]
> **მოთხოვნები**
>
> - გამოყენებულია `dev.tuist` Gradle პლაგინი, როგორც აღწერილია <.localized_link href="/guides/get-started/gradle-project">დაიწყეთ Gradle პროექტით</.localized_link>.

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

ტესტების ანალიტიკა ავტომატურად იკრიბება პლაგინის გამოყენებისთანავე. დამატებითი კონფიგურაცია არ არის საჭირო.

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

![დაფა ტესტების ანალიტიკით](/images/guides/features/build-insights/tests-dashboard.png)

## რა ფიქსირდება {#what-is-tracked}

პლაგინი აგროვებს შედეგებს ყველა Gradle `Test` ამოცანიდან, მათ შორის:
- ინდივიდუალური სატესტო შემთხვევის წარმატების/შეცდომის სტატუსი და ხანგრძლივობა
- ტესტების სუიტისა და კლასის სტრუქტურა
- არასტაბილური ტესტების აღმოჩენა გაშვებების მიხედვით

ჩართეთ <.localized_link href="/guides/features/test-code-coverage/gradle">კოდის დაფარვა</.localized_link>, რათა ასევე აიტვირთოს, თუ რომელი კოდი შეასრულეს თქვენმა ტესტებმა.

## ატვირთვის ქცევის კონფიგურაცია {#configure-upload-behavior}

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

შეგიძლიათ გადაწეროთ ეს ქცევა `uploadInBackground`-ის გამოყენებით `tuist` ბლოკში თქვენს `settings.gradle.kts`-ში:

```kotlin
tuist {
    uploadInBackground = false // always upload in the foreground
}
```

### Git ისტორია {#git-history}

CI-ზე პლაგინი ასევე ატვირთავს ჩეკაუტის კომიტების ისტორიას, როდესაც იტყობინება ტესტების გაშვების შესახებ: კომიტების SHA-ები, მათი მშობლები, კომიტების თარიღები და შტო, რომელზეც იყო გაშვება და მისი pull request-ის საბაზისო შტო. არ აიტვირთება ფაილების შინაარსი, კომიტების შეტყობინებები ან ავტორები. ეს არის ის, რაც ეუბნება Tuist-ს, თუ რომელი კომიტები მოხვდა თქვენს საბაზისო შტოზე, მაგალითად, ისინი, რომლებიც merge queue-მ შეამოწმა. პლაგინი კითხულობს ისტორიას, რომელიც უკვე აქვს ჩეკაუტს, და როდესაც ჩეკაუტს არ აქვს საბაზისო შტო, ითხოვს მის უახლეს კომიტს რემოტიდან (`git ls-remote`). ის არ იწერს ისტორიას.

| ცვლადი | ეფექტი |
| --- | --- |
| `TUIST_GIT_UPLOAD_ENABLED=false` | არ კითხულობს და არ ატვირთავს Git-ის ისტორიას. |
| `TUIST_GIT_UNSHALLOW_ENABLED=false` | კითხულობს მხოლოდ ჩეკაუტს, რემოტთან დაკავშირების გარეშე. |
