iPadSplitScreenKit 1.2.0

iPadSplitScreenKit 1.2.0

×

由 dragonLi 维护。

iPadSplitScreenKit 1.2.0

  • 作者
  • DevDragonli

iPadSplitScreenKit

iPad 应用分屏功能基础组件

Version License Platform

【分屏】&&【横竖屏】

Objective-C/Swift 项目（纯 OC/Swift/混合编写）均可使用，[参看下文安装部分]，提供快速适配 iPad 项目的分屏、悬浮窗、横竖屏等能力。

  • 支持版本：iOS9+
  • 可随时获取是否全屏状态、是否横屏状态、当前屏幕具体状态（当前实际用户可见显示最大宽度、高度）✅
  • 支持 APP 启动分屏模式适配✅
    • 首次渲染时机捕获[打点，布局等]
  • 布局不同样式/场景下：通用逻辑部分，大小屏逻辑✅

官网教程：在 iPad 上使用多任务处理功能

  • 不同样式需要 APP 内部适配处理不同的 UI。

  • 针对 APP 启动（可以分屏模式启动）同样需要处理。

  • 可运行 Demo 体验[当前为 2/3 横屏模式为全屏展示，其他为小屏幕模式，此处后期支持自定义]。

安装

iPadSplitScreenKit 通过 Cocoapods 提供。要安装它，只需将以下行添加到您的 Podfile 中

Obj-C 和 Swift Pod 可同时安装，也可单独安装某一语言。

// Default Swift 
pod 'iPadSplitScreenKit','~>1.1.0'

// ObjC
pod 'iPadSplitScreenKit/ObjC','~>1.1.0'

示例

要运行exampleproject，先克隆仓库，然后从Example目录运行pod install。

主API

`iPadSplitScreenStatusTool`

/// NOTE：获取当前是小屏幕还是大屏幕状态
/// 【点击事件弹框展示等使用】
/// 【获取时机：APP首屏渲染后】
@property (nonatomic, assign, readonly, getter=isFullScreen) BOOL fullScreen;

/// NOTE：获取是否为横屏显示形态【YES 即为横屏状态，否则为竖屏状态】
/// 【获取时机：APP启动后 Any 】
@property (nonatomic, assign, readonly, getter=isInterfaceOrientationLandscape)BOOL interfaceOrientationLandscape;

/// NOTE：获取当前最详细的屏幕显示形态【参考 `SplitScreenInterfaceType` 枚举类型】
/// 【获取时机：viewDidLoad函数中/之后生命周期函数中获取】
@property (nonatomic, assign, readonly)SplitScreenInterfaceType currentScreenInterfaceType;

/// NOTE：获取当前最详细的屏幕的相对显示【布局时，获取当前屏幕最大宽度等使用】
/// 【获取时机：APP首屏渲染后】
@property (nonatomic, assign, readonly)CGFloat currentScreenWidth;

`iPadSplitScreenVC`

/// 当前界面共同视图/逻辑添加此处【仅调用一次】
/// 【原：viewDidLoad公用/调通UI/逻辑迁移至此函数】
/// 【Example：界面的CollectionView为大小屏的通用视图，则此处添加，不需要ipadFullScreen和ipadSmallScreen函数处理】
- (void)ipadCommonSetup;

/// iPad 全屏模式【仅调用一次】
- (void)ipadFullScreen;

/// iPad 小屏模式【仅调用一次】
- (void)ipadSmallScreen;

/// 小屏幕切换到大屏幕【处理逻辑】
- (void)ipadSmallToFullScreenConfigurations;

/// 大屏幕切换到小屏幕【处理逻辑】
- (void)ipadFullToSmallScreenConfigurations;

/// 每次屏幕改变均调用此函数【分屏操作，横竖屏改变，子类控制器可通过此函数获取时机】
/// @param changeType changeType
/// @param currentSize currentSize 
- (void)ipadInterfaceOrientationChanged:(ZDInterfaceChangeType)changeType
                            currentSize:(CGSize)currentSize;


/// 当前界面共同视图/逻辑添加此处【仅调用一次】
/// 【原：viewDidLoad公用/调通UI/逻辑迁移至此函数】
/// 【Example：界面的CollectionView为大小屏的通用视图，则此处添加，不需要ipadFullScreen和ipadSmallScreen函数处理】
open func ipadCommonSetup()  {
    
}

///  iPad 全屏模式【仅调用一次】
open func ipadFullScreen()  {
    
}
/// iPad 小屏模式【仅调用一次】
open func ipadSmallScreen()  {
}
    
/// 小屏幕切换到大屏幕【处理逻辑】
open func ipadSmallToFullScreenConfigurations()  {
    
}
    
/// 大屏幕切换到小屏幕【处理逻辑】
open func ipadFullToSmallScreenConfigurations()  {
    
}
   
/// 每次屏幕改变均调用此函数【分屏操作，横竖屏改变，子类控制器可通过此函数获取时机】
open func ipadInterfaceOrientationChanged(changeType:ScreenInterfaceChangeType,currentSize:CGSize) {
   
}

iPadSplitScreen 使用说明

  • 界面控制器继承此控制器类

  • 将viewDidLoad拆分以实现ipadFullScreen或ipadSmallScreen【仅UI逻辑：布局，交互等】。

  • 将viewDidLoad中的其他代码迁移至 ipadCommonSetup！！！【原viewDidLoad打点，通知等逻辑保持不变】

  • 当屏幕出现需要改变布局的时刻【移除当前部分视图，保存当前session数据等场景，请处理于ipadSmallToFull/ipadSmallToFull中。

  • 当前屏幕旋转，改变大小，若无需改变布局，则相关函数不会触发，请知悉。

  • 每次屏幕改动，都会发出通知 SplitScreenChangeNotification。

    • 场景：通过控制器传递/控制链较长，则需要对应视图自身接收事件，内部处理【弹出框嵌套类】。
    • 需要项目内判断是否处理【仅当当前控制器界面的视图才处理】。

  • ipadInterfaceOrientationChanged函数界面渲染后，每次改变都会调用2次！！！，需要通过枚举过滤时机【根据项目需求】。

【需要等待屏幕旋转改变，大小屏切换函数执行后，再处理逻辑，则参考如下】

- (void)ipadInterfaceOrientationChanged:(ZDInterfaceChangeType)changeType
                            currentSize:(CGSize)currentSize {
   if (changeType != ZDInterfaceChangeLatter) {
       return;
   }
   // you custom code
}


【当前是否从小屏幕转化为小屏幕，或者大屏幕转化为大屏幕需要调整细节】

- (void)ipadInterfaceOrientationChanged:(ZDInterfaceChangeType)changeType
                            currentSize:(CGSize)currentSize {
    if (changeType != ZDInterfaceChangeLatter) {
        return;
    }

    if (!SPLITISFULLSCREEN) {
      // 当前切换到小屏幕的逻辑调整
    }  else {
     
   }
}

备注说明：

  • 判断当前是否为全屏【OC使用此宏即可】：SPLITISFULLSCREEN

iPad 屏幕横竖屏演算

以下均指屏幕相对宽度，对苹果的临界数据进行内部处理的计算逻辑。

  • 横屏

    • 1/3: < 0.40
    • 1/2: 0.40 < 0.6
    • 2/3: 0.6 < 1.0

  • 竖屏

    • 小：0.5 （1/2）
    • 大：0.7 (2/3)

  • 横屏数据（宽度和对比比例）

    • 375 678 981 1366 iPad pro 12.9

    • 0.274 0.496 0.71 1.00

    • 320 507 694 1024 ipad mini 5

    • 0.3125 0.495 0.677 1.00

  • 竖屏

    • 320 438 768 mini
    • 0.41 0.57 1.00

作者

DevDragonLi, [email protected]

许可证

iPadSplitScreenKit 受MIT许可协议的许可。有关更多信息，请参阅LICENSE文件。