نگاه

با استفاده از یک API به سبک Jetpack Compose، طرح‌بندی‌هایی برای سطوح از راه دور بسازید.
آخرین به روز رسانی انتشار پایدار کاندید را آزاد کنید نسخه بتا انتشار آلفا
16 اکتبر 2024 1.1.1 - - -

اعلام وابستگی ها

برای افزودن وابستگی به Glance، باید مخزن Google Maven را به پروژه خود اضافه کنید. برای اطلاعات بیشتر، مخزن Maven Google را بخوانید.

وابستگی‌های مصنوعات مورد نیاز خود را در فایل build.gradle برای برنامه یا ماژول خود اضافه کنید:

شیار 

dependencies {
    // For Glance support
    implementation "androidx.glance:glance:1.1.1"
    // For AppWidgets support
    implementation "androidx.glance:glance-appwidget:1.1.1"

    // For Wear-Tiles support
    implementation "androidx.glance:glance-wear-tiles:1.0.0-alpha05"
}

android {
    buildFeatures {
        compose true
    }

    composeOptions {
        kotlinCompilerExtensionVersion = "1.1.0-beta03"
    }

    kotlinOptions {
        jvmTarget = "1.8"
    }
}

کاتلین

dependencies {
    // For Glance support
    implementation("androidx.glance:glance:1.1.1")
    
    // For AppWidgets support
    implementation("androidx.glance:glance-appwidget:1.1.1")

    // For Wear-Tiles support
    implementation("androidx.glance:glance-wear-tiles:1.0.0-alpha05")
}

android {
    buildFeatures {
        compose = true
    }

    composeOptions {
        kotlinCompilerExtensionVersion = "1.1.0-beta03"
    }

    kotlinOptions {
        jvmTarget = "1.8"
    }
}

برای اطلاعات بیشتر درباره وابستگی‌ها، به افزودن وابستگی‌های ساخت نگاه کنید.

بازخورد

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

یک شماره جدید ایجاد کنید

برای اطلاعات بیشتر به مستندات ردیاب مشکل مراجعه کنید.

نسخه 1.1

نسخه 1.1.1

16 اکتبر 2024

androidx.glance:glance-*:1.1.1 منتشر شد. نسخه 1.1.1 حاوی این commit ها است.

رفع امنیتی

  • با توجه به این تغییر ، androidx در برابر protobuf 4.28.2 به منظور آدرس دهی CVE-2024-7254 کامپایل می شود. وابستگی خود را به نسخه 1.1.0 androidx.glance:glance-appwidget-proto و androidx.glance:glance-appwidget-external-protobuf به 1.1.1 ارتقا دهید تا خطر آسیب پذیری را برطرف کنید.

نسخه 1.1.0

12 ژوئن 2024

androidx.glance:glance-*:1.1.0 منتشر شد. نسخه 1.1.0 حاوی این تعهدات است.

تغییرات مهم از 1.0.0

  • Glance را به 1.1.0 stable منتقل می کند.

نسخه 1.1.0-rc01

14 مه 2024

androidx.glance:glance-*:1.1.0-rc01 منتشر شد. نسخه 1.1.0-rc01 حاوی این commit ها است.

ویژگی های جدید

  • پارامترهای عرض و ارتفاع به پیش نمایش حاشیه نویسی برای Glance اضافه شده است. 1.1.0 را به Release Candidate منتقل می کند.

تغییرات API

  • پارامتر اختیاری را به Scaffold اضافه می کند. ( If753f )
  • پارامترهای عرض و ارتفاع را به Glance @Preview اضافه کنید. ( Ibabe8 )
  • پشتیبانی از پیش‌نمایش‌های کاشی پوشیدن یک نگاه را حذف کنید. ( I3850a )
  • API برای تنظیم مقادیر وزن سفارشی برای FontStyle اضافه شد. ( I7390a )
  • برای انعکاس بهتر پیاده‌سازی‌های اساسی، و افزودن ثابت‌های ثابت برای TransformationInfo.sourceRotation ( Ic6149 ) نام‌های ImplementationMode Viewfinder را تغییر نام دهید.

رفع اشکال

  • رفع اشکالی که باعث ایجاد مشکلات رندر برای ViewGroups در حالت سازگاری به عقب ( I8de92 ) شده بود.

مشارکت خارجی

نسخه 1.1.0-beta02

17 آوریل 2024

androidx.glance:glance-*:1.1.0-beta02 منتشر شد. این نسخه حاوی جاهای منبعی است که در نسخه قبلی وجود نداشتند.

نسخه 1.1.0-beta01

3 آوریل 2024

androidx.glance:glance-*:1.1.0-beta01 منتشر شد. نسخه 1.1.0-beta01 حاوی این تعهدات است.

نسخه 1.1.0-alpha01

7 فوریه 2024

androidx.glance:glance-*:1.1.0-alpha01 منتشر شد. نسخه 1.1.0-alpha01 حاوی این commit ها است.

ویژگی های جدید

  • کتابخانه تست واحد برای Glance که به UI Automator نیاز ندارد. کد نگاه را می توان به طور مستقیم بدون نیاز به باد کردن نما آزمایش کرد.
  • اجزای سطح بالاتر برای طرح بندی ساده تر.
  • اصلاح‌کننده‌های جدید و گزینه‌های تم.
  • API جدید برای دریافت جریانی از RemoteViews از یک ترکیب، runComposition

تغییرات API

  • یک نقش رنگی widgetBackground جدید را به طرح‌های زمینه Glance اضافه می‌کند. ( Ia2ab8 )
  • GlanceAppWidget.runComposition اضافه کنید ( I6344c , b/298066147 )
  • جزء جدید TopBar را اضافه می کند ( Ibd361 )
  • موارد لغو را به اصلاح کننده clickable اضافه می کند. ( Iacecf )
  • یک api جدید برای رنگ آمیزی دکمه ها اضافه می کند. این باید تا 1.0 کشتی آزمایشی باشد. ( I92523 )
  • runGlanceAppWidgetUnitTest را اضافه می کند که دامنه فراخوانی متدهایی را در GlanceAppWidgetUnitTest مانند provideComposable برای ارائه یک composable جدا شده کوچک برای آزمایش، onNode برای یافتن یک عنصر قابل ترکیب Glance در محتوای ارائه شده را اضافه می کند. این به شما امکان می‌دهد تا تست‌های واحد را برای توابع قابل ترکیب جداگانه در appWidget خود بنویسید تا بررسی کنید که با توجه به ورودی‌های خاص، تابع مجموعه مورد نظر از عناصر قابل ترکیب را به صورت نگاهی خروجی می‌دهد. ( I2f682 )
  • یک اصلاح کننده testTag در معناشناسی برای استفاده در آزمون های واحد اضافه می کند. ( I8f62f )
  • به روز رسانی TitleBar - متن و نماد به صورت جداگانه قابل رنگ کردن. ( Ia0a60 )
  • جزء داربست را اضافه می کند ( I8a736 )
  • فیلتر hasActionRunCallbackClickAction و assertHasActionRunCallbackClickAction را برای آزمایش actionRunCallack اضافه می‌کند. همچنین، توابع نوع مختصر اضافی را برای فیلترهای آزمایشی مربوط به عملکرد اضافه می کند - hasStartActivityClickAction<activityClass>(..) ، hasStartServiceAction<receiverClass>(..) ، hasSendBroadcastAction<receiverClass>(..) . انواع مشابه را برای همتایان assertHasXXX خود اضافه می کند. ( Ieca63 )
  • api منتشر نشده را به اطراف منتقل می کند. یک اصلاح کننده را از داخلی به عمومی تغییر می دهد اما کتابخانه ای محدود شده است ( If2a08 )
  • روش onCompositionError را اضافه می کند که در آن توسعه دهندگان می توانند کد را در صورت بروز خطا اجرا کنند ( I9b56f )
  • دکمه و iconbutton apis را به یک نگاه اضافه می کند ( I0fd6f )
  • فیلترهای isLinearProgressIndicator ، isIndeterminateLinearProgressIndicator ، isIndeterminateCircularProgressIndicator را برای مطابقت با شاخص های پیشرفت اضافه می کند. موارد اضافی شامل فیلتر hasAnyDescendants برای آزمایش اینکه آیا یک گره دارای فرزندی در زیر سلسله مراتب خود است که با یک تطبیق خاص مطابقت دارد یا خیر ( Ifd426 )
  • اظهارات و فیلترهایی را برای فعال کردن آزمایش اقدامات کلیکی که سرویس / فعالیت یا پخش را شروع می کنند اضافه می کند. همچنین شامل آزمایش اگر عناصر ورودی بررسی شده باشند. ( I3041c )

نسخه 1.0.0

نسخه 1.0.0-alpha06

7 فوریه 2024

androidx.glance:glance-appwidget-preview:1.0.0-alpha06 و androidx.glance:glance-preview:1.0.0-alpha06 منتشر شد. نسخه 1.0.0-alpha06 حاوی این commit ها است.

ویژگی های جدید

  • نسخه برای پیروی از ماژول Glance اصلی به روز شد.

نسخه 1.0.0

6 سپتامبر 2023

androidx.glance:glance-*:1.0.0 منتشر شد. نسخه 1.0.0 حاوی این commit ها است.

ویژگی های اصلی 1.0.0

  • Glance را به نسخه پایدار 1.0.0 منتقل کنید

نسخه 1.0.0-rc01

26 جولای 2023

androidx.glance:glance-*:1.0.0-rc01 منتشر شد. نسخه 1.0.0-rc01 حاوی این commit ها است.

Glance را در مسیر انتشار پایدار برای نسخه 1.0.0 به rc01 منتقل می کند.

ویژگی های جدید

  • پارامترهای کلیدی را برای فراخوانی عمل پایدارتر به اکشن لامبدا اضافه می کند.
  • قابلیت ارائه به ActvityOptions برای startActivity را اضافه می کند.
  • پشتیبانی از اندروید 14 را اضافه می کند

تغییرات API

  • یک پارامتر کلید اختیاری برای همه عناصری که لامبدا را می پذیرند اضافه شد. ( ID96c1 , b/282445798 )
  • افزودن پشتیبانی برای تنظیم مجموعه ActivityOptions برای actionStartActivity ( I6a08d )
  • فایل‌های API عمومی و آزمایشی ادغام شده برای مسیرهای d,e,f,g ( I03646 , b/278769092 )
  • N/A، تغییرات فایل API فقط روش‌های مرتب‌سازی مجدد هستند ( I5fa95 )
  • افزودن API برای تنظیم CoroutineContext برای درخواست‌های GlanceAppWidgetReceiver ( I0a100 )
  • یک API جدید برای ارائه ActivityOptions برای LazyColumn و LazyVerticalGrid اضافه کرد که برای همه اقدامات موجود در لیست استفاده خواهد شد. ( Id8d71 )

رفع اشکال

  • N/A، تغییرات فایل API فقط روش‌های مرتب‌سازی مجدد هستند ( I5fa95 )
  • نسخه نمایشی سبک جزء متنی نگاه کنید ( Ie78a4 )

نسخه 1.0.0-beta01

10 مه 2023

androidx.glance:glance-*:1.0.0-beta01 منتشر شد. نسخه 1.0.0-beta01 حاوی این تعهدات است.

ویژگی های جدید

  • کتابخانه را به بتا منتقل می کند.
  • پشتیبانی از قالب‌بندی با استفاده از GlanceTheme ، ماژول‌های glance-material و glance-material3 را برای پشتیبانی از تم‌های سبک متریال 2 و متریال 3 در Glance اضافه می‌کند.
  • پشتیبانی از FontFamily به apis متن اضافه شده است.
  • GlanceAppWidget به مکانیزم به‌روزرسانی مبتنی بر جلسه WorkManager منتقل کرد. کاربران Glance برای AppWidgets اکنون باید GlanceAppWidget.provideGlance به جای روش Content قدیمی لغو کنند. از آنجایی که این مورد اکنون در یک کارگر اتفاق می افتد، اکنون مکان خوبی برای بارگیری منابع، پایگاه داده یا آیتم های شبکه بدون نیاز به داشتن کارگر جداگانه است.

تغییرات API

  • اضافه شده *Defaults برای Button ، Checkbox ، RadioButton و Switch . این نگاه را مطابق با الگوهای Jetpack Compose نزدیک‌تر می‌کند. ( I94828 )
  • ماژول الگوهای نگاه جدید ( I94459 )
  • ساخت ResourceColorProvider داخلی برای ماژول. شکستن تغییر. لازم است زیرا ResourceColorProvider فقط باید برای طرح زمینه پویا استفاده شود تا از موقعیت هایی که برخی از رنگ ها منابع پویا هستند و برخی کاملاً حل شده اند جلوگیری شود. ( Ib0db7 )
  • FontFamily به عنوان گزینه ای برای TextStyle اضافه می کند. ( Ic19ba , b/274179837 )
  • نام پارامتر مقدار برای Enum.valueOf تغییر کرد ( Ia9b89 )
  • استثناهای بیشتر از enum valueOf ( I818fe )
  • GlanceAppWidget برای استفاده از provideGlance به عنوان نقطه ورودی اصلی به روز کرد. GlanceAppWidget.Content اکنون منسوخ شده است. ( I202b5 )
  • گزینه ای برای ارائه رنگ رنگ برای تصاویر اضافه می کند ( I26192 , b/212418562 )
  • تهی پذیری بیشتر نوع بازگشت توابع منسوخ-مخفی. ( IBf7b0 )
  • افزودن حاشیه نویسی @JvmDefaultWithCompatibility ( I8f206 )
  • SingleEntityTemplateData.displayHeader استفاده نشده را حذف کرد. ( I7f094 )
  • پشتیبانی اضافه شده برای استفاده از لامبدا به عنوان تماس ( Ia0bbd )
  • DayNightColorProvider به ماژول Glance منتقل شد ( I1842c , b/256934779 )
  • LocalColorProvider از قالب ها حذف می کند. اکنون الگوها از GlanceTheme.colors استفاده خواهند کرد ( Ic15e2 )
  • قابلیت پوچ‌پذیری از Text(style: TextStyle) حذف شد ( I7123b ، b/237012816 )
  • رنگ متن پیش فرض به مشکی. حذف پوچ پذیری ( I3072c , b/237012816 )
  • ساختن تم پویا ColorProviders برای خودش. ساخت ResourceColorProvider داخلی ماژول. ( Id0e2d , b/237012816 )
  • دسته Undefined را به ImageSize اضافه کنید. ( I2fa39 )
  • حذف تابع GlanceAppWidget.Content منسوخ شده ( Ib05f6 )
  • اصلاح کننده را به عنوان پارامتر به AndroidRemoteViews اضافه می کند. ( I515d4 )
  • برای آسان‌تر کردن تست واحد، GlanceAppWidget.compose اضافه کنید ( Ie9b28 )

رفع اشکال

  • یک ویجت دمو برای فونت های متنی Glance اضافه شد ( I5c3d7 )
  • AndroidRemoteViews با Modifier قابل توجه می کند.
  • مشکلات مربوط به رنگ‌های تم ناسازگار حل شد
  • همه منابع اکنون برای جلوگیری از برخورد پیشوند شده اند

نسخه 1.0.0-alpha05

5 اکتبر 2022

androidx.glance:glance:1.0.0-alpha05 ، androidx.glance:glance-appwidget:1.0.0-alpha05 و androidx.glance:glance-wear-tiles:1.0.0-alpha05 منتشر شدند. نسخه 1.0.0-alpha05 حاوی این commit ها است.

ویژگی های جدید

  • requestPinGlanceAppWidget به GlanceAppWidgetManager اضافه می کند و به برنامه ها اجازه می دهد تا از کاربر بخواهند ویجت مبتنی بر Glance خود را به صفحه اصلی خود اضافه کنند. ( IC6e47 )
  • ACTION_DEBUG_UPDATE را به GlanceAppWidgetReceiver اضافه می کند تا به توسعه دهندگان اجازه دهد ویجت خود را مجبور کنند از adb در دستگاه های روت شده و شبیه سازها به روز شوند. ( I94ae1 )

تغییرات API

  • برای ساده کردن موارد استفاده، دکمه‌های عملکرد سرصفحه را در قالب‌های Glance حذف کنید. ( Ie4387 )
  • Refactored Single Entity Template برای استفاده مجدد از طراحی زیرسیستم Block. ( Iecd2c )
  • الگوی فهرست نگاه مجدد برای استفاده از طراحی بلوک Text/Image/Action . ( If0cc1 )
  • محدوده شماره اولویت را برای TextBlock و ImageBlock اضافه کنید. ( I73100 )

رفع اشکال

  • وابستگی Material3 حذف شد. ( I28d1c )
  • به سمت یک سیستم سازگارتر برای افزودن حاشیه و فاصله در طرح‌بندی الگو حرکت می‌کند. ( I29773 )
  • قانون نادرست Proguard را که انتشارهای کوچک را از ساختن مسدود می کرد، رفع می کند.

نسخه 1.0.0-alpha04

10 آگوست 2022

androidx.glance:glance:1.0.0-alpha04 ، androidx.glance:glance-appwidget:1.0.0-alpha04 و androidx.glance:glance-wear-tiles:1.0.0-alpha04 منتشر شدند. نسخه 1.0.0-alpha04 حاوی این commit ها است.

ویژگی های جدید

  • ویژگی های رنگ آمیزی دکمه را اضافه می کند.
  • حاشیه نویسی GlanceComposable را برای بررسی بهتر زمان کامپایل اضافه می کند.
  • ویژگی‌های خاص Wear Glance را اضافه می‌کند.

تغییرات API

  • Glance Gallery Data API و Condensed View را به‌روزرسانی کنید. ( Ibc7a8 )
  • ButtonColors برای پیکربندی دکمه ها اضافه می کند. ( Iea88d , b/236305351 )
  • تغییر نام ColorProvider.resolve به ColorProvider.getColor ( Ic9dfe )
  • متد copy() به TextStyle اضافه می کند. ( I9aef6 )
  • یک کلاس ColorProviders اضافه می کند که می تواند به عنوان بخشی از تم ها برای Glance استفاده شود. ( I848b9 , b/237012816 )
  • پشتیبانی از قالب لیست را به سبک های لیست و نمای جمع شده اضافه کنید. ( I50cdc )
  • معناشناسی را به GlanceModiier و GlanceCurvedModifier اضافه کنید. ( Ifda7e )
  • حاشیه نویسی GlanceComposable را اضافه کنید. ( I5dbf0 )
  • الگوهای Glance را به پروژه Glance اصلی منتقل می کند. ( I9db94 )
  • افزودن ColorProvider.resolve() ( Ife532 , b/214733442 )
  • روش جدید برای دریافت GlanceId از یک appWidgetId موجود یا یک هدف از یک فعالیت پیکربندی ( Icb70c , b/230391946 )
  • حاشیه نویسی GlanceComposable را اضافه کنید. ( I2c21f )
  • GlanceRemoteViews برای اجرای ترکیب خارج از GlanceAppWidget اضافه شد. ( I18f92 )
  • حذف رنگ در ProgressIndicatorDefaults . ( I40299 )
  • برای سازگاری با APIهای عمومی، همانطور که در بازخورد بررسی API لازم است، روش onRun ActionCallback را به onAction تغییر نام دهید. ( ICfa57 )
  • تبدیل طرح‌بندی الگوی نگاهی به استفاده از نقشه ( I46bfd )
  • افزودن RadioButton قابل تنظیم ( I4ecce )
  • GlanceWearTiles برای ترکیب کاشی های پوشیده اضافه شد ( Ia9f65 )
  • قابل کلیک به GlanceCurvedModifier ( Iec2a0 ) اضافه شد
  • CurvedRow به‌عنوان یک محدوده پیاده‌سازی کنید و یک DSL برای اضافه کردن عناصر معمولی قابل ترکیب و/یا منحنی ایجاد کنید. همچنین curvedLine و curvedSpacer اضافه شده است که به ArcLine و ArcSpacer در کاشی‌های اولیه ترجمه شده‌اند ( Ib955b )
  • پوچ پذیری به روز شده در هسته و appcompat برای مطابقت با Tiramisu DP2 ( I0cbb7 )
  • پشتیبانی از RuncallbackAction در کاشی‌های glance-wear-اضافه کنید، فقط RunCallbackAction با پارامتر NO در حال حاضر پشتیبانی می‌شود ( Ide64a )

مشارکت خارجی

  • به روز شد :compose:ui:ui-test api (updateApi) به دلیل مهاجرت test-coroutines-lib ( I3366d )

نسخه 1.0.0-alpha03

23 فوریه 2022

androidx.glance:glance-*:1.0.0-alpha03 منتشر شد. نسخه 1.0.0-alpha03 حاوی این commit ها است.

ویژگی های جدید

  • تعریف حالت ساده شده به صورت پیش‌فرض در تنظیمات برگزیده.

تغییرات API

  • مدیریت حالت را با تبدیل حالت PreferencesGlanceStateDefinition به حالت پیش فرض ساده کنید. GlanceAppWidget.updateAppWidgetState حذف کرد و updateAppWidgetState معرفی کرد که به طور پیش فرض از Preferences استفاده می کند. ( I58963 )
  • کلاس Glance TemplateText را اضافه کنید و طراحی الگو را به روز کنید ( I4e146 )
  • زیرساخت طرح کلی را برای قالب Freeform اضافه می کند ( If03d6 )
  • به‌روزرسانی‌های طرح‌بندی SingleEntityTemplate ( If925d )
  • LazyVerticalGrid ( I5f442 ) اضافه شد
  • استفاده از ColorProvider در SingleEntityTemplate ( I01ee0 )
  • به‌روزرسانی نام کلاس الگو ( I3720e )
  • اضافه شده LinearProgressIndicator و CircularProgressIndicator قابل ترکیب. ( Ie116b )

رفع اشکال

  • اجرای الگوهای با نگاه اولیه، داده‌های «الگوی تک موردی» و طرح‌بندی الگوی نمونه را تعریف می‌کند ( I35837 )
  • به طور پیش فرض محتوای کاشی را در مرکز قرار دهید ( I264be )
  • رفع اشکال با fillMaxSize/Width/Height در کاشی‌های پوشیدنی ( I0a39f )

نسخه 1.0.0-alpha02

26 ژانویه 2022

androidx.glance:glance-*:1.0.0-alpha02 منتشر شد. نسخه 1.0.0-alpha02 حاوی این commit ها است.

ویژگی های جدید

این نسخه شامل مجموعه ای از APIها برای ساخت Wear Tiles با استفاده از Compose Runtime با قابلیت های composable بهینه شده برای "Glanceable" است.

  • خدمات کاشی پوشیدن خود را با گسترش GlanceTileService ، سرویسی برای ایجاد کاشی شما در تابع ()Content قابل ترکیب، اعلام کنید.
  • کاشی‌ها را با یک نگاه خاص بپوشید: CurvedRow ، CurvedText .
  • با تعریف TimelineMode.SingleEntry و TimelineMode.TimeBoundEntries ، حالت های مختلف جدول زمانی کاشی را مدیریت کنید.
  • LocalTimeInterval ، ترکیب محلی به یک بازه زمانی خاص اشاره دارد.
  • BorderModifer یک GlanceModifier است که یک حاشیه در اطراف یک عنصر اعمال می کند.

این نسخه همچنین نشانگرهای پیشرفت را به AppWidget Glance اضافه می کند.

تغییرات API

  • اضافه شده LinearProgressIndicator و CircularProgressIndicator قابل ترکیب. ( Ie116b )
  • تغییر actionStartBroadcastReceiver به actionSendBroadcast ( I7d555 )
  • ارسال متن به GlanceAppWidget در حذف پاسخ تماس ( I4c795 )

رفع اشکال

  • مدیریت صحیح OPTIONS_APPWIDGET_SIZES در صورت وجود اما خالی. ( I01f82 )

نسخه 1.0.0-alpha01

15 دسامبر 2021

androidx.glance:glance:1.0.0-alpha01 ، androidx.glance:glance-appwidget:1.0.0-alpha01 و androidx.glance:glance-appwidget-proto:1.0.0-alpha01 منتشر شدند. نسخه 1.0.0-alpha01 حاوی این commit ها است.

ویژگی های نسخه اولیه

  • اولین نسخه Glance شامل اولین مجموعه APIها برای ساخت AppWidget با استفاده از Compose Runtime با مجموعه‌ای از Composables جدید بهینه‌سازی شده برای "Glanceables" است.

ویژگی ها