Fonctionnalités et API

Android 17 offre aux développeurs de nouvelles fonctionnalités et API de qualité. Les sections suivantes récapitulent ces fonctionnalités pour vous aider à vous lancer avec les API associées.

Pour obtenir une liste détaillée des nouvelles API, des API modifiées et supprimées, consultez le rapport de différences des API. Pour en savoir plus sur les nouvelles API, consultez la documentation de référence des API Android. Les nouvelles API sont mises en évidence.

Vous devez également examiner les domaines dans lesquels les changements de plate-forme peuvent affecter vos applications. Pour en savoir plus, consultez les pages suivantes :

Fonctionnalité de base

Android 17 ajoute les nouvelles fonctionnalités suivantes liées à la fonctionnalité Android de base.

Nouveaux déclencheurs ProfilingManager

Android 17 ajoute plusieurs déclencheurs système à ProfilingManager pour vous aider à collecter des données détaillées afin de déboguer les problèmes de performances.

Voici les nouveaux déclencheurs :

TRIGGER_TYPE_COLD_START : le déclencheur se produit lors du démarrage à froid de l'application. Il fournit à la fois un exemple de pile d'appels et une trace système dans la réponse.
TRIGGER_TYPE_OOM : le déclencheur se produit lorsqu'une application génère une OutOfMemoryError et fournit un vidage du tas Java en réponse.
TRIGGER_TYPE_KILL_EXCESSIVE_CPU_USAGE : le déclencheur se produit lorsqu'une application est arrêtée en raison d'une utilisation anormale et excessive du processeur, et fournit un exemple de pile d'appels en réponse.

Pour savoir comment configurer le déclencheur système, consultez la documentation sur le profilage basé sur les déclencheurs et sur la récupération et l'analyse des données de profilage.

API JobDebugInfo

Android 17 introduit de nouvelles API JobDebugInfo pour aider les développeurs à déboguer leurs jobs JobScheduler : pourquoi ils ne s'exécutent pas, combien de temps ils se sont exécutés et d'autres informations agrégées.

La première méthode des API JobDebugInfo développées est getPendingJobReasonStats(), qui renvoie une carte des raisons pour lesquelles le job était dans un état d'exécution en attente et leurs durées d'attente cumulées respectives. Cette méthode combine les méthodes getPendingJobReasonsHistory() et getPendingJobReasons() pour vous aider à comprendre pourquoi un job planifié ne s'exécute pas comme prévu. Elle simplifie toutefois la récupération d'informations en rendant la durée et le motif du job disponibles dans une seule méthode.

Par exemple, pour un jobId spécifié, la méthode peut renvoyer PENDING_JOB_REASON_CONSTRAINT_CHARGING et une durée de 60 000 ms, ce qui indique que la tâche était en attente pendant 60 000 ms en raison du non-respect de la contrainte de recharge.

Confidentialité

Android 17 inclut les nouvelles fonctionnalités suivantes pour améliorer la confidentialité des utilisateurs.

Sélecteur de contacts Android

Le sélecteur de contacts Android est une interface standardisée et navigable qui permet aux utilisateurs de partager des contacts avec votre application. Disponible sur les appareils fonctionnant sous Android 17 ou version ultérieure, il offre une alternative respectueuse de la confidentialité à l'autorisation READ_CONTACTS étendue. Au lieu de demander l'accès à l'intégralité du carnet d'adresses de l'utilisateur, votre application spécifie les champs de données dont elle a besoin, tels que les numéros de téléphone ou les adresses e-mail, et l'utilisateur sélectionne les contacts spécifiques à partager. Cela accorde à votre application un accès en lecture uniquement aux données sélectionnées, ce qui garantit un contrôle précis tout en offrant une expérience utilisateur cohérente avec des fonctionnalités de recherche, de changement de profil et de sélection multiple intégrées, sans avoir à créer ni à gérer l'UI.

Pour en savoir plus, consultez la documentation sur le sélecteur de contacts.

Sécurité

Android 17 ajoute les nouvelles fonctionnalités suivantes pour améliorer la sécurité des appareils et des applications.

Mode Protection Avancée Android (AAPM)

Le mode Protection Avancée d'Android offre aux utilisateurs Android un nouvel ensemble de fonctionnalités de sécurité puissantes. Il s'agit d'une étape importante pour protéger les utilisateurs, en particulier ceux qui sont plus exposés, contre les attaques sophistiquées. Conçue comme une fonctionnalité optionnelle, l'AAPM s'active avec un seul paramètre de configuration que les utilisateurs peuvent activer à tout moment pour appliquer un ensemble de protections de sécurité.

Ces configurations de base incluent le blocage de l'installation d'applications provenant de sources inconnues (téléchargement indépendant), la restriction de la signalisation des données USB et l'analyse obligatoire de Google Play Protect, ce qui réduit considérablement la surface d'attaque de l'appareil. Les développeurs peuvent s'intégrer à cette fonctionnalité à l'aide de l'API AdvancedProtectionManager pour détecter l'état du mode, ce qui permet aux applications d'adopter automatiquement une posture de sécurité renforcée ou de restreindre les fonctionnalités à haut risque lorsqu'un utilisateur a activé le mode.

Connectivité

Android 17 ajoute les fonctionnalités suivantes pour améliorer la connectivité des appareils et des applications.

Réseaux satellites contraints

Implémente des optimisations pour permettre aux applications de fonctionner efficacement sur les réseaux satellites à faible bande passante.

Expérience utilisateur et UI du système

Android 17 inclut les modifications suivantes pour améliorer l'expérience utilisateur.

Transfert

Le transfert est une nouvelle fonctionnalité et API qui sera disponible dans Android 17. Les développeurs d'applications pourront l'intégrer pour offrir une continuité inter-appareils à leurs utilisateurs. Il permet à l'utilisateur de démarrer une activité d'application sur un appareil Android et de la transférer vers un autre appareil Android. Le transfert s'exécute en arrière-plan de l'appareil d'un utilisateur et affiche les activités disponibles à partir des autres appareils à proximité de l'utilisateur via différents points d'entrée, comme le lanceur d'applications et la barre des tâches, sur l'appareil de réception.

Les applications peuvent désigner Handoff pour lancer la même application Android native, si elle est installée et disponible sur l'appareil de réception. Dans ce flux d'application à application, l'utilisateur est redirigé vers l'activité désignée à l'aide d'un lien profond. Vous pouvez également proposer le transfert d'application à Web comme option de secours ou l'implémenter directement avec le transfert d'URL.

La prise en charge du transfert est implémentée par activité. Pour activer le transfert, appelez la méthode setHandoffEnabled() pour l'activité. Des données supplémentaires peuvent être nécessaires lors du transfert pour que l'activité recréée sur l'appareil de réception puisse restaurer l'état approprié. Implémentez le rappel onHandoffActivityRequested() pour renvoyer un objet HandoffActivityData qui contient des détails spécifiant comment Handoff doit gérer et recréer l'activité sur l'appareil de réception.

Mise à jour en direct : API de couleurs sémantiques

Avec Android 17, Live Update lance les API de coloration sémantique pour prendre en charge les couleurs ayant une signification universelle.

Les classes suivantes sont compatibles avec la coloration sémantique :

Jeux de coloriage

Vert : associé à la sécurité. Cette couleur doit être utilisée pour indiquer aux utilisateurs que vous êtes en sécurité.
Orange : pour désigner la prudence et marquer les risques physiques. Cette couleur doit être utilisée lorsque les utilisateurs doivent faire attention à définir un meilleur paramètre de protection.
Rouge : indique généralement un danger ou un arrêt. Il doit être présenté dans le cas où l'attention des utilisateurs est requise de toute urgence.
Bleu : couleur neutre pour le contenu informatif qui doit se démarquer des autres contenus.

L'exemple suivant montre comment appliquer des styles sémantiques au texte d'une notification :

  val ssb = SpannableStringBuilder()
        .append("Colors: ")
        .append("NONE", Notification.createSemanticStyleAnnotation(SEMANTIC_STYLE_UNSPECIFIED), 0)
        .append(", ")
        .append("INFO", Notification.createSemanticStyleAnnotation(SEMANTIC_STYLE_INFO), 0)
        .append(", ")
        .append("SAFE", Notification.createSemanticStyleAnnotation(SEMANTIC_STYLE_SAFE), 0)
        .append(", ")
        .append("CAUTION", Notification.createSemanticStyleAnnotation(SEMANTIC_STYLE_CAUTION), 0)
        .append(", ")
        .append("DANGER", Notification.createSemanticStyleAnnotation(SEMANTIC_STYLE_DANGER), 0)

    Notification.Builder(context, channelId)
          .setSmallIcon(R.drawable.ic_icon)
          .setContentTitle("Hello World!")
          .setContentText(ssb)
          .setOngoing(true)
              .setRequestPromotedOngoing(true)

API UWB Downlink-TDoA pour Android 17

La télémétrie DL-TDoA (Downlink Time Difference of Arrival) permet à un appareil de déterminer sa position par rapport à plusieurs points d'ancrage en mesurant les temps d'arrivée relatifs des signaux.

L'extrait de code suivant montre comment initialiser le Ranging Manager, vérifier les capacités de l'appareil et démarrer une session DL-TDoA :

Kotlin

class RangingApp {

    fun initDlTdoa(context: Context) {
        // Initialize the Ranging Manager
        val rangingManager = context.getSystemService(RangingManager::class.java)

        // Register for device capabilities
        val capabilitiesCallback = object : RangingManager.CapabilitiesCallback {
            override fun onRangingCapabilities(capabilities: RangingCapabilities) {
                // Make sure Dl-TDoA is supported before starting the session
                if (capabilities.uwbCapabilities != null && capabilities.uwbCapabilities!!.isDlTdoaSupported) {
                    startDlTDoASession(context)
                }
            }
        }
        rangingManager.registerCapabilitiesCallback(Executors.newSingleThreadExecutor(), capabilitiesCallback)
    }

    fun startDlTDoASession(context: Context) {

        // Initialize the Ranging Manager
        val rangingManager = context.getSystemService(RangingManager::class.java)

        // Create session and configure parameters
        val executor = Executors.newSingleThreadExecutor()
        val rangingSession = rangingManager.createRangingSession(executor, RangingSessionCallback())
        val rangingRoundIndexes = intArrayOf(0)
        val config: ByteArray = byteArrayOf() // OOB config data
        val params = DlTdoaRangingParams.createFromFiraConfigPacket(config, rangingRoundIndexes)

        val rangingDevice = RangingDevice.Builder().build()
        val rawTagDevice = RawRangingDevice.Builder()
            .setRangingDevice(rangingDevice)
            .setDlTdoaRangingParams(params)
            .build()

        val dtTagConfig = RawDtTagRangingConfig.Builder(rawTagDevice).build()

        val preference = RangingPreference.Builder(DEVICE_ROLE_DT_TAG, dtTagConfig)
            .setSessionConfig(SessionConfig.Builder().build())
            .build()

        // Start the ranging session
        rangingSession.start(preference)
    }
}

private class RangingSessionCallback : RangingSession.Callback {
    override fun onDlTdoaResults(peer: RangingDevice, measurement: DlTdoaMeasurement) {
        // Process measurement results here
    }
}

Java

public class RangingApp {

    public void initDlTdoa(Context context) {

        // Initialize the Ranging Manager
        RangingManager rangingManager = context.getSystemService(RangingManager.class);

        // Register for device capabilities
        RangingManager.CapabilitiesCallback capabilitiesCallback = new RangingManager.CapabilitiesCallback() {
            @Override
            public void onRangingCapabilities(RangingCapabilities capabilities) {
                // Make sure Dl-TDoA is supported before starting the session
                if (capabilities.getUwbCapabilities() != null && capabilities.getUwbCapabilities().isDlTdoaSupported) {
                    startDlTDoASession(context);
                }
            }
        };
        rangingManager.registerCapabilitiesCallback(Executors.newSingleThreadExecutor(), capabilitiesCallback);
    }

    public void startDlTDoASession(Context context) {
        RangingManager rangingManager = context.getSystemService(RangingManager.class);

        // Create session and configure parameters
        Executor executor = Executors.newSingleThreadExecutor();
        RangingSession rangingSession = rangingManager.createRangingSession(executor, new RangingSessionCallback());
        int[] rangingRoundIndexes = new int[] {0};
        byte[] config = new byte[0]; // OOB config data
        DlTdoaRangingParams params = DlTdoaRangingParams.createFromFiraConfigPacket(config, rangingRoundIndexes);

        RangingDevice rangingDevice = new RangingDevice.Builder().build();
        RawRangingDevice rawTagDevice = new RawRangingDevice.Builder()
                .setRangingDevice(rangingDevice)
                .setDlTdoaRangingParams(params)
                .build();

        RawDtTagRangingConfig dtTagConfig = new RawDtTagRangingConfig.Builder(rawTagDevice).build();

        RangingPreference preference = new RangingPreference.Builder(DEVICE_ROLE_DT_TAG, dtTagConfig)
                .setSessionConfig(new SessionConfig.Builder().build())
                .build();

        // Start the ranging session
        rangingSession.start(preference);
    }

    private static class RangingSessionCallback implements RangingSession.Callback {

        @Override
        public void onDlTdoaResults(RangingDevice peer, DlTdoaMeasurement measurement) {
            // Process measurement results here
        }
    }
}

Configurations hors bande

L'extrait de code suivant fournit un exemple de données de configuration DL-TDoA OOB pour le Wi-Fi et le BLE :

Java

// Wifi Configuration
byte[] wifiConfig = {
    (byte) 0xDD, (byte) 0x2D, (byte) 0x5A, (byte) 0x18, (byte) 0xFF, // Header
    (byte) 0x5F, (byte) 0x19, // FiRa Sub-Element
    (byte) 0x02, (byte) 0x00, // Profile ID
    (byte) 0x06, (byte) 0x02, (byte) 0x20, (byte) 0x08, // MAC Address
    (byte) 0x14, (byte) 0x01, (byte) 0x0C, // Preamble Index
    (byte) 0x27, (byte) 0x02, (byte) 0x08, (byte) 0x07, // Vendor ID
    (byte) 0x28, (byte) 0x06, (byte) 0xCA, (byte) 0xC8, (byte) 0xA6, (byte) 0xF7, (byte) 0x6F, (byte) 0x08, // Static STS IV
    (byte) 0x08, (byte) 0x02, (byte) 0x60, (byte) 0x09, // Slot Duration
    (byte) 0x1B, (byte) 0x01, (byte) 0x0A, // Slots per RR
    (byte) 0x09, (byte) 0x04, (byte) 0xE8, (byte) 0x03, (byte) 0x00, (byte) 0x00, // Duration
    (byte) 0x9F, (byte) 0x04, (byte) 0x67, (byte) 0x45, (byte) 0x23, (byte) 0x01  // Session ID
};

// BLE Configuration
byte[] bleConfig = {
    (byte) 0x2D, (byte) 0x16, (byte) 0xF4, (byte) 0xFF, // Header
    (byte) 0x5F, (byte) 0x19, // FiRa Sub-Element
    (byte) 0x02, (byte) 0x00, // Profile ID
    (byte) 0x06, (byte) 0x02, (byte) 0x20, (byte) 0x08, // MAC Address
    (byte) 0x14, (byte) 0x01, (byte) 0x0C, // Preamble Index
    (byte) 0x27, (byte) 0x02, (byte) 0x08, (byte) 0x07, // Vendor ID
    (byte) 0x28, (byte) 0x06, (byte) 0xCA, (byte) 0xC8, (byte) 0xA6, (byte) 0xF7, (byte) 0x6F, (byte) 0x08, // Static STS IV
    (byte) 0x08, (byte) 0x02, (byte) 0x60, (byte) 0x09, // Slot Duration
    (byte) 0x1B, (byte) 0x01, (byte) 0x0A, // Slots per RR
    (byte) 0x09, (byte) 0x04, (byte) 0xE8, (byte) 0x03, (byte) 0x00, (byte) 0x00, // Duration
    (byte) 0x9F, (byte) 0x04, (byte) 0x67, (byte) 0x45, (byte) 0x23, (byte) 0x01  // Session ID
};

Si vous ne pouvez pas utiliser de configuration OOB, car elle est manquante, ou si vous devez modifier des valeurs par défaut qui ne figurent pas dans la configuration OOB, vous pouvez créer des paramètres avec DlTdoaRangingParams.Builder, comme indiqué dans l'extrait suivant. Vous pouvez utiliser ces paramètres à la place de DlTdoaRangingParams.createFromFiraConfigPacket() :

Kotlin

val dlTdoaParams = DlTdoaRangingParams.Builder(1)
    .setComplexChannel(UwbComplexChannel.Builder()
            .setChannel(9).setPreambleIndex(10).build())
    .setDeviceAddress(deviceAddress)
    .setSessionKeyInfo(byteArrayOf(0x01, 0x02, 0x03, 0x04))
    .setRangingIntervalMillis(240)
    .setSlotDuration(UwbRangingParams.DURATION_2_MS)
    .setSlotsPerRangingRound(20)
    .setRangingRoundIndexes(byteArrayOf(0x01, 0x05))
    .build()

Java

DlTdoaRangingParams dlTdoaParams = new DlTdoaRangingParams.Builder(1)
    .setComplexChannel(new UwbComplexChannel.Builder()
            .setChannel(9).setPreambleIndex(10).build())
    .setDeviceAddress(deviceAddress)
    .setSessionKeyInfo(new byte[]{0x01, 0x02, 0x03, 0x04})
    .setRangingIntervalMillis(240)
    .setSlotDuration(UwbRangingParams.DURATION_2_MS)
    .setSlotsPerRangingRound(20)
    .setRangingRoundIndexes(new byte[]{0x01, 0x05})
    .build();

Fonctionnalités et API Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Fonctionnalité de base

Nouveaux déclencheurs ProfilingManager

API JobDebugInfo

Confidentialité

Sélecteur de contacts Android

Sécurité

Mode Protection Avancée Android (AAPM)

Connectivité

Réseaux satellites contraints

Expérience utilisateur et UI du système

Transfert

Mise à jour en direct : API de couleurs sémantiques

Jeux de coloriage

API UWB Downlink-TDoA pour Android 17

Kotlin

Java

Configurations hors bande

Java

Kotlin

Java

Fonctionnalités et API