Gradle-ის პლაგინის დაყენება
Tuist გთავაზობთ Gradle-ის პლაგინს, რომელიც ინტეგრირდება თქვენს Gradle-ის პროექტთან ისეთი ფუნქციების ჩასართავად, როგორიცაა დისტანციური ბილდის ქეშირება და ბილდის ანალიტიკა. ეს სახელმძღვანელო გაგიწევთ დახმარებას პლაგინის დაყენებასა და კონფიგურაციაში.
პლაგინს სჭირდება Gradle 8.12.1 ან უფრო ახალი ვერსია.
1. Tuist-ის ინიციალიზაცია#
შეასრულეთ შემდეგი ბრძანება თქვენი Gradle-ის პროექტის ფესვში:
mise x tuist@latest -- tuist init
tuist init
ბრძანება გაგივლით ავტორიზაციის, Tuist-ის პროექტის შექმნის ან შერჩევის და თქვენი Gradle-ის პროექტისთვის კონფიგურაციის გენერირების პროცესში.
2. პლაგინის გამოყენება#
tuist init-ის შესრულების შემდეგ, თქვენ უნდა დაამატოთ Tuist-ის პლაგინი თქვენს settings.gradle.kts-ში, როგორც მითითებულია ბრძანების გამოტანაში:
plugins {
id("dev.tuist") version "0.18.1"
}
3. თქვენი გუნდისა და უწყვეტი ინტეგრაციის ავტორიზაცია#
მიუხედავად იმისა, რომ tuist init გაავთენტებს თქვენ ლოკალურად, თქვენს გუნდის წევრებსა და უწყვეტი ინტეგრაციის გარემოებს ცალ-ცალკე ავტორიზაცია დასჭირდებათ.
თითოეულმა გუნდის წევრმა უნდა შეასრულოს შემდეგი, რათა მიიღოს წვდომა Tuist-ის ფუნქციებზე თავის მანქანაზე:
tuist auth login
როდესაც იყენებთ self-hosted ან ლოკალურ Tuist სერვერს, გადაეცით იგივე საბაზისო URL, რომელიც კონფიგურირებულია tuist.toml-ში:
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-ში:
org.gradle.configuration-cache=true
org.gradle.unsafe.isolated-projects=true
თქვენმა ბილდის სკრიპტებმა და სხვა პლაგინებმა ასევე უნდა მხარი დაუჭირონ ამ ფუნქციებს. Gradle იუწყება თავსებადობის პრობლემებს კონფიგურაციის ქეშის შენახვისას.
პრევიუების გამოქვეყნება#
Android აპლიკაციის მოდულებისთვის, პლაგინი არეგისტრირებს tuistShare<Variant> ამოცანებს:
./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-ს, დაუშვით არაუსაფრთხო პროტოკოლი მხოლოდ ამ ლოკალურ კონფიგურაციაში:
tuist {
buildCache {
allowInsecureProtocol = true
}
}
არ ჩართოთ allowInsecureProtocol ჰოსტინგული ან სხვა https:// სერვერებისთვის.
project-ის (და სურვილისამებრ url-ის) კონფიგურირების რეკომენდებული გზა არის tuist.toml ფაილის გამოყენება თქვენი პროექტის ფესვში. ამ გზით კონფიგურაცია საერთოა Tuist-ის ბრძანების ხაზის ინტერფეისსა და Gradle-ის პლაგინს შორის. საჭიროების შემთხვევაში, თქვენ კვლავ შეგიძლიათ გადაწეროთ ეს მნიშვნელობები settings.gradle.kts-ში.
project = "account/project"
url = "https://tuist.dev"
HTTP პროქსი#
თუ თქვენი ქსელი გამავალ ტრაფიკს HTTP პროქსის მეშვეობით ატარებს, იხილეთ HTTP პროქსის სახელმძღვანელო.
შემდეგი ნაბიჯები#
პლაგინის დაყენებისა და კონფიგურაციის შემდეგ, შეგიძლიათ ჩართოთ:
- დაშორებული ბილდის ქეში ბილდის არტეფაქტების გასაზიარებლად თქვენს გუნდსა და უწყვეტი ინტეგრაციის გამშვებლებს შორის.
- ბილდის ანალიტიკა ამოცანების შესრულების დროისა და ქეშის ქცევის თვალყურის სადევნებლად Tuist-ის დაფაზე.
- ტესტების ანალიტიკა ტესტების წარმადობის თვალყურის სადევნებლად და არასტაბილური ტესტების აღმოსაჩენად.
- არასტაბილური ტესტები არასტაბილური ტესტების ავტომატურად აღმოსაჩენად, თვალყურის სადევნებლად და იზოლირებისთვის.