分支	版本
master	≥ 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

请参阅我们详细的更新日志，了解最新的功能、改进和错误修复。

功能

要求

iOS 11.0+
tvOS 11.0+
watchOS 4.0+

安装

可以通过多种方式安装 DeviceKit。

CocoaPods

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 Package Manager

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"),
    /// ...
]

Carthage

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 子模块

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

用法

首先确保导入框架

import DeviceKit

以下是一些用法示例。所有设备也可以作为模拟器使用

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

您可以在 Playground 中尝试这些示例。

注意

要在 playground 中尝试 DeviceKit，请打开 DeviceKit.xcworkspace 并首先为任何模拟器构建 DeviceKit.framework，方法是将 "DeviceKit" 选择为当前 scheme。

获取您正在运行的设备

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 捆绑的模拟器应用程序中提取。

贡献

如果您需要实现某个特定功能或者遇到了错误，请打开一个 issue。如果您自己扩展了 DeviceKit 的功能并希望其他人也使用它，请提交一个 pull request。

贡献者

贡献给此项目的所有人员的完整列表可在此处获得 here。没有您们，DeviceKit 就不会是现在的样子！非常感谢！🙏