keisei/KeiSeiKit-1.0
2
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
KeiSeiKit-1.0/_blocks/stack-swift-ios.md
Parfii-bot 0be354a920 KeiSeiKit-public — clean state 
Single-commit clean baseline after security scrub of niche-tells,
project codenames, internal jargon, and contributor-email leaks.

Contents:
- 100 Rust crates (_primitives/_rust/)
- 37 agent manifests (_manifests/) + generated specs (_generated/)
- 67 user-invocable skills (skills/)
- 33 hooks (hooks/)
- Composition blocks (_blocks/)
- Documentation (docs/, README.md)
- TS adapter packages (_ts_packages/)
- Assembler (_assembler/)
- Roles (_roles/)
- Templates (_templates/)
- Forgejo CI (.forgejo/)

Author: Denis Parfionovich <info@greendragon.info>

License: see LICENSE.
2026-05-01 12:09:03 +08:00

1.5 KiB
Raw Blame History

STACK — Swift iOS (UIKit / SwiftUI hybrid)

Use for platform-native iOS UI — this is the only sane choice for iOS.

UIKit vs SwiftUI:

  • SwiftUI for new screens by default (iOS 16+ targets). Wrap UIKit views via UIViewRepresentable only when SwiftUI has no equivalent (AVKit camera, ARKit, MapKit gestures).
  • UIKit required for: deep UITextInput custom protocols, scroll-view precise tracking, UIPageViewController paging animations < 60 fps on SwiftUI.

App lifecycle:

  • @main struct App or AppDelegate/SceneDelegate pair. NOT both — pick one.
  • LaunchScreen.storyboard required (Info.plist key UILaunchStoryboardName) — Apple rejects static image launch.

Info.plist mandatory keys:

  • NSCameraUsageDescription / NSPhotoLibraryUsageDescription / NSLocationWhenInUseUsageDescription — if capability used; missing → runtime crash, not build error.
  • CFBundleURLTypes for custom URL schemes (deeplinks).
  • NSAppTransportSecurity — never set NSAllowsArbitraryLoads=true in prod (App Store rejection).
  • UIBackgroundModes array for any background audio / location / BLE.

Threading: @MainActor for UI mutation; actor for shared mutable state; Task { ... } for async. NO DispatchQueue.main.async wrapping UI updates from Swift Concurrency code (defeats actor isolation).

Forbidden: NSAllowsArbitraryLoads=true, force-unwrapping UIImage(named:) (use failable init), hardcoded API keys in .swift sources (use .xcconfig + Bundle.main.infoDictionary).