@mcamdali/sdkbump 0.0.0-stage → 0.1.3

package/README.tr.md

@@ -0,0 +1,338 @@
+<!-- i18n-source: README.md@49073c524eb2b7aad433b6794961ec40869c1170 status=reviewed -->
+<!-- brand:start -->
+
+<p align="center"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/muhittincamdali/sdkbump/main/.github/brand/banner-dark.svg"><source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/muhittincamdali/sdkbump/main/.github/brand/banner-light.svg"><img src="https://raw.githubusercontent.com/muhittincamdali/sdkbump/main/.github/brand/banner-light.svg" alt="sdkbump: Checks native iOS, Flutter and React Native apps for the iOS 27 SDK changes and names the fix for each."></picture></p>
+
+<!-- lang-selector:start -->
+<p align="center"><a href="README.md">English</a> · <a href="README.tr.md">Türkçe</a> · <a href="README.zh-CN.md">简体中文</a> · <a href="README.ja.md">日本語</a> · <a href="README.ko.md">한국어</a> · <a href="README.es.md">Español</a> · <a href="README.de.md">Deutsch</a> · <a href="README.fr.md">Français</a> · <a href="README.pt-BR.md">Português (Brasil)</a> · <a href="README.ru.md">Русский</a></p>
+<!-- lang-selector:end -->
+
+<p align="center">
+<a href="https://github.com/muhittincamdali/sdkbump/actions/workflows/ci.yml"><img src="https://github.com/muhittincamdali/sdkbump/actions/workflows/ci.yml/badge.svg" alt="CI durumu"></a>
+<a href="https://github.com/muhittincamdali/sdkbump/releases"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/muhittincamdali/sdkbump/main/.github/brand/badge-version-dark.svg"><source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/muhittincamdali/sdkbump/main/.github/brand/badge-version-light.svg"><img src="https://raw.githubusercontent.com/muhittincamdali/sdkbump/main/.github/brand/badge-version-light.svg" alt="Son sürüm: v0.1.2"></picture></a>
+<a href="https://github.com/muhittincamdali/sdkbump/blob/main/package.json"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/muhittincamdali/sdkbump/main/.github/brand/badge-language-dark.svg"><source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/muhittincamdali/sdkbump/main/.github/brand/badge-language-light.svg"><img src="https://raw.githubusercontent.com/muhittincamdali/sdkbump/main/.github/brand/badge-language-light.svg" alt="Dil sürümü: Node.js 22.12+"></picture></a>
+<a href="https://github.com/muhittincamdali/sdkbump/blob/main/LICENSE"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/muhittincamdali/sdkbump/main/.github/brand/badge-license-dark.svg"><source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/muhittincamdali/sdkbump/main/.github/brand/badge-license-light.svg"><img src="https://raw.githubusercontent.com/muhittincamdali/sdkbump/main/.github/brand/badge-license-light.svg" alt="Lisans: MIT"></picture></a>
+</p>
+
+<p align="center">
+<a href="#hızlı-başlangıç"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/muhittincamdali/sdkbump/main/.github/brand/button-start-tr-dark.svg"><source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/muhittincamdali/sdkbump/main/.github/brand/button-start-tr-light.svg"><img src="https://raw.githubusercontent.com/muhittincamdali/sdkbump/main/.github/brand/button-start-tr-light.svg" alt="Başlayın"></picture></a>
+<a href="https://muhittincamdali.github.io/sdkbump/"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/muhittincamdali/sdkbump/main/.github/brand/button-docs-tr-dark.svg"><source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/muhittincamdali/sdkbump/main/.github/brand/button-docs-tr-light.svg"><img src="https://raw.githubusercontent.com/muhittincamdali/sdkbump/main/.github/brand/button-docs-tr-light.svg" alt="Dokümantasyon"></picture></a>
+<a href="https://github.com/muhittincamdali/sdkbump/tree/main/docs/guides"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/muhittincamdali/sdkbump/main/.github/brand/button-guides-tr-dark.svg"><source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/muhittincamdali/sdkbump/main/.github/brand/button-guides-tr-light.svg"><img src="https://raw.githubusercontent.com/muhittincamdali/sdkbump/main/.github/brand/button-guides-tr-light.svg" alt="Rehberler"></picture></a>
+<a href="https://github.com/muhittincamdali/sdkbump/tree/main/examples"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/muhittincamdali/sdkbump/main/.github/brand/button-examples-tr-dark.svg"><source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/muhittincamdali/sdkbump/main/.github/brand/button-examples-tr-light.svg"><img src="https://raw.githubusercontent.com/muhittincamdali/sdkbump/main/.github/brand/button-examples-tr-light.svg" alt="Örnekler"></picture></a>
+</p>
+
+> Bu belge İngilizce README'nin çevirisidir. İkisi arasında fark varsa güncel olan İngilizce sürümdür.
+
+<!-- brand:end -->
+
+Xcode 27 ile derlenmiş bir sürümü yayınlamadan önce: sdkbump, yerel iOS, Flutter veya React
+Native/Expo projesini iOS 27 SDK'sının getirdiği değişiklikler (başta UIScene yaşam döngüsü) için
+denetler ve her bulgu için hangi çözümün geçerli olduğunu söyler. Projenizin dosyalarını okur;
+hiçbir şeyi derlemez, çalıştırmaz veya değiştirmez.
+
+<picture><source media="(prefers-color-scheme: dark)" srcset="docs/media/demo-rn-087-dark.svg"><source media="(prefers-color-scheme: light)" srcset="docs/media/demo-rn-087-light.svg"><img src="docs/media/demo-rn-087-light.svg" alt="React Native 0.87 uygulamasında çalıştırılan sdkbump: iOS 27 SDK'sıyla derlendiğinde açılmıyor; SCN001 sahne yapılandırması yok ve SCN002 pencere uygulama delegesinde oluşturuluyor, üç çözüm yoluyla"></picture>
+
+<sub>Gerçek CLI'dan kaydedildi; <a href="fixtures/rn-087">rn-087 fixture</a>'ında, yani
+<code>@react-native-community/cli init</code> ile oluşturulmuş bir React Native 0.87.1
+uygulamasında (<code>npm run demo</code>).</sub>
+
+## Öne çıkanlar
+
+- **"Açılacak mı?" sorusunu yanıtlar.** Hiçbir sahne tanımlamayan bir uygulama Xcode 27 ile derlenir,
+  ama açılışta durur. sdkbump bunu bir test cihazında fark etmenizden önce söyler ve değiştirmeniz
+  gereken dosyaları belirtir.
+- **Yerel, Flutter, React Native ve Expo** tek raporda, aynı kural kimlikleriyle; metin, Markdown
+  veya JSON olarak ve CI için bir çıkış koduyla.
+- **Projenize uyan çözüm**: React Native 0.88 veya elle yazılmış bir sahne delegesi, Expo SDK 57'nin
+  isteğe bağlı desteği veya SDK 58, Flutter'ın otomatik geçişi veya elle yapılacak adımlar (sdkbump,
+  Flutter'ın geçiş aracıyla aynı koşulları denetler) ya da SwiftUI uygulaması için SwiftUI API'si.
+- **Sessiz bozulmalar da**: uygulamada bir sahne olduğunda UIKit'in artık kullanmadığı uygulama
+  delegesi metotları ve başlatma seçenekleri (bağlantılar, Handoff, hızlı eylemler, ön plan ve arka
+  plan geçişleri) ile doğru pencereyi artık bulamayan pencere sorguları.
+- **Her ifadenin bir kaynağı var.** Kurallar veridir ([rules/ios27.json](rules/ios27.json)) ve her
+  biri Apple'ın, Flutter'ın, React Native'in veya Expo'nun kendi sayfalarına atıfta bulunur; birinin
+  kaynağı yoksa testler başarısız olur.
+- **iOS 27 simülatöründe denendi**: SCN001 ve SCN002'nin arkasındaki açılış hatası ve siyah ekran
+  Xcode 27.0 ile yeniden üretildi; kayıtlar depodadır.
+
+## Hızlı başlangıç
+
+[Node.js](https://nodejs.org/) 22.12 veya üstü gerekir (`node --version` sürümü gösterir; Mac'te
+`brew install node` ile kurulur). Başka bir şey gerekmez.
+
+**1. Uygulamanızın klasöründe bir terminal açın**; `.xcodeproj`, `pubspec.yaml` veya
+`package.json` dosyasının bulunduğu klasör:
+
+```sh
+cd path/to/YourApp
+```
+
+**2. sdkbump'ı çalıştırın:**
+
+```sh
+npx @mcamdali/sdkbump
+```
+
+npm paketinin adı `@mcamdali/sdkbump`; kurduğu komut `sdkbump`. Scope'suz bir `npx sdkbump` bu
+paketi çalıştırmaz.
+
+**3. Projenizin adının altındaki ilk satırı okuyun.** "Fails to launch when built with the iOS 27
+SDK" (iOS 27 SDK'sıyla derlendiğinde açılmıyor), **ERROR** bulgularını düzeltene kadar uygulamanın
+açılışta duracağı anlamına gelir; her bulgu, "How to fix" listesindeki hangi çözümün geçerli
+olduğunu söyler. **WARNING** bulguları açılışı engellemez, ancak uygulamada bir sahne olunca
+çalışmayı bırakır. "Launch not determined" (açılıp açılmayacağı belirlenemedi), sdkbump'ın bir
+Info.plist'i okuyamadığı anlamına gelir; raporun sonundaki notlar hangisi olduğunu ve nedenini
+söyler (aşağıdaki Sınırlar bölümüne bakın).
+
+## iOS 27 SDK'sıyla derleyince ne değişiyor
+
+Apple'ın
+[Transitioning to the UIKit scene-based life cycle](https://developer.apple.com/documentation/uikit/transitioning-to-the-uikit-scene-based-life-cycle)
+sayfasından (çeviri):
+
+> iOS 27, iPadOS 27, Mac Catalyst 27, tvOS 27 ve visionOS 27'den itibaren, en son SDK ile derlenen
+> uygulamaların sahne tabanlı yaşam döngüsünü benimsemesi gerekir; aksi halde açılmazlar.
+
+1. **Uygulama hiçbir sahne tanımlamıyorsa açılışta durur.** Info.plist'te yapılandırması olan bir
+   `UIApplicationSceneManifest` yok ve `application(_:configurationForConnecting:options:)` yok:
+   UIKit süreci "UIScene life cycle is required for apps built with this SDK" iletisiyle sonlandırır.
+   Derleyici uyarı vermez, çünkü denetim uygulama başlarken yapılır. React Native 0.87 ve öncesi,
+   isteğe bağlı desteği açılmamış Expo SDK 57 ve Expo SDK 56 ve öncesi böyle uygulamalar oluşturur;
+   Flutter aracının geçiremediği Flutter uygulamaları da öyle.
+2. **Bir sahne varsa uygulama delegesi artık arayüz olaylarını almaz.** Bağlantılar, kullanıcı
+   etkinlikleri, hızlı eylemler ve etkin/arka plan geçişleri sahne delegesine gider; uygulama
+   delegesinin oluşturduğu pencere ise hiç gösterilmez.
+
+[Neden derleniyor ama yine de çöküyor](docs/guides/why-it-crashes.md), iOS 27.0 simülatöründe
+çalıştırdığımız [açılış matrisini](examples/launch-matrix/README.md) gösterir.
+
+## sdkbump neleri denetler
+
+| Kural  | Önem derecesi | Bulgu                                                                                                                                                                                                  | iOS 27.0 simülatöründe gözlenen                                           |
+| ------ | ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------- |
+| SCN001 | error         | Sahne yapılandırması yok: yapılandırılmış `UIApplicationSceneManifest` yok, `configurationForConnecting` yok, SwiftUI `App` değil; `ios/` klasörü olmayan Expo için SDK sürümü ve `enableSceneSupport` | açılışta duruyor                                                          |
+| SCN002 | error         | Uygulama delegesi pencereyi `UIWindow(frame:)` ile oluşturuyor                                                                                                                                         | uygulamada bir sahne olunca siyah ekran                                   |
+| SCN003 | warning       | UIKit'in sahnelerle artık kullanmadığı uygulama delegesi metotları ve başlatma seçeneği anahtarları (13 tane), sahne delegesi zaten işlemiyorsa                                                        | bir SwiftUI uygulamasında `applicationDidEnterBackground(_:)` çağrılmıyor |
+| SCN004 | warning       | `UIApplication.shared.keyWindow`, `.windows` veya uygulama delegesinin `window` özelliği üzerinden pencere sorguları                                                                                   | yalnızca derleyicinin kullanımdan kaldırma uyarıları                      |
+
+Kural verisi `ios27@2026.10.15`, Xcode 27.0 (27A266a) ile denetlendi. React Native veya Expo
+projesinde `react-native-uiscene-bridge` ya da `react-native-xcode27` kuruluysa, bunların çalışma
+zamanında ele aldığı bulgular README'lerindeki sınırlarla birlikte "ele alınmış" olarak gösterilir
+ve çalıştırmayı başarısız saymaz.
+
+## Kurulum
+
+`sdkbump` komutunu npm'den kurun (paket `@mcamdali/sdkbump`):
+
+```sh
+npm i -g @mcamdali/sdkbump
+sdkbump
+```
+
+Bir projede `npm install --save-dev @mcamdali/sdkbump` bir sürümü sabitler; ardından
+`npx sdkbump` o kopyayı çalıştırır. Her [GitHub sürümü](https://github.com/muhittincamdali/sdkbump/releases) aynı paketi
+`sdkbump-<sürüm>.tgz` olarak bir `SHA256SUMS` dosyasıyla birlikte taşır; `npx` onu npm olmadan
+URL'sinden çalıştırır. `muhittincamdali/tap` için bir Homebrew
+formülü release workflow'u tarafından hazırlanır (tap'in ilk sürümüyle birlikte planlanıyor).
+
+## Kullanım
+
+```text
+sdkbump [path] [options]
+```
+
+| Seçenek                 | Ne yapar                                                                              |
+| ----------------------- | ------------------------------------------------------------------------------------- |
+| `path`                  | Proje klasörü veya `.xcodeproj`; varsayılan geçerli klasördür                         |
+| `-f, --format <format>` | `tty` (varsayılan), `markdown` veya `json`                                            |
+| `-o, --output <file>`   | Raporu terminal yerine bir dosyaya yazar                                              |
+| `--fail-on <severity>`  | `error` (varsayılan), `warning`, `info` veya `none`: çıkış kodunun ne zaman 1 olacağı |
+| `--no-color`            | Terminalde bile düz metin (`NO_COLOR` ve `FORCE_COLOR` dikkate alınır)                |
+
+Çıkış kodları: `0` `--fail-on` düzeyinde veya üstünde ele alınmamış bulgu yok, `1` bu düzeyde veya
+üstünde bulgu var, `2` hatalı argüman, iOS projesi bulunamadı veya beklenmeyen bir hata.
+
+sdkbump iOS uygulamasını kendisi bulur: yerel uygulamalar için kökteki veya bir klasör altındaki bir
+`.xcodeproj`, Flutter, React Native ve Expo uygulamaları için `ios/` (Flutter eklentisi için
+`example/ios/`). Proje dosyasındaki her iOS uygulama hedefini, her birinin adını verdiği Info.plist
+dosyasını (XML veya ikili) ve uygulamanın Swift ile Objective-C dosyalarını okur; Pods,
+`node_modules`, derleme çıktıları ve testleri atlar. `ios/` klasörü olmayan Expo uygulamaları
+package.json ve app.json üzerinden denetlenir.
+
+### Markdown raporunu kodla birlikte saklayın
+
+```sh
+npx @mcamdali/sdkbump --format markdown --output sdkbump.md
+```
+
+### JSON raporunu betiklerde kullanın
+
+```sh
+npx @mcamdali/sdkbump --format json > sdkbump.json
+```
+
+Her bulguda `rule`, `severity`, `file`, `line`, `message`, adımları ve rehberiyle `fix`,
+`alternatives`, `mitigation` (bir geçici çözüm paketi ele alıyorsa dolu olur) ve `sources` bulunur.
+Yapı `schemaVersion` 0'dır ve 1.0'dan önce değişebilir.
+[examples/shell/launch-blockers.sh](examples/shell/launch-blockers.sh) bunu `jq` ile süzer.
+
+### CI'da çalıştırın
+
+[examples/github-actions/sdkbump.yml](examples/github-actions/sdkbump.yml), iOS uygulamasına dokunan
+her pull request'in iş özetine raporu ekler ve hata varsa işi başarısız kılar.
+
+### JavaScript'ten
+
+```js
+import { render, scan } from 'sdkbump';
+
+const report = await scan('path/to/app');
+console.log(report.verdict.text);
+console.log(render(report, 'markdown'));
+```
+
+Çalıştırılabilir bir sürümü [examples/api/verdicts.mjs](examples/api/verdicts.mjs) dosyasındadır.
+
+## Demo
+
+Terminal kayıtları, her araç zinciriyle oluşturulmuş gerçek projeler olan
+[fixture'lar](fixtures/README.md) üzerinde CLI'dan alınmıştır:
+
+| Proje                                                            | Kayıt                                                                                |
+| ---------------------------------------------------------------- | ------------------------------------------------------------------------------------ |
+| React Native 0.87.1 uygulaması                                   | bu sayfanın başında                                                                  |
+| Özelleştirilmiş AppDelegate'li Flutter uygulaması (Flutter 3.24) | [açık](docs/media/demo-flutter-light.svg) · [koyu](docs/media/demo-flutter-dark.svg) |
+| Adaptör uygulama delegeli SwiftUI uygulaması                     | [açık](docs/media/demo-swiftui-light.svg) · [koyu](docs/media/demo-swiftui-dark.svg) |
+
+iOS 27.0 simülatöründe (iPhone 17, Xcode 27.0 ile derlendi) yerel UIKit fixture'ı açılışta durur;
+aynı uygulama bir sahne delegesine taşındığında açılır:
+
+<picture><source media="(prefers-color-scheme: dark)" srcset="docs/media/demo-simulator-native-uikit-dark.svg"><source media="(prefers-color-scheme: light)" srcset="docs/media/demo-simulator-native-uikit-light.svg"><img src="docs/media/demo-simulator-native-uikit-light.svg" alt="iOS 27.0 simülatöründe scripts/simulator-check.sh native-uikit: açılıştan 4 saniye sonra çalışmıyor; UIKit'in satırı: Application failed to launch: UIScene life cycle is required for apps built with this SDK"></picture>
+
+<p align="center"><img src="docs/media/simulator/launched.png" width="480" alt="native-uikit-scenes ve native-swiftui fixture'ları, Xcode 27.0 ile derlenmiş, iOS 27.0 yüklü bir iPhone 17 simülatöründe çalışıyor"></p>
+
+15 Ekim 2026'da, Node.js 26.11 yüklü bir Mac'te (Apple silicon, M5 Max), makinede başka işler
+çalışırken ölçüldü: on fixture üzerinde `node dist/cli/main.js` 100'er çalıştırmalık üç seri,
+Node.js'in açılışı dahil. Serilerin medyanları 0,11, 0,12 ve 0,19 saniye; en yavaş çalıştırma 0,33
+saniye sürdü. Makine daha yüklüyken süreler uzar.
+
+## Durum
+
+| Özellik                                                                                                              | Durum             |
+| -------------------------------------------------------------------------------------------------------------------- | ----------------- |
+| Yerel, Flutter (uygulama ve eklenti örneği), React Native ve Expo projesi algılama                                   | çalışıyor         |
+| Uygulamanın kendi Info.plist'i ve Swift/Objective-C kaynaklarında SCN001 ile SCN004                                  | çalışıyor         |
+| Ekosisteme ve sürüme göre çözüm seçimi; Flutter otomatik geçiş denetimi; geçici çözüm paketleri                      | çalışıyor         |
+| Terminal, Markdown ve JSON raporları; `--fail-on` çıkış kodları                                                      | çalışıyor         |
+| Bağımlılıklar: Pods, `node_modules` ve Flutter eklenti kaynakları, paketin adıyla                                    | planlanıyor (0.2) |
+| SCN005 geçici çözüm bildirimi ayrı bir kural olarak; 15.0 altındaki dağıtım hedefleri için DPT001                    | planlanıyor (0.2) |
+| `--verify`: CLI'dan iOS 27 simülatöründe derleme ve açma                                                             | planlanıyor (0.3) |
+| Kalıplar yerine Swift/Objective-C sözdizimi ağaçları; derlenmiş `.app` denetimleri; SiriKit kullanımdan kaldırmaları | planlanıyor (0.5) |
+| Yerel uygulamalar için `fix --dry-run`, SARIF çıktısı, GitHub Action                                                 | planlanıyor (0.8) |
+| Kararlı kural şeması ve JSON yapısı                                                                                  | planlanıyor (1.0) |
+
+## Sınırlar
+
+- **Derleyici değil, kalıp.** Kurallar, yorumları ve dizgeleri boşaltılmış Swift ve Objective-C
+  metni üzerinde çalışan düzenli ifadelerdir. Üretilmiş kod, makroların arkasındaki kod veya
+  alışılmadık biçimde yazılmış kod gözden kaçabilir ya da yanlışlıkla eşleşebilir. Sözdizimi
+  ağaçları planlanıyor (0.5).
+- **Yalnızca uygulamanın kendi kaynakları.** Pods, `node_modules`, Flutter eklentileri ve diğer
+  bağımlılıklar okunmaz; bu yüzden UIKit'in artık çağırmadığı app delegate yöntemlerine dayanan bir
+  eklenti raporlanmaz. Bağımlılık denetimi planlanıyor (0.2).
+- **Derleme ayarları yalnızca project.pbxproj'den.** sdkbump, `INFOPLIST_FILE` ve
+  `GENERATE_INFOPLIST_FILE` ayarlarını proje dosyasından okur ve `$(SRCROOT)`, `$(PROJECT_DIR)`,
+  `$(TARGET_NAME)` ile `$(PRODUCT_NAME)` değerlerini yerine koyar. `.xcconfig` dosyalarını okumaz,
+  diğer derleme ayarlarını yerine koymaz ve proje klasörünün dışındaki bir Info.plist'i okumaz. Bir
+  hedefin Info.plist'ini okuyamadığında tahmin yürütmek yerine SCN001'i info düzeyinde bir bulgu
+  yapar ve sonucu "Launch not determined" olarak verir.
+- **Bastırma dosyası yok.** Bir bulgu incelendi olarak işaretlenemez; hangi önem düzeylerinin
+  çalıştırmayı başarısız yapacağına `--fail-on` karar verir.
+- **Yalnızca dosyalar.** sdkbump uygulamayı derlemez ve açmaz; `--verify` planlanıyor (0.3).
+
+## Dokümantasyon
+
+API başvurusu ve rehberler: [muhittincamdali.github.io/sdkbump](https://muhittincamdali.github.io/sdkbump/).
+
+## Rehberler
+
+- [Neden derleniyor ama yine de çöküyor](docs/guides/why-it-crashes.md)
+- [Yerel UIKit ve SwiftUI uygulamaları](docs/guides/native-ios.md)
+- [Flutter: özelleştirilmiş AppDelegate ve eklentiler](docs/guides/flutter.md)
+- [0.88 öncesi React Native ve SDK 58 öncesi Expo](docs/guides/react-native-expo.md)
+- [Yerel modül yazarları: soğuk başlangıçta bağlantılar ve bildirimler](docs/guides/native-module-authors.md)
+
+## İlgili araçlar
+
+Başka projeler de aynı değişiklik üzerinde çalışıyor; hangisinin uygun olduğu neye ihtiyacınız
+olduğuna bağlıdır:
+
+- [react-native-uiscene-bridge](https://github.com/Atomics-hub/react-native-uiscene-bridge) ve
+  [react-native-xcode27](https://github.com/Atomics-hub/react-native-xcode27), bir React Native
+  veya Expo uygulamasını kod değişikliği olmadan, çalışma zamanında açılır hale getirir. Henüz
+  yükseltemediğinizde işe yararlar; sdkbump bunları tanır.
+- [auditor-uiscene](https://github.com/Anzell/auditor-uiscene), Flutter uygulamalarını ve
+  eklentilerini bir kabuk betiğiyle denetler.
+- Flutter'ın kendi geçiş aracı (3.41'den itibaren `flutter build ios`), değiştirilmemiş bir Flutter
+  uygulamasını geçirir.
+- [flutter_spm_doctor](https://pub.dev/packages/flutter_spm_doctor) Flutter eklentilerini denetler.
+
+## Gereksinimler
+
+| Araç zinciri | En düşük sürüm |
+| ------------ | -------------- |
+| Node.js      | 22.12          |
+
+sdkbump'ın Xcode'a ihtiyacı yoktur: dosyaları okur, bu yüzden Linux'ta da çalışır. CI testleri
+Node.js 22 ve 24'te (Linux) çalıştırır; yerelde 280 testin tamamı bir Mac'te (Apple silicon)
+Node.js 22.23, 24.22 ve 26.11 ile geçer. Simülatör kayıtları Xcode 27 yüklü bir Mac gerektirir ve
+CI'ın parçası değildir.
+
+## Mimari
+
+```text
+path ─► detectProject      native | flutter | react-native | expo; iOS folder; versions
+     ─► collectApp         iOS app targets from project.pbxproj, their Info.plist (XML or binary),
+                           Swift and Objective-C sources with comments and strings blanked
+     ─► checkApp           SCN001…SCN004, fix per ecosystem and version, workaround packages
+          rules/ios27.json  what each rule says, fixes, sources (validated with zod)
+     ─► render             tty | markdown | json
+```
+
+- Algılama kalıpları, yorumları ve dizgeleri boşaltılmış kaynak metin üzerindeki düzenli ifadelerdir
+  ve gereken yerde yalnızca bir uygulama delegesinin veya sahne delegesinin içinde sayılır.
+- Kural verisi koddan ayrıdır ve sürümlüdür (`ios27@2026.10.15`); bir kuralın, çözümün veya geçici
+  çözümün kaynağı yoksa bir test başarısız olur.
+- CLI (`src/cli/`) yalnızca argümanları ayrıştırır, renkleri ve genişlikleri seçer ve çıkış kodunu
+  belirler.
+
+## Yol haritası
+
+[Durum](#durum) tablosuna bakın: 0.2 bağımlılıkları ve dağıtım hedeflerini ekler, 0.3 CLI'dan
+simülatörde açmayı, 0.5 sözdizimi ağaçlarını ve derlenmiş uygulama denetimlerini, 0.8 çözümleri ve
+SARIF'i, 1.0 kararlı bir şemayı. [CHANGELOG.md](CHANGELOG.md) her sürümde nelerin değiştiğini listeler.
+
+## SSS
+
+**Uygulamam bugün iOS 27'de çalışıyor. Etkilenir mi?** Xcode 26 veya öncesiyle derlendiyse bu denetim
+o derleme için geçerli değildir: bizim denememizde, iOS 26 SDK'sına bağlanan aynı kod iOS 27
+simülatöründe açıldı. Xcode 27 ile yapacağınız bir sonraki derleme için geçerlidir.
+
+**sdkbump bir cihazda test etmenin yerini tutar mı?** Hayır. Dosyaları okur. Bu depodaki simülatör
+kayıtları iOS 27.0 simülatöründendir; burada hiçbir şey bir cihazda çalıştırılmadı.
+
+**Bir bulgu neden "ele alınmış" görünüyor?** package.json'daki bir geçici çözüm paketi
+(react-native-uiscene-bridge veya react-native-xcode27) çalışma zamanında bir sahne tanımlar.
+Uygulama açılır, ama kendi başına hâlâ sahne desteği yoktur; rapor paketin sınırlarını ve gerçek
+çözümü listeler.
+
+**sdkbump projemi değiştirir mi?** Hayır. Projeyi okur ve yalnızca istediğiniz raporu yazar.
+
+
+## Katkıda bulunma
+
+Katkılarınızı bekliyoruz. Pull request açmadan önce [katkı rehberini](CONTRIBUTING.md) ve [davranış kurallarını](https://github.com/muhittincamdali/.github/blob/main/CODE_OF_CONDUCT.md) okuyun. Güvenlik açıklarını [güvenlik politikasında](SECURITY.md) anlatıldığı gibi gizli olarak bildirin.
+
+## Lisans
+
+MIT lisansıyla yayımlanmıştır. Ayrıntılar için [LICENSE](LICENSE) dosyasına bakın.

package/README.zh-CN.md

@@ -0,0 +1,250 @@
+<!-- i18n-source: README.md@49073c524eb2b7aad433b6794961ec40869c1170 status=reviewed -->
+<!-- brand:start -->
+
+<p align="center"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/muhittincamdali/sdkbump/main/.github/brand/banner-dark.svg"><source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/muhittincamdali/sdkbump/main/.github/brand/banner-light.svg"><img src="https://raw.githubusercontent.com/muhittincamdali/sdkbump/main/.github/brand/banner-light.svg" alt="sdkbump: Checks native iOS, Flutter and React Native apps for the iOS 27 SDK changes and names the fix for each."></picture></p>
+
+<!-- lang-selector:start -->
+<p align="center"><a href="README.md">English</a> · <a href="README.tr.md">Türkçe</a> · <a href="README.zh-CN.md">简体中文</a> · <a href="README.ja.md">日本語</a> · <a href="README.ko.md">한국어</a> · <a href="README.es.md">Español</a> · <a href="README.de.md">Deutsch</a> · <a href="README.fr.md">Français</a> · <a href="README.pt-BR.md">Português (Brasil)</a> · <a href="README.ru.md">Русский</a></p>
+<!-- lang-selector:end -->
+
+<p align="center">
+<a href="https://github.com/muhittincamdali/sdkbump/actions/workflows/ci.yml"><img src="https://github.com/muhittincamdali/sdkbump/actions/workflows/ci.yml/badge.svg" alt="CI 状态"></a>
+<a href="https://github.com/muhittincamdali/sdkbump/releases"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/muhittincamdali/sdkbump/main/.github/brand/badge-version-dark.svg"><source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/muhittincamdali/sdkbump/main/.github/brand/badge-version-light.svg"><img src="https://raw.githubusercontent.com/muhittincamdali/sdkbump/main/.github/brand/badge-version-light.svg" alt="最新版本: v0.1.2"></picture></a>
+<a href="https://github.com/muhittincamdali/sdkbump/blob/main/package.json"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/muhittincamdali/sdkbump/main/.github/brand/badge-language-dark.svg"><source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/muhittincamdali/sdkbump/main/.github/brand/badge-language-light.svg"><img src="https://raw.githubusercontent.com/muhittincamdali/sdkbump/main/.github/brand/badge-language-light.svg" alt="语言版本: Node.js 22.12+"></picture></a>
+<a href="https://github.com/muhittincamdali/sdkbump/blob/main/LICENSE"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/muhittincamdali/sdkbump/main/.github/brand/badge-license-dark.svg"><source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/muhittincamdali/sdkbump/main/.github/brand/badge-license-light.svg"><img src="https://raw.githubusercontent.com/muhittincamdali/sdkbump/main/.github/brand/badge-license-light.svg" alt="许可证: MIT"></picture></a>
+</p>
+
+<p align="center">
+<a href="#快速开始"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/muhittincamdali/sdkbump/main/.github/brand/button-start-zh-CN-dark.svg"><source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/muhittincamdali/sdkbump/main/.github/brand/button-start-zh-CN-light.svg"><img src="https://raw.githubusercontent.com/muhittincamdali/sdkbump/main/.github/brand/button-start-zh-CN-light.svg" alt="开始使用"></picture></a>
+<a href="https://muhittincamdali.github.io/sdkbump/"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/muhittincamdali/sdkbump/main/.github/brand/button-docs-zh-CN-dark.svg"><source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/muhittincamdali/sdkbump/main/.github/brand/button-docs-zh-CN-light.svg"><img src="https://raw.githubusercontent.com/muhittincamdali/sdkbump/main/.github/brand/button-docs-zh-CN-light.svg" alt="文档"></picture></a>
+<a href="https://github.com/muhittincamdali/sdkbump/tree/main/docs/guides"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/muhittincamdali/sdkbump/main/.github/brand/button-guides-zh-CN-dark.svg"><source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/muhittincamdali/sdkbump/main/.github/brand/button-guides-zh-CN-light.svg"><img src="https://raw.githubusercontent.com/muhittincamdali/sdkbump/main/.github/brand/button-guides-zh-CN-light.svg" alt="指南"></picture></a>
+<a href="https://github.com/muhittincamdali/sdkbump/tree/main/examples"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/muhittincamdali/sdkbump/main/.github/brand/button-examples-zh-CN-dark.svg"><source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/muhittincamdali/sdkbump/main/.github/brand/button-examples-zh-CN-light.svg"><img src="https://raw.githubusercontent.com/muhittincamdali/sdkbump/main/.github/brand/button-examples-zh-CN-light.svg" alt="示例"></picture></a>
+</p>
+
+> 本文是英文 README 的译文。如两者内容不一致，以英文版为准。
+
+<!-- brand:end -->
+
+在发布使用 Xcode 27 构建的版本之前：sdkbump 会检查原生 iOS、Flutter 或 React Native/Expo 项目是否受 iOS 27 SDK 变更的影响（首先是 UIScene 生命周期），并针对每一项发现告诉你适用的修复方式。它只读取项目文件，不会构建、运行或修改任何内容。
+
+<picture><source media="(prefers-color-scheme: dark)" srcset="docs/media/demo-rn-087-dark.svg"><source media="(prefers-color-scheme: light)" srcset="docs/media/demo-rn-087-light.svg"><img src="docs/media/demo-rn-087-light.svg" alt="在 React Native 0.87 应用上运行 sdkbump：使用 iOS 27 SDK 构建后无法启动；SCN001 没有场景配置，SCN002 在 app delegate 中创建窗口，并给出三种修复方式"></picture>
+
+<sub>录制自真实的 CLI，运行对象是 <a href="fixtures/rn-087">rn-087 fixture</a>，即由 <code>@react-native-community/cli init</code> 创建的 React Native 0.87.1 应用（<code>npm run demo</code>）。</sub>
+
+## 亮点
+
+- **回答“能启动吗？”** 没有声明任何 scene 的应用可以用 Xcode 27 构建，但会在启动时停止。sdkbump 会在你在测试设备上才发现之前就告诉你，并指出需要修改的文件。
+- **原生、Flutter、React Native 和 Expo** 在同一份报告中使用相同的规则 ID，输出格式为文本、Markdown 或 JSON，并提供供 CI 使用的退出码。
+- **适用于你的项目的修复方式**：React Native 0.88 或手写的 scene delegate，Expo SDK 57 的可选开关或 SDK 58，Flutter 的自动迁移或手动步骤（sdkbump 检查的条件与 Flutter 的迁移工具相同），或者针对 SwiftUI 应用的 SwiftUI API。
+- **也包括悄无声息的故障**：应用有了 scene 之后，UIKit 不再使用的 app delegate 方法和启动选项（链接、Handoff、快捷操作、前台与后台切换），以及再也找不到正确窗口的窗口查找方式。
+- **每一条说明都有出处。** 规则以数据形式存放（[rules/ios27.json](rules/ios27.json)），每条规则都引用 Apple、Flutter、React Native 或 Expo 自己的页面；缺少出处时测试会失败。
+- **已在 iOS 27 模拟器中验证**：SCN001 和 SCN002 背后的启动失败与黑屏已用 Xcode 27.0 复现，录像保存在仓库中。
+
+## 快速开始
+
+你需要 [Node.js](https://nodejs.org/) 22.12 或更高版本（`node --version` 可查看版本；在 Mac 上，`brew install node` 即可安装）。不需要其他任何东西。
+
+**1. 在应用所在的文件夹中打开终端**，也就是包含 `.xcodeproj`、`pubspec.yaml` 或 `package.json` 的那个文件夹：
+
+```sh
+cd path/to/YourApp
+```
+
+**2. 运行 sdkbump：**
+
+```sh
+npx @mcamdali/sdkbump
+```
+
+npm 包名是 `@mcamdali/sdkbump`，它安装的命令是 `sdkbump`。不带 scope 的 `npx sdkbump` 不会运行它。
+
+**3. 阅读项目名称下方的第一行。** “Fails to launch when built with the iOS 27 SDK”（使用 iOS 27 SDK 构建后无法启动）表示在你修复 **ERROR** 级别的发现之前，应用会在启动时停止；每一项发现都会说明适用“How to fix”列表中的哪种修复方式。**WARNING** 级别的发现不会阻止启动，但应用有了 scene 之后就会失效。 “Launch not determined”（无法判断能否启动）表示 sdkbump 没能读取某个 Info.plist；报告末尾的注释会说明是哪一个以及原因（见下方“限制”）。
+
+## 使用 iOS 27 SDK 构建时有哪些变化
+
+引自 Apple 的 [Transitioning to the UIKit scene-based life cycle](https://developer.apple.com/documentation/uikit/transitioning-to-the-uikit-scene-based-life-cycle)（译文）：
+
+> 从 iOS 27、iPadOS 27、Mac Catalyst 27、tvOS 27 和 visionOS 27 开始，使用最新 SDK 构建的应用必须采用基于 scene 的生命周期，否则将无法启动。
+
+1. **如果应用没有声明 scene，它会在启动时停止。** Info.plist 中没有带配置的 `UIApplicationSceneManifest`，也没有 `application(_:configurationForConnecting:options:)`：UIKit 会以 “UIScene life cycle is required for apps built with this SDK” 为提示结束进程。编译器不会给出警告，因为这项检查发生在应用启动时。React Native 0.87 及更早版本、未启用可选开关的 Expo SDK 57，以及 Expo SDK 56 及更早版本创建的应用都属于这种情况；Flutter 工具无法迁移的 Flutter 应用也是如此。
+2. **有了 scene，app delegate 就不再接收界面事件。** 链接、user activity、快捷操作以及活跃/后台切换都会转到 scene delegate，而由 app delegate 创建的窗口永远不会显示。
+
+[为什么能编译却仍然崩溃](docs/guides/why-it-crashes.md)介绍了我们在 iOS 27.0 模拟器中运行的[启动矩阵](examples/launch-matrix/README.md)。
+
+## sdkbump 检查什么
+
+| 规则   | 严重程度 | 发现                                                                                                                                                                                 | 在 iOS 27.0 模拟器中观察到的现象                              |
+| ------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------- |
+| SCN001 | error    | 没有 scene 配置：没有已配置的 `UIApplicationSceneManifest`，没有 `configurationForConnecting`，也不是 SwiftUI `App`；对于没有 `ios/` 的 Expo，则检查 SDK 版本和 `enableSceneSupport` | 启动时停止                                                    |
+| SCN002 | error    | app delegate 使用 `UIWindow(frame:)` 创建窗口                                                                                                                                        | 应用有了 scene 之后出现黑屏                                   |
+| SCN003 | warning  | UIKit 在使用 scene 时不再使用的 app delegate 方法和启动选项键（共 13 个），除非 scene delegate 已经处理了它们                                                                        | SwiftUI 应用中 `applicationDidEnterBackground(_:)` 不会被调用 |
+| SCN004 | warning  | 通过 `UIApplication.shared.keyWindow`、`.windows` 或 app delegate 的 `window` 查找窗口                                                                                               | 仅有编译器的弃用警告                                          |
+
+规则数据 `ios27@2026.10.15`，已对照 Xcode 27.0（27A266a）检查。当 React Native 或 Expo 项目安装了 `react-native-uiscene-bridge` 或 `react-native-xcode27` 时，它们在运行时处理的发现会显示为“已处理”，并附上其 README 中说明的限制，不会导致运行失败。
+
+## 安装
+
+从 npm 安装 `sdkbump` 命令（包名 `@mcamdali/sdkbump`）：
+
+```sh
+npm i -g @mcamdali/sdkbump
+sdkbump
+```
+
+在项目中，`npm install --save-dev @mcamdali/sdkbump` 会锁定一个版本，之后 `npx sdkbump` 运行的就是这个副本。每个 [GitHub 发布版本](https://github.com/muhittincamdali/sdkbump/releases)也以 `sdkbump-<版本>.tgz` 的形式附带同一个包和 `SHA256SUMS` 文件，`npx` 可以不经 npm 直接从其 URL 运行。适用于 `muhittincamdali/tap` 的 Homebrew formula 由发布工作流准备（计划随 tap 的首个版本提供）。
+
+## 使用方法
+
+```text
+sdkbump [path] [options]
+```
+
+| 选项                    | 作用                                                           |
+| ----------------------- | -------------------------------------------------------------- |
+| `path`                  | 项目文件夹或 `.xcodeproj`；默认为当前文件夹                    |
+| `-f, --format <format>` | `tty`（默认）、`markdown` 或 `json`                            |
+| `-o, --output <file>`   | 将报告写入文件，而不是输出到终端                               |
+| `--fail-on <severity>`  | `error`（默认）、`warning`、`info` 或 `none`：退出码何时为 1   |
+| `--no-color`            | 即使在终端中也输出纯文本（会遵循 `NO_COLOR` 和 `FORCE_COLOR`） |
+
+退出码：`0` 表示没有达到或超过 `--fail-on` 级别的未处理发现，`1` 表示有达到或超过该级别的发现，`2` 表示参数错误、未找到 iOS 项目或发生意外错误。
+
+sdkbump 会自行找到 iOS 应用：原生应用是根目录或下一级文件夹中的 `.xcodeproj`，Flutter、React Native 和 Expo 应用是 `ios/`（Flutter 插件是 `example/ios/`）。它会读取项目文件中的每个 iOS 应用 target、每个 target 指定的 Info.plist（XML 或二进制），以及应用的 Swift 和 Objective-C 文件，并跳过 Pods、`node_modules`、构建产物和测试。没有 `ios/` 的 Expo 应用则根据 package.json 和 app.json 检查。
+
+### 将 Markdown 报告与代码一起保存
+
+```sh
+npx @mcamdali/sdkbump --format markdown --output sdkbump.md
+```
+
+### 在脚本中使用 JSON 报告
+
+```sh
+npx @mcamdali/sdkbump --format json > sdkbump.json
+```
+
+每项发现都包含 `rule`、`severity`、`file`、`line`、`message`、带有步骤和指南的 `fix`、`alternatives`、`mitigation`（当有变通方案包处理该问题时会设置）以及 `sources`。其结构为 `schemaVersion` 0，在 1.0 之前可能会变化。[examples/shell/launch-blockers.sh](examples/shell/launch-blockers.sh) 用 `jq` 对其进行过滤。
+
+### 在 CI 中运行
+
+[examples/github-actions/sdkbump.yml](examples/github-actions/sdkbump.yml) 会把报告添加到每个涉及 iOS 应用的 pull request 的作业摘要中，并在出现 error 时使作业失败。
+
+### 在 JavaScript 中使用
+
+```js
+import { render, scan } from 'sdkbump';
+
+const report = await scan('path/to/app');
+console.log(report.verdict.text);
+console.log(render(report, 'markdown'));
+```
+
+可运行的版本见 [examples/api/verdicts.mjs](examples/api/verdicts.mjs)。
+
+## 演示
+
+终端录像来自 CLI 在 [fixtures](fixtures/README.md) 上的运行，这些 fixture 是用各个工具链创建的真实项目：
+
+| 项目                                                 | 录像                                                                                 |
+| ---------------------------------------------------- | ------------------------------------------------------------------------------------ |
+| React Native 0.87.1 应用                             | 本页顶部                                                                             |
+| 自定义了 AppDelegate 的 Flutter 应用（Flutter 3.24） | [浅色](docs/media/demo-flutter-light.svg) · [深色](docs/media/demo-flutter-dark.svg) |
+| 使用适配器 app delegate 的 SwiftUI 应用              | [浅色](docs/media/demo-swiftui-light.svg) · [深色](docs/media/demo-swiftui-dark.svg) |
+
+在 iOS 27.0 模拟器（iPhone 17，使用 Xcode 27.0 构建）中，原生 UIKit fixture 会在启动时停止，而改用 scene delegate 的同一个应用可以正常启动：
+
+<picture><source media="(prefers-color-scheme: dark)" srcset="docs/media/demo-simulator-native-uikit-dark.svg"><source media="(prefers-color-scheme: light)" srcset="docs/media/demo-simulator-native-uikit-light.svg"><img src="docs/media/demo-simulator-native-uikit-light.svg" alt="在 iOS 27.0 模拟器上运行 scripts/simulator-check.sh native-uikit：启动 4 秒后未在运行，UIKit 的输出为：Application failed to launch: UIScene life cycle is required for apps built with this SDK"></picture>
+
+<p align="center"><img src="docs/media/simulator/launched.png" width="480" alt="native-uikit-scenes 和 native-swiftui fixture 运行在安装了 iOS 27.0 的 iPhone 17 模拟器上，使用 Xcode 27.0 构建"></p>
+
+2026 年 10 月 15 日在一台 Mac（Apple silicon，M5 Max）上使用 Node.js 26.11 测得，测量时机器上还在运行其他任务：在十个 fixture 上运行 `node dist/cli/main.js`，每组 100 次，共三组（包含 Node.js 启动时间）。三组的中位数分别为 0.11、0.12 和 0.19 秒，最慢的一次为 0.33 秒。机器负载越高，耗时越长。
+
+## 状态
+
+| 功能                                                                          | 状态          |
+| ----------------------------------------------------------------------------- | ------------- |
+| 原生、Flutter（应用和插件示例）、React Native 和 Expo 项目检测                | 可用          |
+| 针对应用自身 Info.plist 和 Swift/Objective-C 源码的 SCN001 到 SCN004          | 可用          |
+| 按生态系统和版本选择修复方式；Flutter 自动迁移检查；变通方案包                | 可用          |
+| 终端、Markdown 和 JSON 报告；`--fail-on` 退出码                               | 可用          |
+| 依赖项：Pods、`node_modules` 和 Flutter 插件源码，并指出包名                  | 计划中（0.2） |
+| 将 SCN005 变通方案提示作为独立规则；针对低于 15.0 的部署目标的 DPT001         | 计划中（0.2） |
+| `--verify`：通过 CLI 在 iOS 27 模拟器中构建并启动                             | 计划中（0.3） |
+| 用 Swift/Objective-C 语法树取代模式匹配；已构建的 `.app` 检查；SiriKit 弃用项 | 计划中（0.5） |
+| 面向原生应用的 `fix --dry-run`、SARIF 输出、GitHub Action                     | 计划中（0.8） |
+| 稳定的规则 schema 和 JSON 结构                                                | 计划中（1.0） |
+
+## 限制
+
+- **基于模式，而不是编译器。** 规则是作用于 Swift 和 Objective-C 文本的正则表达式，文本中的注释和字符串已被清空。生成的代码、藏在宏里的代码或写法不常见的代码可能被漏掉或误判。语法树计划中（0.5）。
+- **只读取应用自身的源码。** 不读取 Pods、`node_modules`、Flutter 插件和其他依赖，因此依赖 UIKit 已不再调用的 app delegate 方法的插件不会被报告。依赖检查计划中（0.2）。
+- **构建设置只来自 project.pbxproj。** sdkbump 从项目文件读取 `INFOPLIST_FILE` 和 `GENERATE_INFOPLIST_FILE`，并展开 `$(SRCROOT)`、`$(PROJECT_DIR)`、`$(TARGET_NAME)` 和 `$(PRODUCT_NAME)`。它不读取 `.xcconfig` 文件，不展开其他构建设置，也不读取项目文件夹之外的 Info.plist。无法读取某个 target 的 Info.plist 时，SCN001 会作为 info 级别的发现报告，结论为“Launch not determined”，而不是猜测。
+- **没有屏蔽文件。** 无法把某项发现标记为已审查；由 `--fail-on` 决定哪些严重级别会让运行失败。
+- **只读取文件。** sdkbump 不会构建或启动应用；`--verify` 计划中（0.3）。
+
+## 文档
+
+API 参考与指南：[muhittincamdali.github.io/sdkbump](https://muhittincamdali.github.io/sdkbump/)。
+
+## 指南
+
+- [为什么能编译却仍然崩溃](docs/guides/why-it-crashes.md)
+- [原生 UIKit 和 SwiftUI 应用](docs/guides/native-ios.md)
+- [Flutter：自定义 AppDelegate 和插件](docs/guides/flutter.md)
+- [0.88 之前的 React Native 和 SDK 58 之前的 Expo](docs/guides/react-native-expo.md)
+- [原生模块作者：冷启动时的链接与通知](docs/guides/native-module-authors.md)
+
+## 相关工具
+
+还有其他项目也在处理同一项变更；哪一个合适，取决于你的需求：
+
+- [react-native-uiscene-bridge](https://github.com/Atomics-hub/react-native-uiscene-bridge) 和 [react-native-xcode27](https://github.com/Atomics-hub/react-native-xcode27) 可以在运行时让 React Native 或 Expo 应用无需修改代码即可启动。它们适用于暂时无法升级的情况；sdkbump 能够识别它们。
+- [auditor-uiscene](https://github.com/Anzell/auditor-uiscene) 用 shell 脚本审计 Flutter 应用及其插件。
+- Flutter 自带的迁移工具（从 3.41 起的 `flutter build ios`）可以迁移未经修改的 Flutter 应用。
+- [flutter_spm_doctor](https://pub.dev/packages/flutter_spm_doctor) 检查 Flutter 插件。
+
+## 系统要求
+
+| 工具链  | 最低版本 |
+| ------- | -------- |
+| Node.js | 22.12    |
+
+sdkbump 不需要 Xcode：它只读取文件，因此也可以在 Linux 上运行。CI 在 Node.js 22 和 24（Linux）上运行测试；在本地的 Mac（Apple silicon）上，全部 280 个测试在 Node.js 22.23、24.22 和 26.11 上均通过。模拟器录像需要安装了 Xcode 27 的 Mac，不属于 CI 的一部分。
+
+## 架构
+
+```text
+path ─► detectProject      native | flutter | react-native | expo; iOS folder; versions
+     ─► collectApp         iOS app targets from project.pbxproj, their Info.plist (XML or binary),
+                           Swift and Objective-C sources with comments and strings blanked
+     ─► checkApp           SCN001…SCN004, fix per ecosystem and version, workaround packages
+          rules/ios27.json  what each rule says, fixes, sources (validated with zod)
+     ─► render             tty | markdown | json
+```
+
+- 检测模式是针对源码文本的正则表达式，其中的注释和字符串已被清空；在需要的地方，只有位于 app delegate 或 scene delegate 内部的匹配才会计入。
+- 规则数据与代码分离并带有版本（`ios27@2026.10.15`）；如果某条规则、修复方式或变通方案没有出处，测试就会失败。
+- CLI（`src/cli/`）只负责解析参数、选择颜色和宽度，以及设置退出码。
+
+## 路线图
+
+参见[状态](#状态)表：0.2 增加依赖项和部署目标，0.3 支持通过 CLI 在模拟器中启动，0.5 增加语法树和已构建应用的检查，0.8 增加修复和 SARIF，1.0 提供稳定的 schema。[CHANGELOG.md](CHANGELOG.md) 列出了每个版本的变更。
+
+## 常见问题
+
+**我的应用今天在 iOS 27 上能运行，会受到影响吗？** 如果它是用 Xcode 26 或更早版本构建的，这项检查不适用于那次构建：在我们的测试中，链接到 iOS 26 SDK 的同一份代码可以在 iOS 27 模拟器上启动。它适用于你下一次使用 Xcode 27 的构建。
+
+**sdkbump 能取代真机测试吗？** 不能。它只读取文件。本仓库中的模拟器录像来自 iOS 27.0 模拟器；这里没有任何内容是在真机上运行的。
+
+**为什么某项发现显示为“已处理”？** package.json 中的某个变通方案包（react-native-uiscene-bridge 或 react-native-xcode27）会在运行时声明一个 scene。应用可以启动，但它自身仍然没有 scene 支持；报告会列出该包的限制以及真正的修复方式。
+
+**sdkbump 会修改我的项目吗？** 不会。它只读取项目，只写入你要求的报告。
+
+
+## 参与贡献
+
+欢迎参与贡献。提交 pull request 之前，请先阅读[贡献指南](CONTRIBUTING.md)和[行为准则](https://github.com/muhittincamdali/.github/blob/main/CODE_OF_CONDUCT.md)。如发现安全问题，请按照[安全策略](SECURITY.md)私下报告。
+
+## 许可证
+
+基于 MIT 许可证发布。详见 [LICENSE](LICENSE)。

package/dist/cli/main.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli/main.js

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+import { run } from './run.js';
+process.exitCode = await run(process.argv.slice(2), {
+    cwd: process.cwd(),
+    env: process.env,
+    stdout: (text) => process.stdout.write(text),
+    stderr: (text) => process.stderr.write(text),
+    stdoutIsTty: process.stdout.isTTY === true,
+    columns: process.stdout.columns,
+});
+//# sourceMappingURL=main.js.map