# Android {#bundle-insights-android}

Android ბანდლის ანალიზისთვის მიმართეთ `tuist inspect bundle` აპლიკაციის ბანდლს ან დასაყენებელ ფაილს:

::: code-group
```bash [Analyze an .aab (recommended)]
tuist inspect bundle App.aab
```
```bash [Analyze an .apk]
tuist inspect bundle App.apk
```
<!-- -->
:::

> [!NOTE]
> **`.apk`-ის ანალიზი მოითხოვს `aapt2`-ს**, რომელიც შედის Android SDK build tools-ში. დააყენეთ `ANDROID_HOME` ან `ANDROID_SDK_ROOT`, რათა Tuist-მა იპოვოს ის, ან დაამატეთ `aapt2` `PATH`-ზე. `.aab`-ის ანალიზს გარე ხელსაწყოები არ სჭირდება.

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

![გაანალიზებული ბანდლი](/images/guides/features/bundle-size/analyzed-bundle.png)


## ტეგები {#tags}

ბანდლის ატვირთვისას მიამაგრეთ ტეგები, რათა განასხვაოთ ბილდის ვარიანტები, გარემოები ან გამოშვების არხები. ბანდლის ტეგები ემორჩილებიან იმავე შეთანხმებას, რასაც Build Insights-ის ტეგები:

```bash
tuist inspect bundle App.ipa --tags paid production
```

CI-ში ასევე შეგიძლიათ დააყენოთ მძიმით გამოყოფილი ტეგები `TUIST_BUNDLE_TAGS`-ის საშუალებით:

```bash
TUIST_BUNDLE_TAGS="paid,production" tuist inspect bundle App.ipa
```

ცალსახად მითითებული `--tags` ცვლის გარემოს ცვლადის ტეგებს. ტეგებში შეიძლება იყოს ასოები, ციფრები, დეფისები და ქვედატირეები; თითოეულ ბანდლზე მაქსიმუმ 10 ტეგი და თითოეულ ტეგზე 50 სიმბოლო. იგივე პარამეტრები მუშაობს Android-ის ბანდლებისთვისაც. `--json` მუშაობს მხოლოდ ლოკალურად და არ ატვირთავს ტეგებს ან ბანდლს.

ტეგები ჩანს ბანდლის სახელების გვერდით და ბანდლის დეტალებში. გამოიყენეთ დაშბორდის **ტეგები** ფილტრი და შეიყვანეთ ტეგი, რათა ჩართოთ ან ამოიღოთ ის ბანდლების სიაში. შესაბამისობა ზუსტია და მგრძნობიარეა დიდ/პატარა ასოების მიმართ, მიუხედავად იმისა, რომ ფილტრის ოპერატორებს ეწოდებათ **შეიცავს** და **არ შეიცავს**: `paid` არ ემთხვევა `paid-extra`-ს. CLI-დან გასაფილტრად:

```bash
tuist bundle list --tags paid production
```

CLI, API (`?tags=paid,production`) და MCP-ის `list_bundles` ინსტრუმენტი (`tags: ["paid", "production"]`) აბრუნებს ბანდლებს, რომლებიც შეიცავენ **ყველა** მითითებულ ტეგს. API-ს ატვირთვები იღებენ `bundle.custom_metadata.tags`-ს; სიისა და დეტალური პასუხები აბრუნებენ `custom_metadata.tags`-ს. არსებული ბანდლები ტეგების გარეშე ხელმისაწვდომია, როგორც ადრე. ტეგები ფილტრავენ ბანდლების სიას; ისინი არ ცვლიან ზომის დიაგრამებს ან ავტომატური შედარებისა და ზღვრული მნიშვნელობების საბაზისო ხაზებს.

არსებულ კლიენტებს შეუძლიათ განაგრძონ ბანდლების ატვირთვა და წაკითხვა ტეგების გარეშე. განახლებულ კლიენტებს ასევე შეუძლიათ წაიკითხონ პასუხები უფრო ძველი სერვერებიდან, რომლებიც ტოვებენ `custom_metadata`-ს. ტეგების შენახვა და ფილტრაცია მოითხოვს სერვერის ვერსიას, რომელიც მხარდაჭერს ბანდლის ტეგებს: უფრო ძველი სერვერები იგნორირებენ ატვირთვის მეტამონაცემებს და უარყოფენ ტეგების ფილტრებს. განახლებული კლიენტები ტოვებენ როგორც ატვირთვის მეტამონაცემებს, ასევე ტეგების query პარამეტრებს, როცა ტეგები არ არის მითითებული.

## ბანდლის ზომების გაგება {#understanding-sizes}

ყველა ანალიზირებული ბანდლისთვის Tuist იუწყება ორ მნიშვნელობას:

- **ინსტალაციის ზომა**: ადგილი, რომელსაც აპიკაცია იკავებს მოწყობილობაზე ინსტალაციის შემდეგ.
- **ჩამოტვირთვის ზომა**: შეკუმშული ზომა, რომელსაც მომხმარებლები ჩამოტვირთავენ. Apple-ის ბანდლებისთვის ეს მხოლოდ `.ipa`-ისთვის არის ხელმისაწვდომი (არქივის ზომა); `.xcarchive` ან `.app` შეყვანებისთვის ის არ არის ხელმისაწვდომი.

ზომები ინახება ბაიტებში და გამოისახება ათობითი შეთანხმებით, სადაც 1 MB არის 1,000,000 ბაიტი, ხოლო 1 GB — 1,000,000,000 ბაიტი — იგივე შეთანხმება, რომელსაც Apple იყენებს საცავისა და აპლიკაციების ზომების მოსაწოდებლად (იხილეთ [როგორ იზომება საცავის ტევადობა Apple-ის მოწყობილობებზე](https://support.apple.com/en-us/102119)). 733,446,863 ბაიტის ინსტალაციის ზომა გამოისახება როგორც 733.4 MB.

## უწყვეტი ინტეგრაცია {#continuous-integration}

ბანდლის ზომის დროში ცვლილების თვალყურის დევნებისთვის, გაანალიზეთ ბანდლი CI-ზე. ჯერ დარწმუნდით, რომ თქვენი CI არის <.localized_link href="/guides/server/authentication#continuous-integration">ავტორიზებული</.localized_link>.

Tuist-მა ასევე უნდა იცოდეს, რომელ პროექტს უნდა მიუთითოს ბანდლი. თუ პროექტი ჯერ არ დაუკავშირებიათ, გაუშვით `tuist init`, ან თავად მიუთითეთ handle:

::: code-group
```swift [Tuist.swift]
let tuist = Tuist(fullHandle: "my-account/my-project")
```
```toml [tuist.toml]
project = "my-account/my-project"
```
<!-- -->
:::

გამოიყენეთ <.localized_link href="/references/tuist-toml">`tuist.toml`</.localized_link> პროექტებისთვის Swift მანიფესტის გარეშე, მაგალითად Gradle პროექტებისთვის. როცა ორივე ფაილი არსებობს, `Tuist.swift` აქვს უპირატესობა.

GitHub Actions-ის სამუშაო ნაკადის მაგალითი:

::: code-group
```yaml [Apple]
name: Build

jobs:
  build:
    steps:
      - # Build your app
      - name: Analyze bundle
        run: tuist inspect bundle App.ipa
        env:
          TUIST_TOKEN: ${{ secrets.TUIST_TOKEN }}
```
```yaml [Android]
name: Build

jobs:
  build:
    steps:
      - # Build your app
      - name: Analyze bundle
        # .aab is recommended over .apk for more accurate size analysis
        run: tuist inspect bundle App.aab
        env:
          TUIST_TOKEN: ${{ secrets.TUIST_TOKEN }}
```
<!-- -->
:::

გამართვის შემდეგ შეგიძლიათ ნახოთ, როგორ იცვლება თქვენი ბანდლის ზომა დროში:

![ბანდლის ზომის გრაფიკი](/images/guides/features/bundle-size/bundle-size-graph.png)

## Pull/merge request-ების კომენტარები {#pullmerge-request-comments}

> [!WARNING]
> **Git forge-თან ინტეგრაცია აუცილებელია**
>
> ავტომატური pull/merge request-ების კომენტარების მისაღებად, დააკავშირეთ თქვენი <.localized_link href="/guides/server/accounts-and-projects">Tuist-ის პროექტი</.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 პლატფორმასთან, როგორიცაა [GitHub](https://github.com), Tuist პირდაპირ დაწერს კომენტარს თქვენს pull/merge request-ებში ყოველ ჯერზე, როცა გაუშვებთ `tuist inspect bundle`-ს:

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

## ზომის ზღვრული მნიშვნელობები {#size-thresholds}

> [!WARNING]
> **Git forge-თან ინტეგრაცია აუცილებელია**
>
> ზომის ზღვრული მნიშვნელობების გამოყენებისთვის, დააკავშირეთ [Tuist GitHub App](https://github.com/apps/tuist) თქვენს პროექტთან. ეს შეგიძლიათ გააკეთოთ თქვენი პროექტის ინტეგრაციების გვერდიდან.

ზომის ზღვრული მნიშვნელობები გაძლევთ საშუალებას დაბლოკოთ pull requests, როცა ბანდლის ზომა აღემატება კონფიგურირებულ პროცენტულ ან აბსოლუტურ ზომას საბაზისო შტოსთან შედარებით. როცა ზღვარი ირღვევა, Tuist ქმნის GitHub Check Run-ს PR-ის კომიტზე, რაც ბლოკავს merge-ს, სანამ ზომის ზრდა არ გადაწყდება:

![PR-ის სტატუსის შემოწმება, რომელიც აჩვენებს ბანდლის ზომის ზღვრის გადაჭარბებას](/images/guides/features/bundle-size/github-pr-check-status.png)

შემოწმების გაშვება აჩვენებს საბაზისო ზომას, მიმდინარე ზომას და ცვლილებას კონფიგურირებულ ერთეულში. თუ ზრდა განზრახულია, შეგიძლიათ მიიღოთ ის პირდაპირ GitHub UI-დან **მიღება** ღილაკზე დაჭერით:

![GitHub-ის შემოწმების გაშვება, რომელიც აჩვენებს ზღვრის დარღვევას](/images/guides/features/bundle-size/github-check-run-threshold.png)

### კონფიგურაცია {#size-thresholds-configuration}

ზღვრების კონფიგურაციისთვის, გადადით თქვენი პროექტის **პარამეტრები > ბანდლები** ჩანართზე:

![ბანდლის ზომის ზღვრული მნიშვნელობების პარამეტრები](/images/guides/features/bundle-size/bundle-size-thresholds.png)

აირჩიეთ **ინსტალაციის ზომა** ან **ჩამოტვირთვის ზომა**, შემდეგ აირჩიეთ **ზღვრის ტიპი**:

- **პროცენტი (%)**: ზრდის შეზღუდვა საბაზისო ზომასთან მიმართებაში. მხარდაჭერილია წილადი პროცენტები, როგორიცაა `0.47`. არსებული პროცენტული ზღვრები ინარჩუნებენ თავიანთ კონფიგურირებულ მნიშვნელობებს და ქცევას.
- **აბსოლუტური ზომა (MB)**: ზრდის შეზღუდვა ფიქსირებული რაოდენობით, საბაზისო ზომისგან დამოუკიდებლად. შეიყვანეთ `1.5`, რათა დაუშვათ 1.5 MB-მდე ზრდა. MB იყენებს ათობით ერთეულებს: 1 MB = 1,000,000 ბაიტი. მნიშვნელობები უნდა იყოს დადებითი მთელი რიცხვი ბაიტებში.

![ბანდლის ზომის აბსოლუტური ზრდის ზღვრული მნიშვნელობის კონფიგურაცია](/images/guides/features/bundle-size/absolute-size-threshold.png)

ორივე ტიპი ადარებს კონფიგურირებულ **საბაზისო შტოსთან** არსებულ უახლეს ბანდლს იგივე სახელით, იგივე ბანდლის ტიპით (მაგალითად, `.app` ან `.ipa`) და მინიმუმ ერთი საერთო პლატფორმით, ამიტომ სიმულატორის `.app` შედარდება მხოლოდ სიმულატორის `.app` ატვირთვებთან. არასავალდებულო **ბანდლის სახელი** ზღუდავს წესს მხოლოდ ამ ბანდლისთვის. შემოწმება ვერ გადის მხოლოდ მაშინ, როცა ზრდა **აჭარბებს** ლიმიტს; თანაბარი ზრდა, უცვლელი ზომები და შემცირება გადის. შესაბამისი საბაზისო ხაზის ან არჩეული მეტრიკის ჩაწერილი ზომის გარეშე, წესი გამოტოვებულია. ნულოვანი ზომის საბაზისო ხაზი მხარდაჭერილია აბსოლუტური ლიმიტებისთვის; პროცენტული ლიმიტები კვლავ გამოტოვებენ მას, რადგან პროცენტული ზრდა განუსაზღვრელია.

### ვის შეუძლია მიღება {#size-thresholds-approvals}

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

- **ნებისმიერი**: ნაგულისხმევი. ნებისმიერი, ვისაც რეპოზიტორიაზე ჩაწერის წვდომა აქვს.
- **არჩეული GitHub-ის მომხმარებლები**: მხოლოდ ის GitHub-ის მომხმარებლის სახელები, რომლებსაც დაამატებთ.

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

