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

Gradle-ის პლაგინის დაყენება

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

პლაგინს სჭირდება Gradle 8.12.1 ან უფრო ახალი ვერსია.

1. Tuist-ის ინიციალიზაცია#

შეასრულეთ შემდეგი ბრძანება თქვენი Gradle-ის პროექტის ფესვში:

bash
mise x tuist@latest -- tuist init
bash
tuist init

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

2. პლაგინის გამოყენება#

tuist init-ის შესრულების შემდეგ, თქვენ უნდა დაამატოთ Tuist-ის პლაგინი თქვენს settings.gradle.kts-ში, როგორც მითითებულია ბრძანების გამოტანაში:

kotlin
plugins {
id("dev.tuist") version "0.18.1"
}

3. თქვენი გუნდისა და უწყვეტი ინტეგრაციის ავტორიზაცია#

მიუხედავად იმისა, რომ tuist init გაავთენტებს თქვენ ლოკალურად, თქვენს გუნდის წევრებსა და უწყვეტი ინტეგრაციის გარემოებს ცალ-ცალკე ავტორიზაცია დასჭირდებათ.

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

bash
tuist auth login

როდესაც იყენებთ self-hosted ან ლოკალურ Tuist სერვერს, გადაეცით იგივე საბაზისო URL, რომელიც კონფიგურირებულია tuist.toml-ში:

bash
tuist auth login --url http://localhost:8080
tuist auth whoami --url http://localhost:8080

შეინარჩუნეთ ჰოსტის სახელის მართლწერის თანმიმდევრულობა. მაგალითად, localhost-ისთვის შენახული შესვლა განცალკევებულია 127.0.0.1-ისთვის შენახული შესვლისგან.

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

კონფიგურაციის ქეში და იზოლირებული პროექტები#

პლაგინი მხარს უჭერს Gradle-ის კონფიგურაციის ქეშს და იზოლირებულ პროექტებს. შეინარჩუნეთ პლაგინი settings.gradle.kts-ში; არ არის საჭირო მისი ცალ-ცალკე გამოყენება თითოეულ ქვეპროექტზე.

Tuist არ რთავს ამ ფუნქციებს ავტომატურად. მათ ჩასართავად, დაამატეთ შემდეგი gradle.properties-ში:

plaintext
org.gradle.configuration-cache=true
org.gradle.unsafe.isolated-projects=true

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

პრევიუების გამოქვეყნება#

Android აპლიკაციის მოდულებისთვის, პლაგინი არეგისტრირებს tuistShare<Variant> ამოცანებს:

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

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

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

შემდეგი პარამეტრები ხელმისაწვდომია tuist გაფართოების ბლოკში settings.gradle.kts-ში:

პარამეტრი ტიპი ნაგულისხმები აღწერა
project String? null (არასავალდებულო) პროექტის იდენტიფიკატორი account/project ფორმატში. თუ არ არის მითითებული, პლაგინი კითხულობს მას tuist.toml-დან.
url String? null Tuist სერვერის საბაზისო URL. თუ არ არის მითითებული, ნაგულისხმევად იყენებს "https://tuist.dev"-ს ან tuist.toml-ში განსაზღვრულ მნიშვნელობას.
uploadInBackground Boolean? null ატვირთოს თუ არა ბილდისა და ტესტების ანალიტიკა ფონურ რეჟიმში. როდესაც null (ნაგულისხმები), ატვირთვები ფონურ რეჟიმში ხდება ლოკალური ბილდებისთვის და წინა პლანზე უწყვეტი ინტეგრაციის გამშვებლებზე.
stressNewTests.mode String? null "report" ან "enforce". ხელახლა უშვებს ტესტის შემთხვევებს, რომლებსაც ბილდი ამატებს და აღნიშნავს ნებისმიერს, რომელიც არასტაბილურად აღმოჩნდება; იხილეთ ახალი ტესტების სტრეს-ტესტირება. გამორთულია, თუ არ არის მითითებული.

ლოკალური სერვერისთვის, რომელიც იყენებს http:// URL-ს, დაუშვით არაუსაფრთხო პროტოკოლი მხოლოდ ამ ლოკალურ კონფიგურაციაში:

kotlin
tuist {
buildCache {
allowInsecureProtocol = true
}
}

არ ჩართოთ allowInsecureProtocol ჰოსტინგული ან სხვა https:// სერვერებისთვის.

Tuist.toml

project-ის (და სურვილისამებრ url-ის) კონფიგურირების რეკომენდებული გზა არის tuist.toml ფაილის გამოყენება თქვენი პროექტის ფესვში. ამ გზით კონფიგურაცია საერთოა Tuist-ის ბრძანების ხაზის ინტერფეისსა და Gradle-ის პლაგინს შორის. საჭიროების შემთხვევაში, თქვენ კვლავ შეგიძლიათ გადაწეროთ ეს მნიშვნელობები settings.gradle.kts-ში.

toml
project = "account/project"
url = "https://tuist.dev"

HTTP პროქსი#

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

შემდეგი ნაბიჯები#

პლაგინის დაყენებისა და კონფიგურაციის შემდეგ, შეგიძლიათ ჩართოთ:

  • დაშორებული ბილდის ქეში ბილდის არტეფაქტების გასაზიარებლად თქვენს გუნდსა და უწყვეტი ინტეგრაციის გამშვებლებს შორის.
  • ბილდის ანალიტიკა ამოცანების შესრულების დროისა და ქეშის ქცევის თვალყურის სადევნებლად Tuist-ის დაფაზე.
  • ტესტების ანალიტიკა ტესტების წარმადობის თვალყურის სადევნებლად და არასტაბილური ტესტების აღმოსაჩენად.
  • არასტაბილური ტესტები არასტაბილური ტესტების ავტომატურად აღმოსაჩენად, თვალყურის სადევნებლად და იზოლირებისთვის.