# Gradle eklentisini yükleyin {#install-the-gradle-plugin}

Tuist, Gradle projenizle entegre olarak <.localized_link href="/guides/features/cache/gradle-cache">uzak derleme önbellekleme</.localized_link> ve <.localized_link href="/guides/features/build-insights/gradle">derleme içgörüsü</.localized_link> 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 {#initialize-tuist}

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

::: code-group

```bash [Mise]
mise x tuist@latest -- tuist init
```

```bash [Global Tuist (Homebrew)]
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 {#apply-the-plugin}

`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 {#authenticate}

`tuist init` sizi yerel olarak kimlik doğrularken, ekip arkadaşlarınızın ve <.localized_link href="/guides/integrations/continuous-integration">sürekli entegrasyon</.localized_link> 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 <.localized_link href="/guides/server/authentication#continuous-integration">sürekli entegrasyon kimlik doğrulama kılavuzunu</.localized_link> takip edin.

## Yapılandırma önbelleği ve İzole Projeler {#configuration-cache-and-isolated-projects}

Eklenti, Gradle'ın yapılandırma önbelleğini ve [İzole Projeleri](https://docs.gradle.org/current/userguide/isolated_projects.html) 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:

```properties
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 {#publish-previews}

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 <.localized_link href="/guides/features/previews/gradle">Gradle önizlemelerine</.localized_link> bakın.

## Yapılandırma referansı {#configuration-reference}

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. <.localized_link href="/guides/features/test-insights/flaky-tests/gradle#stress-testing-new-tests">yeni testlere stres testi uygulama</.localized_link>. 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.

> [!NOTE]
> **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 {#http-proxy}

Ağınız giden trafiği bir HTTP vekil sunucusu üzerinden yönlendiriyorsa <.localized_link href="/guides/integrations/http-proxy">HTTP vekil sunucusu kılavuzuna</.localized_link> bakın.

## Sonraki adımlar {#next-steps}

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 <.localized_link href="/guides/features/cache/gradle-cache">Uzak derleme önbelleği</.localized_link>.
- Tuist kontrol panelinde görev sürelerini ve önbellek davranışını izlemek için <.localized_link href="/guides/features/build-insights/gradle">Derleme içgörülerini</.localized_link>.
- Test performansını izlemek ve kararsız testleri tespit etmek için <.localized_link href="/guides/features/test-insights/gradle">Test içgörülerini</.localized_link>.
- Kararsız testleri otomatik olarak tespit etmek, izlemek ve karantinaya almak için <.localized_link href="/guides/features/test-insights/flaky-tests">Kararsız testler</.localized_link>.