نظرة عامة على الميزات وواجهات برمجة التطبيقات

يقدّم الإصدار Android 14 ميزات وواجهات برمجة تطبيقات رائعة للمطوّرين. تساعدك المعلومات التالية في التعرّف على ميزات تطبيقاتك والبدء في استخدام واجهات برمجة التطبيقات ذات الصلة.

للحصول على قائمة مفصّلة بواجهات برمجة التطبيقات التي تمت إضافتها وتعديلها وإزالتها، يُرجى الاطّلاع على تقرير الاختلافات في واجهات برمجة التطبيقات. للحصول على تفاصيل حول واجهات برمجة التطبيقات المضافة، يُرجى الانتقال إلى مرجع واجهة برمجة تطبيقات Android. بالنسبة إلى نظام التشغيل Android 14، ابحث عن واجهات برمجة التطبيقات التي تمت إضافتها في المستوى 34 لواجهة برمجة التطبيقات. للتعرّف على المجالات التي قد تؤثّر فيها تغييرات النظام الأساسي في تطبيقاتك، احرص على الاطّلاع على تغييرات السلوك في الإصدار 14 من نظام التشغيل Android للتطبيقات التي تستهدف الإصدار 14 من نظام التشغيل Android ولجميع التطبيقات.

التوافق مع أسواق عالمية

إعدادات اللغة المخصصة حسب التطبيقات

Android 14 expands on the per-app language features that were introduced in Android 13 (API level 33) with these additional capabilities:

• Automatically generate an app's localeConfig: Starting with Android Studio Giraffe Canary 7 and AGP 8.1.0-alpha07, you can configure your app to support per-app language preferences automatically. Based on your project resources, the Android Gradle plugin generates the LocaleConfig file and adds a reference to it in the final manifest file, so you no longer have to create or update the file manually. AGP uses the resources in the res folders of your app modules and any library module dependencies to determine the locales to include in the LocaleConfig file.

• Dynamic updates for an app's localeConfig: Use the setOverrideLocaleConfig() and getOverrideLocaleConfig() methods in LocaleManager to dynamically update your app's list of supported languages in the device's system settings. Use this flexibility to customize the list of supported languages per region, run A/B experiments, or provide an updated list of locales if your app utilizes server-side pushes for localization.

• App language visibility for input method editors (IMEs): IMEs can utilize the getApplicationLocales() method to check the language of the current app and match the IME language to that language.

Grammatical Inflection API

3 billion people speak gendered languages: languages where grammatical categories—such as nouns, verbs, adjectives, and prepositions—inflect according to the gender of people and objects you talk to or about. Traditionally, many gendered languages use masculine grammatical gender as the default or generic gender.

Addressing users in the wrong grammatical gender, such as addressing women in masculine grammatical gender, can negatively impact their performance and attitude. In contrast, a UI with language that correctly reflects the user's grammatical gender can improve user engagement and provide a more personalized and natural-sounding user experience.

لمساعدتك في إنشاء واجهة مستخدم تركّز على المستخدم للغات التي تراعي الجنس، يوفّر الإصدار 14 من Android واجهة برمجة التطبيقات 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%

بدءًا من الإصدار Android 14، يتيح النظام زيادة حجم الخط بنسبة تصل إلى %200، ما يوفّر ضعاف البصر مع خيارات إمكانية الوصول الإضافية التي تتوافق مع إرشادات إتاحة المحتوى (WCAG):

لمنع تكبير عناصر النص الكبيرة على الشاشة بشكلٍ كبير جدًا، يطبّق النظام منحنى تكبير غير خطي. تعني استراتيجية تغيير الحجم هذه أنّ النص الكبير لا يتم تغيير حجمه بالمعدل نفسه الذي يتم به تغيير حجم النص الأصغر. يساعد الضبط غير الخطّي لحجم الخط في الحفاظ على التسلسل الهرمي النسبي بين العناصر ذات الأحجام المختلفة مع الحد من المشاكل المتعلّقة بتغيير حجم النص بشكل خطي بدرجات عالية (مثل اقتطاع النص أو صعوبة قراءته بسبب أحجام الشاشة الكبيرة جدًا).

اختبار تطبيقك باستخدام ميزة الضبط غير الخطّي لحجم الخط

إذا كنت تستخدم بالفعل وحدات البكسل المُعدَّل لتحديد حجم النص، خيارات إضافية وتحسينات التوسعة تلقائيًا على النص في تطبيقك. ومع ذلك، لا يزال يتعين عليك إجراء اختبار واجهة المستخدم بأقصى تم تفعيل حجم الخط (%200) لضمان استخدام التطبيق لأحجام الخط بشكل صحيح ويمكن أن تستوعب أحجام خطوط أكبر دون التأثير على سهولة الاستخدام.

لتفعيل حجم الخط بنسبة %200، اتّبِع الخطوات التالية:

1. افتح تطبيق الإعدادات وانتقل إلى إمكانية الوصول > حجم العرض النص.
2. بالنسبة إلى خيار حجم الخط، انقر على رمز علامة الجمع (+) إلى أن يتم ضبط الحدّ الأقصى للخط. تم تمكين إعداد الحجم، كما هو موضح في الصورة المصاحبة لهذا .

استخدام وحدات البكسل المعدَّلة (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.

الكاميرا والوسائط

دقة HDR فائقة للصور

Android 14 adds support for High Dynamic Range (HDR) images that retain more of the information from the sensor when taking a photo, which enables vibrant colors and greater contrast. Android uses the Ultra HDR format, which is fully backward compatible with JPEG images, allowing apps to seamlessly interoperate with HDR images, displaying them in Standard Dynamic Range (SDR) as needed.

Rendering these images in the UI in HDR is done automatically by the framework when your app opts in to using HDR UI for its Activity Window, either through a manifest entry or at runtime by calling Window.setColorMode(). You can also capture compressed Ultra HDR still images on supported devices. With more colors recovered from the sensor, editing in post can be more flexible. The Gainmap associated with Ultra HDR images can be used to render them using OpenGL or Vulkan.

التكبير/التصغير والتركيز والمعاينة بعد الالتقاط والمزيد في إضافات الكاميرا

يُجري نظام Android 14 ترقيات وتحسينات على إضافات الكاميرا، ويسمح للتطبيقات بمعالجة الصور لفترات أطول، ما يؤدي إلى تحسين الصور باستخدام خوارزميات كثيفة الاستخدام للمعالجة، مثل التصوير في الإضاءة المنخفضة على الأجهزة المتوافقة. وتوفّر هذه الميزات للمستخدمين تجربة أكثر فعالية عند استخدام إمكانات توسيع نطاق الكاميرا. تشمل أمثلة هذه التحسينات ما يلي:

• يقدّم تقدير وقت الاستجابة لمعالجة الصور الثابتة الديناميكية مزيدًا من الدقة في تقدير وقت الاستجابة لالتقاط الصور الثابتة استنادًا إلى المشهد الحالي وظروف التصوير. استخدِم دالة CameraExtensionSession.getRealtimeStillCaptureLatency() للحصول على عنصر StillCaptureLatency يتضمّن طريقتَين لتقدير وقت الاستجابة. تُرجع الطريقة getCaptureLatency() وقت الاستجابة المقدَّر بين onCaptureStarted و onCaptureProcessStarted()، وتُرجع الطريقة getProcessingLatency() وقت الاستجابة المقدَّر بين onCaptureProcessStarted() ووقت توفُّر الإطار النهائي الذي تمت معالجته.
• إتاحة عمليات استدعاء لعرض مستوى التقدّم في الالتقاط كي تتمكّن التطبيقات من عرض المستوى الحالي للتقدّم في عمليات معالجة الصور الثابتة التي تستغرق وقتًا طويلاً يمكنك التحقّق مما إذا كانت هذه الميزة متاحة مع CameraExtensionCharacteristics.isCaptureProcessProgressAvailable، وإذا كانت متاحة، يمكنك تنفيذ دالة callback الخاصة بتسجيل التقدّم onCaptureProcessProgressed()، والتي تم تمرير التقدّم (من 0 إلى 100) إليها كمَعلمة.

• البيانات الوصفية الخاصة بالإضافة، مثل CaptureRequest.EXTENSION_STRENGTH للاتصال برقم هاتفي مقدار تأثير الإضافة، مثل مقدار التمويه في الخلفية باستخدام EXTENSION_BOKEH

• ميزة "العرض اللاحق" لالتقاط الصور في إضافات الكاميرا، والتي تقدّم صورة تمّت معالجتها بشكل أقلّ بسرعة أكبر من الصورة النهائية إذا كانت إضافة الصور تزيد من وقت الاستجابة في المعالجة، يمكن تقديم صورة ما بعد المشاهدة كعنصر بدلٍ لتحسين تجربة المستخدم واستبدالها لاحقًا بالصورة النهائية. يمكنك معرفة ما إذا كانت هذه الميزة متاحة باستخدام CameraExtensionCharacteristics.isPostviewAvailable. بعد ذلك، يمكنك تمرير OutputConfiguration إلى ExtensionSessionConfiguration.setPostviewOutputConfiguration.

• إتاحة استخدام SurfaceView للاستفادة من مسار عرض معاينة أكثر فعالية من حيث الطاقة

• إتاحة ميزة "النقر للتركيز" والتكبير/التصغير أثناء استخدام الإضافة

التكبير داخل المستشعر

When REQUEST_AVAILABLE_CAPABILITIES_STREAM_USE_CASE in CameraCharacteristics contains SCALER_AVAILABLE_STREAM_USE_CASES_CROPPED_RAW, your app can use advanced sensor capabilities to give a cropped RAW stream the same pixels as the full field of view by using a CaptureRequest with a RAW target that has stream use case set to CameraMetadata.SCALER_AVAILABLE_STREAM_USE_CASES_CROPPED_RAW. By implementing the request override controls, the updated camera gives users zoom control even before other camera controls are ready.

صوت عالي الدقة عبر 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.

إنتاجية المطوّرين وأدواتهم

مدير بيانات الاعتماد

يضيف الإصدار 14 من Android واجهة برمجة التطبيقات Credential Manager كواجهة برمجة تطبيقات لمنصّة Android، مع إتاحة استخدامها على أجهزة Android 4.4 (المستوى 19 من واجهة برمجة التطبيقات) والإصدارات الأقدم من خلال مكتبة Jetpack باستخدام "خدمات Google Play". يهدف Credential Manager إلى تسهيل تسجيل الدخول للمستخدمين من خلال واجهات برمجة التطبيقات التي تسترجع بيانات الاعتماد وتخزّنها باستخدام موفّري بيانات الاعتماد الذين يضبطهم المستخدم. توفِّر واجهة برمجة التطبيقات Credential Manager طُرق تسجيل دخول متعدّدة، بما في ذلك اسم المستخدم وكلمة المرور ومفاتيح المرور، وحلول تسجيل الدخول الموحَّدة (مثل "تسجيل الدخول باستخدام حساب Google") في واجهة برمجة تطبيقات واحدة.

توفّر مفاتيح المرور العديد من المزايا. على سبيل المثال، تم إنشاء مفاتيح المرور استنادًا إلى المعايير المتّبعة في المجال، ويمكن استخدامها في مختلَف أنظمة التشغيل والمنظومات المتكاملة للمتصفِّحات، ويمكن استخدامها مع كلٍّ من المواقع الإلكترونية والتطبيقات.

لمزيد من المعلومات، يُرجى الاطّلاع على مستندات "مدير بيانات الاعتماد" ومفاتيح المرور ومقالة المدونة حول "مدير بيانات الاعتماد" ومفاتيح المرور.

Health Connect

Health Connect is an on-device repository for user health and fitness data. It allows users to share data between their favorite apps, with a single place to control what data they want to share with these apps.

On devices running Android versions prior to Android 14, Health Connect is available to download as an app on the Google Play store. Starting with Android 14, Health Connect is part of the platform and receives updates through Google Play system updates without requiring a separate download. With this, Health Connect can be updated frequently, and your apps can rely on Health Connect being available on devices running Android 14 or higher. Users can access Health Connect from the Settings in their device, with privacy controls integrated into the system settings.

Users can get started using Health Connect without a separate app download on devices running Android 14 or higher.

Users can control which apps have access to their health and fitness data through system settings.

Health Connect includes several new features in Android 14, such as exercise routes, allowing users to share a route of their workout which can be visualized on a map. A route is defined as a list of locations saved within a window of time, and your app can insert routes into exercise sessions, tying them together. To ensure that users have complete control over this sensitive data, users must allow sharing individual routes with other apps.

For more information, see the Health Connection documentation and the blogpost on What's new in Android Health.

تعديلات 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 introduces several PackageInstaller APIs that allow app stores to improve their user experience.

Request install approval before downloading

Installing or updating an app might require user approval. For example, when an installer making use of the REQUEST_INSTALL_PACKAGES permission attempts to install a new app. In prior Android versions, app stores can only request user approval after APKs are written to the install session and the session is committed.

Starting with Android 14, the requestUserPreapproval() method lets installers request user approval before committing the install session. This improvement lets an app store defer downloading any APKs until after the installation has been approved by the user. Furthermore, once a user has approved installation, the app store can download and install the app in the background without interrupting the user.

Claim responsibility for future updates

The setRequestUpdateOwnership() method allows an installer to indicate to the system that it intends to be responsible for future updates to an app it is installing. This capability enables update ownership enforcement, meaning that only the update owner is permitted to install automatic updates to the app. Update ownership enforcement helps to ensure that users receive updates only from the expected app store.

Any other installer, including those making use of the INSTALL_PACKAGES permission, must receive explicit user approval in order to install an update. If a user decides to proceed with an update from another source, update ownership is lost.

Update apps at less-disruptive times

App stores typically want to avoid updating an app that is actively in use because this leads to the app's running processes being killed, which potentially interrupts what the user was doing.

Starting with Android 14, the InstallConstraints API gives installers a way to ensure that their app updates happen at an opportune moment. For example, an app store can call the commitSessionAfterInstallConstraintsAreMet() method to make sure that an update is only committed when the user is no longer interacting with the app in question.

Seamlessly install optional splits

With split APKs, features of an app can be delivered in separate APK files, rather than as a monolithic APK. Split APKs allow app stores to optimize the delivery of different app components. For example, app stores might optimize based on the properties of the target device. The PackageInstaller API has supported splits since its introduction in API level 22.

In Android 14, the setDontKillApp() method allows an installer to indicate that the app's running processes shouldn't be killed when new splits are installed. App stores can use this feature to seamlessly install new features of an app while the user is using the app.

حِزم البيانات الوصفية للتطبيق

اعتبارًا من الإصدار Android 14، يتيح لك أداة تثبيت حِزم Android تحديد البيانات الوصفية للتطبيق، مثل ممارسات أمان البيانات، لتضمينها في صفحات متجر التطبيقات، مثل Google Play.

رصد وقت أخذ المستخدمين لقطات شاشة للجهاز

لإنشاء تجربة أكثر توحيدًا في ما يتعلّق برصد لقطات الشاشة، يقدّم نظام التشغيل Android 14 واجهة برمجة تطبيقات لرصد لقطات الشاشة تحافظ على الخصوصية. تتيح واجهة برمجة التطبيقات هذه للتطبيقات تسجيل عمليات ردّ الاتصال على أساس كل نشاط. يتم استدعاء عمليات الرجوع هذه وإرسال إشعار إلى المستخدم عندما يلتقط لقطة شاشة أثناء ظهور هذا النشاط.

تجربة المستخدم

الإجراءات المخصّصة في ورقة المشاركة والترتيب المحسّن

يُعدّل نظام التشغيل Android 14 جدول مشاركة النظام ليتيح إجراءات التطبيقات المخصّصة ونتائج معاينة أكثر فائدة للمستخدمين.

إضافة إجراءات مخصّصة

باستخدام الإصدار 14 من نظام التشغيل Android، يمكن لتطبيقك إضافة إجراءات مخصّصة إلى جدول مشاركة النظام الذي يستدعيه.

تحسين ترتيب استهدافات المشاركة المباشرة

يستخدم الإصدار 14 من نظام التشغيل Android المزيد من الإشارات من التطبيقات لتحديد ترتيب استهدافات مشاركة المحتوى المباشر من أجل تقديم نتائج أكثر فائدة للمستخدم. لتقديم الإشارة الأكثر فائدة للترتيب، اتّبِع الإرشادات المتعلقة ب تحسين ترتيب استهدافات "المشاركة المباشرة". يمكن أيضًا لتطبيقات التواصل الإبلاغ عن استخدام الاختصارات للرسائل المغادرة والواردة.

إتاحة صور متحركة مضمّنة ومخصّصة لإيماءة "الرجوع التنبؤي"

Android 13 introduced the predictive back-to-home animation behind a developer option. When used in a supported app with the developer option enabled, swiping back shows an animation indicating that the back gesture exits the app back to the home screen.

Android 14 includes multiple improvements and new guidance for Predictive Back:

• You can set android:enableOnBackInvokedCallback=true to opt in to predictive back system animations per-Activity instead of for the entire app.
• We've added new system animations to accompany the back-to-home animation from Android 13. The new system animations are cross-activity and cross-task, which you get automatically after migrating to Predictive Back.
• We've added new Material Component animations for Bottom sheets, Side sheets, and Search.
• We've created design guidance for creating custom in-app animations and transitions.
• We've added new APIs to support custom in-app transition animations:
  • handleOnBackStarted, handleOnBackProgressed, handleOnBackCancelled in OnBackPressedCallback
  • onBackStarted, onBackProgressed, onBackCancelled in OnBackAnimationCallback
  • Use overrideActivityTransition instead of overridePendingTransition for transitions that respond as the user swipes back.

With this Android 14 preview release, all features of Predictive Back remain behind a developer option. See the developer guide to migrate your app to predictive back, as well as the developer guide to creating custom in-app transitions.

عمليات إلغاء إعدادات التطبيق لكل شركة مصنّعة لأجهزة ذات شاشات كبيرة

Per-app overrides enable device manufacturers to change the behavior of apps on large screen devices. For example, the FORCE_RESIZE_APP override instructs the system to resize the app to fit display dimensions (avoiding size compatibility mode) even if resizeableActivity="false" is set in the app manifest.

Overrides are intended to improve the user experience on large screens.

New manifest properties enable you to disable some device manufacturer overrides for your app.

عمليات إلغاء الإعدادات التلقائية على الشاشات الكبيرة لكل تطبيق

تؤدي عمليات التجاوز لكل تطبيق إلى تغيير سلوك التطبيقات على الأجهزة ذات الشاشات الكبيرة. على سبيل المثال، يمكن للشركة المصنّعة للجهاز OVERRIDE_MIN_ASPECT_RATIO_LARGE إلغاء الإعدادات وضبط نسبة عرض إلى ارتفاع التطبيق على 16:9 بغض النظر عن إعدادات التطبيق.

يتيح الإصدار 1 من الربع الثاني من العام 2021 من نظام التشغيل Android 14 للمستخدمين تطبيق عمليات إلغاء على مستوى كل تطبيق من خلال قائمة إعدادات جديدة على الأجهزة ذات الشاشات الكبيرة.

مشاركة شاشة التطبيق

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.

ميزة "الرد السريع" المستندة إلى نماذج اللغات الكبيرة في Gboard على هاتف Pixel 8 Pro

على أجهزة Pixel 8 Pro التي تم تثبيت حزمة ميزات شهر كانون الأول (ديسمبر) عليها، يمكن للمطوّرين تجربة ردود سريعة بجودة أعلى في Gboard، وذلك باستخدام نماذج لغوية كبيرة (LLM) على الجهاز تعمل على معالج Google Tensor.

تتوفّر هذه الميزة في إصدار تجريبي محدود باللغة الإنجليزية (الولايات المتحدة) في WhatsApp وLine وKakaoTalk. تتطلّب الميزة استخدام جهاز Pixel 8 Pro مع Gboard ك keyboard.

لتجربة هذه الميزة، عليك أولاً تفعيلها من خلال الانتقال إلى الإعدادات > خيارات المطوّرين > إعدادات AICore > تفعيل ميزة Aicore Persistent.

بعد ذلك، افتح محادثة في تطبيق متوافق للاطّلاع على ميزة "الرد السريع" المستندة إلى نموذج اللغة الكبيرة في شريط اقتراحات Gboard استجابةً للرسائل الواردة.

الرسومات

يمكن البحث عن المسارات وتعديلها.

Android's Path API is a powerful and flexible mechanism for creating and rendering vector graphics, with the ability to stroke or fill a path, construct a path from line segments or quadratic or cubic curves, perform boolean operations to get even more complex shapes, or all of these simultaneously. One limitation is the ability to find out what is actually in a Path object; the internals of the object are opaque to callers after creation.

To create a Path, you call methods such as moveTo(), lineTo(), and cubicTo() to add path segments. But there has been no way to ask that path what the segments are, so you must retain that information at creation time.

Starting in Android 14, you can query paths to find out what's inside of them. First, you need to get a PathIterator object using the Path.getPathIterator API:

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

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

Next, you can call PathIterator to iterate through the segments one by one, retrieving all of the necessary data for each segment. This example uses PathIterator.Segment objects, which packages up the data for you:

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

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

PathIterator also has a non-allocating version of next() where you can pass in a buffer to hold the point data.

One of the important use cases of querying Path data is interpolation. For example, you might want to animate (or morph) between two different paths. To further simplify that use case, Android 14 also includes the interpolate() method on Path. Assuming the two paths have the same internal structure, the interpolate() method creates a new Path with that interpolated result. This example returns a path whose shape is halfway (a linear interpolation of .5) between path and otherPath:

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

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

The Jetpack graphics-path library enables similar APIs for earlier versions of Android as well.

شبكات مخصّصة مع مظلّلات الرؤوس والتقسيمات

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

للمساعدة في استخدام واجهة برمجة التطبيقات Canvas في Android للرسم باستخدام التسارع في الأجهزة في HardwareBuffer، يوفّر الإصدار 14 من Android HardwareBufferRenderer. واجهة برمجة التطبيقات هذه عندما تشتمل حالة الاستخدام على التواصل مع النظام المكون من خلال SurfaceControl لوقت الاستجابة المنخفض رسم.