5 آوریل 2023

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

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

androidx.emoji2:emoji2-emojipicker

Emoji Picker یک راه حل رابط کاربری است که ظاهر و احساس مدرن، ایموجی های به روز و سهولت استفاده را ارائه می دهد. کاربران می‌توانند شکلک‌ها و انواع آن‌ها را مرور و انتخاب کنند، یا از میان شکلک‌هایی که اخیراً استفاده کرده‌اند، انتخاب کنند. با استفاده از این کتابخانه، برنامه‌ها در سرتاسر OEM‌های مختلف می‌توانند یک تجربه ایموجی فراگیر و یکپارچه را به کاربران خود ارائه دهند بدون اینکه توسعه‌دهندگان مجبور باشند انتخابگر شکلک خود را از ابتدا بسازند و نگهداری کنند.

ایموجی های به روز

هر ساله ایموجی های جدیدی منتشر می شوند و ما به صورت انتخابی آنها را در Emoji Picker قرار می دهیم. برای اطمینان از سازگاری با عقب، ما یک بررسی دقیق رندرپذیری ایموجی در داخل انجام می دهیم تا توفو را حذف کنیم. این اطمینان حاصل می کند که کتابخانه با چندین نسخه و دستگاه اندروید سازگار است.

انواع چسبنده

با فشار طولانی یک ایموجی، منویی از انواع مختلف مانند جنسیت یا رنگ پوست مختلف نمایش داده می شود. گونه ای که انتخاب می کنید در انتخابگر شکلک ذخیره می شود و آخرین نوع انتخاب شده در پانل اصلی استفاده می شود. با استفاده از این ویژگی، کاربران می توانند انواع شکلک های دلخواه خود را تنها با یک ضربه ارسال کنند.

ایموجی های اخیر

RecentEmojiProvider مسئول ارائه ایموجی‌ها در دسته «اخیراً استفاده شده» است. این کتابخانه یک ارائه‌دهنده شکلک اخیر پیش‌فرض دارد که رایج‌ترین موارد استفاده را برآورده می‌کند:

• همه شکلک‌های انتخابی در سطح هر برنامه در اولویت‌های مشترک ذخیره می‌شوند.
• انتخابگر حداکثر 3 ردیف از شکلک‌های انتخابی را به ترتیب زمانی معکوس نمایش می‌دهد.

اگر این رفتار پیش‌فرض کافی است، دیگر نیازی به تنظیم متد setRecentEmojiProvider() ندارید.

با EmojiCompat کار کنید

اگر برنامه دارای نمونه EmojiCompat باشد، از آن در انتخابگر شکلک برای ارائه هرچه بیشتر شکلک‌های ممکن استفاده می‌شود. اگر EmojiCompat غیرفعال باشد، انتخابگر شکلک همچنان خوب کار می کند.

نحوه استفاده از کتابخانه

برای استفاده از کتابخانه، یک توسعه دهنده برنامه باید

1. androidx.emoji2:emojipicker:$version در build.gradle وارد کنید.

   dependencies {
     implementation "androidx.emoji2:emojipicker:$version"
   }
   

2. نمای انتخابگر ایموجی را باد کنید و به صورت اختیاری emojiGridRows و emojiGridColumns را بر اساس اندازه دلخواه هر سلول ایموجی تنظیم کنید

   • می‌توانید آن‌ها را تنظیم نشده رها کنید، پیش‌فرض ۹ emojiGridColumns است، ردیف‌ها براساس ارتفاع نمای والد و ستون‌های emojiGridColumns محاسبه می‌شوند.
   • می‌توانید emojiGridRows به‌عنوان یک شناور تنظیم کنید تا اگر در XML به پایین اسکرول کنید، ایموجی‌های بیشتری وجود دارد.

    <androidx.emoji2.emojipicker.EmojiPickerView
     android:id="@+id/emoji_picker"
     android:layout_width="match_parent"
     android:layout_height="match_parent"
     app:emojiGridColumns="9" />
   

در کد

    val emojiPickerView = EmojiPickerView(context).apply {
        emojiGridColumns = 15
        layoutParams = ViewGroup.LayoutParams(
            ViewGroup.LayoutParams.MATCH_PARENT,
            ViewGroup.LayoutParams.MATCH_PARENT
        )
    }
    findViewById<ViewGroup>(R.id.emoji_picker_layout).addView(emojiPickerView)

1. با فرض اینکه می خواهید ایموجی های انتخاب شده را به EditText اضافه کنید، از setOnEmojiPickedListener() استفاده کنید.

     emojiPickerView.setOnEmojiPickedListener {
         findViewById<EditText>(R.id.edit_text).append(it.emoji)
     }
   

2. به صورت اختیاری RecentEmojiProvider را تنظیم کنید، برای اجرای نمونه برنامه نمونه را ببینید.

3. به صورت اختیاری استایل ها را سفارشی کنید. سبک خود را ایجاد کنید تا ویژگی‌های تم رایج را نادیده بگیرید و سبک را در EmojiPickerView اعمال کنید. برای مثال، نادیده گرفتن colorControlNormal رنگ نماد دسته را تغییر می‌دهد.

     <style name="CustomStyle" >
         <item name="colorControlNormal">#FFC0CB</item>
     </style>
     <androidx.emoji2.emojipicker.EmojiPickerView
         android:id="@+id/emoji_picker"
         android:layout_width="match_parent"
         android:layout_height="match_parent"
         android:theme="@style/CustomStyle"
         app:emojiGridColumns="9" />
   

برای اجرای نمونه برنامه نمونه را ببینید.

یک سطح کامل API را می توان در اینجا پیدا کرد.

نمونه برنامه

این برنامه نمونه موارد استفاده اساسی به همراه سناریوهای اضافی زیر را نشان می دهد:

• نمای دوباره چیدمان شد زیرا emojiGridRows و emojiGridColumns بازنشانی شدند.
• ارائه‌دهنده Emoji اخیر برای مرتب‌سازی بر اساس فرکانس لغو شده است.
• سفارشی سازی سبک

تغییرات API

کتابخانه Emoji Picker با API های جدید زیر به روز شده است:

• کلاس EmojiPickerView که ایموجی های به روز را در نمای عمودی قابل پیمایش با هدر افقی قابل کلیک ارائه می دهد.
• امکان تنظیم تعداد ستون‌ها و ردیف‌ها در شبکه انتخاب‌کننده emoji از طریق ویژگی‌های XML emojiGridColumns و emojiGridRows یا متدهای setEmojiGridColumns() و setEmojiGridRows() .
• امکان تنظیم یک شنونده انتخاب شده ایموجی از طریق متد setOnEmojiPickedListener() . هر زمان که کاربر روی هر ایموجی کلیک کند، شنونده مطلع می شود.
• امکان ارائه یک ارائه دهنده ایموجی اخیر از طریق متد setRecentEmojiProvider() . این یک تابع اختیاری است. اگر ارائه‌دهنده ایموجی اخیر تنظیم نشده باشد، یک ارائه‌دهنده شکلک اخیر پیش‌فرض توسط کتابخانه استفاده خواهد شد. رفتار پیش فرض به صورت زیر تعریف می شود:
  • همه شکلک‌های انتخابی در سطح هر برنامه در اولویت‌های مشترک ذخیره می‌شوند.
  • انتخابگر حداکثر 3 ردیف از شکلک‌های انتخابی را به ترتیب زمانی معکوس نمایش می‌دهد.
• کلاس EmojiViewItem که ایموجی نمایش داده شده و انواع ایموجی های آن را نگه می دارد.
• رابط RecentEmojiProvider ، که می تواند برای ارائه لیست ایموجی های اخیر پیاده سازی شود. recentEmojiProvider مسئول ارائه ایموجی‌ها در دسته «اخیراً استفاده شده» است.
• رابط RecentEmojiAsyncProvider ، که می تواند برای ارائه لیست ایموجی های اخیر پیاده سازی شود. RecentEmojiAsyncProvider مسئول ارائه ایموجی ها در دسته «اخیراً استفاده شده» است. این رابط معادل RecentEmojiProvider است که به مشتریان اجازه می دهد تا متد getRecentEmojiListAsync() برای ارائه ایموجی های اخیر نادیده بگیرند.
• کلاس RecentEmojiProviderAdapter که آداپتوری برای RecentEmojiAsyncProvider است و RecentEmojiProvider را پیاده سازی می کند.