AppSearch

‫AppSearch היא ספרייה לחיפוש במכשיר שמאפשרת לנהל נתונים מובנים שמאוחסנים באופן מקומי, עם ממשקי API ליצירת אינדקס של נתונים ולאחזור נתונים באמצעות חיפוש טקסט מלא. אפשר להשתמש בו כדי ליצור יכולות חיפוש מותאמות אישית בתוך האפליקציה עבור המשתמשים.
העדכון האחרון גרסה יציבה גרסה מועמדת להפצה גרסת בטא גרסת אלפא
‫25 במרץ 2026 1.1.0 - - ‎1.2.0-alpha01

הצהרה על יחסי תלות

כדי להוסיף תלות ב-AppSearch, צריך להוסיף את מאגר Google Maven לפרויקט. מידע נוסף זמין במאמר בנושא מאגר Maven של Google.

אתם יכולים להוסיף את יחסי התלות של הארטיפקטים שאתם צריכים בקובץ build.gradle של האפליקציה או המודול:

מגניב

dependencies {
    def appsearch_version = "1.2.0-alpha01"

    implementation "androidx.appsearch:appsearch:$appsearch_version"
    // Use kapt instead of annotationProcessor if writing Kotlin classes
    annotationProcessor "androidx.appsearch:appsearch-compiler:$appsearch_version"

    implementation "androidx.appsearch:appsearch-local-storage:$appsearch_version"
    // PlatformStorage is compatible with Android 12+ devices, and offers additional features
    // to LocalStorage.
    implementation "androidx.appsearch:appsearch-platform-storage:$appsearch_version"

    // PlayServicesStorage is compatible with all devices that support Google Play Services on
    // all API levels. It offers the same features as PlatformStorage and is the recommended
    // solution for lower API levels on which PlatformStorage is not supported.
    implementation "androidx.appsearch:appsearch-play-services-storage:$appsearch_version"
}

Kotlin

dependencies {
    val appsearch_version = "1.2.0-alpha01"

    implementation("androidx.appsearch:appsearch:$appsearch_version")
    // Use annotationProcessor instead of kapt if writing Java classes
    kapt("androidx.appsearch:appsearch-compiler:$appsearch_version")

    implementation("androidx.appsearch:appsearch-local-storage:$appsearch_version")
    // PlatformStorage is compatible with Android 12+ devices, and offers additional features
    // to LocalStorage.
    implementation("androidx.appsearch:appsearch-platform-storage:$appsearch_version")

    // PlayServicesStorage is compatible with all devices that support Google Play Services on
    // all API levels. It offers the same features as PlatformStorage and is the recommended
    // solution for lower API levels on which PlatformStorage is not supported.
    implementation("androidx.appsearch:appsearch-play-services-storage:$appsearch_version")

}

מידע נוסף על יחסי תלות זמין במאמר הוספת יחסי תלות ב-build.

משוב

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

יצירת דיווח על בעיה חדשה

מידע נוסף זמין במאמרי העזרה בנושא Issue Tracker.

גרסה 1.2

גרסה ‎1.2.0-alpha01

‫25 במרץ 2026

‫androidx.appsearch:appsearch-*:1.2.0-alpha01 מופץ. גרסה ‎1.2.0-alpha01 מכילה את השמירות האלה.

שינויים ב-API

  • השבתה והסתרה של ה-API להפצת מחיקות (Ia4073, b/384947619)
  • משנים את setSchemaTypeWipeoutAccountPropertyPaths כדי לצלם סדרת תמונות. (If442c, b/470398298)
  • הרשאות גישה לתמיכה עבור Process#isPccUid (I2ee69, ‏ b/463863587)
  • הוסתר חלק מהיצרנים שנחשפו בטעות בסוגים מובנים של AppSearch (I98583, ‏ b/463386955)
  • נוספה הפונקציה AppSearchSchema#fromDocumentClass שמחזירה את הסכימה שנוצרה עבור מחלקה עם הערה מסוג @Document ‏ (I599ad, ‏ b/458101236)
  • הוספה של setSchemaTypeWipeoutAccountPropertyPaths אל GetSchemaResponse (I8f6d4, ‏ b/413089233)
  • הוספת API להגדרת מחיקת חשבון ב-SetSchemaRequest. (Id5a47, b/413089233)
  • נוספה מחלקה של כלי בנייה ליצירת חשבון מסוג מובנה (I29d07, ‏ b/429110646)
  • הוספת API להפצת מחיקה (I57f89, ‏ b/384947619)AppSearch
  • נוסף ממשק משותף ל-GlobalSearchSession ול-EnterpriseGlobalSearchSession (If2a70, ‏ b/422241546)
  • ניקוי ExperimentalAppSearchApi מ-Blob API ‏ (I610e8, ‏ b/273591938)
  • הוספה של סוג כינוי מובנה (I8aba0)
  • נוסף Action Accumulator API ‏ (I3f778, ‏ b/395157195)
  • העברנו מאפיינים מוטמעים שניתנים לאינדוקס לתכונה חדשה (I4cf95, b/407815165)
  • הסרה של הערות @RequiresApi(21) שיצאו משימוש (Ic4792)
  • הוספת חשבון חדש מסוג מובנה (Iadad6, ‏ b/422079057)
  • הוספת קוד שגיאה של תוצאה AppSearchResult#RESULT_UNAVAILABLE (I48411, ‏ b/407815165, ‏ b/404210068, ‏ b/415387509, ‏ b/419875333, ‏ b/417461575, ‏ b/415031127, ‏ b/357835538)
  • נוסף API של Action Accumulator ‏ (I97818, ‏ b/395157195)
  • הוספת AppSearchResult קוד RESULT_ABORTED חדש (I6c375, b/409070736)
  • האירוע שונה כך שנדרש API O. ‫(I4433b, ‏ b/399728815)
  • נוספה AppSearch סכימה מובנית SportsEvent חדשה (I0dea6, ‏ b/399728815)
  • נוספה סכימה מובנית חדשה AppSearch SportsTeam (I073cd, ‏ b/399728815)
  • נוספה סכימה מובנית חדשה AppSearch SportsOrganization (I5729c, ‏ b/399728815)
  • נוספה סכימה מובנית חדשה AppSearch Organization (I4bb2d, b/399728815)
  • נוספה סכימה חדשה מובנית AppSearch Event (Ifd646, ‏ b/399728815)
  • כדי להשתמש בפרויקטים שפורסמו עם Kotlin 2.0, צריך KGP 2.0.0 או גרסה חדשה יותר (Idb6b5,‏ b/344563182)
  • הפיכת WebPage להרחבה (I622f7, ‏ b/399220908)
  • הוספת שדה מקור אל WebPage (Ic4d7b, ‏ b/399220908)
  • שינוי הפרמטרים של בנאי TextMatchInfo (Ie29c3, ‏ b/403591188, ‏ b/395128139)

תיקוני באגים

  • העברה של ספריות לשימוש ביעד Java 11. המשמעות היא שקוד הבייט שנוצר יהיה Java 11 (גרסה 55 של קובץ המחלקה) ויכול להיות שיהיה צורך בביטול הסוכר כדי להשתמש בספרייה (If4c2a, ‏ b/457821470)
  • ‫SearchFeatures וגם RankingFeatures ‫(I54b7d, ‏ b/387291182)
  • שימוש בדגל חדש להפצת מחיקה (If21ae, ‏ b/384947619)
  • הוספת רישום מפורט יותר ביומן (I10604, b/448872333)
  • הוספה מחדש של allowoptimization לכלל שמירה של ProGuard עבור AppSarchDocumentClassMap (I0bd88, b/440484133)
  • תוקן באג בגרסאות אופטימליות שבו הפניות למחלקות מסמכים AppSearch הוחלפו במחלקות לא קשורות בגלל מיזוג מחלקות אופקי (I93f20, ‏ b/440484133)
  • הוספת תכונה ISOLATED_STORAGE (Ifb963)

גרסה 1.1

גרסה 1.1.0

‫2 ביולי 2025

‫androidx.appsearch:appsearch-*:1.1.0 מופץ. גרסה 1.1.0 מכילה את השמירות האלה.

גרסה ‎1.1.0-rc01

‫20 במאי 2025

‫androidx.appsearch:appsearch-*:1.1.0-rc01 מופץ. גרסה ‎1.1.0-rc01 מכילה את השמירות האלה.

תכונות חדשות

  • המודול AppSearch עובר ל-RC.
  • נוסף API ניסיוני חדש לצבירת פעולות לשיטה PutDocumentsRequest#addTakenAction (I7b726)
  • הוספה של SearchResult#TextMatchInfo, SearchResult#EmbeddingMatchInfo; שינוי המבנה של SearchResult#MatchInfo כדי לספק מידע על התאמות של הטמעות (I8f78d)
  • הוספת פונקציות דירוג לשינוי רשימות (Ifa4ab)

שינויים ב-API

  • תמיכה ב-AppSearch annotation processor עבור מאפיין של blob handle. (I9520b)
  • צריך לעדכן את מעבד האנוטציות AppSearch כדי לתמוך בקוונטיזציה. (Ie0c85)
  • נוספה method סטטית getFeatures() ל-PlatformStorage ול-LocalStorage (I5a206)

תיקוני באגים

  • הספרייה הזו משתמשת עכשיו באנוטציות של JSpecify לגבי ערכי null, שהן אנוטציות של שימוש בטיפוסים. מפתחי Kotlin צריכים להשתמש בארגומנטים הבאים של הקומפיילר כדי לאכוף שימוש נכון: ‎-Xjspecify-annotations=strict, -Xtype-enhancement-improvements-strict-mode (I91f42, ‏ b/326456246)

גרסה ‎1.1.0-beta01

‫15 בינואר 2025

‫androidx.appsearch:appsearch-*:1.1.0-beta01 מופץ. גרסה ‎1.1.0-beta01 מכילה את השמירות האלה.

תכונות חדשות

  • מודול AppSearch עובר לגרסת בטא.

שינויים ב-API

  • השבתנו את ה-API הניסיוני AppSearch להפצת מחיקות בגלל בעיות יציבות. (Iea386)
  • ‫Create GlobalSearchApplicationInfo API, דרך ניסיונית ואופציונלית שמאפשרת ליצרנים ולצרכנים לציין עניין בסוגים מסוימים. (I116fd)
  • שינויים קלים בממשקי API ניסיוניים של AST (בונה שאילתות) (Ibd852)

תיקוני באגים

  • הספרייה הזו משתמשת עכשיו באנוטציות של JSpecify לגבי ערכי null, שהן אנוטציות של שימוש בטיפוסים. מפתחים ב-Kotlin צריכים להשתמש בארגומנט המהדר הבא כדי לאכוף שימוש נכון: -Xjspecify-annotations=strict (זו ברירת המחדל החל מגרסה 2.1.0 של מהדר Kotlin). ‫(Ic2976, ‏ b/326456246)
  • הוספת ההרשאה הנדרשת ל-searchPersonCorpus (I4431d)

גרסה ‎1.1.0-alpha07

‫11 בדצמבר 2024

‫androidx.appsearch:appsearch-*:1.1.0-alpha07 מופץ. גרסה ‎1.1.0-alpha07 מכילה את השמירות האלה.

תכונות חדשות

  • מוסיפים את ההערה ExperimentalAppSearchApi לממשקי API חדשים שעדיין לא עברו ייצוב. (Ib09f4)
  • תמיכה באחסון ובשיתוף יעילים של נתוני blob בינאריים באמצעות AppSearchSession#openBlobForWriteAsync ושיטות קשורות
  • תמיכה בסינון תוצאות של שאילתות לפי ביטוי ניקוד באמצעות הפונקציה matchScoreExpression (Id525a)
  • תמיכה בהעברת מחיקה ממסמך אב למסמכי צאצא. (Ia032d)
  • תמיכה בהטמעה של Quantization API כדי לשפר את ביצועי ההטמעה עם ירידה קלה באיכות. (Id8a07)
  • תמיכה בהגבלת חיפושים למסמכים מסוימים באמצעות addFilterDocumentIds API ב-SearchSpec. (I7c6f1)

שינויים ב-API

  • העברת מידע על סוג ההורה מ-GenericDocument אל SearchResult. (I34a1d)
  • תמיכה בסוגים חדשים של פעולות ב-TakenAction API, כולל DismissAction ו-ImpressionAction. (I0c6c7)
  • נוספה סכימה מובנית חדשה של AppSearch‏ WebPage. (I28127)

גרסה ‎1.1.0-alpha06

‫16 באוקטובר 2024

‫androidx.appsearch:appsearch-*:1.1.0-alpha06 מופץ. גרסה ‎1.1.0-alpha06 מכילה את השמירות האלה.

שינויים ב-API

  • נוסף צומת שמייצג את פונקציית השאילתה PropertyDefined. (I1aeaf)
  • מוסיפים צמתים שמייצגים חיפוש מספרי והגבלת מאפיינים. (I963a9)
  • הוספת צומת שמייצג את פונקציית השאילתה GetSearchStringParameter. (I4f99b)
  • מוסיפים צומת שמייצג את פונקציית השאילתה HasProperty. (I9c1c5)
  • הוספנו ממשק להטמעת פונקציות ב-AST. (I9d42e)
  • מוסיפים את האופרטורים AND ו-OR. (Iaa442)
  • מוסיפים NegationNode כדי לייצג שלילת שאילתות לוגיות ב-AST. (Ia855a)
  • הוספת ממשק Node ל-AppSearch להגדרת צמתים. (If42fb)
  • הוספנו הערה לגבי API ניסיוני ל-AppSearch. (I3e57c)

תיקוני באגים

  • מוסיפים TextNodes כדי להחזיק את התנאים. (Iefd02)

תיקון אבטחה

  • החל מהשינוי הזה, androidx עובר קומפילציה מול protobuf 4.28.2 כדי לטפל ב-CVE-2024-7254. כדי לטפל בסיכון לפרצת אבטחה, צריך לשדרג את התלות ב-androidx.appsearch:appsearch-external-protobuf לגרסה העדכנית ביותר, 1.1.0-alpha06.

גרסה ‎1.1.0-alpha05

‫4 בספטמבר 2024

‫androidx.appsearch:appsearch-*:1.1.0-alpha05 מופץ. גרסה ‎1.1.0-alpha05 מכילה את השמירות האלה.

שינויים ב-API

  • הוצאה משימוש של setEmbeddingSearchEnabled ו-getEmbeddingSearchEnabled מיותרים. מחיקה של setListFilterTokenizeFunctionEnabled ושל getListFilterTokenizeFunctionEnabled. נמחקה פונקציית השאילתה tokenize. הוחלפה בפונקציית השאילתה getSearchStringParameter ובפונקציה addSearchStringParameter. (I09f5a)
  • שינוי השם של Alarm#getComputingDevice לgetOriginatingDevice. (I63121)

גרסה ‎1.1.0-alpha04

‫7 באוגוסט 2024

‫androidx.appsearch:appsearch-*:1.1.0-alpha04 מופץ. גרסה ‎1.1.0-alpha04 מכילה את השמירות האלה.

תכונות חדשות

  • תמיכה בהטמעה חדשה של PlayServicesStorage, שמאפשרת להשתמש ב-AppSearch במכשירים ישנים יותר בלי להגדיל באופן משמעותי את גודל קובץ ה-APK של LocalStorage. הטמעת האחסון הזו פועלת על ידי אחסון נתוני האפליקציה בתוך אפליקציית Play Services.
  • תמיכה בממשקי API חדשים במכשירים עם Android 15.
  • תמיכה בחיפוש במסד הנתונים לפי וקטורי הטמעה, שמאפשר התאמה משוערת. (I2b41b)
  • תמיכה בסוגי הורה ובפולימורפיזם במודל הסכימה AppSearch. (I06118)
  • תמיכה ב-API‏ TakenAction שמאפשר לאפליקציות לדווח על מקרים שבהם המשתמשים לחצו על תוצאות או נטשו אותן, כדי לשפר את האיכות של החיפושים הבאים. (I54091)
  • כדי לתמוך בכיתות עם builders ב-מעבד אנוטציות (Annotation processor), הוספנו את ה-אנוטציה החדשה @Document.BuilderProducer. (Iec30a)
  • תמיכה בשליטה מדויקת יותר במאפיינים של מסמך מוטמע שמתווספים לאינדקס. (Iec30a)
  • תמיכה בסינון חיפושים לפי מאפיינים מסוימים של מסמכים. (Ib2659)
  • תמיכה בהגדרות חשיפה מפורטות יותר על ידי מתן אפשרות להשתמש באופרטורים OR ו-AND בהגדרות החשיפה. (I0274b)
  • תמיכה בהענקת הרשאת גישה לנתונים לכל האפליקציות שיכולות לראות את קיום האפליקציה הבעלים (הרשאת גישה ציבורית). (I992e4)
  • תמיכה באחזור רק של תוצאות שמאוכלסות בנתונים במאפיין מסוים. (I7d94f)
  • תמיכה באחזור אנשי קשר ארגוניים בפרופיל לשימוש אישי. (Idd587)

שינויים ב-API

  • מוסיפים את פרמטרי ההערות indexableNestedPropertiesList ו-inheritIndexableNestedPropertiesFromSuperclass להערה Document.DocumentProperty של AppSearch כדי לאפשר יצירת אינדקס של נתיבי מאפיינים ספציפיים שמוטמעים בתוך מאפיינים אחרים. (Iec30a)
  • תמיכה ב-builder constructor ליצירת מופעי builder במעבד אנוטציות (Annotation processor) AppSearch (I265c9)
  • עדכון מעבד האנוטציות AppSearch כדי לתמוך בהגדרת סוגי הורה לפולימורפיזם (I06118)
  • נוסף method‏ GetSchemaRequest לניקוי הגדרות הגישה (I38379)
  • תמיכה ב-addParentType ב-AppSearch עבור פולימורפיזם (Ida14a)
  • הוספת ממשקי API לביטויים נוספים של דירוג (I5d9f4)
  • הוספת SearchAction API ‏ (I54091)
  • הוספת שדה תיאור לסוגים AppSearch (I84762)
  • הטמעת ממשקי API לחיפוש שאילתות והדירוג שלהן ב-AppSearch (I0f6c3)
  • הסרה של getDeletionPropagation (I21192)

גרסה ‎1.1.0-alpha03

‫24 במאי 2023

‫androidx.appsearch:appsearch-*:1.1.0-alpha03 מופץ. גרסה ‎1.1.0-alpha03 מכילה את השמירות האלה.

תכונות חדשות

  • תמיכה ב-API מתקדם לשאילתות, ב-API מתקדם לניקוד ובחיפוש מספרי. (I02d48)
  • נוסף LocalStorage.createGlobalSearchSession API לחיפוש בכל מסדי הנתונים באחסון המקומי של אפליקציה אחת. (Id3c89)
  • הוספנו API לצירוף מסמכים לפי מזהה (Iaecfa)
  • תמיכה במשקלים של נכסים כדי לציין שנכסים מסוימים חשובים יותר כשמשתמשים ב-RANKING_STRATEGY_RELEVANCE_SCORING. (I069b9)
  • מוסיפים את Person ואת ContactPoint כדי לשלוח שאילתה למאגר המידע Person ב-AppSearch. (Ia58f9)
  • נוסף סוג מסמך חדש ImageObject שמבוסס על http://schema.org/ImageObject. (I6a0c0)
  • מוסיפים VERBATIM tokenizer שמאפשר להוסיף מאפיינים בלי ש-AppSearch יפרש אותם. (I47bc0)
  • הוספנו את RFC822_TOKENIZATION כסוג של tokenizer, שמאפשר טוקניזציה של כתובות אימייל. (I8a390)
  • מפעילים את החיפוש הגלובלי בתצוגת ניפוי הבאגים. (I51fb2)

שינויים ב-API

  • הוסרו שיטות שמחזירות ListenableFuture ואין להן סיומת Async. (I0515f)
  • הוספת היכולת להגדיר הקרנות לפי Document כיתה. (I94576)
  • הוספת שדות מThing עד Alarm, AlarmInstance, Timer, Stopwatch, StopwatchLap, ContactPoint וPerson (Id876c)

תיקוני באגים

  • תמיכה מלאה בתכונות של Android 13 ב-appsearch-platform-storage (Ia8e61)
  • פתרון בעיות שקשורות לביטול שמות של סכימות ושדות פרטיים כשמשתמשים בירושה.

גרסה ‎1.1.0-alpha02

‫24 באוגוסט 2022

‫androidx.appsearch:appsearch-*:1.1.0-alpha02 מופץ. גרסה ‎1.1.0-alpha02 מכילה את השמירות האלה.

תכונות חדשות

  • האצת תהליך האופטימיזציה באמצעות דחיסת אינדקס במקום בנייה מחדש של האינדקס מאפס
  • תג הרישום המקורי שונה מ-icing ל-AppSearchIcing, הודעות INFO נרשמות כברירת מחדל

שינויים ב-API

  • נוסף אובייקט PropertyPath חדש לעבודה עם נתיבים, ונוספו methods חדשות של addProjection לקבלת PropertyPath. (I45588)
  • הוספת builtin:Thing לסוגים מובנים של AppSearch (I55427)
  • מניעת שמות מאפיינים ריקים ב-GenericDocument מוקדם יותר – בעבר הם נמנעו בזמן האינדוקס, ועכשיו הם נמנעים בזמן GenericDocument.Builder.build() (I9e780)

תיקוני באגים

  • הסרנו עיצוב מחרוזות מיותר כדי לשפר את הביצועים של ניקוד הרלוונטיות
  • שיפור היעילות של חלוקה לעמודים כשנתקלים במסמכים לא קריאים או שנמחקו
  • הטמענו garbage collection לשאילתות שהוזנחו
  • תיקון התמיכה בהוספה לאינדקס של מסמכים מוטמעים. בעבר המערכת התעלמה מההגדרה indexNestedProperties. (Iae9a6)

External Contribution

  • שיי סמית': תיקון התמיכה באינדקסים מוטמעים במסמכים. (Iae9a6)

גרסה ‎1.1.0-alpha01

‫15 ביוני 2022

‫androidx.appsearch:appsearch-*:1.1.0-alpha01 מופץ. גרסה ‎1.1.0-alpha01 פותחה בענף פרטי של גרסת טרום-השקה, ואין לה שמירות ציבוריות.

שינויים ב-API

  • לכל השיטות שמחזירות ListenableFuture נוסף הסיומת Async. לדוגמה, השם getSchema השתנה ל-getSchemaAsync. הגרסאות הקודמות הוצאו משימוש ויוסרו בגרסה עתידית.

תכונות חדשות

  • הגרסה הראשונה של appsearch-builtin-types. הפרויקט הזה מכיל כמה סוגים מובנים שמבוססים על schema.org, ולקוחות יכולים להשתמש בהם במקום להגדיר סוגים משלהם לאובייקטים נפוצים. סוגים נוספים יתווספו בגרסאות עתידיות.
  • אפשרות להשתמש ב-ShortcutAdapter כדי להמיר מסמך AppSearch ל-ShortcutInfoCompat. כך לקוחות יכולים לשתף מסמכי AppSearch עם Google באמצעות הספרייה core-google-shortcuts
  • אפשרות להשתמש בהורשה עם כיתות @Document. אי אפשר להחליף או לשנות שדות, אבל אפשר להוסיף שדות חדשים על ידי הרחבת מחלקה עם האנוטציה @Document.
  • ‫Observer API חדש שמאפשר ללקוחות להירשם לקבלת התראות כשסוגים שיש להם גישה אליהם משתנים, או כשמסמכים מהסוגים האלה מתווספים, משתנים או מוסרים. חשוב: ההטמעה הנוכחית מספקת התראות רק כשהאפליקציה פועלת. אין כרגע דרך לבדוק שינויים שקרו בזמן שהאפליקציה הייתה מושבתת. לכן, לא כדאי להסתמך על ה-API הזה כדי לקבל נתונים מלאים.
  • ממשק API לניתוח נכסים, שמאפשר לכם לטפל באופן מלא בנתיבי נכסים שמוחזרים על ידי MatchInfo#getPropertyPath ולבדוק אותם.
  • ממשקי API גלובליים getById וגלובליים getSchema לאחזור מסמכים וסכימות מאפליקציות אחרות שהעניקו לכם הרשאת גישה.
  • אפשרות לאחזר מידע על רמת החשיפה ב-getSchema לגבי נתונים שיש לכם גישה אליהם
  • אפשרות להעניק לאפליקציות גישה לנתונים אם יש להן הרשאה מסוימת ב-Android (האפשרות הזו מוגבלת לקבוצה מצומצמת של הרשאות ברשימת ההיתרים)
  • תמיכה בשיטות גישה (getters) בסגנון isFoo()לשדות בוליאניים במעבד אנוטציות (Annotation processor), בנוסף לסגנון הקודם שנתמך hasFoo()
  • תמיכה בתכונות חדשות שמוגנות על ידי @RequiresFeature. אפשר להשתמש ב-AppSearchSession#getFeatures כדי לראות מה ה-Backend הנוכחי תומך.
  • הסרת מגבלת של כ-13,000 טוקנים במסמכים בודדים
  • התאמה לתווים שאינם ASCII ולתווים שאינם אלפאנומריים, כמו אמוג'י

תיקוני באגים

  • תוקן באג שגרם לכשל ב-SetSchema כשמבטלים סוג לא תואם מוטמע.
  • בוצעו תיקונים כדי לתמוך באופן מלא בשימוש בכיתות עם הערות @AutoValue ככיתות @Document של AppSearch
  • תיקונים לקריסות מסוימות שקשורות לרשימות חוזרות של מחלקות מסמכים ולבעיות אחרות
  • תיקון באג שגרם לקריסת חיפוש קידומות בנסיבות מסוימות
  • תיקון באג קל ב-GetStorageInfo שגורם להחזרת ערכים שגויים כשמתרחשות שגיאות קלט/פלט
  • פתרון בעיות שקשורות ל-BUSADDERR בקריאת מסמך
  • תיקון של קובץ logcat פגום שנוצר מהדפסה של טביעת אצבע לא מעוצבת
  • תיקון שגיאת NPE שנגרמת בגלל כשלים בקלט/פלט
  • תיקון דליפת זיכרון ב-GetSchemaType, ב-Get, ב-Delete, ב-DeleteByNamespace וב-DeleteBySchemaType

גרסה 1.0.0

גרסה ‎1.0.0-alpha04

‫3 בנובמבר 2021

‫androidx.appsearch:appsearch-*:1.0.0-alpha04 מופץ. גרסה ‎1.0.0-alpha04 מכילה את השמירות האלה.

תכונות חדשות

  • תלות ב-Guava ListenableFuture נוספת אוטומטית כתלות ב-API

שינויים ב-API

  • נוספו הפונקציות SearchResult#getSubmatchRange()‎ ו-SearchResult#getSubmatch()‎ כדי לספק מידע נוסף על כל התאמה. (I2fef6)
  • הוספנו הבהרות לתיעוד בנוגע לאופן יצירת טביעות אצבע של PackageIdentifier לשיתוף נתונים לפי שם חבילה + אישור

תיקוני באגים

  • תיקון קריסה אם המשתמש מנסה לאחזר דפי תוצאות אחרי סוף קבוצת התוצאות
  • תוקנה בעיה שגרמה לכך שכל מרחבי השמות נשאלו אם רק מרחבי שמות לא חוקיים סופקו כמסנני שאילתות
  • תיקון בעיה שבה כל מרחבי השמות מוסרים אם רק מרחבי שמות לא תקינים סופקו כמסנני remove-by-query
  • פתרון בעיה שבה נתוני מסמכים הפסיקו להיות באינדקס אחרי נקודה מסוימת במסמכים גדולים מאוד
  • תוקנה בעיה שגרמה לכך שפילוח טקסט היה משמיט פלחים עם תווים מספריים שהם לא תווי ASCII
  • הוספת בדיקה של ניסיונות אתחול רצופים שנכשלו כדי לצאת ממצב לא תקין פוטנציאלי שמונע אתחול מוצלח.

גרסה ‎1.0.0-alpha03

21 ביולי 2021

‫androidx.appsearch:appsearch-*:1.0.0-alpha03 מופץ. גרסה ‎1.0.0-alpha03 מכילה את השמירות האלה.

תכונות חדשות

  • השקנו את Platform Storage Backend כדי לאפשר ללקוחות להשתמש ב-AppSearch API עם שירות android.app.appsearch.AppSearchManager חדש שיושק ב-Android S. פרטים נוספים זמינים במדריך למפתחים של AppSearch.
  • תמיכה במעבד אנוטציות (Annotation processor) ב-AutoValue
  • הסרת מגבלת הגודל המקסימלי של מאפיין מחרוזת יחידה
  • פורמט אחסון חדש להפחתת זמן האחזור של האתחול
  • העברת נתונים פנימית חד-פעמית מפורמט אחסון ישן לפורמט אחסון חדש

תיקוני באגים

  • אכיפה נכונה של מגבלת המסמכים המקסימלית כשמוסיפים מסמכים חדשים
  • תוקנה קריסה במהלך יצירת AppSearchSession
  • תוקנו באגים ב-SetSchema שלא זיהו מקרים מסוימים של אי-תאימות לאחור ואי-תאימות לאינדקס

גרסה ‎1.0.0-alpha02

‫30 ביוני 2021

האפליקציות androidx.appsearch:appsearch:1.0.0-alpha02, androidx.appsearch:appsearch-compiler:1.0.0-alpha02 וגם androidx.appsearch:appsearch-local-storage:1.0.0-alpha02 מושקות. גרסה ‎1.0.0-alpha02 מכילה את השמירות האלה.

תכונות חדשות

  • תמיכה מלאה בשפות סינית, יפנית, קוריאנית ותאית
  • הגודל הוקטן ב-androidx.appsearch:appsearch-local-storage
  • הסרה של מגבלת הגודל המקסימלי של מאפיינים חוזרים
  • אפשר לעשות שימוש חוזר בכיתות של כלי הבנייה
  • שיפורים ב-toString() של אובייקטים מסוימים כדי להקל על ניפוי באגים
  • שיפורים במסמכי ה-Javadoc

שינויים ב-API

  • השם של המרחב שונה על ידי SearchResult#getMatches. השם החדש הוא SearchResult#getMatchInfos
  • השם של המרחב שונה על ידי @Document.Int64Property. השם החדש הוא @Document.LongProperty

תיקוני באגים

  • שיפורים ותיקונים בחישוב של תקצירי תוצאות
  • תיקנו באגים באתחול של AppSearchSession

גרסה 1.0.0-alpha01

‫5 במאי 2021

האפליקציות androidx.appsearch:appsearch:1.0.0-alpha01, androidx.appsearch:appsearch-compiler:1.0.0-alpha01 וגם androidx.appsearch:appsearch-local-storage:1.0.0-alpha01 מושקות. גרסה 1.0.0-alpha01 מכילה את השמירות האלה.

תכונות חדשות

‫AppSearch היא ספריית חיפוש לניהול נתונים מובְנים שמאוחסנים באופן מקומי, עם ממשקי API ליצירת אינדקס של נתונים ולאחזור נתונים באמצעות חיפוש טקסט מלא. אפשר להשתמש בו כדי ליצור יכולות חיפוש מותאמות אישית בתוך האפליקציה עבור המשתמשים. הגרסה הראשונית הזו היא 1.0.0-alpha01.