| Branch | Versions |
|---|---|
| master | β₯ 2.0 |
| Swift 4 - 4.2 | β₯ 1.3 < 1.13 |
| Swift 3 | β₯ 1.0 < 1.3 |
| Swift 2.3 | < 1.0 |
DeviceKit is a value-type replacement of UIDevice.
See our detailed changelog for the latest features, improvements and bug fixes.
- Equatable
- Device identification
- Device family detection
- Device group detection
- Simulator detection
- Battery state
- Battery level
- Various device metrics (e.g. screen size, screen ratio, PPI)
- Low Power Mode detection
- Guided Access Session detection
- Screen brightness
- Display Zoom detection
- Detect available sensors (Touch ID, Face ID)
- Detect available disk space
- Apple Pencil support detection
- iOS 11.0+
- tvOS 11.0+
- watchOS 4.0+
DeviceKit can be installed in various ways.
pod 'DeviceKit', '~> 5.2'pod 'DeviceKit', '3.2'pod 'DeviceKit', '~> 1.3'pod 'DeviceKit', '~> 1.2.3'pod 'DeviceKit', :git => 'https://github.com/devicekit/DeviceKit.git', :branch => 'swift-2.3-unsupported'dependencies: [
.package(url: "https://github.com/devicekit/DeviceKit.git", from: "4.0.0"),
/// ...
]dependencies: [
.package(url: "https://github.com/devicekit/DeviceKit.git", from: "3.2.0"),
/// ...
]github "devicekit/DeviceKit" ~> 4.0
github "devicekit/DeviceKit" ~> 3.2
github "devicekit/DeviceKit" ~> 1.3
github "devicekit/DeviceKit" ~> 1.2.3
github "devicekit/DeviceKit" "swift-2.3-unsupported"
To install it manually, drag the DeviceKit project into your app project in Xcode. Or add it as a git submodule by running:
$ git submodule add https://github.com/devicekit/DeviceKit.gitFirst make sure to import the framework:
import DeviceKitHere are some usage examples. All devices are also available as simulators:
.iPhone6 => .simulator(.iPhone6)
.iPhone6s => .simulator(.iPhone6s)You can try these examples in Playground.
Note:
To try DeviceKit in the playground, open the
DeviceKit.xcworkspaceand build DeviceKit.framework for any simulator first by selecting "DeviceKit" as your current 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
}Note:
To get the current battery state we need to set
UIDevice.current.isBatteryMonitoringEnabledtotrue. To avoid any issues with your code, we read the current setting and reset it to what it was before when we're done.
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
}All model identifiers are taken from the following website: https://www.theiphonewiki.com/wiki/Models or extracted from the simulator app bundled with Xcode.
If you have the need for a specific feature that you want implemented or if you experienced a bug, please open an issue. If you extended the functionality of DeviceKit yourself and want others to use it too, please submit a pull request.
The complete list of people who contributed to this project is available here. DeviceKit wouldn't be what it is without you! Thank you very much! π