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.10.0"
}

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

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

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

bash

tuist auth login

როდესაც იყენებთ საკუთარ ადგილზე განთავსებულ ან ლოკალურ 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 აცხადებს თავსებადობის პრობლემებს კონფიგურაციის ქეშის შენახვისას.

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

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