# DuoKit **Repository Path**: nick5683/DuoKit ## Basic Information - **Project Name**: DuoKit - **Description**: DuoKit iPhone Duo适配 - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-11-16 - **Last Updated**: 2026-11-16 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # DuoKit iPhone Duo / 宽屏适配 SDK(LocalPod)。 参考: - [掘金:传统竖屏 UIKit 简单适配第一版](https://juejin.cn/post/7696759034846052367) - [WaterfallLayoutDemo](https://github.com/Rogue24/WaterfallLayoutDemo)(瀑布流 API / 过渡动画思路) ## 安装 ```ruby # 远端(Gitee) pod 'DuoKit', :git => 'https://gitee.com/nick5683/DuoKit.git', :tag => '1.2.0' # 本地开发 pod 'DuoKit', :path => 'LocalPod/DuoKit' ``` 仓库:https://gitee.com/nick5683/DuoKit ## 模块 | 模块 | API | |------|-----| | Env | `DuoEnvironment` / `DuoDisplayMode` / `.duoSceneDidChange` | | Metrics | `DuoScreenMetrics` | | Layout | `DuoLayout` / `DuoLayoutConfig` | | Grid | `DuoGridLayout` | | Waterfall | `DuoWaterfallLayout`(可自适应列数) | | Arrangement | `DuoArrangementPageManager` / `DuoArrangementHostController`(`UIArrangementViewController` + `UISplitArrangement`) | | Chrome | `DuoLiquidGlass` / Tab / Nav | ## 场景广播(掘金方案) ```swift // SceneDelegate DuoEnvironment.setup(window) @available(iOS 26.0, *) func windowScene(_ windowScene: UIWindowScene, didUpdateEffectiveGeometry previous: UIWindowScene.Geometry) { DuoEnvironment.resetIfNeeded(windowScene) } // VC:appear 监听 / disappear 取消 override func viewWillAppear(_ animated: Bool) { super.viewWillAppear(animated) duo_isObservingSceneChanges = true } override func viewDidDisappear(_ animated: Bool) { super.viewDidDisappear(animated) duo_isObservingSceneChanges = false } extension HomeVC: DuoSceneObserving { func duo_sceneDidChange(options: DuoEnvUpdateOptions, transitionDuration: TimeInterval) { // 用 DuoEnvironment.sceneBounds / safeAreaInsets 重算布局 duo_animateLayoutIfNeeded(duration: transitionDuration) } } ``` 临时过渡可在 Info.plist 加 `UIRequiresFullScreen = YES`(反向方向黑边,不拉伸)。 ## 瀑布流 ```swift let layout = DuoWaterfallLayout() layout.usesAdaptiveColumnCount = true // 跟 DuoGridLayout 列数 layout.delegate = self ``` ## Arrangement(左右双栏) iOS 27.1+ 使用系统 `UIArrangementViewController` + 仅横向 `UISplitArrangement`;更早系统退化为单栏 Nav push。 业务侧 `DH_Split*` typealias 仍可用。 ```swift DuoArrangementPageManager.wrapDynamicLeft(leftVC, reuse: host) leftVC.showInArrangementDetail(detailVC) ```