Recursos e APIs

O Android 17 introduz ótimos recursos e APIs novos para desenvolvedores. As seções a seguir resumem esses recursos para ajudar você a começar a usar as APIs relacionadas.

Para uma lista detalhada das APIs novas, modificadas e removidas, leia o Relatório de diferenças da API. Para ver detalhes sobre as novas APIs, acesse a Referência da API do Android. As APIs novas estão em destaque para melhor visibilidade.

Também é importante analisar as áreas em que as mudanças na plataforma podem afetar seus apps. Para mais informações, consulte as seguintes páginas:

Principal recurso

O Android 17 adiciona os novos recursos abaixo relacionados à funcionalidade principal do Android.

Novos acionadores do ProfilingManager

O Android 17 adiciona vários novos acionadores do sistema ao ProfilingManager para ajudar você a coletar dados detalhados para depurar problemas de desempenho.

Os novos acionadores são:

  • TRIGGER_TYPE_COLD_START: o acionador ocorre durante a inicialização a frio do app. Ele fornece uma amostra de pilha de chamadas e um rastreamento do sistema na resposta.
  • TRIGGER_TYPE_OOM: o gatilho ocorre quando um app gera uma OutOfMemoryError e fornece um heap dump do Java em resposta.
  • TRIGGER_TYPE_KILL_EXCESSIVE_CPU_USAGE: o acionador ocorre quando um app é encerrado devido ao uso anormal e excessivo da CPU e fornece uma amostra de pilha de chamadas em resposta.
  • TRIGGER_TYPE_ANOMALY: detecta anomalias de desempenho do sistema, como chamadas excessivas de binder e uso da memória excessivo.

Para entender como configurar o gatilho do sistema, consulte a documentação sobre criação de perfil baseada em gatilhos e como recuperar e analisar dados de criação de perfil.

Acionador de criação de perfil para anomalias de apps

O Android 17 introduz um serviço de detecção de anomalias no dispositivo que monitora comportamentos que consomem muitos recursos e possíveis regressões de compatibilidade. Integrado ao ProfilingManager, esse serviço permite que o app receba artefatos de criação de perfil acionados por eventos específicos detectados pelo sistema.

Use o gatilho TRIGGER_TYPE_ANOMALY para detectar problemas de desempenho do sistema, como chamadas excessivas de binder e uso da memória excessivo. Quando um app viola os limites de memória definidos pelo SO, o acionador de anomalias permite que os desenvolvedores recebam heap dumps específicos do app para ajudar a identificar e corrigir problemas de memória. Além disso, para spam excessivo de binder, o acionador de anomalias fornece um perfil de amostragem de pilha em transações de binder.

Esse callback de API ocorre antes de qualquer restrição imposta pelo sistema. Por exemplo, ela pode ajudar os desenvolvedores a coletar dados de depuração antes que o app seja encerrado pelo sistema por exceder os limites de memória.

val profilingManager =
    applicationContext.getSystemService(ProfilingManager::class.java)
val triggers = ArrayList<ProfilingTrigger>()
triggers.add(ProfilingTrigger.Builder(ProfilingTrigger.TRIGGER_TYPE_ANOMALY))
val mainExecutor: Executor = Executors.newSingleThreadExecutor()
val resultCallback = Consumer<ProfilingResult> { profilingResult ->
    if (profilingResult.errorCode != ProfilingResult.ERROR_NONE) {
        // upload profile result to server for further analysis
        setupProfileUploadWorker(profilingResult.resultFilePath)
    }
    profilingManager.registerForAllProfilingResults(mainExecutor,
                                                    resultCallback)
    profilingManager.addProfilingTriggers(triggers)
}

APIs JobDebugInfo

O Android 17 apresenta novas APIs JobDebugInfo para ajudar os desenvolvedores a depurar os jobs do JobScheduler: por que eles não estão sendo executados, por quanto tempo foram executados e outras informações agregadas.

O primeiro método das APIs JobDebugInfo expandidas é getPendingJobReasonStats(), que retorna um mapa dos motivos pelos quais o job estava em um estado de execução pendente e as respectivas durações pendentes cumulativas. Esse método une os métodos getPendingJobReasonsHistory() e getPendingJobReasons() para que você entenda por que um job programado não está sendo executado como esperado, mas simplifica a recuperação de informações disponibilizando a duração e o motivo do job em um único método.

Por exemplo, para um jobId especificado, o método pode retornar PENDING_JOB_REASON_CONSTRAINT_CHARGING e uma duração de 60.000 ms, indicando que o job estava pendente por 60.000 ms porque a restrição de carregamento não foi atendida.

Reduzir wake locks com suporte de listener para alarmes de permissão durante inatividade

O Android 17 introduz uma nova variante de AlarmManager.setExactAndAllowWhileIdle que aceita um OnAlarmListener em vez de um PendingIntent. Esse novo mecanismo baseado em callback é ideal para apps que dependem de wakelocks contínuos para realizar tarefas periódicas, como apps de mensagens que mantêm conexões de soquete.

Privacidade

O Android 17 inclui os novos recursos a seguir para melhorar a privacidade do usuário.

Suporte da plataforma para Encrypted Client Hello (ECH)

O Android 17 introduz suporte da plataforma para o Encrypted Client Hello (ECH), uma melhoria significativa de privacidade para comunicações de rede. O ECH é uma extensão do TLS 1.3 que criptografa a indicação de nome do servidor (SNI, na sigla em inglês) durante o handshake inicial do TLS. Essa criptografia ajuda a proteger a privacidade do usuário, dificultando que intermediários de rede identifiquem o domínio específico a que um app está se conectando.

A plataforma agora inclui as APIs necessárias para que as bibliotecas de rede implementem o ECH. Isso inclui novos recursos em DnsResolver para consultar registros DNS HTTPS que contêm configurações de ECH e novos métodos nos SSLEngines e SSLSockets do Conscrypt para ativar o ECH transmitindo essas configurações ao se conectar a um domínio. Os desenvolvedores podem configurar as preferências de ECH, como ativá-lo de forma oportunista ou obrigar o uso dele, usando o novo <domainEncryption> elemento no arquivo de configuração de segurança de rede, aplicável globalmente ou por domínio.

Espera-se que bibliotecas de rede populares, como HttpEngine, WebView e OkHttp, integrem essas APIs da plataforma em atualizações futuras, facilitando a adoção do ECH pelos apps e aprimorando a privacidade do usuário.

Para mais informações, consulte a documentação do Encrypted Client Hello.

Seletor de contatos do Android

The Android Contact Picker is a standardized, browsable interface for users to share contacts with your app. Available on devices running Android 17 (API level 37) or higher, the picker offers a privacy-preserving alternative to the broad READ_CONTACTS permission. Instead of requesting access to the user's entire address book, your app specifies the data fields it needs, such as phone numbers or email addresses, and the user selects specific contacts to share. This grants your app read access to only the selected data, ensuring granular control while providing a consistent user experience with built-in search, profile switching, and multi-selection capabilities without having to build or maintain the UI.

For more information, see the contact picker documentation.

Segurança

O Android 17 adiciona os novos recursos abaixo para melhorar a segurança do dispositivo e do app.

Modo Proteção Avançada do Android (AAPM)

O modo de Proteção Avançada do Android oferece aos usuários do Android um novo conjunto de recursos de segurança poderosos, marcando uma etapa significativa na proteção dos usuários, principalmente aqueles com maior risco, contra ataques sofisticados. Projetado como um recurso de ativação, o AAPM é ativado com uma única configuração que os usuários podem ativar a qualquer momento para aplicar um conjunto de proteções de segurança.

Essas configurações principais incluem o bloqueio da instalação de apps de fontes desconhecidas (sideload), a restrição da sinalização de dados USB e a obrigatoriedade da verificação do Google Play Protect, o que reduz significativamente a área de superfície de ataque do dispositivo. Os desenvolvedores podem se integrar a esse recurso usando a API AdvancedProtectionManager para detectar o status do modo, permitindo que os aplicativos adotem automaticamente uma postura de segurança reforçada ou restrinjam funcionalidades de alto risco quando um usuário ativa o recurso.

Assinatura de APK com PQC

O Android agora oferece suporte a um esquema de assinatura de APK híbrido para proteger a identidade de assinatura do seu app contra a possível ameaça de ataques que usam computação quântica. Esse recurso apresenta um novo esquema de assinatura de APK, que permite parear uma chave de assinatura clássica (como RSA ou EC) com um novo algoritmo de criptografia pós-quântica (PQC, na sigla em inglês) (ML-DSA).

Essa abordagem híbrida garante que o app permaneça seguro contra futuros ataques quânticos, mantendo total compatibilidade com versões anteriores do Android e dispositivos que dependem da verificação de assinatura clássica.

Impacto para desenvolvedores

  • Apps que usam a Assinatura de apps do Google Play:se você usa esse recurso, pode esperar que o Google Play ofereça a opção de fazer upgrade para uma assinatura híbrida usando uma chave de PQC gerada pelo Google Play, garantindo que seu app esteja protegido sem precisar de gerenciamento manual de chaves.
  • Apps que usam chaves autogerenciadas:os desenvolvedores que gerenciam as próprias chaves de assinatura podem usar as ferramentas de build do Android atualizadas (como o apksigner) para fazer a rotação para uma identidade híbrida, combinando uma chave PQC com uma nova chave clássica. É preciso criar uma nova chave clássica, não é possível reutilizar a antiga.

Conectividade

O Android 17 adiciona os recursos abaixo para melhorar a conectividade de dispositivos e apps.

Redes de satélite restritas

Implementa otimizações para permitir que os apps funcionem de maneira eficaz em redes de satélite de baixa largura de banda.

Experiência do usuário e interface do sistema

O Android 17 inclui as mudanças a seguir para melhorar a experiência do usuário.

Controle de volume específico a assistentes

O Android 17 apresenta um controle de volume específico para apps assistivos, para reprodução com USAGE_ASSISTANT. Essa mudança separa o áudio do Assistente do fluxo de mídia padrão, oferecendo aos usuários controle isolado sobre os dois volumes. Isso permite, por exemplo, silenciar a reprodução de mídia sem afetar a audibilidade das respostas do Google Assistente, e vice-versa.

Os apps assistivos com acesso ao novo modo de áudio MODE_ASSISTANT_CONVERSATION podem melhorar ainda mais a consistência do controle de volume. Os apps do Assistente podem usar esse modo para fornecer uma dica ao sistema sobre uma sessão ativa do Assistente, garantindo que o stream do Assistente possa ser controlado fora da reprodução ativa de USAGE_ASSISTANT ou com periféricos Bluetooth conectados.

Handoff

A transferência é um novo recurso e uma nova API que serão lançados no Android 17. Os desenvolvedores de apps podem fazer a integração para oferecer continuidade entre dispositivos aos usuários. Ele permite que o usuário inicie uma atividade de app em um dispositivo Android e a transfira para outro. O Handoff é executado em segundo plano no dispositivo de um usuário e mostra as atividades disponíveis de outros dispositivos próximos do usuário por vários pontos de entrada, como o acesso rápido e a barra de tarefas, no dispositivo receptor.

Os apps podem designar o Handoff para iniciar o mesmo app Android nativo, se ele estiver instalado e disponível no dispositivo receptor. Nesse fluxo entre apps, o usuário é direcionado por link direto para a atividade designada. Como alternativa, o Handoff de app para Web pode ser oferecido como uma opção de substituição ou implementado diretamente com o Handoff de URL.

O suporte à transferência é implementado por atividade. Para ativar o Handoff, chame o método setHandoffEnabled() para a atividade. Talvez seja necessário transmitir outros dados com a transferência para que a atividade recriada no dispositivo receptor possa restaurar o estado adequado. Implemente o callback onHandoffActivityDataRequested() para retornar um objeto HandoffActivityData que contém detalhes que especificam como o Handoff deve processar e recriar a atividade no dispositivo receptor.

Atualização em tempo real: API de cores semânticas

Com o Android 17, a Atualização em Tempo Real lança as APIs de Cores Semânticas para oferecer suporte a cores com significado universal.

As seguintes classes são compatíveis com a coloração semântica:

Colorir

  • Verde: associado à segurança. Essa cor deve ser usada para informar que você está em uma situação segura.
  • Laranja: para indicar cuidado e marcar perigos físicos. Essa cor deve ser usada na situação em que os usuários precisam prestar atenção para definir uma configuração de proteção melhor.
  • Vermelho: geralmente indica perigo, pare. Ele deve ser apresentado quando você precisa da atenção das pessoas com urgência.
  • Azul: cor neutra para conteúdo informativo que deve se destacar do restante.

O exemplo a seguir mostra como aplicar estilos semânticos ao texto em uma notificação:

  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 Downlink-TDoA de UWB para Android 17

下行链路到达时间差 (DL-TDoA) 测距功能可让设备通过测量信号的相对到达时间来确定其相对于多个锚点的位置。

以下代码段演示了如何初始化测距管理器、验证设备功能以及启动 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.RangingCapabilitiesCallback {
            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 = byteArrayOf(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.RangingCapabilitiesCallback() {
            @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());
        byte[] rangingRoundIndexes = new byte[] {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
        }
    }
}

带外 (OOB) 配置

以下代码段提供了 Wi-Fi 和 BLE 的 DL-TDoA OOB 配置数据示例：

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
};

如果您因缺少 OOB 配置而无法使用该配置，或者需要更改 OOB 配置中没有的默认值，则可以使用 DlTdoaRangingParams.Builder 构建参数，如以下代码段所示。您可以使用以下参数代替 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();