المتطلبات الأساسية
قبل البدء في نقل الرمز، تأكَّد من استيفاء المتطلبات التالية:
- تتوافق حزمة ML Kit مع الإصدار 13.2.1 من Xcode أو الإصدارات الأحدث.
- تتوافق حزمة تعلّم الآلة مع الإصدار 10 من نظام التشغيل iOS أو الإصدارات الأحدث.
- لا تتوافق حزمة تعلّم الآلة مع بُنى 32 بت (i386 و armv7). تتوافق مجموعة أدوات تعلُّم الآلة مع بُنى 64 بت (x86_64 و arm64).
- لا تتوفّر مكتبة ML Kit إلا على شكل حلقات سفينة. لا يمكنك المزج بين أطر العمل وكائنات cocoapods، لذا عليك أولاً النقل لاستخدام هذه المكتبة لاستخدام cocoapods.
تعديل Cocoapods
يمكنك تعديل الاعتماديات الخاصة بالاشتراكات التعاونية في حزمة ML Kit على نظام التشغيل iOS في ملف Podfile الخاص بتطبيقك:
واجهة برمجة التطبيقات | أسماء المجموعات القديمة | أسماء المجموعات الجديدة |
---|---|---|
مسح الرمز الشريطي ضوئيًا | Firebase/MLVision Firebase/MLVisionBarcodeModel |
GoogleMLKit/BarcodeScanning |
التعرّف على الوجه | Firebase/MLVision Firebase/MLVisionFaceModel |
GoogleMLKit/FaceDetection |
تصنيف الصور | Firebase/MLVision Firebase/MLVisionLabelModel |
GoogleMLKit/ImageLabeling |
رصد العناصر وتتبُّعها | Firebase/MLVisionObjectDetection | GoogleMLKit/ObjectDetection |
التعرّف على النص | Firebase/MLVision Firebase/MLVisionTextModel |
GoogleMLKit/Textإدراك |
تصنيف الصور تلقائيًا باستخدام ميزة AutoML (نموذج مجمّع) | Firebase/MLVisionAutoML | GoogleMLKit/ImageLabelingCustom |
تصنيف صور AutoML (تنزيل النموذج من Firebase) | Firebase/MLVisionAutoML | GoogleMLKit/ImageLabelingCustom GoogleMLKit/LinkFirebase |
معرف اللغة | Firebase/MLNatralLanguage Firebase/MLNLLanguageID |
GoogleMLKit/LanguageID |
الرد السريع | Firebase/MLNatralLanguage Firebase/MLNLSmartReply |
GoogleMLKit/SmartReply |
ترجمة | Firebase/MLNatralLanguage Firebase/MLNLTranslation |
GoogleMLKit/الترجمة |
تعديل أسماء الفئات والتعدادات والأنواع
وبوجه عام، يجب إعادة تسمية الفئات والتعدادات والأنواع على النحو التالي:
- Swift: إزالة البادئة
Vision
من أسماء الفئات والتعدادات - الهدف-ج: استبدال كل من اسم الفئة
FIRVision
وFIR
وبادئات التعداد بحلولMLK
بالنسبة إلى بعض أسماء الفئات وأنواعها، لا تنطبق هذه القاعدة العامة:
Swift
الفئة أو النوع القديم | صف أو نوع جديد |
---|---|
AutoMLLocalModel | LocalModel |
AutoMLRemoteModel | CustomRemoteModel |
VisionBarcodeDetectionCallback | BarcodeScanningCallback |
VisionBarcodeDetector | BarcodeScanner |
VisionBarcodeDetectorOptions | BarcodeScannerOptions |
VisionImage | VisionImage (بدون تغيير) |
VisionPoint | VisionPoint (بدون تغيير) |
VisionOnDeviceAutoMLImageLabelerOptions | CustomImageLabelerOptions |
VisionOnDeviceImageLabelerOptions | ImageLabelerOptions |
Objective-C
الفئة أو النوع القديم | صف أو نوع جديد |
---|---|
FIRAutoMLLocalModel | MLKLocalModel |
FIRAutoMLRemoteModel | MLKCustomRemoteModel |
FIRVisionBarcodeDetectionCallback | MLKBarcodeScanningCallback |
FIRVisionBarcodeDetector | MLKBarcodeScanner |
FIRVisionBarcodeDetectorOptions | MLKBarcodeScannerOptions |
FIRVisionImage | MLKVisionImage |
FIRVisionOnDeviceAutoMLImageLabelerOptions | MLKCustomImageLabelerOptions |
FIRVisionOnDeviceImageLabelerOptions | MLKImageLabelerOptions |
FIRVisionPoint | MLKVisionPoint |
Objective-C
تعديل أسماء الطرق
عدِّل أسماء الطرق وفقًا للقواعد التالية:
لم تعُد فئات نقاط إدخال النطاق (
Vision
وNaturalLanguage
) متوفّرة. هم بفئات محددة للمهام. استبدال الاتصالات بأساليب المصنع المختلفة للحصول على أجهزة الرصد توجيه المكالمات إلى كل طريقة من طرق المصنع لكل كاشف.تمت إزالة الفئة
VisionImageMetadata
بالإضافة إلى تعدادVisionDetectorImageOrientation
استخدِم سمةorientation
VisionImage
لتحديد اتجاه عرض الصورة.إنّ طريقة
onDeviceTextRecognizer
التي تحصل على مثيلTextRecognizer
جديد تحتوي على تمت إعادة تسميته إلىtextRecognizer
.تمت إزالة خاصية الثقة من النص صفوف نتائج التعرّف، بما في ذلك
TextElement
وTextLine
وTextBlock
.الطريقتان
onDeviceImageLabeler
وonDeviceImageLabeler(options:)
للحصول على تم دمج مثيلImageLabeler
الجديد وإعادة تسميتهimageLabeler(options:)
تمت إزالة طريقة
objectDetector
للحصول على مثيلObjectDetector
جديد. يمكنك استخدامobjectDetector(options:)
كبديل.تمت إزالة السمة
type
منImageLabeler
تمت إزالة السمةentityID
من فئة نتائج تصنيف الصور،ImageLabel
.تمت إعادة تسمية واجهة برمجة تطبيقات مسح الرموز الشريطية
detect(in _:, completion:)
لتصبحprocess(_:, completion:)
ليتوافق مع واجهات برمجة تطبيقات الرؤية الأخرى.تستخدم واجهات برمجة التطبيقات للّغة الطبيعية الآن المصطلح "علامة اللغة" (كما هو محدد في BCP-47 standard) بدلاً من "رمز اللغة".
يستخدم
TranslateLanguage
الآن أسماء قابلة للقراءة (مثل .english) كجزء من ثوابته. بدلاً من علامات اللغة ( مثل .en).
في ما يلي بعض الأمثلة على طرق Swift القديمة والجديدة:
الإصدار القديم
let options = VisionOnDeviceImageLabelerOptions() options.confidenceThreshold = 0.75 let labeler = Vision.vision().onDeviceImageLabeler(options: options) let detector = Vision.vision().faceDetector(options: options) let localModel = AutoMLLocalModel(manifestPath: "automl/manifest.json") let options = VisionOnDeviceAutoMLImageLabelerOptions(localModel: localModel) options.confidenceThreshold = 0.75 let labeler = vision.onDeviceAutoMLImageLabeler(options: options) let detector = Vision.vision().objectDetector()
جديد
let options = ImageLabelerOptions() options.confidenceThreshold = NSNumber(value:0.75) let labeler = ImageLabeler.imageLabeler(options: options) let detector = FaceDetector.faceDetector(options: options) let localModel = LocalModel(manifestPath: "automl/manifest.json") let options = CustomImageLabelerOptions(localModel: localModel) options.confidenceThreshold = NSNumber(value:0.75) let labeler = ImageLabeler.imageLabeler(options: options) let detector = ObjectDetector.objectDetector(options: ObjectDetectorOptions())
وفي ما يلي بعض الأمثلة على طرق الهدف-ج القديمة والجديدة:
الإصدار القديم
FIRVisionOnDeviceImageLabelerOptions *options = [[FIRVisionOnDeviceImageLabelerOptions alloc] init]; options.confidenceThreshold = 0.75; FIRVisionImageLabeler *labeler = [[FIRVision vision] onDeviceImageLabelerWithOptions:options]; FIRVisionFaceDetector *detector = [[FIRVision vision] faceDetectorWithOptions: options]; FIRAutoMLLocalModel *localModel = [[FIRAutoMLLocalModel alloc] initWithManifestPath:@"automl/manifest.json"]; FIRVisionOnDeviceAutoMLImageLabelerOptions *options = [[FIRVisionOnDeviceAutoMLImageLabelerOptions alloc] initWithLocalModel: localModel]; options.confidenceThreshold = 0.75 FIRVisionImageLabeler *labeler = [[FIRVision vision] onDeviceAutoMLImageLabelerWithOptions:options]; FIRVisionObjectDetector *detector = [[FIRVision vision] objectDetector];
جديد
MLKImageLabelerOptions *options = [[MLKImageLabelerOptions alloc] init]; options.confidenceThreshold = @(0.75); MLKImageLabeler *labeler = [MLKImageLabeler imageLabelerWithOptions:options]; MLKFaceDetector *detector = [MLKFaceDetector faceDetectorWithOptions:options]; MLKLocalModel *localModel = [[MLKLocalModel alloc] initWithManifestPath:@"automl/manifest.json"]; MLKCustomImageLabelerOptions *options = [[MLKCustomImageLabelerOptions alloc] initWithLocalModel:localModel]; options.confidenceThreshold = @(0.75) MLKImageLabeler *labeler = [MLKImageLabeler imageLabelerWithOptions:options]; MLKObjectDetectorOptions *options = [[MLKObjectDetectorOptions alloc] init]; MLKObjectDetector *detector = [MLKObjectDetector objectDetectorWithOptions:options];
التغييرات الخاصة بواجهة برمجة التطبيقات
رصد العناصر وتتبُّعها
إذا كان تطبيقك يستخدم تصنيف الكائنات، يُرجى العلم بأنّ حزمة تطوير البرامج (SDK) الجديدة قد تغيّرت. يؤدي إلى إرجاع فئة تصنيف الأجسام المرصودة.
يتم إرجاع VisionObjectCategory
في VisionObject
على أنّه text
في ObjectLabel
.
بدلاً من عدد صحيح. يتم تضمين جميع فئات السلاسل الممكنة في
تعداد DetectedObjectLabel
يُرجى العِلم أنّه تمت إزالة الفئة .unknown
. عندما تزداد الثقة في تصنيف
إذا كان الكائن منخفضًا، فإن المصنِّف لا يُرجع أي تسمية على الإطلاق.
فيما يلي مثال على رمز Swift القديم والجديد:
الإصدار القديم
if (object.classificationCategory == .food) { ... }
جديد
if let label = object.labels.first { if (label.text == DetectedObjectLabel.food.rawValue) { ... } } // or if let label = object.labels.first { if (label.index == DetectedObjectLabelIndex.food.rawValue) { ... } }
فيما يلي مثال لرمز الهدف-C القديم والجديد:
الإصدار القديم
if (object.classificationCategory == FIRVisionObjectCategoryFood) { ... }
جديد
if ([object.labels[0].text isEqualToString:MLKDetectedObjectLabelFood]) { ... } // or if ([object.labels[0].index == MLKDetectedObjectLabelIndexFood]) { ... }
إزالة اعتماديات Firebase (اختياري)
لا تنطبق هذه الخطوة إلا عند استيفاء الشروط التالية:
- إنّ حزمة تعلُّم الآلة من Firebase هي المكوّن الوحيد الذي تستخدمه في Firebase.
- استخدام واجهات برمجة التطبيقات على الجهاز فقط
- لا تستخدم نموذج عرض
في هذه الحالة، يمكنك إزالة تبعيات Firebase بعد نقل البيانات. اتبع الخطوات التالية:
- أزِل ملف إعداد Firebase من خلال حذف GoogleService-Info.plist. ملف من دليل التطبيق ومشروع Xcode.
- أزِل أي ملف cocoapod في Firebase، مثل
pod 'Firebase/Analytics'
، من Podfile. - أزِل أي إعداد لتطبيق Firebase، مثل
FirebaseApp.configure()
، من الرمز. - احذف تطبيقك في Firebase من "وحدة تحكُّم Firebase" حسب التعليمات على الموقع الإلكتروني لدعم Firebase.
الحصول على المساعدة
إذا واجهت أيّ مشاكل، يُرجى الاطّلاع على صفحة المنتدى حيث نوضّح القنوات المتاحة للتواصل معنا.