تغییرات رفتار: همه برنامه ها

پلتفرم Android 15 شامل تغییرات رفتاری است که ممکن است بر برنامه شما تأثیر بگذارد. تغییرات رفتاری زیر برای همه برنامه‌ها ، بدون توجه به targetSdkVersion ، هنگام اجرا بر روی Android 15 اعمال می‌شود. شما باید برنامه خود را آزمایش کنید و سپس آن را در صورت لزوم تغییر دهید تا در صورت لزوم از این موارد به درستی پشتیبانی شود.

مطمئن شوید که فهرستی از تغییرات رفتاری که فقط بر برنامه‌هایی که اندروید 15 را هدف قرار می‌دهند را نیز بررسی کنید.

عملکرد اصلی

اندروید 15 قابلیت های اصلی مختلف سیستم اندروید را اصلاح یا گسترش می دهد.

تغییرات در وضعیت بسته

هدف از وضعیت بسته FLAG_STOPPED (که کاربران می توانند با فشار طولانی یک نماد برنامه و انتخاب "توقف اجباری" در ساخت های AOSP شرکت کنند) همیشه این بوده است که برنامه ها را در این حالت نگه دارد تا زمانی که کاربر به طور مستقیم برنامه را از این حالت خارج کند. راه‌اندازی برنامه یا تعامل غیرمستقیم با برنامه (از طریق اشتراک‌گذاری یا ویجت، انتخاب برنامه به عنوان تصویر زمینه زنده و غیره). در اندروید 15، رفتار سیستم را به‌روزرسانی کرده‌ایم تا با این رفتار مورد نظر هماهنگ شود. برنامه ها فقط باید از طریق اقدام مستقیم یا غیرمستقیم کاربر از حالت توقف حذف شوند.

برای پشتیبانی از رفتار در نظر گرفته شده، علاوه بر محدودیت‌های موجود، هنگامی که برنامه در دستگاه دارای Android 15 به حالت توقف وارد می‌شود، سیستم علاوه بر محدودیت‌های موجود، تمام اهداف معلق را نیز لغو می‌کند. هنگامی که اقدامات کاربر برنامه را از حالت توقف خارج می‌کند، پخش ACTION_BOOT_COMPLETED انجام می‌شود. به برنامه تحویل داده می شود و فرصتی برای ثبت مجدد هرگونه نیات معلق فراهم می کند.

توجه: برنامه‌ها از اهداف معلق برای به‌روزرسانی ابزارک‌های برنامه استفاده می‌کنند. اگر برنامه‌ای وارد حالت توقف شده شود، تمام این اهداف معلق لغو می‌شوند و سیستم ابزارک‌های برنامه را غیرفعال می‌کند. (ویجت ها خاکستری هستند و کاربر دستگاه نمی تواند با آنها تعامل داشته باشد.) دفعه بعد که کاربر برنامه را راه اندازی می کند، سیستم ویجت ها را دوباره فعال می کند.

می‌توانید متد جدید ApplicationStartInfo.wasForceStopped() را فراخوانی کنید تا تأیید کنید که آیا برنامه در حالت توقف قرار گرفته است یا خیر.

پشتیبانی از اندازه صفحه 16 کیلوبایت

从历史上看，Android 仅支持 4 KB 内存页面大小，这优化了系统内存性能，以适应 Android 设备通常拥有的平均总内存量。从 Android 15 开始，AOSP 支持配置为使用 16 KB 页面大小的设备（16 KB 设备）。如果您的应用直接或通过 SDK 间接使用任何 NDK 库，则需要重新构建应用，才能在这些 16 KB 设备上运行。

随着设备制造商不断制造出具有更大物理内存 (RAM) 的设备，许多此类设备将采用 16 KB（最终甚至更大）的页面大小来优化设备性能。添加对 16 KB 页面大小设备的支持，可让您的应用在这些设备上运行，并帮助您的应用受益于相关的性能改进。如果不重新编译，应用将无法在未来 Android 版本的 16 KB 设备上运行。

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

优势和性能提升

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

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

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

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

如果您的应用使用了任何原生代码，则应重新构建应用，使其支持 16 KB 设备。如果您不确定自己的应用是否使用了原生代码，可以使用 APK 分析器来确定是否存在任何原生代码，然后检查您找到的任何共享库的 ELF 段对齐情况。Android Studio 还提供了一些功能，可帮助您自动检测对齐问题。

如果您的应用仅使用以 Java 或 Kotlin 编程语言编写的代码（包括所有库或 SDK），则该应用已支持 16 KB 设备。不过，我们建议您在 16 KB 环境中测试应用，以验证应用行为是否出现意外的回归。

تغییرات لازم برای برخی از برنامه ها برای پشتیبانی از فضای خصوصی

私密空间是 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。

فونت ایموجی مبتنی بر PNG حذف شد

فایل فونت emoji قدیمی مبتنی بر PNG ( NotoColorEmojiLegacy.ttf ) حذف شده است و فقط فایل مبتنی بر برداری باقی می ماند. با شروع Android 13 (سطح API 33)، فایل فونت emoji مورد استفاده توسط رندر ایموجی سیستم از یک فایل مبتنی بر PNG به یک فایل مبتنی بر برداری تغییر کرد . این سیستم فایل فونت قدیمی را در اندروید 13 و 14 به دلایل سازگاری حفظ کرد، به طوری که برنامه‌هایی با ارائه‌دهنده فونت خود می‌توانند به استفاده از فایل فونت قدیمی تا زمانی که قادر به ارتقا باشند ادامه دهند.

برای بررسی اینکه آیا برنامه شما تحت تأثیر قرار گرفته است، کد برنامه خود را برای ارجاع به فایل NotoColorEmojiLegacy.ttf جستجو کنید.

می‌توانید برنامه خود را به روش‌های مختلفی تطبیق دهید:

• از API های پلتفرم برای رندر متن استفاده کنید. می‌توانید متن را به یک Canvas با پشتوانه بیت‌مپ رندر کنید و در صورت لزوم از آن برای دریافت تصویر خام استفاده کنید.
• پشتیبانی از فونت COLRv1 را به برنامه خود اضافه کنید. کتابخانه منبع باز FreeType از COLRv1 در نسخه 2.13.0 و بالاتر پشتیبانی می کند.
• به‌عنوان آخرین راه‌حل، می‌توانید فایل فونت emoji قدیمی ( NotoColorEmoji.ttf ) را در APK خود قرار دهید، اگرچه در این صورت برنامه شما آخرین به‌روزرسانی‌های ایموجی را از دست خواهد داد. برای اطلاعات بیشتر، به صفحه پروژه Noto Emoji GitHub مراجعه کنید.

حداقل نسخه SDK هدف از 23 به 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

امنیت و حریم خصوصی

Android 15 引入了强大的措施来防范动态密码 (OTP) 欺诈并保护用户的敏感内容，重点是增强通知监听器服务和屏幕共享保护措施。主要增强功能包括从可供不可信应用访问的通知中隐去 OTP、在屏幕共享期间隐藏通知，以及在发布 OTP 时保护应用 activity。这些变更旨在保护用户的敏感内容，使其免受未经授权的操作者的侵害。

开发者需要注意以下事项，以确保其应用与 Android 15 中的变更兼容：

动态密码隐去

Android 会阻止实现 NotificationListenerService 的不受信任应用读取已检测到 OTP 的通知中的未隐去的内容。配套设备管理器关联等受信任应用不受这些限制。

屏幕共享保护

• 在屏幕共享会话期间，系统会隐藏通知内容，以保护用户的隐私。如果应用实现了 setPublicVersion()，Android 会显示通知的公开版本，该版本在不安全情境中用作替换通知。否则，系统会隐去通知内容，不提供任何其他背景信息。
• 系统会向远程观看者隐藏密码输入等敏感内容，以防止泄露用户的敏感信息。
• 如果在屏幕共享期间检测到动态密码，系统会隐藏在该时间段内发布通知的应用的活动。应用内容在启动时会向远程查看器隐藏。
• 除了 Android 自动识别敏感字段之外，开发者还可以使用 setContentSensitivity 手动将应用的部分标记为敏感，在屏幕共享期间，这些敏感字段会对远程观看者隐藏。
• 开发者可以选择切换开发者选项下的停用屏幕共享防护选项，以便出于演示或测试目的豁免屏幕共享防护。默认的系统屏幕录制工具不受这些更改的影响，因为录制内容会保留在设备上。

دوربین و رسانه

اندروید 15 تغییرات زیر را در رفتار دوربین و رسانه برای همه برنامه ها ایجاد می کند.

پخش مستقیم و بدون بارگیری آهنگ های صوتی که قبلاً باز شده یا مستقیماً بارگیری شده اند با رسیدن به محدودیت های منابع، باطل می شوند.

Before Android 15, if an app requested direct or offload audio playback while another app was playing audio and the resource limits were reached, the app would fail to open a new AudioTrack.

Beginning with Android 15, when an app requests direct or offload playback and the resource limits are reached, the system invalidates any currently open AudioTrack objects which prevent fulfilling the new track request.

(Direct and offload audio tracks are typically opened for playback of compressed audio formats. Common use-cases for playing direct audio include streaming encoded audio over HDMI to a TV. Offload tracks are typically used to play compressed audio on a mobile device with hardware DSP acceleration.)

تجربه کاربری و رابط کاربری سیستم

اندروید 15 شامل تغییراتی است که برای ایجاد یک تجربه کاربری سازگارتر و بصری در نظر گرفته شده است.

انیمیشن‌های پیش‌بینی‌کننده پشتی برای برنامه‌هایی که شرکت کرده‌اند فعال شد

با شروع اندروید 15، گزینه توسعه دهنده برای انیمیشن های پیش بینی کننده پشت حذف شده است. اکنون انیمیشن‌های سیستمی مانند بازگشت به خانه، تکلیف متقابل و فعالیت متقابل برای برنامه‌هایی ظاهر می‌شوند که به طور کامل یا در سطح فعالیت در ژست بازگشت پیش‌بینی‌کننده شرکت کرده‌اند . اگر برنامه شما تحت تأثیر قرار گرفته است، اقدامات زیر را انجام دهید:

• مطمئن شوید که برنامه شما به درستی منتقل شده است تا از ژست بازگشت پیش بینی کننده استفاده کنید.
• اطمینان حاصل کنید که انتقال قطعه شما با ناوبری پیش‌بینی کننده به عقب کار می‌کند.
• از انتقال انیمیشن و فریمورک دور شوید و به جای آن از انتقال انیماتور و اندرویدکس استفاده کنید.
• از پشته‌هایی که FragmentManager از آن‌ها اطلاعی ندارد، مهاجرت کنید. به جای آن از پشته های پشته ای استفاده کنید که توسط FragmentManager یا مؤلفه Navigation مدیریت می شوند.

وقتی کاربر برنامه‌ای را به اجبار متوقف می‌کند، ابزارک‌ها غیرفعال می‌شوند

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

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

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

تراشه نوار وضعیت نمایش رسانه به کاربران از اشتراک‌گذاری صفحه نمایش، ارسال محتوا و ضبط هشدار می‌دهد

توجه: این تغییر در دستگاه‌های دارای Android 15 QPR1 یا بالاتر اعمال می‌شود.

بهره‌برداری‌های پیش‌بینی صفحه، داده‌های خصوصی کاربر مانند اطلاعات مالی را در معرض دید کاربران قرار می‌دهند، زیرا کاربران متوجه نمی‌شوند که صفحه دستگاهشان به اشتراک گذاشته می‌شود.

برای برنامه‌هایی که روی دستگاه‌های دارای Android 15 QPR1 یا بالاتر اجرا می‌شوند، یک تراشه نوار وضعیت که بزرگ و برجسته است، به کاربران هشدار می‌دهد که هر گونه نمایش صفحه نمایش در حال پیشرفت را نشان دهند. کاربران می‌توانند روی تراشه ضربه بزنند تا از اشتراک‌گذاری، پخش یا ضبط صفحه نمایش خود جلوگیری کنند. همچنین، با قفل شدن صفحه نمایش دستگاه، نمایش صفحه به طور خودکار متوقف می شود.

用于屏幕共享、投屏和录制的状态栏条状标签。

بررسی کنید که آیا برنامه شما تحت تأثیر قرار گرفته است

به طور پیش‌فرض، برنامه شما شامل تراشه نوار وضعیت است و به‌طور خودکار نمایش صفحه نمایش را با فعال شدن صفحه قفل به حالت تعلیق در می‌آورد.

برای کسب اطلاعات بیشتر درباره نحوه آزمایش برنامه خود برای این موارد استفاده، به تراشه نوار وضعیت و توقف خودکار مراجعه کنید.

محدودیت های دسترسی به شبکه پس زمینه

在 Android 15 中，如果应用在有效的进程生命周期之外启动网络请求，则会收到异常。通常是 UnknownHostException 或其他与套接字相关的 IOException。在有效生命周期之外发生的网络请求通常是因为应用在不再活跃后，不知不觉地继续发出网络请求。

为缓解此异常，请使用生命周期感知型组件，确保您的网络请求具有生命周期感知功能，并在离开有效的进程生命周期时取消。如果您非常重视即使用户离开应用也要发出网络请求，请考虑使用 WorkManager 调度网络请求，或使用前台服务继续执行对用户可见的任务。

تحقیرها

با هر انتشار، APIهای خاص Android ممکن است منسوخ شوند یا برای ارائه تجربه بهتر توسعه‌دهنده یا پشتیبانی از قابلیت‌های پلتفرم جدید نیاز به بازسازی داشته باشند. در این موارد، ما رسماً API های منسوخ شده را منسوخ می کنیم و توسعه دهندگان را به API های جایگزین هدایت می کنیم تا به جای آن از آنها استفاده کنند.

منسوخ شدن به این معنی است که ما به پشتیبانی رسمی از API ها پایان داده ایم، اما آنها همچنان در دسترس توسعه دهندگان خواهند بود. برای کسب اطلاعات بیشتر در مورد منسوخ شدن های قابل توجه در این نسخه از Android، به صفحه منسوخ شدن ها مراجعه کنید.