نمای کلی ویژگی ها و API ها

اندروید 14 ویژگی ها و API های عالی را برای توسعه دهندگان معرفی می کند. موارد زیر به شما کمک می کند تا با ویژگی های برنامه های خود آشنا شوید و با API های مرتبط شروع به کار کنید.

برای فهرست دقیق APIهای اضافه شده، اصلاح شده و حذف شده، گزارش تفاوت API را بخوانید. برای جزئیات بیشتر در مورد APIهای اضافه شده به مرجع Android API مراجعه کنید — برای Android 14، به دنبال APIهایی باشید که در سطح API 34 اضافه شده اند. برای آشنایی با مناطقی که تغییرات پلت فرم ممکن است بر برنامه های شما تأثیر بگذارد، حتماً تغییرات رفتار Android 14 را برای برنامه هایی که Android 14 را هدف قرار می دهند و برای همه برنامه ها بررسی کنید.

بین المللی شدن

ترجیحات زبان برای هر برنامه

Android 14 扩展了 Android 13（API 级别 33）中引入的按应用设定语言功能，并包含以下额外功能：

  • 自动生成应用的 localeConfig：从 Android Studio Giraffe Canary 7 和 AGP 8.1.0-alpha07 开始，您可以将应用配置为自动支持各应用语言偏好设定。Android Gradle 插件会根据您的项目资源生成 LocaleConfig 文件，并在最终清单文件中添加对该文件的引用，这样您就不再需要手动创建或更新该文件。AGP 使用应用模块的 res 文件夹中的资源以及任何库模块依赖项来确定要在 LocaleConfig 文件中添加的语言区域。

  • 动态更新应用的 localeConfig：使用 LocaleManager 方法中的 setOverrideLocaleConfig() 和 getOverrideLocaleConfig() 可以在设备的系统设置中动态更新应用的受支持语言列表。有了这种灵活性，您可以按区域自定义支持的语言列表、运行 A/B 实验，或者如果您的应用通过服务器端推送进行本地化，则可以提供更新后的语言区域列表。

  • 输入法 (IME) 的应用语言可见性：IME 可以利用 getApplicationLocales() 方法查看当前应用的语言，并将 IME 语言与该语言进行匹配。

Grammatical Inflection API

有 30 亿人在使用区分性别的语言，此类语言的语法类别（例如名词、动词、形容词和介词）会根据您交谈所涉及的人或物的性别而变化。传统上，许多区分性别的语言使用阳性语法性别作为默认或通用性别。

以错误的语法性别来称呼用户，例如以阳性语法性别来称呼女性，可能会对她们的表现和态度产生负面影响。相比之下，界面语言如果能正确反映用户的语法性别，就可以提高用户互动度，并提供更个性化、更自然的用户体验。

为帮助您针对区分性别的语言构建以用户为中心的界面，Android 14 引入了 Grammatical Inflection API，让您无需重构应用便能添加对语法性别的支持。

ترجیحات منطقه ای

Regional preferences enable users to personalize temperature units, the first day of the week, and numbering systems. A European living in the United States might prefer temperature units to be in Celsius rather than Fahrenheit and for apps to treat Monday as the beginning of the week instead of the US default of Sunday.

New Android Settings menus for these preferences provide users with a discoverable and centralized location to change app preferences. These preferences also persist through backup and restore. Several APIs and intents—such as getTemperatureUnit and getFirstDayOfWeek— grant your app read access to user preferences, so your app can adjust how it displays information. You can also register a BroadcastReceiver on ACTION_LOCALE_CHANGED to handle locale configuration changes when regional preferences change.

To find these settings, open the Settings app and navigate to System > Languages & input > Regional preferences.

Regional preferences screen in Android system settings.
Temperature options for regional preferences in Android system settings.

قابلیت دسترسی

مقیاس بندی فونت غیر خطی تا 200٪

با شروع اندروید 14، این سیستم از مقیاس بندی فونت تا 200% پشتیبانی می کند، گزینه های دسترسی اضافی را به کاربران کم بینا ارائه می دهد که با دستورالعمل های دسترسی به محتوای وب (WCAG) مطابقت دارد.

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

برنامه خود را با مقیاس بندی فونت غیرخطی آزمایش کنید

حداکثر اندازه فونت را در تنظیمات دسترسی دستگاه فعال کنید تا برنامه خود را آزمایش کنید.

اگر قبلاً از واحدهای پیکسل های مقیاس شده (sp) برای تعریف اندازه متن استفاده می کنید، این گزینه های اضافی و بهبودهای مقیاس بندی به طور خودکار روی متن در برنامه شما اعمال می شوند. با این حال، همچنان باید تست UI را با حداکثر اندازه فونت فعال (200%) انجام دهید تا مطمئن شوید که برنامه شما اندازه فونت را به درستی اعمال می‌کند و می‌تواند اندازه فونت‌های بزرگ‌تر را بدون تأثیرگذاری بر قابلیت استفاده، در خود جای دهد.

برای فعال کردن اندازه فونت 200٪، مراحل زیر را دنبال کنید:

  1. برنامه تنظیمات را باز کنید و به Accessibility > Display size and text بروید.
  2. برای گزینه اندازه قلم ، همانطور که در تصویر همراه با این بخش نشان داده شده است، روی نماد مثبت (+) ضربه بزنید تا حداکثر تنظیم اندازه قلم فعال شود.

برای اندازه‌های متن از واحدهای پیکسل کوچک شده (sp) استفاده کنید

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

از واحدهای sp برای لایه‌بندی استفاده نکنید یا ارتفاع دید را با فرض لایه‌بندی ضمنی تعریف نکنید: با مقیاس‌بندی فونت غیرخطی، ابعاد sp ممکن است متناسب نباشد، بنابراین 4sp + 20sp ممکن است با 24sp برابر نباشد.

تبدیل واحدهای پیکسل مقیاس شده (sp).

از TypedValue.applyDimension() برای تبدیل واحدهای sp به پیکسل و از TypedValue.deriveDimension() برای تبدیل پیکسل ها به sp استفاده کنید. این روش ها منحنی مقیاس بندی غیرخطی مناسب را به طور خودکار اعمال می کنند.

از معادلات کدگذاری سخت با استفاده از Configuration.fontScale یا DisplayMetrics.scaledDensity اجتناب کنید. از آنجایی که مقیاس فونت غیرخطی است، فیلد scaledDensity دیگر دقیق نیست. فیلد fontScale باید فقط برای مقاصد اطلاعاتی استفاده شود زیرا فونت‌ها دیگر با یک مقدار اسکالر مقیاس‌بندی نمی‌شوند.

از واحدهای sp برای lineHeight استفاده کنید

همیشه android:lineHeight با استفاده از واحدهای sp به جای dp تعریف کنید، بنابراین ارتفاع خط همراه با متن شما مقیاس شود. در غیر این صورت، اگر متن شما sp است اما lineHeight شما به صورت dp یا px است، مقیاس نمی‌شود و تنگ به نظر می‌رسد. TextView به طور خودکار lineHeight را تصحیح می کند تا نسبت های مورد نظر شما حفظ شود، اما تنها در صورتی که هر دو textSize و lineHeight در واحدهای sp تعریف شده باشند.

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

Ultra HDR برای تصاویر

تصویری از محدوده دینامیکی استاندارد (SDR) در مقابل کیفیت تصویر با محدوده دینامیکی بالا (HDR).

اندروید 14 از تصاویر با محدوده دینامیکی بالا (HDR) پشتیبانی می کند که اطلاعات بیشتری را از حسگر هنگام عکس گرفتن حفظ می کند، که رنگ های زنده و کنتراست بیشتر را امکان پذیر می کند. اندروید از فرمت Ultra HDR استفاده می‌کند که کاملاً با تصاویر JPEG سازگار است و به برنامه‌ها اجازه می‌دهد تا به طور یکپارچه با تصاویر HDR تعامل داشته باشند و در صورت نیاز آنها را در محدوده دینامیک استاندارد (SDR) نمایش دهند.

رندر کردن این تصاویر در رابط کاربری در HDR زمانی که برنامه شما استفاده از رابط کاربری HDR را برای پنجره فعالیت خود انتخاب می‌کند، چه از طریق ورودی مانیفست یا در زمان اجرا با فراخوانی Window.setColorMode() به طور خودکار توسط چارچوب انجام می‌شود. همچنین می توانید تصاویر ثابت Ultra HDR فشرده شده را در دستگاه های پشتیبانی شده ضبط کنید. با بازیابی رنگ های بیشتر از حسگر، ویرایش در پست می تواند انعطاف پذیرتر باشد. Gainmap مرتبط با تصاویر Ultra HDR می تواند برای رندر آنها با استفاده از OpenGL یا Vulkan استفاده شود.

،
تصویری از محدوده دینامیکی استاندارد (SDR) در مقابل کیفیت تصویر با محدوده دینامیکی بالا (HDR).

اندروید 14 از تصاویر با محدوده دینامیکی بالا (HDR) پشتیبانی می کند که اطلاعات بیشتری را از حسگر هنگام عکس گرفتن حفظ می کند، که رنگ های زنده و کنتراست بیشتر را امکان پذیر می کند. اندروید از فرمت Ultra HDR استفاده می‌کند که کاملاً با تصاویر JPEG سازگار است و به برنامه‌ها اجازه می‌دهد تا به طور یکپارچه با تصاویر HDR تعامل داشته باشند و در صورت نیاز آنها را در محدوده دینامیک استاندارد (SDR) نمایش دهند.

رندر کردن این تصاویر در رابط کاربری در HDR زمانی که برنامه شما استفاده از رابط کاربری HDR را برای پنجره فعالیت خود انتخاب می‌کند، چه از طریق ورودی مانیفست یا در زمان اجرا با فراخوانی Window.setColorMode() به طور خودکار توسط چارچوب انجام می‌شود. همچنین می توانید تصاویر ثابت Ultra HDR فشرده شده را در دستگاه های پشتیبانی شده ضبط کنید. با بازیابی رنگ های بیشتر از حسگر، ویرایش در پست می تواند انعطاف پذیرتر باشد. Gainmap مرتبط با تصاویر Ultra HDR می تواند برای رندر آنها با استفاده از OpenGL یا Vulkan استفاده شود.

زوم، فوکوس، Postview و موارد دیگر در پسوند دوربین

Android 14 升级并改进了相机扩展程序，让应用能够处理更长的处理时间，从而支持在受支持的设备上使用计算密集型算法（例如弱光摄影）来改善图片。这些功能可让用户在使用相机扩展功能时获得更出色的体验。这些改进的示例包括：

زوم درون سنسور

当 CameraCharacteristics 中的 REQUEST_AVAILABLE_CAPABILITIES_STREAM_USE_CASE 包含 SCALER_AVAILABLE_STREAM_USE_CASES_CROPPED_RAW 时，您的应用可以使用高级传感器功能，将剪裁后的 RAW 数据流的像素与全视野范围相同，方法是将 CaptureRequest 与将数据流用例设置为 CameraMetadata.SCALER_AVAILABLE_STREAM_USE_CASES_CROPPED_RAW 的 RAW 目标搭配使用。通过实现请求替换控件，更新后的相机可让用户在其他相机控件准备就绪之前使用缩放控件。

صدای USB بدون اتلاف

Android 14 gains support for lossless audio formats for audiophile-level experiences over USB wired headsets. You can query a USB device for its preferred mixer attributes, register a listener for changes in preferred mixer attributes, and configure mixer attributes using the AudioMixerAttributes class. This class represents the format, such as channel mask, sample rate, and behavior of the audio mixer. The class allows for audio to be sent directly, without mixing, volume adjustment, or processing effects.

بهره وری توسعه دهندگان و ابزار

مدیر اعتبار

Android 14 将 Credential Manager 添加为平台 API，并通过使用 Google Play 服务的 Jetpack 库，向后额外支持 Android 4.4（API 级别 19）设备。Credential Manager 旨在通过 API 使用用户配置的凭据提供程序检索和存储凭据，让用户更轻松地登录。Credential Manager 在单个 API 中支持多种登录方法，包括用户名和密码、通行密钥和联合登录解决方案（如“使用 Google 账号登录”）。

通行密钥具有许多优势。例如，通行密钥是基于业界标准构建的，可在各种不同的操作系统和浏览器生态系统中使用，并且可用于网站和应用。

如需了解详情，请参阅 Credential Manager 和通行密钥文档以及介绍 Credential Manager 和通行密钥的博文。

Health Connect

Health Connect یک مخزن روی دستگاه برای داده های سلامت و تناسب اندام کاربر است. این به کاربران اجازه می دهد تا داده ها را بین برنامه های مورد علاقه خود به اشتراک بگذارند، با یک مکان واحد برای کنترل داده هایی که می خواهند با این برنامه ها به اشتراک بگذارند.

در دستگاه‌هایی که نسخه‌های اندرویدی قبل از Android 14 دارند، Health Connect برای دانلود به عنوان یک برنامه در فروشگاه Google Play در دسترس است. با شروع اندروید 14، Health Connect بخشی از پلتفرم است و به‌روزرسانی‌ها را از طریق به‌روزرسانی‌های سیستم Google Play بدون نیاز به دانلود جداگانه دریافت می‌کند. با این کار، Health Connect می‌تواند به‌طور مکرر به‌روزرسانی شود و برنامه‌های شما می‌توانند متکی باشند که Health Connect در دستگاه‌های دارای Android نسخه ۱۴ یا بالاتر در دسترس است. کاربران می‌توانند با کنترل‌های حریم خصوصی که در تنظیمات سیستم یکپارچه شده‌اند، از تنظیمات دستگاه خود به Health Connect دسترسی داشته باشند.

کاربران می‌توانند بدون دانلود برنامه جداگانه در دستگاه‌های دارای Android نسخه ۱۴ یا بالاتر، از Health Connect استفاده کنند.
کاربران می توانند از طریق تنظیمات سیستم کنترل کنند که کدام برنامه ها به داده های سلامتی و تناسب اندام آنها دسترسی دارند.

Health Connect شامل چندین ویژگی جدید در اندروید 14 است، مانند مسیرهای ورزشی، که به کاربران امکان می دهد مسیری از تمرین خود را به اشتراک بگذارند که می تواند بر روی نقشه تجسم شود. مسیر به عنوان لیستی از مکان‌های ذخیره شده در یک پنجره زمانی تعریف می‌شود و برنامه شما می‌تواند مسیرها را در جلسات تمرین وارد کند و آنها را به هم گره بزند. برای اطمینان از اینکه کاربران کنترل کاملی بر این داده های حساس دارند، کاربران باید به اشتراک گذاری مسیرهای فردی با سایر برنامه ها را اجازه دهند.

برای اطلاعات بیشتر، به مستندات Health Connection و پست وبلاگ در مورد چه چیزی در سلامت Android جدید است مراجعه کنید.

به روز رسانی OpenJDK 17

Android 14 continues the work of refreshing Android's core libraries to align with the features in the latest OpenJDK LTS releases, including both library updates and Java 17 language support for app and platform developers.

The following features and improvements are included:

  • Updated approximately 300 java.base classes to Java 17 support.
  • Text Blocks, which introduce multi-line string literals to the Java programming language.
  • Pattern Matching for instanceof, which allows an object to be treated as having a specific type in an instanceof without any additional variables.
  • Sealed classes, which allow you restrict which classes and interfaces can extend or implement them.

Thanks to Google Play system updates (Project Mainline), over 600 million devices are enabled to receive the latest Android Runtime (ART) updates that include these changes. This is part of our commitment to give apps a more consistent, secure environment across devices, and to deliver new features and capabilities to users independent of platform releases.

Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.

بهبود برای فروشگاه های برنامه

Android 14 چندین API PackageInstaller را معرفی می کند که به فروشگاه های برنامه اجازه می دهد تا تجربه کاربری خود را بهبود بخشند.

قبل از دانلود، تأیید نصب را درخواست کنید

نصب یا به‌روزرسانی یک برنامه ممکن است به تأیید کاربر نیاز داشته باشد. به عنوان مثال، هنگامی که نصب کننده ای که از مجوز REQUEST_INSTALL_PACKAGES استفاده می کند، سعی می کند یک برنامه جدید را نصب کند. در نسخه‌های قبلی اندروید، فروشگاه‌های برنامه فقط می‌توانند تأیید کاربر را پس از نوشتن فایل‌های APK در جلسه نصب و انجام جلسه درخواست کنند.

با شروع Android 14، متد requestUserPreapproval() به نصب‌کنندگان این امکان را می‌دهد تا قبل از انجام جلسه نصب درخواست تأیید کاربر کنند. این بهبود به فروشگاه برنامه اجازه می‌دهد دانلود هر فایل APK را تا زمانی که نصب توسط کاربر تأیید شود به تعویق بیاندازد. علاوه بر این، هنگامی که کاربر نصب را تأیید کرد، فروشگاه برنامه می‌تواند برنامه را در پس‌زمینه دانلود و نصب کند بدون اینکه کاربر مزاحم شود.

مسئولیت به روز رسانی های آینده را به عهده بگیرید

متد setRequestUpdateOwnership() به نصب کننده اجازه می دهد تا به سیستم نشان دهد که قصد دارد مسئول به روز رسانی های بعدی برنامه ای باشد که در حال نصب است. این قابلیت اجرای مالکیت به‌روزرسانی را فعال می‌کند، به این معنی که فقط مالک به‌روزرسانی مجاز است به‌روزرسانی‌های خودکار را برای برنامه نصب کند. اجرای مالکیت به‌روزرسانی کمک می‌کند تا اطمینان حاصل شود که کاربران به‌روزرسانی‌ها را فقط از فروشگاه برنامه مورد انتظار دریافت می‌کنند.

هر نصب‌کننده دیگری، از جمله کسانی که از مجوز INSTALL_PACKAGES استفاده می‌کنند، باید تأیید صریح کاربر را برای نصب به‌روزرسانی دریافت کنند. اگر کاربری تصمیم بگیرد به‌روزرسانی را از منبع دیگری ادامه دهد، مالکیت به‌روزرسانی از بین می‌رود.

برنامه‌ها را در زمان‌های کم‌تر به‌روزرسانی کنید

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

با شروع Android 14، InstallConstraints API راهی را به نصب‌کنندگان می‌دهد تا اطمینان حاصل کنند که به‌روزرسانی‌های برنامه‌شان در یک لحظه مناسب انجام می‌شود. به عنوان مثال، یک فروشگاه برنامه می تواند متد commitSessionAfterInstallConstraintsAreMet() را فراخوانی کند تا مطمئن شود که به روز رسانی تنها زمانی انجام می شود که کاربر دیگر با برنامه مورد نظر تعامل نداشته باشد.

یکپارچه تقسیم های اختیاری را نصب کنید

با تقسیم‌بندی APK، ویژگی‌های یک برنامه را می‌توان در فایل‌های APK جداگانه به جای یک APK یکپارچه ارائه کرد. Split APK به فروشگاه‌های برنامه اجازه می‌دهد تا تحویل اجزای مختلف برنامه را بهینه کنند. به عنوان مثال، فروشگاه های برنامه ممکن است بر اساس ویژگی های دستگاه مورد نظر بهینه سازی کنند. PackageInstaller API از زمان معرفی آن در سطح 22 API از تقسیمات پشتیبانی می کند.

در اندروید 14، متد setDontKillApp() به نصب کننده اجازه می دهد تا نشان دهد که فرآیندهای در حال اجرا برنامه نباید در هنگام نصب اسپلیت های جدید از بین بروند. فروشگاه های برنامه می توانند از این ویژگی برای نصب یکپارچه ویژگی های جدید یک برنامه در زمانی که کاربر از برنامه استفاده می کند استفاده کنند.

بسته‌های فراداده برنامه

从 Android 14 开始，Android 软件包安装程序可让您指定应用元数据（例如数据安全做法），以在 Google Play 等应用商店页面上架。

تشخیص زمانی که کاربران از دستگاه عکس می گیرند

为了打造更加标准化的屏幕截图检测体验，Android 14 引入了可保护隐私的屏幕截图检测 API。借助此 API，应用可以按 activity 注册回调。如果用户在该 activity 可见时截取屏幕截图，系统会调用这些回调并通知用户。

تجربه کاربری

اقدامات سفارشی اشتراک‌گذاری و رتبه‌بندی بهبود یافته

Android 14 更新了系统 Sharesheet，以便为用户提供自定义应用操作和信息更丰富的预览结果。

添加自定义操作

对于 Android 14，您的应用可以向其调用的系统 Sharesheet 添加自定义操作。

分享表格中自定义操作的屏幕截图。

提高直接共享目标的排名

Android 14 根据来自应用的更多信号来确定直接共享目标的排名，以便为用户提供更实用的结果。为了提供最实用的排名信号，请遵循提高直接共享目标排名的准则。通讯应用还可以报告出站和入站消息的快捷方式使用情况。

共享表单中的“直接分享”行，如 1
所示

پشتیبانی از انیمیشن های داخلی و سفارشی برای Predictive Back

视频：预测性返回动画

Android 13 在开发者选项背后引入了预测性“返回主屏幕”动画。在已启用开发者选项的受支持应用中使用时，滑回手势会显示动画，表明返回手势会使应用退回到主屏幕。

Android 14 包含针对“预测性返回”的多项改进和新指南：

在此 Android 14 预览版中，所有预测性返回功能都是位于开发者选项背后。请参阅与将您的应用迁移到预测性返回有关的开发者指南，以及与创建自定义应用内转换有关的开发者指南。

تولیدکننده دستگاه صفحه بزرگ برای هر برنامه لغو می شود

借助按应用替换项，设备制造商可以更改应用在大屏设备上的行为。例如，FORCE_RESIZE_APP 替换项会指示系统调整应用大小以适应显示屏尺寸（避免进入尺寸兼容模式），即使在应用清单中设置了 resizeableActivity="false" 也是如此。

替换项旨在改善大屏设备上的用户体验。

借助新的清单属性，您可以为应用停用某些设备制造商替换项。

صفحه نمایش بزرگ کاربر در هر برنامه لغو می شود

按应用替换项会更改应用在大屏设备上的行为。例如，无论应用的配置如何，OVERRIDE_MIN_ASPECT_RATIO_LARGE 设备制造商替换项都会将应用宽高比设置为 16:9。

借助 Android 14 QPR1，用户可以在大屏设备上通过新的设置菜单应用按应用替换项。

اشتراک گذاری صفحه نمایش برنامه

App screen sharing enables users to share an app window instead of the entire device screen during screen content recording.

With app screen sharing, the status bar, navigation bar, notifications, and other system UI elements are excluded from the shared display. Only the content of the selected app is shared.

App screen sharing improves productivity and privacy by enabling users to run multiple apps but limit content sharing to a single app.

پاسخ هوشمند مبتنی بر LLM در Gboard در Pixel 8 Pro

On Pixel 8 Pro devices with the December Feature Drop, developers can try out higher-quality smart replies in Gboard powered by on-device Large Language Models (LLMs) running on Google Tensor.

This feature is available as a limited preview for US English in WhatsApp, Line, and KakaoTalk. It requires using a Pixel 8 Pro device with Gboard as your keyboard.

To try it out, first enable the feature in Settings > Developer Options > AiCore Settings > Enable Aicore Persistent.

Next, open a conversation in a supported app to see LLM-powered Smart Reply in Gboard's suggestion strip in response to incoming messages.

Gboard utilizes on-device LLMs to provide higher-quality smart replies.

گرافیک

مسیرها قابل پرس و جو و درون یابی هستند

Android 的 Path API 是一种强大且灵活的机制，可用于创建和渲染矢量图形，能够描边或填充路径、根据线段或二次曲线或立方曲线构建路径、执行布尔运算以获取更复杂的形状，或同时执行所有这些操作。但有一个限制是，您无法了解 Path 对象中实际包含的内容；该对象的内部信息在创建后对调用方是不透明的。

如需创建 Path，您可以调用 moveTo()、lineTo() 和 cubicTo() 等方法来添加路径段。但是，无法询问该路径有哪些片段，因此您必须在创建时保留该信息。

从 Android 14 开始，您可以查询路径以了解其内部内容。首先，您需要使用 Path.getPathIterator API 获取 PathIterator 对象：

Kotlin

val path = Path().apply {
    moveTo(1.0f, 1.0f)
    lineTo(2.0f, 2.0f)
    close()
}
val pathIterator = path.pathIterator

Java

Path path = new Path();
path.moveTo(1.0F, 1.0F);
path.lineTo(2.0F, 2.0F);
path.close();
PathIterator pathIterator = path.getPathIterator();

接下来，您可以调用 PathIterator 逐个遍历片段，并检索每个片段的所有必要数据。以下示例使用了 PathIterator.Segment 对象，它会为您打包数据：

Kotlin

for (segment in pathIterator) {
    println("segment: ${segment.verb}, ${segment.points}")
}

Java

while (pathIterator.hasNext()) {
    PathIterator.Segment segment = pathIterator.next();
    Log.i(LOG_TAG, "segment: " + segment.getVerb() + ", " + segment.getPoints());
}

PathIterator 还有一个非分配版 next()，您可以在其中传入缓冲区来保存点数据。

查询 Path 数据的一个重要用例是插值。例如，您可能想在两个不同的路径之间添加动画（或变形）。为了进一步简化该用例，Android 14 针对 Path 还包含 interpolate() 方法。假设两个路径具有相同的内部结构，interpolate() 方法会使用该插值结果创建一个新的 Path。以下示例返回了一个形状介于 path 和 otherPath 之间的一半（线性插值为 0.5）的路径：

Kotlin

val interpolatedResult = Path()
if (path.isInterpolatable(otherPath)) {
    path.interpolate(otherPath, .5f, interpolatedResult)
}

Java

Path interpolatedResult = new Path();
if (path.isInterpolatable(otherPath)) {
    path.interpolate(otherPath, 0.5F, interpolatedResult);
}

Jetpack graphics-path 库也为早期版本的 Android 启用了类似的 API。

مش های سفارشی با سایه زن های راس و قطعه

Android has long supported drawing triangle meshes with custom shading, but the input mesh format has been limited to a few predefined attribute combinations. Android 14 adds support for custom meshes, which can be defined as triangles or triangle strips, and can, optionally, be indexed. These meshes are specified with custom attributes, vertex strides, varying, and vertex and fragment shaders written in AGSL.

The vertex shader defines the varyings, such as position and color, while the fragment shader can optionally define the color for the pixel, typically by using the varyings created by the vertex shader. If color is provided by the fragment shader, it is then blended with the current Paint color using the blend mode selected when drawing the mesh. Uniforms can be passed into the fragment and vertex shaders for additional flexibility.

رندر بافر سخت افزاری برای Canvas

协助使用 Android 的 Canvas API 通过 硬件加速至 HardwareBuffer、Android 14 引入了 HardwareBufferRenderer。如果您的用例涉及通过 SurfaceControl 与系统合成器通信以实现低延迟绘制，此 API 特别有用。