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

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

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

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

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

يقدّم نظام التشغيل Android 14 ميزات إضافية لكل تطبيق باللغة تم تقديمها في Android 13 (المستوى 33 لواجهة برمجة التطبيقات)، وهي:

  • إنشاء localeConfig للتطبيق تلقائيًا: بدءًا من الإصدار Android Studio Giraffe Canary 7 والإصدار AGP 8.1.0-alpha07، يمكنك ضبط تطبيقك ليعمل تلقائيًا على إتاحة الإعدادات المفضّلة للغة لكل تطبيق. استنادًا إلى موارد مشروعك، ينشئ المكوّن الإضافي لنظام Gradle المتوافق مع Android ملف LocaleConfig ويضيف إليه إشارة في ملف البيان النهائي، ما يغنيك عن إنشاء الملف أو تعديله يدويًا. يستخدم AGP الموارد في مجلدات res الخاصة بوحدات تطبيقك وأي ملحقات لوحدات المكتبة لتحديد اللغات المطلوب تضمينها فيملف LocaleConfig.

  • التحديثات الديناميكية لقائمة localeConfig للتطبيق: استخدِم الطريقتَين setOverrideLocaleConfig() و getOverrideLocaleConfig() في LocaleManager لتعديل قائمة اللغات المتاحة في تطبيقك ديناميكيًا في إعدادات نظام الجهاز. يمكنك الاستفادة من هذه المرونة لتخصيص قائمة اللغات المتاحة لكل منطقة، أو إجراء تجارب أ/ب، أو تقديم قائمة محدّثة للغات إذا كان تطبيقك يستخدم عمليات الإرسال من جهة الخادم لعملية التعريب.

  • إظهار لغة التطبيق لمحرّري أساليب الإدخال (IME): يمكن لمحرّري أساليب الإدخال استخدام الأسلوب getApplicationLocales() للتحقّق من لغة التطبيق الحالي ومطابقة لغة محرّر أسلوب الإدخال مع هذه اللغة.

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.

To help you build a user-centric UI for gendered languages, Android 14 introduces the Grammatical Inflection API, which lets you add support for grammatical gender without refactoring your app.

الإعدادات المفضّلة للمنطقة

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

توفّر قوائم إعدادات Android الجديدة لهذه الإعدادات المفضّلة للمستخدمين مكانًا يسهل العثور عليه ويكون مركزيًا لتغيير الإعدادات المفضّلة للتطبيقات. هذه والتفضيلات أيضًا من خلال النسخ الاحتياطي والاستعادة. هناك العديد من واجهات برمجة التطبيقات الأهداف - مثل getTemperatureUnit أو getFirstDayOfWeek— منح تطبيقك إذن الوصول للقراءة إلى إعدادات المستخدم المفضّلة، حتى يتمكّن التطبيق من تعديل إعداداته تعرض المعلومات. يمكنك أيضًا تسجيل خيار "BroadcastReceiver" مفعَّل ACTION_LOCALE_CHANGED لمعالجة تغييرات إعدادات اللغة عند تغيير الإعدادات المفضّلة للمنطقة.

للعثور على هذه الإعدادات، افتح تطبيق "الإعدادات" وانتقِل إلى النظام > اللغات والإدخال > الإعدادات المفضّلة على مستوى المنطقة.

شاشة الإعدادات المفضّلة على مستوى المنطقة في إعدادات نظام Android
خيارات درجة الحرارة للإعدادات المفضّلة على مستوى المنطقة في إعدادات نظام Android

تسهيل الاستخدام

الضبط غير الخطي لحجم الخط بما يصل إلى ‎200%

Starting in Android 14, the system supports font scaling up to 200%, providing users with additional accessibility options.

To prevent large text elements on screen from scaling too large, the system applies a nonlinear scaling curve. This scaling strategy means that large text doesn't scale at the same rate as smaller text. Nonlinear font scaling helps preserve the proportional hierarchy between elements of different sizes while mitigating issues with linear text scaling at high degrees (such as text being cut off or text that becomes harder to read due to an extremely large display sizes).

Test your app with nonlinear font scaling

Enable the maximum font size in a device's accessibility settings to test your app.

If you already use scaled pixels (sp) units to define text sizing, then these additional options and scaling improvements are applied automatically to the text in your app. However, you should still perform UI testing with the maximum font size enabled (200%) to ensure that your app applies the font sizes correctly and can accommodate larger font sizes without impacting usability.

To enable 200% font size, follow these steps:

  1. Open the Settings app and navigate to Accessibility > Display size and text.
  2. For the Font size option, tap the plus (+) icon until the maximum font size setting is enabled, as shown in the image that accompanies this section.

Use scaled pixel (sp) units for text-sizes

Remember to always specify text sizes in sp units. When your app uses sp units, Android can apply the user's preferred text size and scale it appropriately.

Don't use sp units for padding or define view heights assuming implicit padding: with nonlinear font scaling sp dimensions might not be proportional, so 4sp + 20sp might not equal 24sp.

Convert scaled pixel (sp) units

Use TypedValue.applyDimension() to convert from sp units to pixels, and use TypedValue.deriveDimension() to convert pixels to sp. These methods apply the appropriate nonlinear scaling curve automatically.

Avoid hardcoding equations using Configuration.fontScale or DisplayMetrics.scaledDensity. Because font scaling is nonlinear, the scaledDensity field is no longer accurate. The fontScale field should be used for informational purposes only because fonts are no longer scaled with a single scalar value.

Use sp units for lineHeight

Always define android:lineHeight using sp units instead of dp, so the line height scales along with your text. Otherwise, if your text is sp but your lineHeight is in dp or px, it doesn't scale and looks cramped. TextView automatically corrects the lineHeight so that your intended proportions are preserved, but only if both textSize and lineHeight are defined in sp units.

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

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

An illustration of Standard Dynamic Range (SDR) versus High Dynamic Range (HDR) image quality.

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 upgrades and improves camera extensions, allowing apps to handle longer processing times, which enables improved images using compute-intensive algorithms like low-light photography on supported devices. These features give users an even more robust experience when using camera extension capabilities. Examples of these improvements include:

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

عندما يحتوي REQUEST_AVAILABLE_CAPABILITIES_STREAM_USE_CASE في CameraCharacteristics على SCALER_AVAILABLE_STREAM_USE_CASES_CROPPED_RAW، يمكن لتطبيقك استخدام إمكانات أداة الاستشعار المتقدّمة لتوفير بثّ RAW مقطّع يحتوي على كثافة بكسل مماثلة لكثافة بكسل مجال العرض الكامل باستخدام CaptureRequest مع هدف RAW تم ضبط حالة استخدام البث عليه على CameraMetadata.SCALER_AVAILABLE_STREAM_USE_CASES_CROPPED_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 adds Credential Manager as a platform API, with additional support back to Android 4.4 (API level 19) devices through a Jetpack Library using Google Play services. Credential Manager aims to make sign-in easier for users with APIs that retrieve and store credentials with user-configured credential providers. Credential Manager supports multiple sign-in methods, including username and password, passkeys, and federated sign-in solutions (such as Sign-in with Google) in a single API.

Passkeys provide many advantages. For example, passkeys are built on industry standards, can work across different operating systems and browser ecosystems, and can be used with both websites and apps.

For more information, see the Credential Manager and passkeys documentation and the blogpost about Credential Manager and passkeys.

Health Connect

‫Health Connect هو مستودع على الجهاز لبيانات الصحة واللياقة البدنية للمستخدم. ويسمح الإعداد للمستخدمين بمشاركة البيانات بين تطبيقاتهم المفضّلة، مع توفير مكان واحد للتحكّم في البيانات التي يريدون مشاركتها مع هذه التطبيقات.

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

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

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

لمزيد من المعلومات، يُرجى الاطّلاع على مستندات Health Connect والمقالة في المدونة حول الميزات الجديدة في تطبيق "صحة 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 العديد من واجهات برمجة تطبيقات PackageInstaller التي تسمح لمتاجر التطبيقات بتحسين تجربة المستخدمين.

طلب الموافقة على التثبيت قبل التنزيل

قد يتطلّب تثبيت تطبيق أو تحديثه موافقة المستخدم. على سبيل المثال، عندما يحاول أحد تطبيقات التثبيت التي تستخدم إذن REQUEST_INSTALL_PACKAGES تثبيت تطبيق جديد، لا يمكن لمتاجر التطبيقات طلب موافقة المستخدم إلا بعد كتابة حِزم APK في جلسة التثبيت وإتمام الجلسة.

اعتبارًا من Android 14، تتيح طريقة requestUserPreapproval() للمُثبّتين طلب موافقة المستخدم قبل إكمال جلسة التثبيت. يتيح هذا التحسين لمتجر التطبيقات تأجيل تنزيل أي حِزم APK إلى بعد أن يوافق المستخدم على التثبيت. بالإضافة إلى ذلك، بعد أن يمنح أحد المستخدمين موافقته على التثبيت، يمكن لمتجر التطبيقات تنزيل التطبيق وتثبيته في الخلفية بدون مقاطعة المستخدم.

تأكيد مسؤولية التعديلات المستقبلية

تسمح طريقة setRequestUpdateOwnership() للمثبّت بإعلام النظام بأنّه سيتحمّل مسؤولية التحديثات المستقبلية للتطبيق الذي يتم تثبيته. تتيح هذه الميزة فرض ملكية التحديث، ما يعني أنّه لا يُسمح إلا لمالك التحديث بتثبيت التحديثات التلقائية للتطبيق. ويساعد فرض ملكية التحديث في ضمان تلقّي المستخدمين للتحديثات من متجر التطبيقات المتوقّع فقط.

يجب أن يحصل أي مُثبِّت آخر، بما في ذلك مُثبِّتي التطبيقات الذين يستخدمون إذن INSTALL_PACKAGES، على موافقة صريحة من المستخدمين لتثبيت التحديث. إذا قرّر أحد المستخدِمين مواصلة تعديل من مصدر آخر، ستتم فقدان ملكية التعديل.

تحديث التطبيقات في أوقات أقل إزعاجًا

تحاول متاجر التطبيقات عادةً تجنُّب تحديث تطبيق قيد الاستخدام بشكل نشط، لأنّ ذلك يؤدي إلى إيقاف العمليات الجارية للتطبيق، ما قد يؤدي بدوره إلى إيقاف ما كان يفعله المستخدم.

بدءًا من Android 14، تقدّم واجهة برمجة التطبيقات InstallConstraints للمُثبّتين طريقة لضمان إجراء تحديثات التطبيقات في الوقت المناسب. على سبيل المثال، يمكن لمتجر تطبيقات استدعاء الأسلوب commitSessionAfterInstallConstraintsAreMet() لمحاولة التأكد من عدم التزام المستخدم بالتغييرات إلا عندما يتوقف عن التفاعل مع التطبيق المعني.

تثبيت الفواصل الاختيارية بسلاسة

باستخدام حِزم APK المجزّأة، يمكن توفير ميزات التطبيق في حِزم APK منفصلة، بدلاً من حزمة APK واحدة. تسمح ملفات APK المجزّأة لمتاجر التطبيقات بتحسين عرض مكوّنات التطبيق المختلفة. على سبيل المثال، قد تعمل متاجر التطبيقات على تحسين التطبيقات استنادًا إلى خصائص الجهاز المستهدَف. كانت واجهة برمجة التطبيقات PackageInstaller متوافقة مع عمليات التقسيم منذ إدخالها في المستوى 22 من واجهة برمجة التطبيقات.

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

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

Starting in Android 14, the Android package installer lets you specify app metadata, such as data safety practices, to include on app store pages such as Google Play.

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

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

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

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

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

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

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

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

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

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

صف المشاركة المباشرة في لوحة المشاركة، كما هو موضّح في 1

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

Video: Predictive back animations

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:

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.

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

تتيح عمليات إلغاء الإعدادات على مستوى التطبيق لصنّاع الأجهزة تغيير سلوك التطبيقات على الأجهزة ذات الشاشات الكبيرة. على سبيل المثال، عند إلغاء FORCE_RESIZE_APP، يتم توجيه النظام لتغيير حجم التطبيق ليلائم أبعاد العرض (وتجنُّب وضع توافق الحجم) حتى في حال ضبط resizeableActivity="false" في بيان التطبيق.

تهدف عمليات الإلغاء إلى تحسين تجربة المستخدم على الشاشات الكبيرة.

تتيح لك سمات البيان الجديدة إيقاف بعض عمليات إلغاء الشركة المصنّعة للجهاز لتطبيقك.

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

Per-app overrides change the behavior of apps on large screen devices. For example, the OVERRIDE_MIN_ASPECT_RATIO_LARGE device manufacturer override sets the app aspect ratio to 16:9 regardless of the app's configuration.

Android 14 QPR1 enables users to apply per‑app overrides by means of a new settings menu on large screen devices.

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

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 استجابةً للرسائل الواردة.

تستخدم Gboard نماذج لغوية كبيرة على الجهاز لتقديم ردود سريعة ذكية وعالية الجودة.

الرسومات

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

Path API هي آلية فعّالة ومرنة ل إنشاء الرسومات المتجهّة وعرضها، مع إمكانية رسم خطوط أو ملء مسار أو إنشاء مسار من أجزاء خطية أو منحنيات ثنائية أو ثلاثية الحدود، أو تنفيذ عمليات منطقية للحصول على أشكال أكثر تعقيدًا، أو كل ذلك في الوقت نفسه. ويتمثل أحد القيود في القدرة على معرفة ما هو موجود بالفعل في كائن "مسار"، وتكون العناصر الداخلية للكائن معتمة للمتصلين بعد إنشائه.

لإنشاء Path، يمكنك استدعاء طرق مثل moveTo() وlineTo() و cubicTo() لإضافة شرائح مسار. ولكن لم تكن هناك طريقة للسؤال عن الأجزاء في هذا المسار، لذلك يجب عليك الاحتفاظ بهذه المعلومات في وقت الإنشاء.

بدءًا من Android 14، يمكنك طلب البحث عن المسارات لمعرفة ما بداخلها. عليك أولاً الحصول على كائن PathIterator باستخدام واجهة برمجة تطبيقات Path.getPathIterator:

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 أيضًا طريقة interpolate() في Path. بافتراض أنّ المسارَين لهما البنية الداخلية نفسها، تنشئ الطريقة interpolate() Path جديدة مع تلك النتيجة المضمَّنة. يعرض هذا المثال مسارًا يكون شكله في منتصف الطريق (تداخل خطي بنسبة 0.5) بين path وotherPath:

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

تتيح مكتبة graphics-path في Jetpack واجهات برمجة تطبيقات مشابهة لإصدارات Android الأقدم أيضًا.

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

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 لوقت الاستجابة المنخفض رسم.