DeviceKit

Filial	Versões
mestre	≥ 2,0
Swift 4 - 4.2	≥ 1,3 <1,13
Swift 3	≥ 1,0 <1,3
Swift 2.3	<1,0

DeviceKit é uma substituição do tipo de valor do UIDevice .

Versão atual 5.5.0

Consulte nosso Changelog detalhado para obter os recursos mais recentes, melhorias e correções de bugs.

Características

• Equivável
• Identificação do dispositivo
• Detecção familiar de dispositivos
• Detecção de grupo de dispositivos
• Detecção do simulador
• Estado da bateria
• Nível da bateria
• Várias métricas de dispositivo (por exemplo, tamanho da tela, proporção de tela, PPI)
• Detecção de modo de baixa potência
• Detecção de sessão de acesso guiado
• Brilho da tela
• Exibir detecção de zoom
• Detectar sensores disponíveis (ID de toque, ID da face)
• Detectar espaço de disco disponível
• Detecção de suporte a lápis Apple

Requisitos

• iOS 11.0+
• TvOS 11.0+
• WatchOS 4.0+

Instalação

DeviceKit pode ser instalado de várias maneiras.

Cocoapods

Swift 5

 pod 'DeviceKit' , '~> 5.2' 

IOS 8.0 Suporte

 pod 'DeviceKit' , '3.2' 

Swift 4.0 - Swift 4.2

 pod 'DeviceKit' , '~> 1.3' 

Swift 3

 pod 'DeviceKit' , '~> 1.2.3' 

Swift 2.3 (sem suporte)

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

Gerente de pacotes Swift

Swift 5

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

IOS 8.0 Suporte

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

Cartago

Swift 5

 github "devicekit/DeviceKit" ~> 4.0

IOS 8.0 Suporte

 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 (sem suporte)

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

Manualmente

Para instalá -lo manualmente, arraste o projeto DeviceKit para o seu projeto de aplicativo no Xcode. Ou adicione -o como um submódulo Git executando:

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

Uso

Primeiro, certifique -se de importar a estrutura:

import DeviceKit

Aqui estão alguns exemplos de uso. Todos os dispositivos também estão disponíveis como simuladores:

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

Você pode experimentar esses exemplos no playground.

Observação:

Para experimentar o DeviceKit no playground, abra o DeviceKit.xcworkspace e crie o DeviceKit.Framework para qualquer simulador primeiro selecionando o "DeviceKit" como seu esquema atual.

Obtenha o dispositivo em que você está executando

 let device = Device . current

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

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

Obtenha a família do 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)
}

Verifique se a execução no simulador

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

Obtenha o 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
}

Verifique se o dispositivo está contido em um grupo pré -configurado

 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
}

Obtenha o estado da bateria atual

Observação:

Para obter o estado da bateria atual, precisamos definir UIDevice.current.isBatteryMonitoringEnabled como true . Para evitar problemas com seu código, lemos a configuração atual e a redefinimos para o que era antes quando terminamos.

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

Obtenha o nível atual da bateria

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

Obtenha o status do modo de baixa potência

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

Verifique se uma sessão de acesso guiada está atualmente ativa

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

Obtenha o brilho da tela

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

Obtenha espaço de disco disponível

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
} 

Fonte de informação

Todos os identificadores de modelo são retirados do seguinte site: https://www.theiphonewiki.com/wiki/models ou extraído do aplicativo simulador com xcode.

Contribuindo

Se você precisar de um recurso específico que deseja implementar ou se experimentou um bug, abra um problema. Se você estendeu a funcionalidade do DeviceKit e deseja que outras pessoas o usem também, envie uma solicitação de tração.

Colaboradores

A lista completa de pessoas que contribuíram para este projeto está disponível aqui. DeviceKit não seria o que é sem você! Muito obrigado!