Mudanças de comportamento: todos os apps

A plataforma Android 15 inclui mudanças de comportamento que podem afetar seu app. As mudanças de comportamento a seguir se aplicam a todos os apps quando executados no Android 15, independente da targetSdkVersion. Teste o app e modifique-o conforme necessário para oferecer suporte a essas mudanças, quando aplicável.

Consulte também a lista de mudanças de comportamento que afetam apenas os apps destinados ao Android 15.

Principal recurso

O Android 15 modifica ou expande vários recursos principais do sistema Android.

Mudanças no estado de pacotes interrompidos

软件包 FLAG_STOPPED 状态（用户可以通过在 AOSP build 中长按应用图标并选择“强制停止”来启用此状态）的用途一直是让应用保持在此状态，直到用户通过直接启动应用或间接与应用互动（通过 Sharesheet 或 widget、将应用选择为动态壁纸等）来明确将应用从此状态移除。在 Android 15 中，我们更新了系统行为，使其与此预期行为保持一致。应用应仅通过直接或间接的用户操作从停止状态移除。

为了支持预期行为，除了现有限制之外，当应用在搭载 Android 15 的设备上进入停止状态时，系统还会取消所有待处理 intent。当用户的操作将应用从停止状态移除时，系统会将 ACTION_BOOT_COMPLETED 广播传送到应用，以便应用有机会重新注册所有待处理 intent。

注意 ：应用使用待处理 intent 来更新应用微件。如果应用进入停止状态，系统会取消所有这些待处理 intent，并停用应用的 widget。（微件会灰显，设备用户无法与其互动。）系统会在用户下次启动应用时重新启用这些微件。

您可以调用新的 ApplicationStartInfo.wasForceStopped() 方法来确认应用是否已进入停止状态。

Suporte a tamanhos de página de 16 KB

Android 过去仅支持 4 KB 内存页面大小， 优化了系统内存性能，以针对 Android 设备通常具备的功能。从 Android 15 开始，AOSP 支持 配置为使用 16 KB (16 KB) 页面大小的设备 设备）。如果您的应用使用任何 NDK 库，请直接使用 或者通过 SDK 间接创建，那么，您需要重新构建自己的应用 支持这些 16KB 设备。

随着设备制造商不断打造出 物理内存 (RAM)，许多此类设备都会采用 16KB（以及 页面大小以优化设备的性能。正在添加 支持 16 KB 页面大小的设备，可使您的应用在这些设备上运行 并有助于您的应用从相关的广告效果中获益 改进。如果不重新编译，应用可能无法在 16KB 设备上运行 在未来的 Android 版本中正式推出。

为帮助您为应用添加支持，我们提供了有关如何检查 如果您的应用受到影响 重新构建您的应用（如果适用），以及如何在 Google Play 中 使用模拟器（包括 Android 15）的 16 KB 环境 系统映像）。

Benefícios e ganhos de desempenho

配置为使用 16 KB 页面大小的设备平均会使用略多一些的内存，但系统和应用的性能也会得到各种提升：

• 缩短了系统内存压力时的应用启动时间：平均降低了 3.16%；对于我们测试的某些应用而言，改进幅度更大（最高可达 30%）
• 应用启动期间的功耗降低：平均降低了 4.56%
• 相机启动更快：热启动速度平均提高了 4.48%，冷启动速度平均提高了 6.60%
• 缩短了系统启动时间：平均缩短了 8%（约 950 毫秒）

这些改进基于我们的初始测试，实际设备上的结果可能会有所不同。随着测试的继续进行，我们将进一步分析应用的潜在收益。

Verificar se o app é afetado

Se o app usar algum código nativo, recompile o app com suporte a dispositivos de 16 KB. Se você não tiver certeza se o app usa código nativo, use o APK Analyzer para identificar se há algum código nativo e verifique o alinhamento dos segmentos ELF para encontrar bibliotecas compartilhadas.

Se o app usa apenas código escrito na linguagem de programação Java ou Kotlin, incluindo bibliotecas ou SDKs, ele já oferece suporte a dispositivos de 16 KB. No entanto, recomendamos que você teste seu app em um ambiente de 16 KB para verificar se não há regressões inesperadas no comportamento do app.

Mudanças necessárias para que alguns apps ofereçam suporte ao espaço particular

私密空间是 Android 15 中推出的一项新功能，可让用户在设备上创建一个单独的空间，在额外的身份验证层保护下，防止敏感应用遭到窥探。由于私密空间中的应用具有受限的公开范围，因此某些类型的应用需要执行额外的步骤，才能查看和与用户私密空间中的应用互动。

所有应用

由于私密空间中的应用会保存在单独的用户资料中（类似于工作资料），因此应用不应假定其任何未位于主资料中的已安装副本都位于工作资料中。如果您的应用包含与工作资料应用相关的逻辑，并且做出了上述假设，则需要调整此逻辑。

医疗应用

当用户锁定私密空间时，私密空间中的所有应用都会停止运行，并且这些应用无法执行前台或后台活动，包括显示通知。此行为可能会严重影响安装在私密空间中的医疗应用的使用和功能。

私密空间设置体验会向用户发出警告，告知私密空间不适合需要执行关键前台或后台活动的应用，例如显示医疗应用发送的通知。不过，应用无法确定自己是否在私密空间中使用，因此无法在这种情况下向用户显示警告。

因此，如果您开发的是医疗应用，请检查此功能可能会对您的应用产生哪些影响，并采取适当的措施（例如告知用户不要在私密空间中安装您的应用），以免中断关键的应用功能。

启动器应用

如果您开发的是启动器应用，则必须执行以下操作，才能看到私密空间中的应用：

1. 您的应用必须被指定为设备的默认启动器应用，即具有 ROLE_HOME 角色。
2. 您的应用必须在应用的清单文件中声明 ACCESS_HIDDEN_PROFILES 普通权限。

声明 ACCESS_HIDDEN_PROFILES 权限的启动器应用必须处理以下私密空间用例：

1. 您的应用必须为安装在私密空间中的应用提供单独的启动器容器。使用 getLauncherUserInfo() 方法确定要处理的用户个人资料类型。
2. 用户必须能够隐藏和显示私密空间容器。
3. 用户必须能够锁定和解锁私密空间容器。使用 requestQuietModeEnabled() 方法锁定（通过传递 true）或解锁（通过传递 false）私密空间。

4. 在锁定状态下，私密空间容器中的任何应用都应不可见，也无法通过搜索等机制被发现。您的应用应为 ACTION_PROFILE_AVAILABLE 和 ACTION_PROFILE_UNAVAILABLE 广播注册接收器，并在私密空间容器的锁定或解锁状态发生变化时更新应用中的界面。这两种状态的广播都包含 EXTRA_USER，您的应用可以使用该常量来引用不公开个人资料的用户。

   您还可以使用 isQuietModeEnabled() 方法检查私密空间个人资料是否已锁定。

应用商店应用

私密空间包含一个“安装应用”按钮，用于启动隐式 intent 以将应用安装到用户的私密空间。为了让应用能够接收此隐式 intent，请在应用的清单文件中声明一个 <intent-filter>，并将 <category> 设为 CATEGORY_APP_MARKET。

A fonte de emoji baseada em PNG foi removida

O arquivo de fonte de emoji legada (NotoColorEmojiLegacy.ttf) com base em PNG foi removido, deixando apenas o arquivo baseado em vetor. A partir do Android 13 (nível 33 da API), o arquivo de fonte de emoji usado pelo renderizador de emoji do sistema mudou de um arquivo baseado em PNG para um baseado em vetor. O sistema reteve o arquivo de fonte legada no Android 13 e 14 por motivos de compatibilidade. Assim, apps com renderizadores de fontes próprios podiam continuar usando o arquivo de fonte legada até que pudessem fazer upgrade.

Para verificar se o app foi afetado, procure referências ao arquivo NotoColorEmojiLegacy.ttf no código do app.

Você pode adaptar seu app de várias maneiras:

• Use APIs da plataforma para renderização de texto. É possível renderizar texto em uma Canvas com suporte a bitmap e usá-la para receber uma imagem bruta, se necessário.
• Adicione suporte a fontes COLRv1 ao app. A biblioteca de código aberto FreeType oferece suporte a COLRv1 na versão 2.13.0 e mais recentes.
• Como último recurso, você pode agrupar o arquivo de fonte de emoji legado (NotoColorEmoji.ttf) no APK, mas, nesse caso, o app não terá as atualizações mais recentes de emoji. Para mais informações, consulte a página do projeto Noto Emoji no GitHub (em inglês).

Aumento da versão mínima do SDK de destino de 23 para 24

Android 15 基于 在 Android 14 中进行的更改，并扩展了 安全性。在 Android 15 中， 无法安装低于 24 的 targetSdkVersion。 要求应用符合现代 API 级别有助于确保更好的安全性和 保护隐私。

恶意软件通常会以较低的 API 级别为目标平台，以绕过安全和隐私 更高的 Android 版本中引入的保护机制。例如，有些恶意软件应用使用 targetSdkVersion 22，以避免受到 Android 6.0 Marshmallow（API 级别 23）在 2015 年引入的运行时权限模型的约束。这项 Android 15 变更使恶意软件更难以规避安全和隐私权方面的改进限制。尝试安装以较低 API 级别为目标平台的应用将导致安装失败，并且 Logcat 中会显示如下所示的消息：

INSTALL_FAILED_DEPRECATED_SDK_VERSION: App package must target at least SDK version 24, but found 7

在升级到 Android 15 的设备上，targetSdkVersion 级别较低的任何应用 安装在 Google Play 上

如果您需要测试以旧版 API 级别为目标平台的应用，请使用以下 ADB 命令：

adb install --bypass-low-target-sdk-block FILENAME.apk

Segurança e privacidade

O Android 15 apresenta medidas robustas para combater a fraude de senha única (OTP, na sigla em inglês) e proteger o conteúdo sensível do usuário, com foco em aumentar a proteção do serviço de listener de notificações e do compartilhamento de tela. As principais melhorias incluem a edição de OTPs de notificações acessíveis a apps não confiáveis, o ocultamento de notificações durante o compartilhamento de tela e a proteção de atividades do app quando OTPs são publicadas. O objetivo dessas mudanças é proteger o conteúdo sensível do usuário contra atores não autorizados.

Os desenvolvedores precisam estar cientes do seguinte para garantir que os apps sejam compatíveis com as mudanças no Android 15:

OTP Redaction

O Android vai impedir que apps não confiáveis que implementam um NotificationListenerService leiam conteúdo não editado de notificações em que um OTP foi detectado. Os apps confiáveis, como as associações de gerenciador de dispositivos secundário, estão isentos dessas restrições.

Proteção de compartilhamento de tela

• O conteúdo da notificação é ocultado durante as sessões de compartilhamento de tela para preservar a privacidade do usuário. Se o app implementar setPublicVersion(), o Android vai mostrar a versão pública da notificação, que serve como uma notificação de substituição em contextos não seguros. Caso contrário, o conteúdo da notificação será editado sem nenhum outro contexto.
• Conteúdo sensível, como a entrada de senha, fica oculto para os espectadores remotos para evitar a revelação de informações sensíveis do usuário.
• As atividades de apps que postam notificações durante o compartilhamento de tela em que um OTP foi detectado serão ocultas. O conteúdo do app fica oculto do espectador remoto quando é iniciado.
• Além da identificação automática de campos sensíveis do Android, os desenvolvedores podem marcar manualmente partes do app como sensíveis usando setContentSensitivity, que é ocultado dos espectadores remotos durante o compartilhamento de tela.
• Os desenvolvedores podem ativar a opção Desativar proteções do compartilhamento de tela em Opções do desenvolvedor para serem dispensados das proteções do compartilhamento de tela para fins de demonstração ou teste. O gravador de tela padrão do sistema está isento dessas mudanças, já que as gravações permanecem no dispositivo.

Câmera e mídia

O Android 15 faz as seguintes mudanças no comportamento da câmera e da mídia para todos os apps.

A reprodução de áudio direto e de transferência invalida as faixas de áudio direto ou de transferência abertas anteriormente quando os limites de recursos são atingidos

在 Android 15 之前，如果某个应用在另一个应用播放音频且达到资源限制时请求直接或分流音频播放，该应用将无法打开新的 AudioTrack。

从 Android 15 开始，当应用请求直接播放或分流播放且达到资源限制时，系统会使任何当前打开的 AudioTrack 对象失效，以防止执行新轨道请求。

（直接音轨和分流音轨通常会打开，以播放压缩音频格式。播放直接音频的常见用例包括通过 HDMI 将编码的音频流式传输到电视。分流轨道通常用于在具有硬件 DSP 加速的移动设备上播放压缩音频。）

Experiência do usuário e interface do sistema

O Android 15 inclui algumas mudanças que têm como objetivo criar uma experiência do usuário mais consistente e intuitiva.

Animações de volta preditiva ativadas para apps que ativaram a opção

从 Android 15 开始，预测性返回动画的开发者选项已被移除。现在，如果应用已完全或在 activity 级别选择启用预测性返回手势，则系统会为其显示“返回主屏幕”“跨任务”和“跨 activity”等系统动画。如果您的应用受到了影响，请执行以下操作：

• 确保您的应用已正确迁移，以使用预测性返回手势。
• 确保 fragment 转场效果可与预测性返回导航搭配使用。
• 请弃用动画和框架过渡，改用动画和 androidx 过渡。
• 从 FragmentManager 不认识的返回堆栈迁移。请改用由 FragmentManager 或 Navigation 组件管理的返回堆栈。

Widgets desativados quando o usuário interrompe um app

如果用户在搭载 Android 15 的设备上强制停止应用，系统会暂时停用该应用的所有微件。这些 widget 会灰显，用户无法与其互动。这是因为，从 Android 15 开始，当系统强制停止应用时，会取消应用的所有待处理 intent。

系统会在用户下次启动应用时重新启用这些微件。

如需了解详情，请参阅对软件包停止状态的更改。

O ícone da barra de status da projeção de mídia alerta os usuários sobre o compartilhamento, a transmissão e a gravação de tela

注意 ：搭载 Android 15 QPR1 或更高版本的设备包含此更改。

As explorações de projeção de tela expõem dados privados do usuário, como informações financeiras, porque os usuários não percebem que a tela do dispositivo está sendo compartilhada.

Para apps executados em dispositivos com o Android 15 QPR1 ou mais recente, um ícone grande e visível na barra de status alerta os usuários sobre qualquer projeção de tela em andamento. Os usuários podem tocar no ícone para impedir que a tela seja compartilhada, transmitida ou gravada. Além disso, a projeção da tela é interrompida automaticamente quando a tela do dispositivo é bloqueada.

Bloco da barra de status para compartilhamento de tela, transmissão e gravação.

检查您的应用是否受到影响

默认情况下，您的应用会包含状态栏条状标签，并会在锁定屏幕激活时自动暂停屏幕投影。

如需详细了解如何针对这些用例测试应用，请参阅状态栏条状标签和自动停止。

Restrições de acesso à rede em segundo plano

No Android 15, os apps que iniciam uma solicitação de rede fora de um ciclo de vida de processo válido recebem uma exceção. Normalmente, um UnknownHostException ou outro IOException relacionado ao soquete. As solicitações de rede que acontecem fora de um ciclo de vida válido geralmente são devido a apps que continuam uma solicitação de rede sem saber, mesmo depois que o app não está mais ativo.

Para reduzir essa exceção, use componentes com reconhecimento de ciclo de vida para garantir que as solicitações de rede tenham reconhecimento de ciclo de vida e sejam canceladas ao sair de um ciclo de vida de processo válido. Se for importante que a solicitação de rede aconteça mesmo quando o usuário sair do aplicativo, programe a solicitação de rede usando o WorkManager ou continue uma tarefa visível para o usuário usando o Serviço em primeiro plano.

Suspensões de uso

A cada versão, algumas APIs específicas do Android podem se tornar obsoletas ou precisar ser refatoradas para fornecer uma melhor experiência aos desenvolvedores ou oferecer compatibilidade com as novas funcionalidades da plataforma. Nesses casos, descontinuamos oficialmente as APIs obsoletas e direcionamos os desenvolvedores para usar APIs alternativas.

Descontinuação significa que encerramos o suporte oficial para as APIs, mas elas continuarão disponíveis para os desenvolvedores. Para saber mais sobre as descontinuações importantes nesta versão do Android, consulte a página descontinuações.