DeviceKit

Rama	Versiones
maestro	≥ 2.0
Swift 4 - 4.2	≥ 1.3 <1.13
Swift 3	≥ 1.0 <1.3
Swift 2.3	<1.0

DeviceKit es un reemplazo de valor de valor de UIDevice .

Versión actual 5.5.0

Vea nuestro ChangeLog detallado para las últimas características, mejoras y correcciones de errores.

Características

• Equitable
• Identificación del dispositivo
• Detección familiar del dispositivo
• Detección de grupos de dispositivos
• Detección de simulador
• Estado de batería
• Nivel de batería
• Varias métricas de dispositivos (por ejemplo, tamaño de pantalla, relación de pantalla, PPI)
• Detección de modo de baja potencia
• Detección de sesión de acceso guiado
• Brillo de la pantalla
• Mostrar detección de zoom
• Detectar sensores disponibles (ID de contacto, ID de cara)
• Detectar el espacio de disco disponible
• Detección de soporte de lápiz de manzana

Requisitos

• iOS 11.0+
• tvos 11.0+
• WatchOS 4.0+

Instalación

DeviceKit se puede instalar de varias maneras.

Cocoapods

Swift 5

 pod 'DeviceKit' , '~> 5.2' 

Soporte de 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 (sin apoyo)

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

Administrador de paquetes Swift

Swift 5

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

Soporte de iOS 8.0

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

Cartago

Swift 5

 github "devicekit/DeviceKit" ~> 4.0

Soporte de 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 (sin apoyo)

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

A mano

Para instalarlo manualmente, arrastre el proyecto DeviceKit a su proyecto de aplicación en Xcode. O agréguelo como un submódulo git ejecutando:

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

Uso

Primero asegúrese de importar el marco:

import DeviceKit

Aquí hay algunos ejemplos de uso. Todos los dispositivos también están disponibles como simuladores:

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

Puedes probar estos ejemplos en el patio de recreo.

Nota:

Para probar DeviceKit en el patio de recreo, abra el DeviceKit.xcworkspace y cree dispositivos para cualquier simulador primero seleccionando "DeviceKit" como su esquema actual.

Obtenga el dispositivo en el que se está ejecutando

 let device = Device . current

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

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

Obtener la familia del dispositivo

 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)
}

Compruebe si se ejecuta en simulador

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

Obtenga el dispositivo simulador

 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
}

Asegúrese de que el dispositivo esté contenido en un grupo preconfigurado

 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
}

Obtenga el estado actual de la batería

Nota:

Para obtener el estado actual de la batería, necesitamos establecer UIDevice.current.isBatteryMonitoringEnabled en true . Para evitar cualquier problema con su código, leemos la configuración actual y la restablecemos a lo que era antes cuando terminamos.

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

Obtenga el nivel actual de la batería

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

Obtener un estado de modo de baja potencia

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

Compruebe si una sesión de acceso guiado está actualmente activa

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

Obtener brillo de la pantalla

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

Obtenga espacio en disco disponible

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
} 

Fuente de información

Todos los identificadores de modelos se toman del siguiente sitio web: https://www.theiphonewiki.com/wiki/models o se extraen de la aplicación de simulador incluida con xcode.

Que contribuye

Si tiene la necesidad de una función específica que desee implementarse o si experimentó un error, abra un problema. Si extendió la funcionalidad de DeviceKit y desea que otros lo usen también, envíe una solicitud de extracción.

Colaboradores

La lista completa de personas que contribuyeron a este proyecto está disponible aquí. ¡DeviceKit no sería lo que es sin ti! ¡Muchas gracias!