Migration für iOS

Methodennamen aktualisieren

Aktualisieren Sie die Methodennamen gemäß diesen Regeln:

• Die Einstiegspunktklassen für Domains (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 Ausrichtung eines Bildes anzugeben.

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

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

• Die onDeviceImageLabeler und onDeviceImageLabeler(options:) Methoden 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 type Attribut wurde aus ImageLabeler entfernt und das entityID Attribut aus der Ergebnisklasse für die Bildlabeling, ImageLabel.

• Die Barcode-Scanning-API detect(in _:, completion:) wurde in process(_:, completion:) umbenannt, um sie an andere Vision APIs anzugleichen.

• Die Natural Language APIs verwenden jetzt den Begriff „Sprach-Tag“ (gemäß dem BCP-47-Standard) anstelle von „Sprachcode“.

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

Hier 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 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. Alle möglichen Stringkategorien sind im Enum DetectedObjectLabel 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 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 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 (optional)

Dieser Schritt gilt nur, wenn die folgenden Bedingungen erfüllt sind:

• Firebase ML Kit ist die einzige Firebase-Komponente, die Sie verwenden.
• Sie verwenden nur APIs auf dem Gerät.
• Sie verwenden keine Modellbereitstellung.

In diesem Fall können Sie Firebase-Abhängigkeiten nach der Migration entfernen. 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, z. B. pod 'Firebase/Analytics', aus der Podfile-Datei.
• Entfernen Sie alle FirebaseApp-Initialisierungen, z. B. 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 Probleme finden Sie auf unserer Community-Seite weitere Informationen dazu, wie Sie uns kontaktieren können.