DeviceKit

فرع	الإصدارات
يتقن	≥ 2.0
سريع 4 - 4.2	≥ 1.3 <1.13
سريع 3	≥ 1.0 <1.3
سويفت 2.3	<1.0

DeviceKit هو استبدال من نوع القيمة من UIDevice .

الإصدار الحالي 5.5.0

شاهد changelog التفصيلية الخاصة بنا للحصول على أحدث الميزات والتحسينات وإصلاحات الأخطاء.

سمات

• مساواة
• تحديد الجهاز
• اكتشاف عائلة الجهاز
• اكتشاف مجموعة الأجهزة
• اكتشاف محاكاة
• حالة البطارية
• مستوى البطارية
• مقاييس الجهاز المختلفة (على سبيل المثال حجم الشاشة ، نسبة الشاشة ، PPI)
• الكشف عن وضع الطاقة المنخفض
• اكتشاف جلسة الوصول الموجهة
• سطوع الشاشة
• عرض اكتشاف التكبير
• اكتشف المستشعرات المتاحة (معرف اللمس ، معرف الوجه)
• اكتشف مساحة القرص المتاحة
• اكتشاف دعم قلم رصاص Apple

متطلبات

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

تثبيت

يمكن تثبيت DeviceKit بطرق مختلفة.

كوكوبودس

سريع 5

 pod 'DeviceKit' , '~> 5.2' 

دعم iOS 8.0

 pod 'DeviceKit' , '3.2' 

سريع 4.0 - سويفت 4.2

 pod 'DeviceKit' , '~> 1.3' 

سريع 3

 pod 'DeviceKit' , '~> 1.2.3' 

سويفت 2.3 (غير مدعوم)

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

مدير الحزمة السريع

سريع 5

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

دعم iOS 8.0

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

قرطاج

سريع 5

 github "devicekit/DeviceKit" ~> 4.0

دعم iOS 8.0

 github "devicekit/DeviceKit" ~> 3.2

سريع 4.0 - سويفت 4.2

 github "devicekit/DeviceKit" ~> 1.3

سريع 3

 github "devicekit/DeviceKit" ~> 1.2.3

سويفت 2.3 (غير مدعوم)

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

يدويًا

لتثبيته يدويًا ، اسحب مشروع DeviceKit إلى مشروع التطبيق الخاص بك في XCode. أو إضافتها كوحدة فرعية بوابة عن طريق التشغيل:

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

الاستخدام

تأكد أولاً من استيراد الإطار:

import DeviceKit

فيما يلي بعض أمثلة الاستخدام. جميع الأجهزة متوفرة أيضًا كمحاكاة:

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

يمكنك تجربة هذه الأمثلة في الملعب.

ملحوظة:

لتجربة DeviceKit في الملعب ، افتح DeviceKit.xcworkspace وقم بإنشاء DeviceKit.Framework لأي محاكاة أولاً عن طريق تحديد "DeviceKit" كمخطط الحالي الخاص بك.

احصل على الجهاز الذي تقوم بتشغيله

 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
}

احصل على حالة البطارية الحالية

ملحوظة:

للحصول على حالة البطارية الحالية ، نحتاج إلى تعيين UIDevice.current.isBatteryMonitoringEnabled إلى true . لتجنب أي مشكلات في الكود الخاص بك ، نقرأ الإعداد الحالي وإعادة ضبطه على ما كان عليه قبل أن ننتهي.

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
} 

مصدر المعلومات

جميع معرفات النماذج مأخوذة من الموقع التالي: https://www.theiphonewiki.com/wiki/models أو استخراجها من تطبيق المحاكاة المجمعة مع Xcode.

المساهمة

إذا كنت بحاجة إلى ميزة محددة تريد تنفيذها أو إذا واجهت خطأ ، فيرجى فتح مشكلة. إذا قمت بتوسيع وظيفة DeviceKit بنفسك وتريد أن يستخدمها الآخرون أيضًا ، فيرجى إرسال طلب سحب.

المساهمين

تتوفر القائمة الكاملة للأشخاص الذين ساهموا في هذا المشروع هنا. DeviceKit لن يكون ما هو بدونك! شكراً جزيلاً!