ML Kit-Modellinstallationspfade unter Android
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Alle ML Kit-Funktionen nutzen standardmäßig von Google trainierte Modelle für maschinelles Lernen (sogenannte Basismodelle). Dieser Leitfaden gilt nur für Basismodelle. Weitere Informationen zu benutzerdefinierten Modellen
Es gibt drei Möglichkeiten, Modelle in ML Kit APIs zu installieren:
- Nicht gekoppelt:Modelle werden über die Google Play-Dienste heruntergeladen und verwaltet.
- Im Bundle:Modelle sind zur Buildzeit statisch mit Ihrer App verknüpft.
- Dynamisch heruntergeladen:Modelle werden bei Bedarf heruntergeladen.
Unterstützte Installationspfade für jede API
In der folgenden Tabelle sehen Sie, welche Installationspfade für Modelle von den einzelnen ML Kit-Funktionen unterstützt werden:
API-spezifische Anleitungen zeigen, welche Installationsoptionen für die jeweilige API verfügbar sind.
Wichtige Unterschiede zwischen den Installationsoptionen
|
|
Nicht in Paketen enthalten
|
Im Set
|
Dynamisch heruntergeladen
|
| Wo werden Modelle gespeichert?
|
Befindet sich in den Google Play-Diensten und wird nicht auf den Speicherplatz angerechnet, der von dieser App verwendet wird
|
Nach der Installation im app-spezifischen Speicher gespeichert
|
Nach dem Modelldownload im appspezifischen Speicher gespeichert
|
| Wie wirkt sich die Modellgröße auf die App-Größe aus?
|
Sie tragen nicht zur App-Größe bei.
|
trägt direkt zur App-Größe bei
|
Trägt nicht zur App-Größe bei, erhöht aber den app-spezifischen Speicherplatz
|
| Wann werden Modelle aktualisiert?
|
Wird automatisch aktualisiert, wenn eine neuere Version veröffentlicht wird
|
App aktualisieren, um Modell zu aktualisieren
|
App aktualisieren, um Modell zu aktualisieren
|
| Wann werden Modelle heruntergeladen?
|
Modelle müssen vor der Verwendung heruntergeladen werden.
|
Alle Modelle und Funktionen sind bei der Installation der App enthalten und können sofort verwendet werden.
|
Downloads, Aktualisierungen und Löschvorgänge von Modellen müssen manuell mit der RemoteModelManager API verwaltet werden.
|
| Wann werden Modelle vom Gerät entfernt?
|
Das Modell wird von Google Play-Diensten nur aus dem Speicher entfernt, wenn alle Apps deinstalliert wurden, die vom Modell abhängig sind.
|
Modelle werden aus dem app-spezifischen Speicher entfernt, wenn die App deinstalliert wird.
|
Heruntergeladene Modelle werden aus dem app-spezifischen Speicher entfernt, wenn die App deinstalliert wird.
|
Zwischen Paket und Einzelkauf wählen
Wenn eine API sowohl die Installationsoptionen für die Bündelung als auch für die eigenständige Installation unterstützt:
Verwenden Sie die Option „Im Paket“, wenn Sie Folgendes priorisieren:
- Vollständige Funktion der Funktion sofort nach der App-Installation
- Funktionsfähigkeit der Funktionen ohne Netzwerkverbindung nach der App-Installation
Verwenden Sie die Option „Nicht im Paket“ für Folgendes:
- Kleinere App-Größe
- Automatische Modellupdates durch Google Play-Dienste
Modelle herunterladen
Wenn Sie die Option „Unverbundenes Modell“ verwenden, können Sie angeben, wie Modelle auf das Gerät heruntergeladen werden sollen:
Sie können Modeldownloads bei der Installation aktivieren, indem Sie der AndroidManifest.xml-Datei Ihrer App eine Erklärung hinzufügen. Im folgenden Code-Snippet wird beispielsweise gezeigt, wie Sie Ihre App so konfigurieren, dass das Barcode-Scan-Modell automatisch heruntergeladen wird, nachdem Ihre App aus dem Play Store installiert wurde:
<application ...>
...
<meta-data
android:name="com.google.mlkit.vision.DEPENDENCIES"
android:value="barcode" >
<!-- To use multiple models: android:value="barcode,model2,model3" -->
</application>
Sie können den expliziten Download über die Google Play Services ModuleInstallClient API anfordern.
Wenn Sie den Download von Modellen bei der Installation nicht aktivieren oder einen expliziten Download anfordern, wird das Modell beim ersten Ausführen der Funktion heruntergeladen.
Bis der Download abgeschlossen ist, schlagen Inferenzanfragen fehl.
Modelle aktualisieren
So aktualisieren Sie Ihre Modelle, wenn Sie das Paketmodell oder die Option für dynamisch heruntergeladene Modelle verwenden:
Aktualisieren Sie die Gradle-Datei Ihrer App, um die neueste Clientbibliothek für ML Kit-Funktionen zu verwenden.
dependencies {
implementation 'com.google.mlkit:barcode-scanning: 17.3.0' // The latest version number of the API
}
Erstellen Sie Ihre App neu.
Warum einige APIs dynamisch heruntergeladene Modelle anbieten
Einige ML Kit APIs haben zu viele Modelloptionen, um sie zu bündeln. Die Erkennung digitaler Eingaben unterstützt beispielsweise über 300 Sprachen. Es ist nicht immer erforderlich, bei der Installation alle Sprachen in die Funktion aufzunehmen.
Dazu bieten wir die dritte Installationsoption an, bei der Modelle nach der Installation auf Anfrage heruntergeladen werden. Derzeit ist diese Option nur für die Erkennung digitaler Handschriften, die Übersetzung und die Entitätsextraktion verfügbar.
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-08-29 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-08-29 (UTC)."],[[["\u003cp\u003eML Kit features utilize Google-trained machine learning models, offering three installation options: unbundled, bundled, and dynamically downloaded.\u003c/p\u003e\n"],["\u003cp\u003eUnbundled models are downloaded via Google Play Services, while bundled models are included in the app, and dynamically downloaded models are fetched on demand.\u003c/p\u003e\n"],["\u003cp\u003eChoosing between bundled and unbundled models depends on priorities: bundled for immediate functionality, unbundled for smaller app size and automatic updates.\u003c/p\u003e\n"],["\u003cp\u003eModels can be downloaded at install time, explicitly requested, or downloaded on first use, and updates for bundled or dynamically downloaded models require app updates.\u003c/p\u003e\n"],["\u003cp\u003eDynamically downloaded models are offered for APIs with extensive model options, such as Digital Ink Recognition and Translation, to avoid bundling all possibilities.\u003c/p\u003e\n"]]],[],null,["All ML Kit features make use of Google-trained machine learning models (known as\nbase models) by default. This guide is only applicable to base models. [See here\nfor guidance on custom models.](/ml-kit/custom-models)\n\nModels in ML Kit APIs can be installed in one of three ways:\n\n1. **Unbundled:** Models are downloaded and managed via Google Play Services.\n2. **Bundled:** Models are statically linked to your app at build time.\n3. **Dynamically downloaded:** Models are downloaded on demand.\n\nSupported installation paths for each API\n\nThe table below shows which model installation paths are supported by each ML\nKit feature:\n\n|---------------------------------------------------------------------------|---------------|-------------|----------------------------|\n| | **Unbundled** | **Bundled** | **Dynamically downloaded** |\n| [Text recognition v2](/ml-kit/vision/text-recognition/v2/android) | ✅ | ✅ | |\n| [Face detection](/ml-kit/vision/face-detection/android) | ✅ | ✅ | |\n| [Face mesh detection](/ml-kit/vision/face-mesh-detection/android) | | ✅ | |\n| [Pose detection](/ml-kit/vision/pose-detection/android) | | ✅ | |\n| [Selfie segmentation](/ml-kit/vision/selfie-segmentation/android) | | ✅ | |\n| [Barcode scanning](/ml-kit/vision/barcode-scanning/android) | ✅ | ✅ | |\n| [Image labeling](/ml-kit/vision/image-labeling/android) | ✅ | ✅ | |\n| [Object detection and tracking](/ml-kit/vision/object-detection/android) | | ✅ | |\n| [Digital ink recognition](/ml-kit/vision/digital-ink-recognition/android) | | | ✅ |\n| [Document scanner](/ml-kit/vision/doc-scanner) | ✅ | | |\n| [Subject segmentation](/ml-kit/vision/subject-segmentation/android) | ✅ | | |\n| [Google code scanner](/ml-kit/code-scanner) | ✅ | | |\n| [Language identification](/ml-kit/language/identification/android) | ✅ | ✅ | |\n| [Translation](/ml-kit/language/translation/android) | | | ✅ |\n| [Smart Reply](/ml-kit/language/smart-reply/android) | ✅ | ✅ | |\n| [Entity Extraction](/ml-kit/language/entity-extraction/android) | | | ✅ |\n\nAPI-specific guides show which installation options are available for the given\nAPI.\n\nKey differences between installation options\n\n|----------------------------------------------|-------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| | **Unbundled** | **Bundled** | **Dynamically downloaded** |\n| **Where are models stored?** | Resides in Google Play Services and is not counted towards the storage used by this app | Saved in [app-specific storage](https://developer.android.com/training/data-storage/app-specific) after installation | Saved in [app-specific storage](https://developer.android.com/training/data-storage/app-specific) after model download |\n| **How does model size affect app size?** | Does not contribute to app size | Directly contributes to app size | Does not contribute to app size but increase the [app-specific storage](https://developer.android.com/training/data-storage/app-specific) |\n| **When are models updated?** | Automatically updated when a newer version is released | [Need to update the app to update model](#update-model) | [Need to update the app to update model](#update-model) |\n| **When are models downloaded?** | [Models must be downloaded before use](#download-models) | All models and features are included when the app is installed, so are usable immediately | Model downloads, updates, and deletions must be managed manually using the [RemoteModelManager](/android/reference/com/google/mlkit/common/model/RemoteModelManager) API |\n| **When are models removed from the device?** | Google Play Services will only remove the model from storage if all apps that depend on the model are uninstalled | Models are removed from [app-specific storage](https://developer.android.com/training/data-storage/app-specific) when the app is uninstalled | Downloaded models are removed from [app-specific storage](https://developer.android.com/training/data-storage/app-specific) when the app is uninstalled |\n\nHow to choose between bundled and unbundled\n\nIf an API supports both the bundled and unbundled installation options:\n\n- Use the bundled option if you prioritize:\n\n - Complete feature functionality immediately after app installation\n - Feature functionality without network connection after app installation\n- Use the unbundled option if you prioritize:\n\n - Smaller app size\n - Automated model updates by Google Play Services\n\nHow to download models\n\nWhen using the unbundled model option, you can specify how you want models to be\ndownloaded to the device:\n\n- You can enable **install-time model downloads** by adding a declaration to\n your app's `AndroidManifest.xml` file. For example, the code snippet below\n shows how to configure your app to automatically download the Barcode\n Scanning model after your app is installed from the Play Store:\n\n \u003capplication ...\u003e\n ...\n \u003cmeta-data\n android:name=\"com.google.mlkit.vision.DEPENDENCIES\"\n android:value=\"barcode\" \u003e\n \u003c!-- To use multiple models: android:value=\"barcode,model2,model3\" --\u003e\n \u003c/application\u003e\n\n- You can **request explicit download** through Google Play Services\n [ModuleInstallClient API](/android/guides/module-install-apis).\n\n- If you don't enable install-time model downloads or request explicit\n download, the model will be downloaded the first time you run the feature.\n Until the download is completed, inference requests will fail.\n\nHow to update models\n\nTo update your models when using the bundled model or the dynamically downloaded\nmodels option:\n\n1. Update your app's gradle file to use the latest ML Kit feature client\n library.\n\n dependencies {\n implementation 'com.google.mlkit:barcode-scanning: 17.3.0' // The latest version number of the API\n }\n\n2. Rebuild your app.\n\nWhy some APIs offer dynamically downloaded models\n\nSome ML Kit API have too many model options to bundle. For example, [Digital ink\nrecognition](/ml-kit/vision/digital-ink-recognition) supports [300+\nlanguages](/ml-kit/vision/digital-ink-recognition/base-models), and it's not\nalways necessary to put every language inside the feature during installation.\nFor that purpose, we provide the third installation option, in which models are\ndownloaded on demand after installation. Currently, only [Digital ink\nrecognition](/ml-kit/vision/digital-ink-recognition),\n[Translation](/ml-kit/language/translation) and [Entity\nextraction](/ml-kit/language/entity-extraction) have this option."]]
