DeviceKit

分支	版本
掌握	≥2.0
Swift 4-4.2	≥1.3<1.13
Swift 3	≥1.0<1.3
Swift 2.3	<1.0

DeviceKit是UIDevice的值替代。

当前版本5.5.0

有关最新功能，改进和错误修复，请参阅我们的详细ChangElog。

特征

• 平等
• 设备标识
• 设备家庭检测
• 设备组检测
• 模拟器检测
• 电池状态
• 电池水平
• 各种设备指标（例如屏幕尺寸，屏幕比例，PPI）
• 低功率模式检测
• 指导访问会话检测
• 屏幕亮度
• 显示变焦检测
• 检测可用的传感器（触摸ID，脸部ID）
• 检测可用的磁盘空间
• 苹果铅笔支持检测

要求

• iOS 11.0+
• TVOS 11.0+
• WatchOS 4.0+

安装

DeviceKit可以以各种方式安装。

可可录

Swift 5

 pod 'DeviceKit' , '~> 5.2' 

iOS 8.0支持

 pod 'DeviceKit' , '3.2' 

Swift 4.0 -Swift 4.2

 pod 'DeviceKit' , '~> 1.3' 

Swift 3

 pod 'DeviceKit' , '~> 1.2.3' 

Swift 2.3（不支持）

 pod 'DeviceKit' , :git => 'https://github.com/devicekit/DeviceKit.git' , :branch => 'swift-2.3-unsupported'

Swift软件包管理器

Swift 5

dependencies: [
    . package ( url : " https://github.com/devicekit/DeviceKit.git " , from : " 4.0.0 " ) ,
    /// ...
] 

iOS 8.0支持

dependencies: [
    . package ( url : " https://github.com/devicekit/DeviceKit.git " , from : " 3.2.0 " ) ,
    /// ...
]

迦太基

Swift 5

 github "devicekit/DeviceKit" ~> 4.0

iOS 8.0支持

 github "devicekit/DeviceKit" ~> 3.2

Swift 4.0 -Swift 4.2

 github "devicekit/DeviceKit" ~> 1.3

Swift 3

 github "devicekit/DeviceKit" ~> 1.2.3

Swift 2.3（不支持）

 github "devicekit/DeviceKit" "swift-2.3-unsupported"

手动

要手动安装它，请将DeviceKit项目拖到XCode的应用程序项目中。或通过运行将其作为git subsodule添加：

$ git submodule add https://github.com/devicekit/DeviceKit.git

用法

首先确保导入框架：

import DeviceKit

这是一些用法示例。所有设备也可作为模拟器提供：

 . iPhone6 => . simulator ( . iPhone6 )
. iPhone6s => . simulator ( . iPhone6s )

您可以在操场上尝试这些示例。

笔记：

要在操场上尝试DeviceKit，请打开DeviceKit.xcworkspace并首先选择“ DeviceKit”作为当前方案，为任何模拟器构建devicekit.framework。

获取您正在运行的设备

 let device = Device . current

print ( device )     // prints, for example, "iPhone 6 Plus"

if device == . iPhone6Plus {
  // Do something
} else {
  // Do something else
}

获取设备家庭

 let device = Device . current
if device . isPod {
  // iPods (real or simulator)
} else if device . isPhone {
  // iPhone (real or simulator)
} else if device . isPad {
  // iPad (real or simulator)
}

检查是否在模拟器上运行

 let device = Device . current
if device . isSimulator {
  // Running on one of the simulators(iPod/iPhone/iPad)
  // Skip doing something irrelevant for Simulator
} 

获取模拟器设备

 let device = Device . current
switch device {
case . simulator ( . iPhone6s ) : break // You're running on the iPhone 6s simulator
case . simulator ( . iPadAir2 ) : break // You're running on the iPad Air 2 simulator
default : break
}

确保该设备包含在预配置组中

 let groupOfAllowedDevices : [ Device ] = [ . iPhone6 , . iPhone6Plus , . iPhone6s , . iPhone6sPlus , . simulator ( . iPhone6 ) , . simulator ( . iPhone6Plus ) , . simulator ( . iPhone6s ) , . simulator ( . iPhone6sPlus ) . simulator ( . iPhone8 ) , . simulator ( . iPhone8Plus ) , . simulator ( . iPhoneX ) , . simulator ( . iPhoneXS ) , . simulator ( . iPhoneXSMax ) , . simulator ( . iPhoneXR ) ]

let device = Device . current
 
if device . isOneOf ( groupOfAllowedDevices ) {
  // Do your action
}

获取当前的电池状态

笔记：

为了获得当前的电池状态，我们需要将UIDevice.current.isBatteryMonitoringEnabled设置为true 。为了避免您的代码问题，我们读取当前设置并将其重置为以前完成的设置。

if device . batteryState == . full || device . batteryState >= . charging ( 75 ) {
  print ( " Your battery is happy! ? " )
}

获取当前的电池水平

if device . batteryLevel >= 50 {
  install_iOS ( )
} else {
  showError ( )
}

获得低功率模式状态

if device . batteryState . lowPowerMode {
  print ( " Low Power mode is enabled! ? " )
} else {
  print ( " Low Power mode is disabled! ? " )
}

检查当前有指导访问会话是否处于活动状态

if device . isGuidedAccessSessionActive {
  print ( " Guided Access session is currently active " )
} else {
  print ( " No Guided Access session is currently active " )
}

获取屏幕亮度

if device . screenBrightness > 50 {
  print ( " Take care of your eyes! " )
}

获取可用的磁盘空间

if Device . volumeAvailableCapacityForOpportunisticUsage ?? 0 > Int64 ( 1_000_000 ) {
  // download that nice-to-have huge file
}

if Device . volumeAvailableCapacityForImportantUsage ?? 0 > Int64 ( 1_000 ) {
  // download that file you really need
} 

信息来源

所有模型标识符均来自以下网站：https：//www.theiphonewiki.com/wiki/models或从与Xcode捆绑在一起的模拟器应用程序中提取。

贡献

如果您需要要实施的特定功能或遇到错误，请打开问题。如果您自己扩展了DeviceKit的功能，并希望其他人也使用它，请提交拉动请求。

贡献者

在此处提供了为该项目做出贡献的人的完整列表。没有您，DeviceKit不会是什么！非常感谢！