APIs unter Android 5.0

API-Level: 21

Android 5.0 (LOLLIPOP) bietet neue Funktionen für Nutzer und App-Entwickler. In diesem Dokument werden die wichtigsten neuen APIs vorgestellt.

Wenn du eine veröffentlichte App hast, solltest du dir die Verhaltensänderungen in Android 5.0 ansehen, die du in deiner App berücksichtigen solltest. Diese Verhaltensänderungen können sich auf deine App auf Android 5.0-Geräten auswirken, auch wenn du keine neuen APIs verwendest oder keine neuen Funktionen nutzt.

Einen allgemeinen Überblick über die neuen Plattformfunktionen finden Sie unter Highlights von Android Lollipop.

Hier geht es los

Wenn Sie Apps für Android 5.0 entwickeln möchten, müssen Sie zuerst das Android SDK herunterladen. Verwenden Sie dann den SDK-Manager, um die Android 5.0-SDK-Plattform und die System-Images herunterzuladen.

Ziel-API-Level aktualisieren

Wenn du deine App für Geräte mit Android 5.0 optimieren möchtest, setze targetSdkVersion auf "21", installiere deine App auf einem Android 5.0-System-Image, teste sie und veröffentliche dann die aktualisierte App mit dieser Änderung.

Du kannst Android 5.0 APIs verwenden und gleichzeitig frühere Versionen unterstützen, indem du deinem Code Bedingungen hinzufügst, die das System-API-Level prüfen, bevor APIs ausgeführt werden, die von deiner minSdkVersion nicht unterstützt werden. Weitere Informationen zur Abwärtskompatibilität finden Sie unter Supporting Different Platform Versions (Unterstützung verschiedener Plattformversionen).

Weitere Informationen zur Funktionsweise von API-Levels finden Sie unter Was ist ein API-Level?.

Wichtige Verhaltensänderungen

Wenn Sie bereits eine App für Android veröffentlicht haben, beachten Sie, dass Ihre App von Änderungen in Android 5.0 betroffen sein könnte.

Ausführliche Informationen finden Sie unter Änderungen in Android 5.0.

Benutzeroberfläche

Material Design-Unterstützung

Android 5.0 bietet Unterstützung für den neuen Material Design-Stil von Android. Mit Material Design können Sie Apps erstellen, die visuell dynamisch sind und Übergänge zwischen UI-Elementen haben, die sich für Nutzer natürlich anfühlen. Dieser Support umfasst:

  • Material Theme
  • Schatten ansehen
  • Das Widget RecyclerView
  • Drawable-Animationen und -Stileffekte
  • Material Design-Animationen und Übergangseffekte für Aktivitäten
  • Animatoren für Ansichtseigenschaften basierend auf dem Status der Ansicht
  • Anpassbare UI-Widgets und App-Leisten mit Farbpaletten, die Sie steuern können
  • Animierte und nicht animierte Drawables auf Basis von XML-Vektorgrafiken

Weitere Informationen zum Hinzufügen von Material Design-Funktionen zu Ihrer App finden Sie unter Material Design.

Gleichzeitige Dokumente und Aktivitäten auf dem Bildschirm „Zuletzt verwendet“

In früheren Versionen konnte auf dem Bildschirm „Letzte“ nur eine Aufgabe für jede App angezeigt werden, mit der der Nutzer zuletzt interagiert hat. Ihre Anwendung kann jetzt bei Bedarf weitere Tasks für zusätzliche gleichzeitige Aktivitäten für Dokumente öffnen. Diese Funktion erleichtert das Multitasking, da Nutzer schnell zwischen einzelnen Aktivitäten und Dokumenten auf dem Bildschirm „Letzte“ wechseln können. Das Wechseln funktioniert in allen Apps gleich. Beispiele für solche gleichzeitigen Aufgaben sind geöffnete Tabs in einer Webbrowser-App, Dokumente in einer Produktivitäts-App, gleichzeitige Spiele in einem Spiel oder Chats in einer Messaging-App. Ihre App kann ihre Aufgaben über die Klasse ActivityManager.AppTask verwalten.

Wenn Sie eine logische Unterbrechung einfügen möchten, damit das System Ihre Aktivität als neue Aufgabe behandelt, verwenden Sie FLAG_ACTIVITY_NEW_DOCUMENT, wenn Sie die Aktivität mit startActivity() starten. Du kannst dieses Verhalten auch erreichen, indem du das Attribut documentLaunchMode des Elements <activity> in deinem Manifest auf "intoExisting" oder "always" setzt.

Damit der Bildschirm „Letzte“ nicht überladen wird, kannst du die maximale Anzahl von Aufgaben aus deiner App festlegen, die auf diesem Bildschirm angezeigt werden können. Legen Sie dazu das Attribut android:maxRecents von <application> fest. Derzeit können maximal 50 Aufgaben pro Nutzer angegeben werden (25 für Geräte mit wenig RAM).

Aufgaben auf dem Bildschirm „Letzte“ können so eingestellt werden, dass sie auch nach einem Neustart erhalten bleiben. Mit dem Attribut android:persistableMode können Sie das Persistenzverhalten steuern. Du kannst auch die visuellen Eigenschaften einer Aktivität auf dem Bildschirm „Letzte“ ändern, z. B. die Farbe, das Label und das Symbol der Aktivität, indem du die Methode setTaskDescription() aufrufst.

WebView-Updates

Mit Android 5.0 wird die WebView-Implementierung auf Chromium M37 aktualisiert. Dadurch werden Sicherheits- und Stabilitätsverbesserungen sowie Fehlerkorrekturen eingeführt. Der Standard-User-Agent-String für eine WebView, die unter Android 5.0 ausgeführt wird, wurde aktualisiert und enthält jetzt die Versionsnummer 37.0.0.0.

In dieser Version wird die Klasse PermissionRequest eingeführt, mit der Ihre App die Berechtigung WebView für den Zugriff auf geschützte Ressourcen wie die Kamera und das Mikrofon über Web-APIs wie getUserMedia() gewähren kann. Ihre App muss die entsprechenden Android-Berechtigungen für diese Ressourcen haben, um die Berechtigungen für die WebView zu gewähren.

Mit der neuen onShowFileChooser()-Methode können Sie jetzt ein Eingabeformularfeld in der WebView verwenden und eine Dateiauswahl starten, um Bilder und Dateien vom Android-Gerät auszuwählen.

Außerdem werden in dieser Version die offenen Standards WebAudio, WebGL und WebRTC unterstützt. Weitere Informationen zu den neuen Funktionen in diesem Release finden Sie unter WebView für Android.

Bildschirmaufnahme und Freigabe

Mit Android 5.0 kannst du deiner App mit den neuen android.media.projection-APIs Funktionen für die Bildschirmaufnahme und Bildschirmfreigabe hinzufügen. Diese Funktion ist beispielsweise nützlich, wenn Sie die Bildschirmfreigabe in einer Videokonferenz-App aktivieren möchten.

Mit der neuen Methode createVirtualDisplay() kann Ihre App den Inhalt des Hauptbildschirms (Standardanzeige) in einem Surface-Objekt erfassen, das Ihre App dann über das Netzwerk senden kann. Die API erlaubt nur das Aufnehmen von nicht sicheren Bildschirminhalten und nicht von Systemaudio. Damit die Bildschirmaufnahme gestartet werden kann, muss Ihre App zuerst die Berechtigung des Nutzers anfordern. Dazu wird ein Dialogfeld für die Bildschirmaufnahme mit einem Intent gestartet, das über die Methode createScreenCaptureIntent() abgerufen wird.

Ein Beispiel für die Verwendung der neuen APIs finden Sie in der Klasse MediaProjectionDemo im Beispielprojekt.

Benachrichtigungen

Benachrichtigungen auf dem Sperrbildschirm

Auf Sperrbildschirmen in Android 5.0 können Benachrichtigungen angezeigt werden. Nutzer können in den Einstellungen festlegen, ob sensible Benachrichtigungsinhalte auf einem sicheren Sperrbildschirm angezeigt werden dürfen.

In deiner App kannst du festlegen, wie viele Details angezeigt werden, wenn Benachrichtigungen auf dem sicheren Sperrbildschirm eingeblendet werden. Wenn Sie die Sichtbarkeit steuern möchten, rufen Sie setVisibility() auf und geben Sie einen der folgenden Werte an:

  • VISIBILITY_PRIVATE: Es werden grundlegende Informationen wie das Symbol der Benachrichtigung angezeigt, der vollständige Inhalt der Benachrichtigung wird jedoch ausgeblendet.
  • VISIBILITY_PUBLIC: Der vollständige Inhalt der Benachrichtigung wird angezeigt.
  • VISIBILITY_SECRET: Es wird nichts angezeigt, nicht einmal das Symbol der Benachrichtigung.

Wenn die Sichtbarkeitsstufe VISIBILITY_PRIVATE ist, können Sie auch eine gekürzte Version des Benachrichtigungsinhalts bereitstellen, in der personenbezogene Daten ausgeblendet sind. Eine SMS-App könnte beispielsweise eine Benachrichtigung mit dem Text „Du hast 3 neue Nachrichten“ anzeigen, aber den Inhalt der Nachrichten und die Absender ausblenden. Wenn Sie diese alternative Benachrichtigung bereitstellen möchten, erstellen Sie zuerst die Ersatzbenachrichtigung mit Notification.Builder. Wenn Sie das private Benachrichtigungsobjekt erstellen, hängen Sie die Ersatzbenachrichtigung mit der Methode setPublicVersion() an.

Metadaten zu Benachrichtigungen

Android 5.0 verwendet Metadaten, die mit Ihren App-Benachrichtigungen verknüpft sind, um die Benachrichtigungen intelligenter zu sortieren. Rufen Sie zum Festlegen der Metadaten die folgenden Methoden in Notification.Builder auf, wenn Sie die Benachrichtigung erstellen:

  • setCategory(): Gibt dem System an, wie es mit deinen App-Benachrichtigungen umgehen soll, wenn sich das Gerät im Prioritätsmodus befindet (z. B. wenn eine Benachrichtigung einen eingehenden Anruf, eine Sofortnachricht oder einen Alarm darstellt).
  • setPriority(): Kennzeichnet die Benachrichtigung als wichtiger oder weniger wichtig als normale Benachrichtigungen. Benachrichtigungen, bei denen das Prioritätsfeld auf PRIORITY_MAX oder PRIORITY_HIGH gesetzt ist, werden in einem kleinen schwebenden Fenster angezeigt, wenn die Benachrichtigung auch einen Ton oder eine Vibration hat.
  • addPerson(): Hier können Sie eine oder mehrere Personen hinzufügen, die für eine Benachrichtigung relevant sind. Ihre App kann damit dem System signalisieren, dass Benachrichtigungen von den angegebenen Personen gruppiert oder als wichtiger eingestuft werden sollen.

Grafik

Unterstützung für OpenGL ES 3.1

Android 5.0 bietet Java-Schnittstellen und native Unterstützung für OpenGL ES 3.1. Zu den wichtigsten neuen Funktionen in OpenGL ES 3.1 gehören:

  • Compute-Shader
  • Separate Shader-Objekte
  • Indirekte Zeichenbefehle
  • Multisample- und Schablonentexturen
  • Verbesserungen der Shading-Sprache
  • Erweiterungen für erweiterte Mischmodi und Fehlerbehebung
  • Abwärtskompatibilität mit OpenGL ES 2.0 und 3.0

Die Java-Schnittstelle für OpenGL ES 3.1 unter Android wird mit GLES31 bereitgestellt. Wenn Sie OpenGL ES 3.1 verwenden, müssen Sie es in Ihrer Manifestdatei mit dem Tag <uses-feature> und dem Attribut android:glEsVersion deklarieren. Beispiel:

<manifest>
    <uses-feature android:glEsVersion="0x00030001" />
    ...
</manifest>

Weitere Informationen zur Verwendung von OpenGL ES, einschließlich der Überprüfung der vom Gerät unterstützten OpenGL ES-Version zur Laufzeit, finden Sie im OpenGL ES API-Leitfaden.

Android Extension Pack

Zusätzlich zu OpenGL ES 3.1 bietet diese Version ein Erweiterungspaket mit Java-Schnittstellen und nativer Unterstützung für erweiterte Grafikfunktionen. Diese Erweiterungen werden von Android als ein einziges Paket behandelt. Wenn die Erweiterung ANDROID_extension_pack_es31a vorhanden ist, kann Ihre App davon ausgehen, dass alle Erweiterungen im Paket vorhanden sind, und die Funktionen der Shading-Sprache mit einer einzigen #extension-Anweisung aktivieren.

Das Erweiterungspaket unterstützt Folgendes:

  • Erforderliche Fragment-Shader-Unterstützung für Shader-Speicherpuffer, Bilder und Atomics (Fragment-Shader-Unterstützung ist in OpenGL ES 3.1 optional)
  • Tessellierungs- und Geometrie-Shader
  • ASTC (LDR)-Texturkomprimierungsformat
  • Interpolation und Schattierung pro Sample
  • Verschiedene Füllmethoden für jeden Farbanhang in einem Framebuffer

Die Java-Schnittstelle für das Erweiterungspaket wird mit GLES31Ext bereitgestellt. In deinem App-Manifest kannst du deklarieren, dass deine App nur auf Geräten installiert werden darf, die das Erweiterungspaket unterstützen. Beispiel:

<manifest>
    <uses-feature android:name="android.hardware.opengles.aep"
        android:required="true" />
    ...
</manifest>

Medien

Kamera-API für erweiterte Kamerafunktionen

Mit Android 5.0 wird die neue API android.hardware.camera2 eingeführt, die eine detaillierte Fotoaufnahme und Bildverarbeitung ermöglicht. Sie können jetzt mit getCameraIdList() programmatisch auf die im System verfügbaren Kamerageräte zugreifen und mit openCamera() eine Verbindung zu einem bestimmten Gerät herstellen. Wenn Sie mit der Aufnahme von Bildern beginnen möchten, erstellen Sie ein CameraCaptureSession-Objekt und geben Sie die Surface-Objekte an, an die die aufgenommenen Bilder gesendet werden sollen. Die CameraCaptureSession kann so konfiguriert werden, dass sie einzelne Aufnahmen oder mehrere Bilder in einer Serie aufnimmt.

Wenn Sie benachrichtigt werden möchten, wenn neue Bilder aufgenommen werden, implementieren Sie den Listener CameraCaptureSession.CaptureCallback und legen Sie ihn in Ihrer Aufnahmeanfrage fest. Wenn das System die Anfrage zur Bilderfassung abgeschlossen hat, empfängt der CameraCaptureSession.CaptureCallback-Listener einen Aufruf von onCaptureCompleted(), der die Metadaten der Bilderfassung in einem CaptureResult bereitstellt.

Mit der Klasse CameraCharacteristics kann deine App erkennen, welche Kamerafunktionen auf einem Gerät verfügbar sind. Die Eigenschaft INFO_SUPPORTED_HARDWARE_LEVEL des Objekts gibt den Funktionsumfang der Kamera an.

Informationen zur Verwendung der aktualisierten Camera API findest du in den Implementierungsbeispielen für Camera2Basic und Camera2Video in diesem Release.

Audiowiedergabe

Diese Version enthält die folgenden Änderungen an AudioTrack:

  • Deine App kann jetzt Audiodaten im Gleitkommaformat (ENCODING_PCM_FLOAT) bereitstellen. Dies ermöglicht einen größeren Dynamikbereich, eine konsistentere Genauigkeit und einen größeren Headroom. Gleitkommaarithmetik ist besonders bei Zwischenberechnungen nützlich. Wiedergabe-Endpunkte verwenden das Ganzzahlformat für Audiodaten und eine geringere Bittiefe. (In Android 5.0 sind Teile der internen Pipeline noch nicht Gleitkomma.)
  • Ihre App kann jetzt Audiodaten als ByteBuffer im selben Format wie von MediaCodec bereitstellen.
  • Die Option WRITE_NON_BLOCKING kann die Zwischenspeicherung und das Multithreading für einige Anwendungen vereinfachen.

Wiedergabesteuerung

Verwende die neuen Benachrichtigungs- und Medien-APIs, damit die System-UI über deine Medienwiedergabe informiert ist und Albumcover extrahieren und anzeigen kann. Mit den neuen Klassen MediaSession und MediaController ist es jetzt einfacher, die Medienwiedergabe über eine Benutzeroberfläche und einen Dienst zu steuern.

Die neue Klasse MediaSession ersetzt die verworfene Klasse RemoteControlClient und bietet einen einzigen Satz von Callback-Methoden für die Verarbeitung von Transportsteuerungen und Medienschaltflächen. Wenn deine App Medien wiedergibt und auf der Android TV- oder Wear-Plattform ausgeführt wird, verwende die Klasse MediaSession, um die Transportsteuerung mit denselben Callback-Methoden zu verarbeiten.

Mit der neuen Klasse MediaController kannst du jetzt deine eigene Mediencontroller-App erstellen. Diese Klasse bietet eine threadsichere Möglichkeit, die Medienwiedergabe über den UI-Prozess Ihrer App zu überwachen und zu steuern. Geben Sie beim Erstellen eines Controllers ein MediaSession.Token-Objekt an, damit Ihre App mit dem angegebenen MediaSession interagieren kann. Mit den MediaController.TransportControls-Methoden kannst du Befehle wie play(), stop(), skipToNext() und setRating() senden, um die Medienwiedergabe in dieser Sitzung zu steuern. Mit dem Controller können Sie auch ein MediaController.Callback-Objekt registrieren, um auf Metadaten- und Statusänderungen in der Sitzung zu warten.

Außerdem kannst du mit der neuen Klasse Notification.MediaStyle Rich-Benachrichtigungen erstellen, die die Wiedergabesteuerung für eine Mediensitzung ermöglichen.

Medien durchsuchen

Mit Android 5.0 wird die Möglichkeit eingeführt, dass Apps über die neue android.media.browse API die Mediathek einer anderen App durchsuchen können. Wenn du die Medieninhalte in deiner App verfügbar machen möchtest, erweitere die Klasse MediaBrowserService. Deine Implementierung von MediaBrowserService sollte Zugriff auf einen MediaSession.Token bieten, damit Apps Medieninhalte abspielen können, die über deinen Dienst bereitgestellt werden.

Verwende die Klasse MediaBrowser, um mit einem MediaBrowserService zu interagieren. Geben Sie den Komponentennamen für eine MediaSession an, wenn Sie eine MediaBrowser-Instanz erstellen. Über diese Browserinstanz kann deine App dann eine Verbindung zum zugehörigen Dienst herstellen und ein MediaSession.Token-Objekt abrufen, um Inhalte abzuspielen, die über diesen Dienst bereitgestellt werden.

Speicher

Verzeichnisauswahl

Android 5.0 erweitert das Storage Access Framework, sodass Nutzer einen gesamten Verzeichnisunterbaum auswählen können. Dadurch erhalten Apps Lese-/Schreibzugriff auf alle enthaltenen Dokumente, ohne dass für jedes Element eine Bestätigung durch den Nutzer erforderlich ist.

Wenn Sie eine Verzeichnisunterstruktur auswählen möchten, erstellen und senden Sie einen OPEN_DOCUMENT_TREE-Intent. Das System zeigt alle DocumentsProvider-Instanzen an, die die Auswahl von Unterstrukturen unterstützen, sodass der Nutzer ein Verzeichnis suchen und auswählen kann. Der zurückgegebene URI stellt den Zugriff auf die ausgewählte Unterstruktur dar. Anschließend können Sie buildChildDocumentsUriUsingTree() und buildDocumentUriUsingTree() zusammen mit query() verwenden, um den Unterbaum zu erkunden.

Mit der neuen Methode createDocument() können Sie neue Dokumente oder Verzeichnisse an einer beliebigen Stelle im Unterbaum erstellen. Verwenden Sie renameDocument() und deleteDocument(), um vorhandene Dokumente zu verwalten. Prüfen Sie COLUMN_FLAGS, ob der Anbieter diese Aufrufe unterstützt, bevor Sie sie ausführen.

Wenn Sie einen DocumentsProvider implementieren und die Auswahl von Unterstrukturen unterstützen möchten, implementieren Sie isChildDocument() und fügen Sie FLAG_SUPPORTS_IS_CHILD in Ihren COLUMN_FLAGS ein.

Mit Android 5.0 werden auch neue paketspezifische Verzeichnisse im freigegebenen Speicher eingeführt, in denen deine App Mediendateien zur Aufnahme in MediaStore ablegen kann. Die neue getExternalMediaDirs() gibt Pfade zu diesen Verzeichnissen auf allen freigegebenen Speichergeräten zurück. Ähnlich wie bei getExternalFilesDir() sind für den Zugriff auf die zurückgegebenen Pfade keine zusätzlichen Berechtigungen erforderlich. Die Plattform sucht regelmäßig nach neuen Medien in diesen Verzeichnissen. Sie können aber auch MediaScannerConnection verwenden, um explizit nach neuen Inhalten zu suchen.

Drahtlos & Konnektivität

Mehrere Netzwerkverbindungen

Android 5.0 bietet neue Multi-Netzwerk-APIs, mit denen deine App dynamisch nach verfügbaren Netzwerken mit bestimmten Funktionen suchen und eine Verbindung zu ihnen herstellen kann. Diese Funktion ist nützlich, wenn deine App ein spezielles Netzwerk erfordert, z. B. ein SUPL-, MMS- oder Mobilfunkanbieter-Abrechnungsnetzwerk, oder wenn du Daten über einen bestimmten Typ von Transportprotokoll senden möchtest.

So wählen Sie ein Netzwerk dynamisch aus Ihrer App aus und stellen eine Verbindung her:

  1. Erstellen Sie einen ConnectivityManager.
  2. Verwende die Klasse NetworkRequest.Builder, um ein NetworkRequest-Objekt zu erstellen und die Netzwerkfunktionen und den Transporttyp anzugeben, die für deine App relevant sind.
  3. Wenn du nach geeigneten Netzwerken suchen möchtest, rufe requestNetwork() oder registerNetworkCallback() auf und übergib das NetworkRequest-Objekt und eine Implementierung von ConnectivityManager.NetworkCallback. Verwenden Sie die Methode requestNetwork(), wenn Sie aktiv zu einem geeigneten Netzwerk wechseln möchten, sobald es erkannt wird. Wenn Sie nur Benachrichtigungen für gescannte Netzwerke erhalten möchten, ohne aktiv zu wechseln, verwenden Sie stattdessen die Methode registerNetworkCallback().

Wenn das System ein geeignetes Netzwerk erkennt, stellt es eine Verbindung zum Netzwerk her und ruft den Callback onAvailable() auf. Sie können das Network-Objekt aus dem Callback verwenden, um zusätzliche Informationen zum Netzwerk abzurufen oder Traffic über das ausgewählte Netzwerk zu leiten.

Bluetooth Low Energy

Mit Android 4.3 wurde die Plattformunterstützung für Bluetooth Low Energy (Bluetooth LE) in der zentralen Rolle eingeführt. In Android 5.0 kann ein Android-Gerät jetzt als Bluetooth LE-Peripheriegerät fungieren. Apps können diese Funktion nutzen, um ihre Anwesenheit für Geräte in der Nähe bekannt zu machen. Sie können beispielsweise Apps entwickeln, mit denen ein Gerät als Schrittzähler oder Gesundheitsmonitor fungieren und seine Daten an ein anderes Bluetooth LE-Gerät übertragen kann.

Mit den neuen android.bluetooth.le-APIs können deine Apps Werbung senden, nach Antworten suchen und Verbindungen zu Bluetooth LE-Geräten in der Nähe herstellen. Wenn du die neuen Funktionen für Advertising und Scannen verwenden möchtest, füge die Berechtigung BLUETOOTH_ADMIN in deinem Manifest hinzu. Wenn Nutzer Ihre App im Google Play Store aktualisieren oder herunterladen, werden sie aufgefordert, Ihrer App die folgende Berechtigung zu erteilen: „Bluetooth-Verbindungsinformationen: Ermöglicht der App, Bluetooth zu steuern, einschließlich der Übertragung an oder des Abrufs von Informationen über Bluetooth-Geräte in der Nähe.“

Wenn du Bluetooth LE-Advertising starten möchtest, damit andere Geräte deine App finden können, rufe startAdvertising() auf und übergib eine Implementierung der Klasse AdvertiseCallback. Das Callback-Objekt erhält einen Bericht über den Erfolg oder Misserfolg des Advertising-Vorgangs.

In Android 5.0 wird die Klasse ScanFilter eingeführt, damit deine App nur nach den spezifischen Gerätetypen suchen kann, die für sie relevant sind. Wenn du nach Bluetooth LE-Geräten suchen möchtest, rufe startScan() auf und übergib eine Liste mit Filtern. Im Methodenaufruf müssen Sie auch eine Implementierung von ScanCallback angeben, um zu melden, wenn ein Bluetooth LE-Advertisement gefunden wird.

NFC-Verbesserungen

Android 5.0 bietet die folgenden Verbesserungen, um eine breitere und flexiblere Nutzung von NFC zu ermöglichen:

  • Android Beam ist jetzt im Menü Teilen verfügbar.
  • Ihre App kann Android Beam auf dem Gerät des Nutzers aufrufen, um Daten zu teilen, indem sie invokeBeam() aufruft. So muss der Nutzer das Gerät nicht manuell an ein anderes NFC-fähiges Gerät halten, um die Datenübertragung abzuschließen.
  • Mit der neuen Methode createTextRecord() kannst du einen NDEF-Datensatz mit UTF-8-Textdaten erstellen.
  • Wenn Sie eine Zahlungs-App entwickeln, können Sie jetzt eine NFC-Anwendungs-ID (AID) dynamisch registrieren, indem Sie registerAidsForService() aufrufen. Mit setPreferredService() kannst du auch den bevorzugten Dienst für die Kartenemulation festlegen, der verwendet werden soll, wenn eine bestimmte Aktivität im Vordergrund ist.

Project Volta

Zusätzlich zu den neuen Funktionen bietet Android 5.0 Verbesserungen bei der Akkulaufzeit. Mit den neuen APIs und dem neuen Tool kannst du den Stromverbrauch deiner App besser nachvollziehen und optimieren.

Jobs planen

Android 5.0 bietet eine neue JobScheduler API, mit der Sie die Akkulaufzeit optimieren können. Dazu definieren Sie Jobs, die das System zu einem späteren Zeitpunkt oder unter bestimmten Bedingungen (z. B. wenn das Gerät geladen wird) asynchron ausführt. Die Jobplanung ist in folgenden Situationen nützlich:

  • Die App führt Aufgaben aus, die für Nutzer nicht sichtbar sind und die Sie aufschieben können.
  • Die App führt Aufgaben aus, die Sie lieber erledigen möchten, wenn das Gerät an die Stromversorgung angeschlossen ist.
  • Die App hat eine Aufgabe, für die Netzwerkzugriff oder eine WLAN-Verbindung erforderlich ist.
  • Die Anwendung umfasst eine Reihe von Aufgaben, die Sie regelmäßig als Batch ausführen möchten.

Eine Arbeitseinheit wird durch ein JobInfo-Objekt gekapselt. Dieses Objekt gibt die Planungskriterien an.

Verwenden Sie die Klasse JobInfo.Builder, um zu konfigurieren, wie die geplante Aufgabe ausgeführt werden soll. Sie können die Aufgabe so planen, dass sie unter bestimmten Bedingungen ausgeführt wird, z. B.:

  • Starten, wenn das Gerät geladen wird
  • Starten, wenn das Gerät mit einem Netzwerk ohne Datenlimit verbunden ist
  • Starten, wenn das Gerät inaktiv ist
  • Vor einer bestimmten Frist oder mit einer minimalen Verzögerung fertigstellen

Sie können beispielsweise Code wie den folgenden hinzufügen, um Ihre Aufgabe in einem Netzwerk ohne Datenlimit auszuführen:

Kotlin

val uploadTask: JobInfo = JobInfo.Builder(
        jobId,
        serviceComponent /* JobService component */
).run {
    setRequiredNetworkType(JobInfo.NETWORK_TYPE_UNMETERED)
    build()
}
val jobScheduler = context.getSystemService(Context.JOB_SCHEDULER_SERVICE) as JobScheduler
jobScheduler.schedule(uploadTask)

Java

JobInfo uploadTask = new JobInfo.Builder(jobId,
                                         serviceComponent /* JobService component */)
        .setRequiredNetworkCapabilities(JobInfo.NETWORK_TYPE_UNMETERED)
        .build();
JobScheduler jobScheduler =
        (JobScheduler) context.getSystemService(Context.JOB_SCHEDULER_SERVICE);
jobScheduler.schedule(uploadTask);

Wenn das Gerät stabil mit Strom versorgt wird (d. h., es ist seit mehr als 2 Minuten an eine Stromquelle angeschlossen und der Akku ist ausreichend geladen), führt das System alle geplanten Jobs aus, die bereit sind, auch wenn die Frist des Jobs noch nicht abgelaufen ist.

Ein Beispiel für die Verwendung der JobScheduler API finden Sie im JobSchedulerSample-Implementierungsbeispiel in diesem Release.

Entwicklertools für die Akkunutzung

Der neue Befehl dumpsys batterystats generiert interessante statistische Daten zur Akkunutzung auf einem Gerät, sortiert nach eindeutiger Nutzer-ID (UID). Die Statistiken umfassen:

  • Verlauf der akkubezogenen Ereignisse
  • Globale Statistiken für das Gerät
  • Ungefährer Stromverbrauch pro UID und Systemkomponente
  • Mobile ms pro Paket und App
  • Aggregierte Statistiken zur System-UID
  • Aggregierte Statistiken zur App-UID

Mit der Option --help können Sie sich über die verschiedenen Optionen zum Anpassen der Ausgabe informieren. Wenn du beispielsweise die Akkunutzungsstatistiken für ein bestimmtes App-Paket seit dem letzten Aufladen des Geräts ausgeben möchtest, führe diesen Befehl aus:

$ adb shell dumpsys batterystats --charged <package-name>

Du kannst das Tool Battery Historian für die Ausgabe des Befehls dumpsys verwenden, um eine HTML-Visualisierung von energiebezogenen Ereignissen aus den Protokollen zu generieren. Anhand dieser Informationen kannst du Probleme mit dem Akku leichter nachvollziehen und diagnostizieren.

Android am Arbeitsplatz und in Bildungseinrichtungen

Verwaltete Bereitstellung

Android 5.0 bietet neue Funktionen zum Ausführen von Apps in einer Unternehmensumgebung. Ein Geräteadministrator kann einen verwalteten Bereitstellungsprozess initiieren, um einem Gerät ein gleichzeitig vorhandenes, aber separates verwaltetes Profil hinzuzufügen, wenn der Nutzer ein bestehendes privates Konto hat. Apps, die mit verwalteten Profilen verknüpft sind, werden im Launcher, auf dem Bildschirm „Letzte“ und in den Benachrichtigungen des Nutzers zusammen mit nicht verwalteten Apps angezeigt.

Senden Sie ACTION_PROVISION_MANAGED_PROFILE in einem Intent, um den verwalteten Bereitstellungsprozess zu starten. Wenn der Aufruf erfolgreich ist, löst das System den Callback onProfileProvisioningComplete() aus. Anschließend können Sie setProfileEnabled() aufrufen, um dieses verwaltete Profil zu aktivieren.

Standardmäßig ist im verwalteten Profil nur eine kleine Teilmenge von Apps aktiviert. Sie können zusätzliche Apps im verwalteten Profil installieren, indem Sie enableSystemApp() aufrufen.

Wenn du eine Launcher-App entwickelst, kannst du die neue Klasse LauncherApps verwenden, um eine Liste der startbaren Aktivitäten für den aktuellen Nutzer und alle zugehörigen verwalteten Profile abzurufen. Ihr Launcher kann die verwalteten Apps visuell hervorheben, indem er dem Symbol ein Arbeitssymbol hinzufügt. Rufen Sie getUserBadgedIcon() auf, um das Symbol mit Kennzeichnung abzurufen.

Informationen zur Verwendung der neuen Funktion finden Sie im BasicManagedProfile-Implementierungsbeispiel in diesem Release.

Geräteeigentümer

Mit Android 5.0 wird die Möglichkeit eingeführt, eine Geräteeigentümer-App bereitzustellen. Ein Geräteeigentümer ist ein spezieller Typ von Geräteadministrator, der zusätzlich die Möglichkeit hat, sekundäre Nutzer zu erstellen und zu entfernen und globale Einstellungen auf dem Gerät zu konfigurieren. Ihre Device Owner-App kann die Methoden in der Klasse DevicePolicyManager verwenden, um die Konfiguration, die Sicherheit und die Apps auf verwalteten Geräten detailliert zu steuern. Ein Gerät kann jeweils nur einen aktiven Geräteeigentümer haben.

Wenn du einen Geräteeigentümer bereitstellen und aktivieren möchtest, musst du eine NFC-Datenübertragung von einer Programmier-App auf das Gerät ausführen, während sich das Gerät im nicht bereitgestellten Zustand befindet. Bei dieser Datenübertragung werden dieselben Informationen gesendet wie im Intent für die Bereitstellung, der unter Verwaltete Bereitstellung beschrieben wird.

Bildschirm anpinnen

Mit Android 5.0 wird eine neue API für die Bildschirmfixierung eingeführt, mit der du Nutzer vorübergehend daran hindern kannst, deine Aufgabe zu verlassen oder durch Benachrichtigungen unterbrochen zu werden. Dies kann beispielsweise nützlich sein, wenn Sie eine Bildungs-App entwickeln, die die Anforderungen für wichtige Prüfungen unter Android unterstützt, oder eine zweckgebundene oder Kiosk-App. Sobald die App die Bildschirmfixierung aktiviert, können Nutzer keine Benachrichtigungen mehr sehen, nicht mehr auf andere Apps zugreifen und nicht mehr zum Startbildschirm zurückkehren, bis die App den Modus beendet.

Es gibt zwei Möglichkeiten, die Bildschirmfixierung zu aktivieren:

  • Manuell: Nutzer können die Bildschirmfixierung unter Einstellungen > Sicherheit > Bildschirmfixierung aktivieren und die Aufgaben, die sie fixieren möchten, durch Berühren des grünen Stecknadelsymbols auf dem Bildschirm „Letzte“ auswählen.
  • Programmatisch: Wenn Sie die Bildschirmfixierung programmatisch aktivieren möchten, rufen Sie startLockTask() in Ihrer App auf. Wenn die anfragende App kein Geräteeigentümer ist, wird der Nutzer um Bestätigung gebeten. Eine App des Geräteeigentümers kann die Methode setLockTaskPackages() aufrufen, damit Apps ohne Bestätigung durch den Nutzer angepinnt werden können.

Wenn die Aufgabensperre aktiv ist, passiert Folgendes:

  • Die Statusleiste ist leer und Nutzerbenachrichtigungen und Statusinformationen sind ausgeblendet.
  • Die Tasten „Startbildschirm“ und „Letzte Apps“ sind ausgeblendet.
  • Andere Apps können keine neuen Aktivitäten starten.
  • Die aktuelle App kann neue Aktivitäten starten, solange dadurch keine neuen Aufgaben erstellt werden.
  • Wenn die Bildschirmfixierung von einem Geräteeigentümer aufgerufen wird, bleibt der Nutzer so lange auf deine App beschränkt, bis die App stopLockTask() aufruft.
  • Wenn die Bildschirmfixierung durch eine andere App, die kein Geräteeigentümer ist, oder direkt durch den Nutzer aktiviert wird, kann der Nutzer die Fixierung aufheben, indem er die Zurück-Taste und die Taste „Letzte Apps“ gedrückt hält.

Druck-Framework

PDF als Bitmap rendern

Mit der neuen Klasse PdfRenderer können Sie jetzt PDF-Dokumentseiten zum Drucken in Bitmap-Bilder rendern. Sie müssen einen ParcelFileDescriptor angeben, der suchbar ist (d. h., auf den Inhalt kann zufällig zugegriffen werden) und auf den das System den druckbaren Inhalt schreibt. Ihre App kann mit openPage() eine Seite zum Rendern abrufen und dann render() aufrufen, um die geöffnete PdfRenderer.Page in eine Bitmap umzuwandeln. Sie können auch zusätzliche Parameter festlegen, wenn Sie nur einen Teil des Dokuments in ein Bitmap-Bild konvertieren möchten (z. B. um Kachel-Rendering zu implementieren, um das Dokument heranzuzoomen).

Ein Beispiel für die Verwendung der neuen APIs finden Sie im Beispiel PdfRendererBasic.

System

App-Nutzungsstatistiken

Mit der neuen android.app.usage API können Sie jetzt auf den App-Nutzungsverlauf auf einem Android-Gerät zugreifen. Diese API bietet detailliertere Nutzungsinformationen als die verworfene Methode getRecentTasks(). Wenn du diese API verwenden möchtest, musst du zuerst die Berechtigung "android.permission.PACKAGE_USAGE_STATS" in deinem Manifest deklarieren. Der Nutzer muss außerdem den Zugriff für diese App über Einstellungen > Sicherheit > Apps mit Zugriff auf Nutzungsdaten aktivieren.

Das System erfasst die Nutzungsdaten pro App und aggregiert sie in täglichen, wöchentlichen, monatlichen und jährlichen Intervallen. Die maximale Dauer, die das System diese Daten aufbewahrt, ist wie folgt:

  • Tägliche Daten: 7 Tage
  • Wöchentliche Daten: 4 Wochen
  • Monatliche Daten: 6 Monate
  • Jährliche Daten: 2 Jahre

Für jede App werden die folgenden Daten aufgezeichnet:

  • Wann die App zuletzt verwendet wurde
  • Die Gesamtzeit, in der die App im jeweiligen Zeitraum (Tag, Woche, Monat oder Jahr) im Vordergrund war
  • Zeitstempel, der angibt, wann eine Komponente (identifiziert durch einen Paket- und Aktivitätsnamen) im Laufe eines Tages in den Vordergrund oder Hintergrund verschoben wurde
  • Zeitstempel, der erfasst, wann sich eine Gerätekonfiguration geändert hat (z. B. wenn sich die Geräteausrichtung aufgrund einer Drehung geändert hat)

Tests und Bedienungshilfen

Verbesserungen bei Tests und Bedienungshilfen

Android 5.0 bietet die folgende Unterstützung für Tests und Bedienungshilfen:

  • Die neuen Methoden getWindowAnimationFrameStats() und getWindowContentFrameStats() erfassen Frame-Statistiken für Fensteranimationen und Inhalte. Mit diesen Methoden kannst du Instrumentierungstests schreiben, um zu prüfen, ob eine App Frames mit einer ausreichenden Aktualisierungsfrequenz rendert, um eine reibungslose Nutzererfahrung zu bieten.
  • Mit der neuen Methode executeShellCommand() können Sie Shell-Befehle aus Ihrem Instrumentierungstest ausführen. Die Befehlsausführung ähnelt der Ausführung von adb shell von einem Host, der mit dem Gerät verbunden ist. So können Sie shellbasierte Tools wie dumpsys, am, content und pm verwenden.
  • Bedienungshilfen und Testtools, die die Accessibility APIs verwenden (z. B. UiAutomator), können jetzt detaillierte Informationen zu den Eigenschaften von Fenstern auf dem Bildschirm abrufen, mit denen sehende Nutzer interagieren können. Rufen Sie die neue Methode getWindows() auf, um eine Liste von AccessibilityWindowInfo-Objekten abzurufen.
  • Mit der neuen Klasse AccessibilityNodeInfo.AccessibilityAction kannst du Standardaktionen oder benutzerdefinierte Aktionen definieren, die für ein AccessibilityNodeInfo ausgeführt werden sollen. Die neue Klasse AccessibilityNodeInfo.AccessibilityAction ersetzt die aktionsbezogenen APIs, die zuvor in AccessibilityNodeInfo enthalten waren.
  • Android 5.0 bietet eine genauere Kontrolle über die Text-zu-Sprache-Synthese in deiner App. Mit der neuen Klasse Voice kann deine App Sprachprofile verwenden, die mit bestimmten Sprachen, Qualitäts- und Latenzbewertungen sowie Parametern für die Text-zu-Sprache-Engine verknüpft sind.

IME

Einfacherer Wechsel zwischen Eingabesprachen

Ab Android 5.0 können Nutzer zwischen allen von der Plattform unterstützten Eingabemethoden-Editoren (IMEs) wechseln. Durch Ausführen der festgelegten Wechselaktion (normalerweise durch Berühren des Globussymbols auf der Bildschirmtastatur) werden alle diese IMEs durchlaufen. Diese Verhaltensänderung wird durch die Methode shouldOfferSwitchingToNextInputMethod() implementiert.

Außerdem prüft das Framework jetzt, ob die nächste Eingabemethode überhaupt einen Wechselmechanismus enthält (und somit, ob diese Eingabemethode den Wechsel zur nachfolgenden Eingabemethode unterstützt). Eine Eingabemethode mit einem Wechselmechanismus wechselt nicht zu einer Eingabemethode ohne Wechselmechanismus. Diese Verhaltensänderung wird durch die Methode switchToNextInputMethod() implementiert.

Ein Beispiel für die Verwendung der aktualisierten APIs zum Wechseln der Eingabemethode finden Sie im aktualisierten Beispiel für die Implementierung der Bildschirmtastatur in dieser Version. Weitere Informationen zum Implementieren des Wechsels zwischen IMEs finden Sie unter Eingabemethode erstellen.

Manifestdeklarationen

Deklarierbare erforderliche Funktionen

Die folgenden Werte werden jetzt im Element <uses-feature> unterstützt. So kannst du dafür sorgen, dass deine App nur auf Geräten installiert wird, die die von deiner App benötigten Funktionen bieten.

Nutzerberechtigungen

Die folgende Berechtigung wird jetzt im Element <uses-permission> unterstützt, um die Berechtigungen zu deklarieren, die Ihre App für den Zugriff auf bestimmte APIs benötigt.

  • BIND_DREAM_SERVICE: Wenn Sie auf API-Level 21 und höher abzielen, ist diese Berechtigung für einen Daydream-Dienst erforderlich, damit nur das System eine Bindung herstellen kann.