# Magic Devtools

**Uygulamanızı Magic'in gördüğü gibi görün.**

tapir ve crumbs geliştirme araçları için Magic adaptör katmanı. Snapshot'larını ve kayıtlarını Magic bağlamıyla zenginleştirir; `!kReleaseMode` koruması arkasında release derlemelerinde yer almaz.

## Magic'i tanıyan geliştirme araçları.

tapir ve crumbs Magic hakkında bir şey bilmez. Magic Devtools onları uyarlar; böylece LLM ajanı ya da CI sürücüsü route'u, auth kullanıcısını, controller durumunu ve Gate sonuçlarını tahmin etmek yerine okur.

### Magic'i tanıyan snapshot'lar

`MagicTapirIntegration.install()` tapir snapshot'larına enricher kaydeder: route ve middleware, formlar ve hataları, controller durumu, Gate sonuçları, auth kullanıcısı, yayın bağlıysa Echo, son HTTP istekleri, loglar ve exception'lar.

[Daha fazla Magic'i tanıyan snapshot'lar hakkında](https://anilcancakir.com/magic/docs/devtools/getting-started/installation.md)

### Magic'i tanıyan kayıtlar

`MagicCrumbsIntegration.install()` Magic olayları için crumbs watcher'ları ve Magic HTTP isteklerini kaydeden bir `MagicHttpFacadeAdapter` kaydeder.

[Daha fazla Magic'i tanıyan kayıtlar hakkında](https://anilcancakir.com/magic/docs/devtools/getting-started/installation.md)

### Maskelenen auth header

`auth.token.header` ile adlandırılan header (varsayılan `Authorization`) crumbs kayıtlarında gizlenir. Gövdeler crumbs'ın kendi redaction'ından geçer.

[Daha fazla Maskelenen auth header hakkında](https://anilcancakir.com/magic/docs/devtools/getting-started/installation.md)

### Tek çatı, iki aşama

`MagicDevtools.installPre()` `Magic.init()` öncesinde, `installPost()` sonrasında çalışır; tapir ve crumbs önce açılır, Magic container hazır olunca bağlanır.

[Daha fazla Tek çatı, iki aşama hakkında](https://anilcancakir.com/magic/docs/devtools/getting-started/installation.md)

### Performans oturumları

`MagicPerfIntegration.install()` performans oturumlarını insight kuralları (`PerfInsightRules`) ve bir navigator observer ile kaydeder.

[Daha fazla Performans oturumları hakkında](https://anilcancakir.com/magic/docs/devtools/getting-started/installation.md)

### Geliştirme önizleme kataloğu

`MagicPreview.register(...)` ve `MagicPreview.registerRoutes()` `/preview` ile `/preview/:component` route'larını ekler. Her seferinde tek bileşen; üstteki düğme açık ve koyu temayı değiştirir.

[Daha fazla Geliştirme önizleme kataloğu hakkında](https://anilcancakir.com/magic/docs/devtools/getting-started/installation.md)

## Saniyeler içinde ekleyin

```bash
flutter pub add magic_devtools
```

Ya da `pubspec.yaml` dosyasına ekleyin:

```yaml
dependencies:
  magic_devtools: ^1.0.0
```

Ya da yapay zeka ajanınıza şu istemi verin:

```text
https://anilcancakir.com/magic/docs/devtools/llms.txt adresini oku ve Magic Devtools paketini bu projeye kur.
```