iOS için taşıma

Bu kılavuzda, iOS için Firebase'de ML Kit'ten nasıl geçiş yapılacağı açıklanmaktadır.

Ön koşullar

Kodunuzu taşımaya başlamadan önce aşağıdaki koşulları karşıladığınızdan emin olun:

• ML Kit, Xcode 13.2.1 veya sonraki sürümleri destekler.
• ML Kiti, iOS 15.5 veya sonraki sürümleri destekler.
• ML Kiti, 32 bit mimarileri (i386 ve armv7) desteklemez. ML Kit, 64 bit mimarileri (x86_64 ve arm64) destekler.
• ML Kit kitaplığı yalnızca cocoapods olarak sağlanır. Framework'leri ve Cocoapods'i birlikte kullanamazsınız. Bu nedenle, bu kitaplığı kullanmak için önce Cocoapods'e geçmeniz gerekir.

Cocoapods'u güncelleme

Uygulamanızın Podfile'ında ML Kit iOS cocoapods'larının bağımlılıklarını güncelleyin:

Sınıfların, numaralandırılmış türlerin ve türlerin adlarını güncelleme

Genel olarak sınıfların, numaralandırmaların ve türlerin aşağıdaki şekilde yeniden adlandırılması gerekir:

• Swift: Sınıf adlarından ve numaralandırmalardan Vision önekini kaldırın
• Objective-C: Hem FIRVision hem de FIR sınıf adını ve enum öneklerini MLK ile değiştirin.

Bazı sınıf adları ve türleri için bu genel kural geçerli değildir:

Yöntem adlarını güncelleme

Yöntem adlarını şu kurallara göre güncelleyin:

• Alan adı giriş noktası sınıfları (Vision, NaturalLanguage) artık mevcut değil. Bu sınıfların yerini göreve özel sınıflar aldı. Algılayıcıları almak için çeşitli fabrika yöntemlerine yapılan çağrıları, her algılayıcının fabrika yöntemine yapılan doğrudan çağrılarla değiştirin.

• VisionImageMetadata sınıfı, VisionDetectorImageOrientation enum'u ile birlikte kaldırıldı. Bir resmin görüntüleme yönünü belirtmek için VisionImage öğesinin orientation özelliğini kullanın.

• Yeni bir TextRecognizer örneği alan onDeviceTextRecognizer yöntemi, textRecognizer olarak yeniden adlandırıldı.

• Güven özelliği, TextElement, TextLine ve TextBlock dahil olmak üzere metin tanıma sonucu sınıflarından kaldırıldı.

• Yeni bir ImageLabeler örneği almak için kullanılan onDeviceImageLabeler ve onDeviceImageLabeler(options:) yöntemleri birleştirilerek imageLabeler(options:) olarak yeniden adlandırıldı.

• Yeni bir ObjectDetector örneği almak için kullanılan objectDetector yöntemi kaldırıldı. Bunun yerine objectDetector(options:) politikasını kullanın.

• type özelliği, ImageLabeler öğesinden kaldırıldı. entityID özelliği ise görsel etiketleme sonucu sınıfı ImageLabel öğesinden kaldırıldı.

• Barkod tarama API'si detect(in _:, completion:), diğer Vision API'leriyle tutarlı olması için process(_:, completion:) olarak yeniden adlandırıldı.

• Natural Language API'leri artık "dil kodu" yerine "dil etiketi" (BCP-47 standardında tanımlandığı şekliyle) terimini kullanıyor.

• TranslateLanguage artık sabitleri için dil etiketleri (ör. .en) yerine okunabilir adlar (ör. .english) kullanıyor.

Eski ve yeni Swift yöntemlerine dair bazı örnekler:

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

Eski ve yeni Objective-C yöntemlerine dair bazı örnekleri aşağıda bulabilirsiniz:

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'ye özgü değişiklikler

Nesne algılama ve izleme

Uygulamanızda nesne sınıflandırması kullanılıyorsa yeni SDK'nın, algılanan nesneler için sınıflandırma kategorisini döndürme şeklini değiştirdiğini unutmayın.

VisionObject içindeki VisionObjectCategory, tam sayı yerine ObjectLabel nesnesinde text olarak döndürülür. Olası tüm dize kategorileri DetectedObjectLabel enum'una dahil edilir.

.unknown kategorisinin kaldırıldığını unutmayın. Bir nesnenin sınıflandırılmasıyla ilgili güven düzeyi düşük olduğunda sınıflandırıcı hiçbir etiket döndürmez.

Eski ve yeni SWIFT kodu örneğini aşağıda bulabilirsiniz:

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

Eski ve yeni Objective-C koduna ilişkin bir örneği aşağıda bulabilirsiniz:

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

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

Firebase bağımlılıklarını kaldırma

Taşıma işleminden sonra Firebase bağımlılıklarını kaldırın. Şu adımları uygulayın:

• Firebase yapılandırma dosyasını, uygulamanızın dizinindeki ve Xcode projenizdeki GoogleService-Info.plist dosyasını silerek kaldırın.
• Podfile'ınızdan pod 'Firebase/Analytics' gibi Firebase cocoapod'larını kaldırın.
• Kodunuzdan FirebaseApp.configure() gibi FirebaseApp başlatma işlemlerini kaldırın.
• Firebase destek sitesindeki talimatlara göre Firebase konsolunda Firebase uygulamanızı silin.

Yardım Alma

Herhangi bir sorunla karşılaşırsanız lütfen topluluk sayfamıza göz atın. Bu sayfada, bizimle iletişime geçebileceğiniz kanallar açıklanmaktadır.