Gradle eklentisini yükleyin

Tuist, Gradle projenizle entegre olarak uzak derleme önbellekleme ve derleme içgörüsü gibi özellikleri etkinleştiren bir Gradle eklentisi sağlar. Bu kılavuz, eklentinin kurulması ve yapılandırılması sürecinde size rehberlik eder.

Eklenti için Gradle 8.12.1 veya daha yeni bir sürüm gereklidir.

1. Tuist'i başlatın#

Gradle proje kök dizininizde aşağıdaki komutu çalıştırın:

bash

mise x tuist@latest -- tuist init

bash

tuist init

Komut, kimlik doğrulama, bir Tuist projesi oluşturma veya seçme ve Gradle projeniz için yapılandırma dosyalarını oluşturma adımlarında size rehberlik edecektir.

2. Eklentiyi uygulayın#

tuist init komutunu çalıştırdıktan sonra, komut çıktısında belirtildiği üzere Tuist eklentisini settings.gradle.kts dosyanıza eklemeniz gerekir:

kotlin

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

3. Ekibinizi ve sürekli entegrasyonu kimlik doğrulamasına tabi tutun#

tuist init sizi yerel olarak kimlik doğrularken, ekip arkadaşlarınızın ve sürekli entegrasyon ortamlarının ayrı ayrı kimlik doğrulaması yapması gerekir.

Her ekip arkadaşı, makinelerinde Tuist özelliklerine erişim sağlamak için aşağıdakini çalıştırmalıdır:

bash

tuist auth login

Kendi sunucunuzda veya yerel bir Tuist sunucusunda çalışırken, tuist.toml içinde yapılandırılan aynı temel URL'yi kullanın:

bash

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

Ana bilgisayar adı yazımını tutarlı tutun. Örneğin, localhost için kaydedilmiş bir oturum açma bilgisi, 127.0.0.1 için kaydedilenden ayrıdır.

Otomatik çalışanlar için, ortamınızın kimlik doğrulamasını yapılandırmak amacıyla sürekli entegrasyon kimlik doğrulama kılavuzunu takip edin.

Yapılandırma önbelleği ve İzole Projeler#

Eklenti, Gradle'ın yapılandırma önbelleğini ve İzole Projeleri destekler. Eklentiyi settings.gradle.kts dosyasında tutun; her alt projeye ayrı ayrı uygulamak gerekmez.

Tuist bu özellikleri otomatik olarak etkinleştirmez. Opt-in yapmak için gradle.properties dosyasına aşağıdakileri ekleyin:

plaintext

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

Derleme betiklerinizin ve diğer eklentilerinizin de bu özellikleri desteklemesi gerekir. Gradle, yapılandırma önbelleğini kaydederken uyumluluk sorunlarını raporlar.

Önizlemeleri yayımlayın#

Android uygulama modülleri için eklenti, tuistShare<Variant> görevlerini kaydeder:

bash

./gradlew :app:tuistShareDebug --track nightly

Görev, tek bir imzalı APK oluşturur ve doğrular, ardından mevcut Tuist kimlik doğrulamanızla bunu yayımlar. Görevi çağırmak opt-in anlamına gelir: normal assemble, build ve test görevleri önizleme yayımlamaz. CLI yükleme adımı gerekmez. Uygunluk, önbellek yeniden oynatma ve hata davranışı için Gradle önizlemelerine bakın.

Yapılandırma referansı#

Aşağıdaki seçenekler, settings.gradle.kts içindeki tuist genişletme bloğunda kullanılabilir:

Seçenek	Tür	Varsayılan	Açıklama
`project`	`String?`	`null` (isteğe bağlı)	Proje tanımlayıcısı, `account/project` formatındadır. Ayarlanmazsa eklenti bunu `tuist.toml` dosyasından okur.
`url`	`String?`	`null`	Tuist sunucusunun temel URL'si. Ayarlanmazsa varsayılan olarak `"https://tuist.dev"` veya `tuist.toml` içinde tanımlanan değer kullanılır.
`uploadInBackground`	`Boolean?`	`null`	Derleme ve test içgörülerinin arka planda yüklenip yüklenmeyeceğini belirler. `null` (varsayılan) olduğunda, yüklemeler yerel derlemeler için arka planda, sürekli entegrasyon çalışanlarında ise ön planda çalışır.
`stressNewTests.mode`	`String?`	`null`	`"report"` veya `"enforce"`. Derlemenin eklediği test senaryolarını yeniden çalıştırır ve kararsız olanları işaretler; bkz. yeni testlere stres testi uygulama. Ayarlanmadığında kapalıdır.

http:// URL'si kullanan yerel bir sunucu için, güvensiz protokole yalnızca o yerel yapılandırmada izin verin:

kotlin

tuist {
    buildCache {
        allowInsecureProtocol = true
    }
}

Barındırılan veya diğer https:// sunucuları için allowInsecureProtocol özelliğini etkinleştirmeyin.

Tuist.toml

project (ve isteğe bağlı olarak url) yapılandırmanın önerilen yolu, proje kök dizininizdeki bir tuist.toml dosyası aracılığıyladır. Bu sayede yapılandırma, Tuist komut satırı arayüzü ile Gradle eklentisi arasında paylaşılır. Gerekirse bu değerleri settings.gradle.kts içinde geçersiz kılabilirsiniz.

toml

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

HTTP vekil sunucusu#

Ağınız giden trafiği bir HTTP vekil sunucusu üzerinden yönlendiriyorsa HTTP vekil sunucusu kılavuzuna bakın.

Sonraki adımlar#

Eklenti yüklendikten ve yapılandırıldıktan sonra şunları etkinleştirebilirsiniz:

Derleme yapıtlarını ekibiniz ve sürekli entegrasyon çalışanları arasında paylaşmak için Uzak derleme önbelleği.
Tuist kontrol panelinde görev sürelerini ve önbellek davranışını izlemek için Derleme içgörülerini.
Test performansını izlemek ve kararsız testleri tespit etmek için Test içgörülerini.
Kararsız testleri otomatik olarak tespit etmek, izlemek ve karantinaya almak için Kararsız testler.