Hardware Utilities Quick Start Guide

For iOS, tvOS, watchOS and macOS development with Swift and Xcode

Hardware Utilities

Hardware Utilities provide commonly used information about the device an app is running on such as the device type (for example iPhoneX), the OS version (for example iOS 11.1) and if the app can connect to the internet.

The following is included:

AppleHardwareType – Enum that contains a human-readable Apple Device Type (such as iPhoneX).
HardwareInformation – Provides information about the device an app is running on.

AppleHardwareType

Used to convert an Apple device model name (in the form iPhone10,3) to a human readable form (such as iPhoneX). This enum works with the HardwareInformation class to get the type of device the app is running on.

Known Device Types

The following device types are handled:

iPhone:

iPhone – The original version.
iPhone3G
iPhone3GS
iPhone4
iPhone4S
iPhone5
iPhone5C
iPhone5S
iPhone6
iPhone6Plus
iPhone6S
iPhone6SPlus
iPhoneSE
iPhone7
iPhone7Plus
iPhone8
iPhone8Plus
iPhoneX

iPad

iPad – The original version.
iPad2
iPadMini
iPad3
iPad4
iPadAir
iPadMini2
iPadMini3
iPadMini4
iPadAir2
iPadPro12In
iPadPro9In
iPad5thGen
iPadPro12In2ndGen
iPadPro10In

iPod Touch

iPodTouch – The original version.
iPodTouch2ndGen
iPodTouch3rdGen
iPodTouch4thGen
iPodTouch6thGen

AppleTV

appleTV2ndGen
appleTV3rdGen
appleTV4thGen
appleTV4K

AirPods

airPods – The original version.

AppleWatch

appleWatch – The original version.
appleWatchSeries1
appleWatchSeries2
appleWatchSeries3

HomePod

homePod – The original version.

MacBook

macBookRetina12In2017
macBookRetina12In2016
macBookRetina12In2015
macBook13In2010
macBook13InLate2009
macBook13In2009

MacBook Air

macBookAir13In2015To2017
macBookAir11In2015
macBookAir13In2013To2014
macBookAir11In2013To2014
macBookAir13In2012
macBookAir11In2012
macBookAir13In2011
macBookAir13In2010
macBookAir11In2012
macBookAir2009

MacBook Pro

macBookPro15In2017
macBookPro13In2017
macBookPro15In2016
macBookPro13In2016
macBookProRetina15In2015
macBookProRetina13In2015
macBookProRetina15In2013To2014
macBookProRetina13In2013To2014
macBookProRetina13In2012To2013
macBookProRetina15In2012
macBookPro15In2012
macBookPro13In2012
macBookPro17In2011
macBookPro15In2011
macBookPro13In2011
macBookPro17In2010
macBookPro15In2011
macBookPro13In2011
macBookPro17In2010
macBookPro13In2010
macBookPro17In2009
macBookPro15In2009
macBookPro13In2009

Mac Mini

macMini2006
macMini2007
macMini2009
macMini2010
macMini2011
macMini2012
macMini2014

Mac Pro

macPro2013
macPro2010To2012
macPro2009

iMac

iMac21In2017
iMacRetina4K21In2017
iMacRetina5K27In2017
iMac21In2015
iMacRetina4K21In2015
iMacRetina5K27In2014To2015
iMac21In2014
iMac21In2013
iMac27In2013
iMac21In2012
iMac27In2012
iMac21In2011
iMac27In2011
iMac21In2011
iMac27In2011
iMac21In2009To2010
iMac27In2009To2010
iMac20InOr24In2009

Example:

let device = AppleHardwareType(fromModel: "iPhone10,3")

HardwareInformation

Defines a set of convenience properties and functions when working on Apple devices, such as checking the device model name (iPhone10,3), getting the device type (iPhoneX), getting the OS version (iOS 11.1), the current device orientation and internet connection state.

The following properties are available:

isPhone

Returns true if the app is running on an iPhone, else returns false. For example:

if HardwareInformation.isPhone {
    // App is running on an iPhone
    ...
}

isPad

Returns true if the app is running on an iPad, else returns false. For example:

if HardwareInformation.isPad {
    // App is running on an iPad
    ...
}

isTV

Returns true if the app is running on an Apple TV, else returns false. For example:

if HardwareInformation.isTV {
    // App is running on an Apple TV
    ...
}

isCar

Returns true if the app is running on a CarPlay connected device, else returns false. For example:

if HardwareInformation.isCar {
    // App is running on CarPlay
    ...
}

isWatch

Returns true if the app is running on an Apple Watch, else returns false. For example:

if HardwareInformation.isWatch {
    // App is running on an Apple Watch
    ...
}

isMac

Returns true if the app is running on a Mac laptop or desktop, else returns false. For example:

if HardwareInformation.isMac {
    // App is running on a Mac
    ...
}

modelName

Returns the model name of the device the app is running on. For example, iPhone10,3 or iPhone10,6 for the iPhone X. For example:

let model = HardwareInformation.modelName

deviceType

Returns the human-readable type of the device that the app is running on (for example iPhoneX) or unknown if the type cannot be discovered. For example:

if HardwareInformation.deviceType == .iPhoneX {
    // The app is running on an iPhone X
    ...
}

osVersion

Returns the version number (for example iOS 11.1) of the OS installed on the device that the app is running on. For example:

let version = HardwareInformation.osVersion

deviceOrientation (iOS and watchOS only)

Returns the current orientation of the device that the app is running on. If the orientation is unknown, a guess will be made based on the main screen’s bounds: if the width is less than the height, portrait is returned, else landscapeLeft is returned. For example:

if HardwareInformation.deviceOrientation == .portrait {
    // The device is in the portrait position
    ...
}

isRetinaDisplay

Returns true if the device the app is running on has a retina display, else returns false. For example:

if HardwareInformation.isRetinaDisplay {
    // The device has a Retina display
    ...
}

isHDDisplay

Returns true if the device the app is running on has a HD display, else returns false. For example:

if HardwareInformation.isHDDisplay {
    // The device has a HD display
    ...
}

screenBounds

Returns the bounds of the main screen of the device that the app is running on. As of iOS 8.0, these bounds will always be relative to the device’s orientation. For example:

let bounds = HardwareInformation.screenBounds

isConnectedToNetwork (iOS, tvOS and macOS Only)

Returns true if the device the app is running on is connected to the internet, else returns false. For example:

if HardwareInformation.isConnectedToNetwork {
    // The device has an internet connection
    ...
}

isWWANNetworkConnection (iOS Only)

Returns true if the device the app is running on is connected to the internet via a cellular connection, such as EDGE or GPRS, else returns false. For example:

if HardwareInformation.isWWANNetworkConnection {
    // The device has an internet via cellular
    ...
}