Problemas conhecidos
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Problemas com o Android
- Para o ID de idioma agrupado, o app pode falhar ao fazer upgrade para o AGP 7.0.0 ou mais recente.
Para evitar a falha em
com.google.mlkit:language-id:16.1.1 ou versões anteriores, inclua a regra abaixo:
-keep class com.google.mlkit.nl.languageid.internal.LanguageIdentificationJni { *; }
Para evitar a falha em com.google.mlkit:language-id:17.0.0 ou com.google.mlkit:language-id:17.0.1, inclua a regra abaixo:
-keep class com.google.mlkit.nl.languageid.internal.ThickLanguageIdentifier { *; }
- A InputImage construída por Bitmap com um rotationDegrees diferente de zero causa uma
MlKitException de "rotação inválida" para a API FaceDetection desde
com.google.mlkit:face-detection:16.0.5
e com.google.android.gms:play-services-mlkit-barcode-scanning:16.1.4. Use uma versão
anterior e aguarde a próxima versão, que inclui a correção para esse problema.
Os SDKs de leitura de código de barras foram alterados para com.google.mlkit:barcode-scanning:16.1.0
e com.google.android.gms:play-services-mlkit-barcode-scanning:16.1.3
e não funcionam em alguns dispositivos com a versão camera-camera2:1.0.0-beta08 ou mais recente.
Você pode usar uma versão anterior do camera-camera2 para contornar esse problema. Exemplo:
implementation "androidx.camera:camera-core:1.0.0-beta07"
implementation "androidx.camera:camera-camera2:1.0.0-beta07"
implementation "androidx.camera:camera-view:1.0.0-alpha14"
implementation "androidx.camera:camera-extensions:1.0.0-alpha14"
implementation "androidx.camera:camera-lifecycle:1.0.0-beta07"
Os métodos nativos podem ser ofuscados por regras personalizadas no com.google.mlkit:language-id:16.1.1 ou versões anteriores.
Inclua a seguinte regra para manter os dados se você encontrar erros como java.lang.UnsatisfiedLinkError:
-keepclasseswithmembernames class com.google.mlkit.nl.languageid.internal.LanguageIdentificationJni {
native <methods>;
}Para as APIs de reconhecimento de texto, rotulagem de imagem e detecção e
rastreamento de objetos, o desempenho com o CameraX e o Camera2 ainda não está no mesmo nível
do Camera1, porque leva mais tempo para fazer a conversão de formato de imagem
com o CameraX e o Camera2.
Os callbacks de tarefa
podem ser executados depois que a atividade ou o fragmento em que foram
registrados foram destruídos. Isso pode levar a uma exceção se o callback
tentar acessar um detector que foi fechado nesse meio tempo. Se você
estiver usando o ML Kit em uma atividade, poderá registrar um
listener no escopo da atividade,
que será removido automaticamente quando a atividade for interrompida. Se você
estiver usando o ML Kit em um fragmento ou outro ambiente, poderá fornecer um executor
personalizado que encerra a execução quando o fragmento é destruído. Consulte
ScopedExecutor.Java no Guia de início rápido da Vision para conferir um
exemplo.
Para a rotulagem de imagens com formatos de imagem diferentes de bitmap, a variante agrupada
tem melhor desempenho do que a variante "slim", que depende do Google Play Services.
Para tinta digital com.google.mlkit:digital-ink-recognition:17.0.0 ou versões anteriores
e extração de entidade com.google.mlkit:entity-extraction:16.0.0-beta2 ou versões anteriores,
você vai receber a seguinte exceção de execução se definir targetSdkVersion como 31
e executar no Android S.
Targeting S+ (version 31 and above) requires that one of FLAG_IMMUTABLE or FLAG_MUTABLE be specified when creating a PendingIntent.
AndroidRuntime: Strongly consider using FLAG_IMMUTABLE, only use FLAG_MUTABLE if some functionality depends on the PendingIntent being mutable, e.g. if it needs to be used with inline replies or bubbles.
Esse problema foi corrigido nas versões mais recentes.
Se você preferir usar versões mais antigas, defina targetSdkVersion como
menos de 31 ou adicione o seguinte à build.gradle como solução alternativa.
// For apps targeting Android S+, add the following
constraints {
implementation 'androidx.work:work-runtime:2.7.0-alpha04'
}
Problemas com o iOS
- Não há suporte para simuladores em Macs com M1.
- O simulador X86_64 não tem suporte para a tradução
'GoogleMLKit/Translate', '4.0.0' ou mais recente e a resposta inteligente 'GoogleMLKit/SmartReply', '4.0.0' ou mais recente.
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-08-29 UTC.
[null,null,["Última atualização 2025-08-29 UTC."],[[["\u003cp\u003eUpgrading to AGP 7.0.0+ with bundled Language ID may cause crashes, requiring specific keep rules to be added for different versions.\u003c/p\u003e\n"],["\u003cp\u003eInputImage created with Bitmap and rotationDegrees may cause errors with FaceDetection API in specific versions; use earlier versions or await a fix.\u003c/p\u003e\n"],["\u003cp\u003eBarcodeScanning SDKs before 16.1.0/16.1.3 have compatibility issues with camera-camera2:1.0.0-beta08+, consider using earlier camera-camera2 versions.\u003c/p\u003e\n"],["\u003cp\u003eTask callbacks may execute after Activity/Fragment destruction, potentially causing exceptions; use Activity-scoped listeners or custom executors for mitigation.\u003c/p\u003e\n"],["\u003cp\u003eOn Android S with targetSdkVersion 31, Digital Ink and Entity Extraction SDKs before specific versions may cause runtime exceptions regarding PendingIntent flags; upgrade to newer SDKs or apply a workaround.\u003c/p\u003e\n"]]],["Key actions and information regarding Android issues include: adding specific `-keep` rules to avoid crashes when using Language ID with AGP 7.0.0 or later; using earlier versions of Face Detection and Barcode Scanning due to \"invalid rotation\" and camera compatibility issues; adding a rule to fix `UnsatisfiedLinkError` with Language ID. Performance with CameraX/Camera2 is not optimized for Text Recognition, Image Labeling, and Object Detection. Activity-scoped listeners can be registered to prevent exceptions with Task callbacks. Setting `targetSdkVersion` or adding constraints to address Digital Ink and Entity Extraction issues.\n"],null,["Android issues\n\n- For bundled Language ID, the app may crash when upgrading to AGP 7.0.0 or later. To avoid the crash in `com.google.mlkit:language-id:16.1.1` or earlier, include the rule below: \n\n ```scdoc\n -keep class com.google.mlkit.nl.languageid.internal.LanguageIdentificationJni { *; }\n ```\n To avoid the crash in `com.google.mlkit:language-id:17.0.0` or `com.google.mlkit:language-id:17.0.1`, include the rule below: \n\n ```scdoc\n -keep class com.google.mlkit.nl.languageid.internal.ThickLanguageIdentifier { *; }\n ```\n- InputImage constructed by Bitmap with a non zero rotationDegrees causes an \"invalid rotation\" MlKitException for FaceDetection API since `com.google.mlkit:face-detection:16.0.5` and `com.google.android.gms:play-services-mlkit-barcode-scanning:16.1.4`. Please use an earlier version and wait for our next release which includes the fix for this issue.\n- BarcodeScanning SDKs pior to `com.google.mlkit:barcode-scanning:16.1.0`\n and `com.google.android.gms:play-services-mlkit-barcode-scanning:16.1.3`\n do not work on some devices running with camera-camera2:1.0.0-beta08 version or later.\n You can use an earlier version of camera-camera2 to bypass this issue. For example:\n\n ```carbon\n implementation \"androidx.camera:camera-core:1.0.0-beta07\"\n implementation \"androidx.camera:camera-camera2:1.0.0-beta07\"\n implementation \"androidx.camera:camera-view:1.0.0-alpha14\"\n implementation \"androidx.camera:camera-extensions:1.0.0-alpha14\"\n implementation \"androidx.camera:camera-lifecycle:1.0.0-beta07\"\n ```\n\n \u003cbr /\u003e\n\n- Native methods might be obfuscated by custom rules in `com.google.mlkit:language-id:16.1.1` or earlier.\n Include the following rule to keep them if you encounter errors like `java.lang.UnsatisfiedLinkError`:\n\n ```text\n -keepclasseswithmembernames class com.google.mlkit.nl.languageid.internal.LanguageIdentificationJni {\n native \u003cmethods\u003e;\n }\n ```\n\n \u003cbr /\u003e\n\n- For the Text Recognition, Image Labeling, and Object Detection and\n Tracking APIs, the performance with CameraX and Camera2 is still not on par\n with Camera1, because it takes more time to do format conversion for image\n from CameraX and Camera2.\n\n- [Task](https://developers.google.com/android/guides/tasks)\n callbacks might execute after the Activity or Fragment in which they have been\n registered has been destroyed. This might lead to an exception if the callback\n tries to access a detector that has been closed in the meantime. If you are\n using ML Kit in an Activity, you can register an\n [Activity-scoped listener](https://developers.google.com/android/guides/tasks#activity-scoped_listeners),\n which is automatically removed when the Activity is stopped. If you are\n using ML Kit in a Fragment or other environment, you can provide a custom\n executor that shuts down execution when the Fragment is destroyed. See\n `ScopedExecutor.Java` in the [Vision Quickstart](https://github.com/googlesamples/mlkit/tree/master/android/vision-quickstart) for an\n example.\n\n- For Image Labeling with image formats other than Bitmap, bundled variant\n has better performance than \"thin\" variant that depends on Google Play Services.\n\n- For Digital Ink `com.google.mlkit:digital-ink-recognition:17.0.0` or earlier\n and Entity Extraction `com.google.mlkit:entity-extraction:16.0.0-beta2` or earlier,\n you will get the following runtime exception if you set `targetSdkVersion` to 31\n and run on Android S.\n\n Targeting S+ (version 31 and above) requires that one of FLAG_IMMUTABLE or FLAG_MUTABLE be specified when creating a PendingIntent.\n AndroidRuntime: Strongly consider using FLAG_IMMUTABLE, only use FLAG_MUTABLE if some functionality depends on the PendingIntent being mutable, e.g. if it needs to be used with inline replies or bubbles.\n\n This issue is fixed in our more recent releases.\n\n \u003cbr /\u003e\n\n If you prefer using older versions, you can either set `targetSdkVersion` to\n less than 31 or add the following to your `build.gradle` as a workaround. \n\n ```carbon\n // For apps targeting Android S+, add the following\n constraints {\n implementation 'androidx.work:work-runtime:2.7.0-alpha04'\n }\n ```\n\n \u003cbr /\u003e\n\niOS issues\n\n- Simulators on M1-based Mac are not supported.\n- X86_64 simulator is not supported for Translation `'GoogleMLKit/Translate', '4.0.0'` or later and Smart Reply `'GoogleMLKit/SmartReply', '4.0.0'` or later."]]
