DeviceKit

Cabang	Versi
menguasai	≥ 2.0
Swift 4 - 4.2	≥ 1,3 <1,13
Swift 3	≥ 1.0 <1.3
Swift 2.3	<1.0

DeviceKit adalah penggantian tipe nilai UIDevice .

Versi 5.5.0 saat ini

Lihat changelog terperinci kami untuk fitur terbaru, perbaikan, dan perbaikan bug.

Fitur

• Setara
• Identifikasi perangkat
• Deteksi Keluarga Perangkat
• Deteksi Grup Perangkat
• Deteksi simulator
• Status baterai
• Level baterai
• Berbagai metrik perangkat (misalnya ukuran layar, rasio layar, PPI)
• Deteksi Mode Daya Rendah
• Deteksi Sesi Akses Terpandu
• Kecerahan layar
• Deteksi Zoom Tampilan
• Deteksi sensor yang tersedia (ID sentuh, ID wajah)
• Mendeteksi ruang disk yang tersedia
• Deteksi Dukungan Pensil Apple

Persyaratan

• iOS 11.0+
• TVOS 11.0+
• Watchos 4.0+

Instalasi

DeviceKit dapat diinstal dengan berbagai cara.

Cocoapods

Swift 5

 pod 'DeviceKit' , '~> 5.2' 

Dukungan 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 (tidak didukung)

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

Manajer Paket Swift

Swift 5

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

Dukungan iOS 8.0

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

Kartago

Swift 5

 github "devicekit/DeviceKit" ~> 4.0

Dukungan 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 (tidak didukung)

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

Secara manual

Untuk menginstalnya secara manual, seret proyek DeviceKit ke proyek aplikasi Anda di Xcode. Atau tambahkan sebagai submodule git dengan menjalankan:

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

Penggunaan

Pertama pastikan untuk mengimpor kerangka kerja:

import DeviceKit

Berikut adalah beberapa contoh penggunaan. Semua perangkat juga tersedia sebagai simulator:

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

Anda dapat mencoba contoh -contoh ini di taman bermain.

Catatan:

Untuk mencoba DeviceKit di Playground, buka DeviceKit.xcworkspace dan membangun DeviceKit.Framework untuk simulator apa pun terlebih dahulu dengan memilih "DeviceKit" sebagai skema Anda saat ini.

Dapatkan perangkat yang sedang Anda jalankan

 let device = Device . current

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

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

Dapatkan Keluarga Perangkat

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

Periksa apakah berjalan di simulator

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

Dapatkan perangkat 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
}

Pastikan perangkat terkandung dalam grup yang telah dikonfigurasi sebelumnya

 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
}

Dapatkan status baterai saat ini

Catatan:

Untuk mendapatkan status baterai saat ini, kita perlu mengatur UIDevice.current.isBatteryMonitoringEnabled menjadi true . Untuk menghindari masalah apa pun dengan kode Anda, kami membaca pengaturan saat ini dan mengatur ulang apa yang terjadi sebelumnya ketika kami selesai.

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

Dapatkan level baterai saat ini

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

Dapatkan status mode daya rendah

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

Periksa apakah sesi akses berpemandu saat ini aktif

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

Dapatkan kecerahan layar

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

Dapatkan ruang disk yang tersedia

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
} 

Sumber informasi

Semua pengidentifikasi model diambil dari situs web berikut: https://www.theiphonewiki.com/wiki/models atau diekstraksi dari aplikasi simulator yang dibundel dengan Xcode.

Berkontribusi

Jika Anda memiliki kebutuhan untuk fitur tertentu yang ingin Anda terapkan atau jika Anda mengalami bug, buka masalah. Jika Anda memperluas fungsionalitas DeviceKit sendiri dan ingin orang lain juga menggunakannya, silakan kirim permintaan tarik.

Kontributor

Daftar lengkap orang yang berkontribusi pada proyek ini tersedia di sini. DeviceKit tidak akan seperti apa itu tanpamu! Terima kasih banyak!