Migration für iOS

In diesem Leitfaden wird erläutert, wie Sie von ML Kit für Firebase für iOS migrieren.

Vorbereitung

Bevor Sie mit der Migration Ihres Codes beginnen, müssen die folgenden Anforderungen erfüllt sein:

• ML Kit unterstützt Xcode 13.2.1 oder höher.
• ML Kit unterstützt iOS-Versionen ab 15.5.
• ML Kit unterstützt keine 32-Bit-Architekturen (i386 und armv7). ML Kit unterstützt 64-Bit-Architekturen (x86_64 und arm64).
• Die ML Kit-Bibliothek wird nur als Cocoapods bereitgestellt. Frameworks und CocoaPods können nicht kombiniert werden. Wenn Sie diese Bibliothek verwenden möchten, müssen Sie zuerst zu CocoaPods migrieren.

CocoaPods aktualisieren

Aktualisieren Sie die Abhängigkeiten für die ML Kit-iOS-CocoaPods in der Podfile-Datei Ihrer App:

Namen von Klassen, Enums und Typen aktualisieren

Im Allgemeinen müssen Klassen, Enums und Typen so umbenannt werden:

• Swift: Entfernen Sie das Präfix Vision aus Klassennamen und Enums.
• Objective-C: Ersetzen Sie die Klassennamen- und Enum-Präfixe FIRVision und FIR durch MLK.

Für einige Klassennamen und ‑typen gilt diese allgemeine Regel nicht:

Methodennamen aktualisieren

Aktualisieren Sie Methodennamen gemäß den folgenden Regeln:

• Die Domain-Einstiegspunktklassen (Vision, NaturalLanguage) sind nicht mehr vorhanden. Sie wurden durch aufgabenspezifische Klassen ersetzt. Ersetzen Sie Aufrufe der verschiedenen Factory-Methoden zum Abrufen von Detektoren durch direkte Aufrufe der Factory-Methode des jeweiligen Detektors.

• Die Klasse VisionImageMetadata wurde zusammen mit dem Enum VisionDetectorImageOrientation entfernt. Verwenden Sie das Attribut orientation von VisionImage, um die Anzeigeausrichtung eines Bildes anzugeben.

• Die Methode onDeviceTextRecognizer, die eine neue TextRecognizer-Instanz abruft, wurde in textRecognizer umbenannt.

• Das Attribut „confidence“ wurde aus den Ergebnisklassen der Texterkennung entfernt, einschließlich TextElement, TextLine und TextBlock.

• Die Methoden onDeviceImageLabeler und onDeviceImageLabeler(options:) zum Abrufen einer neuen ImageLabeler-Instanz wurden zusammengeführt und in imageLabeler(options:) umbenannt.

• Die Methode objectDetector zum Abrufen einer neuen ObjectDetector-Instanz wurde entfernt. Verwenden Sie stattdessen objectDetector(options:).

• Das Attribut type wurde aus ImageLabeler und das Attribut entityID aus der Ergebnisklasse für die Bildlabelerstellung, ImageLabel, entfernt.

• Die Barcode-Scanning-API detect(in _:, completion:) wurde in process(_:, completion:) umbenannt, um mit anderen Vision APIs konsistent zu sein.

• Die Natural Language APIs verwenden jetzt den Begriff „Sprach-Tag“ (wie im BCP-47-Standard definiert) anstelle von „Sprachcode“.

• TranslateLanguage verwendet jetzt lesbare Namen (z. B. .english) für seine Konstanten anstelle von Sprach-Tags (z. B. .en).

Hier sind einige Beispiele für alte und neue Swift-Methoden:

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

Hier sind einige Beispiele für alte und neue Objective-C-Methoden:

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];
    

API-spezifische Änderungen

Objekterkennung und -tracking

Wenn Ihre App die Objektklassifizierung verwendet, sollten Sie beachten, dass sich die Art und Weise geändert hat, wie das neue SDK die Klassifizierungskategorie für erkannte Objekte zurückgibt.

VisionObjectCategory in VisionObject wird als text in einem ObjectLabel-Objekt anstelle einer Ganzzahl zurückgegeben. In der Aufzählung DetectedObjectLabel sind alle möglichen Stringkategorien enthalten.

Die Kategorie .unknown wurde entfernt. Wenn die Konfidenz bei der Klassifizierung eines Objekts niedrig ist, gibt der Klassifikator überhaupt kein Label zurück.

Hier ist ein Beispiel für den alten und neuen Swift-Code:

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

Hier ist ein Beispiel für den alten und neuen Objective-C-Code:

if (object.classificationCategory == FIRVisionObjectCategoryFood) {
    ...
}

if ([object.labels[0].text isEqualToString:MLKDetectedObjectLabelFood]) {
  ...
}
// or
if ([object.labels[0].index == MLKDetectedObjectLabelIndexFood]) {
  ...
}

Firebase-Abhängigkeiten entfernen

Entfernen Sie nach der Migration die Firebase-Abhängigkeiten. Gehen Sie so vor:

• Entfernen Sie die Firebase-Konfigurationsdatei, indem Sie die Datei GoogleService-Info.plist aus dem Verzeichnis Ihrer App und Ihrem Xcode-Projekt löschen.
• Entfernen Sie alle Firebase-Cocoapods wie pod 'Firebase/Analytics' aus Ihrem Podfile.
• Entfernen Sie alle FirebaseApp-Initialisierungen wie FirebaseApp.configure() aus Ihrem Code.
• Löschen Sie Ihre Firebase-App in der Firebase Console gemäß der Anleitung auf der Firebase-Supportwebsite.

Hilfe erhalten

Bei Problemen finden Sie auf unserer Community-Seite weitere Informationen dazu, wie Sie uns kontaktieren können.