გადადით შინაარსზე

Android

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

bash
tuist inspect bundle App.aab
bash
tuist inspect bundle App.apk
Note

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

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

გაანალიზებული ბანდლი

ტეგები#

ბანდლის ატვირთვისას მიამაგრეთ ტეგები, რათა განასხვაოთ ბილდის ვარიანტები, გარემოები ან გამოშვების არხები. ბანდლის ტეგები ემორჩილებიან იმავე შეთანხმებას, რასაც 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 პარამეტრებს, როცა ტეგები არ არის მითითებული.

ბანდლის ზომების გაგება#

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

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

ზომები ინახება ბაიტებში და გამოისახება ათობითი შეთანხმებით, სადაც 1 MB არის 1,000,000 ბაიტი, ხოლო 1 GB — 1,000,000,000 ბაიტი — იგივე შეთანხმება, რომელსაც Apple იყენებს საცავისა და აპლიკაციების ზომების მოსაწოდებლად (იხილეთ როგორ იზომება საცავის ტევადობა Apple-ის მოწყობილობებზე). 733,446,863 ბაიტის ინსტალაციის ზომა გამოისახება როგორც 733.4 MB.

უწყვეტი ინტეგრაცია#

ბანდლის ზომის დროში ცვლილების თვალყურის დევნებისთვის, გაანალიზეთ ბანდლი CI-ზე. ჯერ დარწმუნდით, რომ თქვენი CI არის ავტორიზებული.

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

swift
let tuist = Tuist(fullHandle: "my-account/my-project")
toml
project = "my-account/my-project"

გამოიყენეთ tuist.toml პროექტებისთვის Swift მანიფესტის გარეშე, მაგალითად Gradle პროექტებისთვის. როცა ორივე ფაილი არსებობს, Tuist.swift აქვს უპირატესობა.

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

yaml
name: Build
jobs:
build:
steps:
- # Build your app
- name: Analyze bundle
run: tuist inspect bundle App.ipa
env:
TUIST_TOKEN: ${{ secrets.TUIST_TOKEN }}
yaml
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 }}

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

ბანდლის ზომის გრაფიკი

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

Git forge-თან ინტეგრაცია აუცილებელია

ავტომატური pull/merge request-ების კომენტარების მისაღებად, დააკავშირეთ თქვენი Tuist-ის პროექტი Git forge-თან: GitHub, Cursor Origin ან Entire.

როცა თქვენი Tuist-ის პროექტი დაკავშირებულია თქვენს Git პლატფორმასთან, როგორიცაა GitHub, Tuist პირდაპირ დაწერს კომენტარს თქვენს pull/merge request-ებში ყოველ ჯერზე, როცა გაუშვებთ tuist inspect bundle-ს:

GitHub-ის აპლიკაციის კომენტარი ინსპექტირებული ბანდლებით

ზომის ზღვრული მნიშვნელობები#

Git forge-თან ინტეგრაცია აუცილებელია

ზომის ზღვრული მნიშვნელობების გამოყენებისთვის, დააკავშირეთ Tuist GitHub App თქვენს პროექტთან. ეს შეგიძლიათ გააკეთოთ თქვენი პროექტის ინტეგრაციების გვერდიდან.

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

PR-ის სტატუსის შემოწმება, რომელიც აჩვენებს ბანდლის ზომის ზღვრის გადაჭარბებას

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

GitHub-ის შემოწმების გაშვება, რომელიც აჩვენებს ზღვრის დარღვევას

კონფიგურაცია#

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

ბანდლის ზომის ზღვრული მნიშვნელობების პარამეტრები

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

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

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

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

ვის შეუძლია მიღება#

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

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

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