סקירה כללית על תכונות וממשקי API

ב-Android 14 נוספו תכונות וממשקי API מעולים למפתחים. המאמרים הבאים יעזרו לכם להבין את התכונות של האפליקציות ולהתחיל להשתמש בממשקי ה-API שקשורים אליהן.

רשימה מפורטת של ממשקי API שנוספו, שונו או הוסרו מופיעה בדוח השוואת ממשקי ה-API. פרטים על ממשקי API שנוספו זמינים בהפניית API של Android. ב-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 באפליקציה: משתמשים בשיטות setOverrideLocaleConfig() ו-getOverrideLocaleConfig() שמפורטות ב-LocaleManager כדי לעדכן באופן דינמי את רשימת השפות הנתמכות באפליקציה בהגדרות המערכת של המכשיר. הגמישות הזו מאפשרת לכם להתאים אישית את רשימת השפות הנתמכות לפי אזור, להריץ ניסויים מסוג A/B או לספק רשימה מעודכנת של אזורי זמן אם האפליקציה שלכם משתמשת בהעברות (push) בצד השרת לצורך לוקליזציה.

  • הצגת שפת האפליקציה לעורכי שיטות קלט (IME): עורכי שיטות קלט יכולים להשתמש ב-method‏ getApplicationLocales() כדי לבדוק את שפת האפליקציה הנוכחית ולהתאים את שפת ה-IME לשפה הזו.

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.

כדי לעזור לכם ליצור ממשק משתמש שמתמקד במשתמשים בשפות עם הבחנה בין מינים, ב-Android 14 מופיע Grammatical Inflection API, שמאפשר לכם להוסיף תמיכה בלשון מגדרית בלי לבצע רפאקציה לאפליקציה.

העדפות הפורמט והמידות

העדפות אזוריות מאפשרות למשתמשים להתאים אישית את יחידות הטמפרטורה, את היום הראשון בשבוע ואת מערכות המספור. אירופאי שגר בארצות הברית עשוי להעדיף יחידות טמפרטורה בצלזיוס ולא בפרנהייט אפליקציות להתייחס ליום שני כתחילת השבוע במקום כברירת המחדל בארה"ב יום ראשון.

תפריטי ההגדרות החדשים של Android עבור ההעדפות האלה מספקים למשתמשים מיקום מרכזי ונגיש לשינוי העדפות האפליקציות. האלה גם בגיבוי ובשחזור. כמה ממשקי API וכוונות (intents) – כמו 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.

מצלמה ומדיה

תמונות ב-Ultra 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 יש שיפורים בתוספים למצלמה, שמאפשרים לאפליקציות להתמודד עם זמני עיבוד ארוכים יותר. כך אפשר לצלם תמונות טובות יותר באמצעות אלגוריתמים שמבוססים על חישובים כבדים, כמו צילום בתאורה חלשה במכשירים נתמכים. התכונות האלה מספקות למשתמשים חוויה חזקה עוד יותר כשהם משתמשים ביכולות של התוספים למצלמה. דוגמאות לשיפורים האלה:

  • אומדן זמן האחזור הדינמי של עיבוד התמונות הסטטיות מספק אומדנים מדויקים הרבה יותר של זמן האחזור של התמונות הסטטיות, על סמך תנאי הסביבה והסצנה הנוכחיים. קוראים ל-CameraExtensionSession.getRealtimeStillCaptureLatency() כדי לקבל אובייקט StillCaptureLatency עם שתי שיטות להערכת זמן האחזור. השיטה getCaptureLatency() מחזירה את זמן האחזור המשוער בין onCaptureStarted ל-onCaptureProcessStarted(), והשיטה getProcessingLatency() מחזירה את זמן האחזור המשוער בין onCaptureProcessStarted() לבין זמינות המסגרת הסופית שעברה עיבוד.
  • תמיכה בקריאות חזרה (callbacks) של התקדמות הצילום, כדי שאפליקציות יוכלו להציג את ההתקדמות הנוכחית של פעולות עיבוד ממושכות של צילומי סטילס. אפשר לבדוק אם התכונה הזו זמינה באמצעות CameraExtensionCharacteristics.isCaptureProcessProgressAvailable. אם כן, מטמיעים את פונקציית הקריאה החוזרת onCaptureProcessProgressed(), שבה מועבר הפרמטר של ההתקדמות (מ-0 עד 100).
  • מטא-נתונים ספציפיים לתוסף, כמו CaptureRequest.EXTENSION_STRENGTH כדי להזין את מידת האפקט של התוסף, למשל מידת הטשטוש של הרקע באמצעות EXTENSION_BOKEH.

  • התכונה 'תצוגה לאחר הצילום' לצילום סטילס בתוספים למצלמה, שמספקת תמונה שעברה עיבוד פחות מאשר התמונה הסופית, במהירות גבוהה יותר. אם תוסף מאריך את זמן האחזור לעיבוד, אפשר לספק תמונה שלאחר הצפייה כתמונה זמנית כדי לשפר את חוויית המשתמש, ולאחר מכן להחליף אותה בתמונה הסופית. אפשר לבדוק אם התכונה הזו זמינה באמצעות CameraExtensionCharacteristics.isPostviewAvailable. לאחר מכן תוכלו להעביר OutputConfiguration אל ExtensionSessionConfiguration.setPostviewOutputConfiguration.

  • תמיכה ב-SurfaceView שמאפשרת נתיב עיבוד נתונים יעיל יותר וחסכוני יותר באנרגיה לתצוגה מקדימה.

  • תמיכה בהקשה כדי להתמקד ובשינוי מרחק התצוגה במהלך השימוש בתוסף.

זום בחיישן

כשהערך של 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 יש תמיכה בפורמטים של אודיו ללא אובדן נתונים, כדי שתוכלו ליהנות מחוויית אודיו ברמה גבוהה באמצעות אוזניות קוויות עם חיבור USB. אפשר לשלוח שאילתה למכשיר USB כדי לקבל את מאפייני המיקסר המועדפים שלו, לרשום מאזין לשינויים במאפייני המיקסר המועדפים ולהגדיר את מאפייני המיקסר באמצעות הכיתה AudioMixerAttributes. המחלקה הזו מייצגת את הפורמט, כמו מסכת הערוץ, קצב הדגימה וההתנהגות של מיקסר האודיו. הסוג הזה מאפשר לשלוח אודיו ישירות, בלי ערבוב, שינוי עוצמת קול או עיבוד אפקטים.

פרודוקטיביות וכלים למפתחים

מנהל פרטי הכניסה

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 זמין במכשירים עם Android מגרסה 14 ואילך. המשתמשים יכולים לגשת ל-Health Connect מההגדרות במכשיר, עם אמצעי בקרה על הפרטיות שמוטמעים בהגדרות המערכת.

משתמשים יכולים להתחיל להשתמש ב-Health Connect בלי להוריד אפליקציה נפרדת במכשירים עם Android מגרסה 14 ואילך.
המשתמשים יכולים לקבוע לאילו אפליקציות תהיה גישה לנתוני הבריאות והכושר שלהם דרך הגדרות המערכת.

Health Connect כולל כמה תכונות חדשות ב-Android 14, כמו מסלולי אימון, שמאפשרים למשתמשים לשתף מסלול של אימון שאפשר לראות במפה. מסלול מוגדר כרשימה של מיקומים שנשמרו בחלון זמן מסוים, והאפליקציה יכולה להוסיף מסלולים לסשנים של אימונים ולקשר ביניהם. כדי להבטיח שלמשתמשים תהיה שליטה מלאה על המידע הרגיש הזה, הם צריכים לאפשר שיתוף של מסלולים ספציפיים עם אפליקציות אחרות.

מידע נוסף זמין במסמכי התיעוד של Health Connect ובפוסט בבלוג בנושא מה חדש ב-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.

חבילות של מטא-נתונים של אפליקציות

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 מוצג API לזיהוי צילומי מסך ששומר על הפרטיות. ה-API הזה מאפשר לאפליקציות לרשום פונקציות קריאה חוזרת על בסיס כל פעילות. הקריאות החוזרות האלה מופעלות, והמשתמש מקבל הודעה, כשהמשתמש מצלם צילום מסך בזמן שהפעילות הזו גלויה.

חוויית משתמש

פעולות מותאמות אישית בקובץ לשיתוף ודירוג משופר

ב-Android 14 מתבצע עדכון של גיליון השיתוף של המערכת כדי לתמוך בפעולות מותאמות אישית באפליקציות ובתצוגות מקדימות מפורטות יותר של תוצאות למשתמשים.

הוספת פעולות בהתאמה אישית

ב-Android 14, האפליקציה יכולה להוסיף פעולות בהתאמה אישית לגיליון השיתוף של המערכת שהיא מפעילה.

צילום מסך של פעולות בהתאמה אישית בחלונית השיתוף.

שיפור הדירוג של יעדים לשיתוף ישיר

ב-Android 14 נעשה שימוש באותות רבים יותר מאפליקציות כדי לקבוע את הדירוג של יעדי השיתוף הישיר, וכך לספק תוצאות מועילות יותר למשתמש. כדי לספק את האות הכי שימושי לדירוג, פועלים לפי ההנחיות לשיפור הדירוג של היעדים של שיתוף ישיר. אפליקציות תקשורת יכולות גם לדווח על שימוש במקשי קיצור להודעות יוצאות ונכנסות.

שורת 'שיתוף ישיר' בגיליון השיתוף, כפי שמוצג ב1

תמיכה באנימציות מובנות ומותאמות אישית לחיזוי של תנועת החזרה

סרטון: אנימציה חזרה חזותית

ב-Android 13 הוספנו את האפשרות להפעיל אנימציה חזרה למסך הבית באופן יזום, כאפשרות לפיתוח. כשמשתמשים בתנועת החלקה לאחור באפליקציה נתמכת עם אפשרות הפיתוח מופעלת, מוצגת אנימציה שמציינת שתנועת ההחלקה לאחור יוצאת מהאפליקציה ומחזירה למסך הבית.

Android 14 כולל כמה שיפורים והנחיות חדשות לגבי 'חזרה חזותית':

בגרסה הזו של Android 14 בתצוגה מקדימה, כל התכונות של 'חזרה חזותית חזרה' נותרו מאחורי אפשרות למפתחים. כדאי לעיין במדריך למפתחים בנושא העברת האפליקציה לחזרה חזותית חזוי, וגם במדריך למפתחים בנושא יצירת מעברים מותאמים אישית באפליקציה.

ביטולים של הגדרות ברירת המחדל לכל אפליקציה בנפרד על ידי יצרן מכשיר עם מסך גדול

שינוי הגדרות ברמת האפליקציה מאפשר ליצרני המכשירים לשנות את ההתנהגות של האפליקציות במכשירים עם מסך גדול. לדוגמה, ההחרגה FORCE_RESIZE_APP מורה למערכת לשנות את גודל האפליקציה כך שיתאים למימדי המסך (מבלי להשתמש במצב תאימות לגודל) גם אם הערך resizeableActivity="false" מוגדר בקובץ המניפסט של האפליקציה.

השינויים מברירת המחדל נועדו לשפר את חוויית המשתמש במסכים גדולים.

מאפייני מניפסט חדשים מאפשרים להשבית חלק מהשינויים של יצרן המכשירים באפליקציה שלכם.

הגדרות שונות לכל אפליקציה למשתמשים במסכים גדולים

שינוי ההגדרות של כל אפליקציה בנפרד משנה את התנהגות האפליקציות במכשירים עם מסך גדול. לדוגמה, שינוי ברירת המחדל של יצרן המכשיר OVERRIDE_MIN_ASPECT_RATIO_LARGE מגדיר את יחס הגובה-רוחב של האפליקציה ל-16:9, ללא קשר להגדרות האפליקציה.

ב-Android 14 QPR1, משתמשים יכולים להחיל שינויים ספציפיים לאפליקציות באמצעות תפריט הגדרות חדש במכשירים עם מסך גדול.

שיתוף מסך של אפליקציה

שיתוף מסך של אפליקציה מאפשר למשתמשים לשתף חלון של אפליקציה במקום את כל מסך המכשיר במהלך הקלטת תוכן המסך.

כשמשתפים את המסך של אפליקציה, סרגל הסטטוס, סרגל הניווט, ההתראות ואלמנטים אחרים בממשק המשתמש של המערכת לא נכללים במסך המשותף. רק התוכן של האפליקציה שנבחרה ישותף.

שיתוף המסך של אפליקציות משפר את הפרודוקטיביות והפרטיות, כי הוא מאפשר למשתמשים להפעיל כמה אפליקציות אבל להגביל את שיתוף התוכן לאפליקציה אחת.

תשובה מהירה מבוססת-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.

גרפיקה

אפשר להריץ שאילתות על נתיבים ולבצע אינטרפולציה שלהם

ה-API Path של Android הוא מנגנון עוצמתי וגמיש ליצירה ולרינדור של גרפיקה וקטורית, עם אפשרות לצייר או למלא נתיב, לבנות נתיב מקטעי קו או מעקומות ריבועיות או ממעלה שלישית, לבצע פעולות בוליאניות כדי לקבל צורות מורכבות יותר או את כל האפשרויות האלה בו-זמנית. אחת מהמגבלות היא היכולת לברר מה נמצא בפועל באובייקט Path. הרכיבים הפנימיים של האובייקט לא גלויים למבצעי הקריאה אחרי היצירה.

כדי ליצור Path, צריך לבצע קריאה ל-methods כמו moveTo(),‏ lineTo() ו-cubicTo() כדי להוסיף קטעי נתיב. אבל לא הייתה אפשרות לשאול את הנתיב הזה מהם הפלחים, ולכן צריך לשמור את המידע הזה בזמן היצירה.

החל מ-Android 14, אפשר לשלוח שאילתות לגבי נתיבים כדי לבדוק מה נמצא בהם. קודם כול, צריך לקבל אובייקט PathIterator באמצעות API של 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. בהנחה שלשני הנתיבים יש מבנה פנימי זהה, ה-method 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 מאפשרת להשתמש בממשקי API דומים גם בגרסאות קודמות של 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

To assist in using Android's Canvas API to draw with hardware acceleration into a HardwareBuffer, Android 14 introduces HardwareBufferRenderer. This API is particularly useful when your use case involves communication with the system compositor through SurfaceControl for low-latency drawing.