Emoji2
androidx.emoji2.text
androidx.emoji2.viewshelper
androidx.emoji2.widget
Dernière mise à jour | Version stable | Version finale | Version bêta | Version alpha |
---|---|---|---|---|
8 février 2023 | 1.2.0 | - | 1.3.0-beta02 | - |
Déclarer des dépendances
Pour ajouter une dépendance sur Emoji2, vous devez ajouter le dépôt Maven de Google à votre projet. Pour en savoir plus, consultez la section Dépôt Maven de Google.
Ajoutez les dépendances des artefacts dont vous avez besoin dans le fichier build.gradle
de votre application ou module :
Groovy
dependencies { def emoji2_version = "1.2.0" implementation "androidx.emoji2:emoji2:$emoji2_version" implementation "androidx.emoji2:emoji2-views:$emoji2_version" implementation "androidx.emoji2:emoji2-views-helper:$emoji2_version" }
Kotlin
dependencies { val emoji2_version = "1.2.0" implementation("androidx.emoji2:emoji2:$emoji2_version") implementation("androidx.emoji2:emoji2-views:$emoji2_version") implementation("androidx.emoji2:emoji2-views-helper:$emoji2_version") }
Pour en savoir plus sur les dépendances, consultez la page Ajouter des dépendances de compilation.
Commentaires
Vos commentaires nous aident à améliorer Jetpack. N'hésitez pas à nous contacter si vous découvrez de nouveaux problèmes ou si vous avez des idées pour améliorer cette bibliothèque. Veuillez consulter les problèmes existants de cette bibliothèque avant d'en signaler un nouveau. Vous pouvez ajouter votre vote à un problème existant en cliquant sur le bouton en forme d'étoile.
Pour en savoir plus, consultez la documentation sur l'outil Issue Tracker.
Emoji2 Emojipicker Version 1.0
Version 1.0.0-alpha01
25 janvier 2023
Publication d'androidx.emoji2:emoji2-emojipicker:1.0.0-alpha01
. Liste des commits de la version 1.0.0-alpha01
Nouvelles fonctionnalités
- Lancement d'un sélecteur d'emoji offrant une expérience utilisateur cohérente avec les derniers emoji sur les appareils et les applications OEM Android OS. Il est compatible avec les derniers emoji et l'interface utilisateur de sélection d'emoji, y compris les variantes de couleur de peau et la compatibilité avec les emoji.
Modifications apportées à l'API
- Introduction de la classe
EmojiPickerView
qui fournit des emoji récents dans une vue à défilement vertical avec un en-tête horizontal cliquable. - Les colonnes de la grille du sélecteur d'emoji peuvent être définies via l'attribut XML
emojiGridColumns
ou la fonctionsetEmojiGridColumns()
. - Les lignes de la grille du sélecteur d'emoji peuvent être définies via l'attribut XML
emojiGridRows
ou la fonctionsetEmojiGridRows()
. - L'écouteur du sélecteur d'emoji peut être défini via
setOnEmojiPickedListener()
. Il est informé chaque fois que l'utilisateur clique sur un emoji. - Le fournisseur d'emoji récents peut être fourni avec
setRecentEmojiProvider()
. Cette fonction est facultative. Si le fournisseur d'emoji récents n'est pas défini, un fournisseur d'emoji récents par défaut sera utilisé par la bibliothèque. Le comportement par défaut est défini comme suit : 1) Tous les emoji sélectionnés seront enregistrés au niveau de l'application dans les préférences partagées. 2) Le sélecteur affiche au maximum trois lignes d'emoji sélectionnés, dédupliqués, dans l'ordre antichronologique - Introduction de la classe
EmojiViewItem
contenant l'emoji affiché et ses variantes d'emoji. - Introduction de l'interface
RecentEmojiProvider
qui peut être mise en œuvre pour fournir une liste d'emoji récents. LerecentEmojiProvider
est chargé de fournir les emoji dans la catégorie "Utilisés récemment".
Version 1.3
Version 1.3.0-beta02
8 février 2023
Publication d'androidx.emoji2:emoji2-*:1.3.0-beta02
. Liste des commits de la version 1.3.0-beta02.
Nouvelles fonctionnalités
- Version de stabilisation destinée à permettre l'intégration dans Compose.
Version 1.3.0-beta01
25 janvier 2023
Publication d'androidx.emoji2:emoji2-*:1.3.0-beta01
. Liste des commits de la version 1.3.0-beta01
Nouvelles fonctionnalités
- Interrogation des exclusions système.
- Remplacement des ancrages pour le code de dessin personnalisé.
- Correction d'un bug qui provoquait l'application incorrecte des ancrages d'arrière-plan derrière
EmojiSopans
. - Cette version ajoute les API nécessaires à la prise en charge de
EmojiCompat
dans Compose. Compose devrait être compatible avec EmojiCompat très prochainement.
Version 1.3.0-alpha01
11 janvier 2023
Publication d'androidx.emoji2:emoji2-*:1.3.0-alpha01
. Liste des commits de la version 1.3.0-alpha01
Nouvelles API pour les interactions de niveau inférieur
- Interrogation des exclusions système
- Remplacement des ancrages pour le code de dessin personnalisé
- Correction d'un bug qui provoquait l'application incorrecte des ancrages d'arrière-plan derrière
EmojiSopans
. - Cette version ajoute les API nécessaires à la prise en charge de
EmojiCompat
dans Compose. Compose devrait être compatible avec EmojiCompat très prochainement.
Modifications apportées à l'API
- Ajout de la possibilité d'interroger les exclusions système dans
TypefaceEmojiRasterizer
. (I5653e) - Ajout d'une API
EmojiCompat.SpanFactory
pour remplacer le comportementEmojiSpan
par défaut par un code de dessin et de dimensionnement personnalisé. (Ib69d9) - Ajout d'
EmojiCompat
à Compose (I96f37, b/139326806)
Correction de bugs
- Emoji2 dessinera désormais correctement les arrière-plans à partir de
BackgroundSpan
. (Ide6a8, b/230525134) - Finalisation des API AppCompat pour la version 1.5.0-beta01 (I2a43d, b/236866227)
Version 1.2
Version 1.2.0
10 août 2022
Publication d'androidx.emoji2:emoji2-*:1.2.0
. Liste des commits de la version 1.2.0
Changements importants depuis la version 1.1.0
Cette version corrige un bug. Aucune nouvelle fonctionnalité ni API ajoutée depuis la version 1.1.0.
Il est toutefois impératif pour les applications qui utilisent PrecomputedText
ou TextView.setText(char[])
de passer à cette version.
Les bugs suivants ont été corrigés :
Emoji2
ajoutera des emoji àPrecomputedText
en supprimant la précédente mise en page de texte précalculée. (I47d06, b/211231958)- Correction du plantage de l'éditeur rétroporté sur Android P vers
EditText
configuré pour utiliser Emoji2. (Ifd709, b/216891011) - Correction du plantage lors du chargement de la police Emoji2 et de l'utilisation de
TextView.setText(char[])
(Id511e, b/206859724)
Version 1.2.0-rc01
27 juillet 2022
Publication d'androidx.emoji2:emoji2-*:1.2.0-rc01
. Liste des commits de la version 1.2.0-rc01.
- Aucune modification depuis la dernière version bêta.
Version 1.2.0-beta01
13 juillet 2022
Publication d'androidx.emoji2:emoji2-*:1.2.0-beta01
. Liste des commits de la version 1.2.0-beta01
Nouvelles fonctionnalités
- Aucune modification par rapport à la dernière version (cette version est compatible avec la version d'AppCompat).
Version 1.2.0-alpha04
20 avril 2022
Publication d'androidx.emoji2:emoji2-*:1.2.0-alpha04
. Liste des commits de la version 1.2.0-alpha04
Nouvelles fonctionnalités
- Aucune modification dans cette version.
Version 1.2.0-alpha03
6 avril 2022
Publication d'androidx.emoji2:emoji2-*:1.2.0-alpha03
. Liste des commits de la version 1.2.0-alpha03
Nouvelles fonctionnalités
- Aucune modification par rapport à la dernière version (cette version est compatible avec la version d'AppCompat).
Version 1.2.0-alpha02
23 mars 2022
Publication d'androidx.emoji2:emoji2-*:1.2.0-alpha02
. Liste des commits de la version 1.2.0-alpha02
Correction de bugs
- Emoji2 ajoutera des emoji à
PrecomputedText
en supprimant la précédente mise en page de texte précalculée. (I47d06, b/211231958) - Correction du plantage de l'éditeur rétroporté sur Android P vers EditText configuré pour utiliser emoji2. (Ifd709, b/216891011)
- Correction du plantage lors du chargement de la police Emoji2 et de l'utilisation de
TextView.setText(char[])
(Id511e, b/206859724)
Version 1.2.0-alpha01
23 février 2022
Publication d'androidx.emoji2:emoji2-*:1.2.0-alpha01
. Liste des commits de la version 1.2.0-alpha01.
Aucune modification par rapport à la version 1.1.0.
1.1
Version 1.1.0
23 février 2022
Publication d'androidx.emoji2:emoji2-*:1.1.0
. Liste des commits de la version 1.1.0
Modifications importantes depuis la version 1.0.0
- Emoji2-bundle contient une police 14 d'émoji
- La nouvelle API
getEmojiMatch
renvoie des informations précises concernant les claviers afin de déterminer la façon dont un emoji s'affiche en présence d'une police emojicompat en arrière-plan de la police du système - Correction d'un bug dans
NumberKeyListener
qui permet de filtrer correctement les caractères en saisissant des chiffres.
Version 1.1.0-rc01
9 février 2022
Publication d'androidx.emoji2:emoji2-*:1.1.0-rc01
. Liste des commits de la version 1.1.0-rc01
Nouvelles fonctionnalités
Aucune modification par rapport à la version bêta.
Nouvelles fonctionnalités par rapport à la version 1.0.0 d'Emoji2 :
emoji2-bundled
contient la police 14 d'emoji- La nouvelle API
getEmojiMatch
renvoie des informations précises concernant les claviers afin de déterminer la façon dont un emoji s'affiche en présence d'une police emojicompat en arrière-plan de la police du système - Correction d'un bug dans
NumberKeyListener
qui permet de filtrer correctement les caractères en saisissant des chiffres
Version 1.1.0-beta01
26 janvier 2022
Publication d'androidx.emoji2:emoji2-*:1.1.0-beta01
. Liste des commits de la version 1.1.0-beta01
Correction de bugs
- Version beta01 d'androidx-emoji2. Aucune modification par rapport à la version alpha01 (Ic61d9)
Version 1.1.0-alpha01
15 décembre 2021
Publication d'androidx.emoji2:emoji2-*:1.1.0-alpha01
. Liste des commits de la version 1.1.0-alpha01
Nouvelles fonctionnalités
emoji2-bundled
contient la police 14 d'emoji- La nouvelle API
getEmojiMatch
renvoie des informations précises concernant les claviers afin de déterminer la façon dont un emoji s'affiche en présence d'une police emojicompat en arrière-plan de la police du système - Correction d'un bug dans
NumberKeyListener
qui permet de filtrer correctement les caractères en saisissant des chiffres
Modifications apportées à l'API
- Ajout d'une nouvelle API
getEmojiMatch
pour autoriser les claviers à rechercher plus précisément des comportements correspondants d'emoji dans emojicompat. - Abandon de
hasEmojiGlyph
, car sa valeur de retour booléenne est imprécise lorsqu'il est testé sur une police plus ancienne que celle de la police emoji. Remplacer pargetEmojiMatch
. (Ie693d)
Correction de bugs
- Emoji2 n'encapsule pas les instances de
NumberKeyListener
. Les paramètres régionaux peuvent donc être configurés parTextView
. - Appcompat n'encapsulera pas les instances de
NumberKeyListener
transmises àsetKeyListener
, ce qui permet àTextView
de configurer correctement les paramètres régionaux surNumberKeyListeners
. (Ibf113, b/207119921)
1.0
Version 1.0.1
15 décembre 2021
Publication d'androidx.emoji2:emoji2-*:1.0.1
. Liste des commits de la version 1.0.1
Correction de bugs
Emoji2
n'encapsulera pas les instances deNumberKeyListener
, ce qui permet de configurer les paramètres régionaux viaTextView
.- Appcompat n'encapsulera pas les instances de
NumberKeyListener
transmises àsetKeyListener
, ce qui permet àTextView
de configurer correctement les paramètres régionaux surNumberKeyListeners
. (Ibf113, b/207119921)
Version 1.0.0
17 novembre 2021
Publication d'androidx.emoji2:emoji2-*:1.0.0
. Liste des commits de la version 1.0.0
Principales fonctionnalités de la version 1.0.0
Androidx.emoji2 remplace Androidx.emoji par des fonctionnalités supplémentaires :
- Diminution de la taille de l'APK par rapport à Androidx.emoji
- Configuration automatique
- Ajouté en tant que dépendance à Appcompat 1.4
Pour en savoir plus sur Androidx.emoji2, consultez Prise en charge des emoji modernes et notre sommet des développeurs Android qui permet d'afficher TOUS les emoji dans votre application Android Dev.
Version 1.0.0-rc01
27 octobre 2021
Publication d'androidx.emoji2:emoji2-*:1.0.0-rc01
. Liste des commits de la version 1.0.0-rc01.
- Aucune modification depuis la version beta02.
Emoji2 version 1.0.0-beta01
15 septembre 2021
Publication d'androidx.emoji2:emoji2-*:1.0.0-beta01
. Liste des commits de la version 1.0.0-beta01
Modifications apportées à l'API
Ajout de
setLoadingExecutor
àFontRequestEmojiCompatConfig
, qui remplace l'API précédente desetHandler
. Cette API permet aux applications de configurerFontRequestEmojiCompatConfig
pour utiliser n'importe quel exécuteur en arrière-plan.Il s'agit d'une modification destructive d'
androidx.emoji:emoji
.setHandler
est donc conservé en tant qu'API obsolète no-op pour faciliter la migration. (I6cd48)EmojiCompat définit correctement
EditorInfo.extras
sur Android 11- Les widgets personnalisés qui utilisent l'IME sans sous-classer EditText peuvent appeler
EmojiCompat.updateEditorInfo
pour indiquer à IME qu'ils acceptent le traitement d'EmojiCompat. (I1ea9b)
- Les widgets personnalisés qui utilisent l'IME sans sous-classer EditText peuvent appeler
Correction de bugs
- Correction de
DefaultEmojiCompatConfig
pour rechercher correctement le fournisseur de polices emoji sur les API 19 et 28. Correction d'un bug introduit dans la version 1.0.0-alpha01 d'Emoji2. (Ib33d8, b/197906329)
Version 1.0.0-alpha03
30 juin 2021
Publication d'androidx.emoji2:emoji2-*:1.0.0-alpha03
. Liste des commits de la version 1.0.0-alpha03
Nouvelles fonctionnalités
Cette version est une version de correction de bug et de stabilisation.
- EmojiEditTextHelper peut désormais transmettre
null
en tant que KeyListener. Cela permet à la plateforme d'appliquer des valeurs nulles aux emoji compatibles avec les intégrations d'EditText. - En cas d'utilisation d'EmojiCompatInitializer, le délai de démarrage initial est amélioré pour se lancer après la première reprise d'activité. Ainsi, le démarrage de l'application peut se dérouler sans interruption, et la police ne doit pas charger au démarrage des applications qui n'affichent jamais d'interface utilisateur. Après quelques instants, EmojiCompat crée un thread pour charger la police des emoji.
- Une nouvelle dépendance à
androidx.lifecycle:lifecycle-process
depuisandroidx.emoji2:emoji2
est ajoutée pour intégrer le délai. L'effet sur la taille des APK sera négligeable pour les applications qui incluent déjà un cycle de vie (par exemple, les applications avec Appcompat).
Modifications apportées à l'API
- Autorise des valeurs nulles de KeyListener dans AppCompatEditText. Cette opération inverse l'annotation non nulle ajoutée à AppCompatEditText dans la version 1.4.0-alpha01 et restaure le comportement précédent lorsqu'il était transmis avec la valeur nulle. (I21482, b/189559345)
Correction de bugs
- Modifiez EmojiCompatInitializer pour retarder le chargement de la police jusqu'à 500 ms après le premier
Activity.onResume
. Cela permet à une activité d'effectuer des opérationsApplication.onCreate
etActivity.onCreate
non exécutées, tout en s'assurant que la police des emoji est chargée peu de temps après le démarrage de l'application. (I4bff7)
Version 1.0.0-alpha02
2 juin 2021
Publication d'androidx.emoji2:emoji2:1.0.0-alpha02
, androidx.emoji2:emoji2-views:1.0.0-alpha02
et androidx.emoji2:emoji2-views-helper:1.0.0-alpha02
. Liste des commits de la version 1.0.0-alpha02
Modifications apportées à l'API
- Le package de
emoji2-views-helper
a été renommé enandroidx.emoji2.viewsintegration
. Il s'agit d'une modification destructive pour AppCompat1.4.0-alpha01
, et les applications doivent s'assurer que la dépendance AppCompat est mise à jour pour utiliser la nouvelle version d'Emoji2. (Ie8397)
Version 1.0.0-alpha01
18 mai 2021
Publication d'androidx.emoji2:emoji2:1.0.0-alpha01
, androidx.emoji2:emoji2-views:1.0.0-alpha01
et androidx.emoji2:emoji2-views-helper:1.0.0-alpha01
. Liste des commits de la version 1.0.0-alpha01
Fonctionnalités de cette version initiale
L'intégration d'Emojicompat est recommandée pour toutes les applications afin qu'elles soient compatibles avec les emoji modernes de l'API 19. Tous les contenus générés par les utilisateurs dans votre application contiennent 🎉.
EmojiCompat est passé des artefacts androidx.emoji
au nouveau androidx.emoji2
, maintenant en version alpha01. Les nouveaux artefacts remplacent la version précédente.
emoji2
est ajouté en tant que dépendance à AppCompat à partir d'AppCompat 1.4.0-alpha01
et est activé par défaut pour les vues AppCompat.
L'artefact emoji2
introduit une nouvelle configuration automatique à l'aide de la bibliothèque androidx.startup
. Vous n'avez plus besoin d'écrire de code 👨🏽 💻 pour afficher 🐻 ❄️.
Modifications entre Emoji2 et Emoji
- Ajout de la configuration automatique
EmojiCompatInitializer
avecandroidx.startup
. - Ajout d'une configuration par défaut qui utilise l'emplacement du service pour trouver un fournisseur de polices téléchargeables dans
DefaultEmojiCompatConfiguration
. - Classes déplacées du package
androidx.emoji
versandroidx.emoji2
. - Division d'
EmojiTextView
et des vues associées dans un artefactemoji2-views
distinct. À utiliser uniquement si votre application n'utilise pas Appcompat. - Des assistants ont été extraits pour intégrer des Emojicompat aux vues personnalisées dans un artefact
emoji2-views-helper
distinct. - Ajout d'annotations pouvant être de valeur nulle.
- Des assistants dans
emoji2-views-helper
peuvent désormais être utilisés même siEmojiCompat
n'est pas initialisé (auparavant, ils généraient une exception).
Quelle dépendance devez-vous ajouter ?
- Les applications utilisant AppCompat doivent passer à la version
1.4.0-alpha01
ou ultérieure d'AppCompat. - Les applications n'utilisant pas AppCompat, mais plutôt
TextView
/EditText
depuis la plate-forme doivent utiliserEmojiTextView
et les classes associées d'emoji2-views
.
Comment prendre en charge les vues personnalisées
- Les applications utilisant AppCompat doivent étendre
AppCompatTextView
,AppCompatButton
, etc. au lieu de la plate-formeTextView
, etc. - Les applications n'utilisant pas AppCompat doivent ajouter la dépendance
androidx.emoji2:emoji2-views-helper
et utiliser des assistants pour intégrer des sous-classesTextView
ouEditText
personnalisées.
Configurer l'initialisation automatique
Les applications peuvent désactiver l'initialisation automatique en ajoutant le code suivant au fichier manifeste :
<provider android:name="androidx.startup.InitializationProvider" android:authorities="${applicationId}.androidx-startup" android:exported="false" tools:node="merge"> <meta-data android:name="androidx.emoji2.text.EmojiCompatInitializer" tools:node="remove" /> </provider>
La configuration automatique est alors désactivée, et vous pouvez ensuite transmettre une configuration personnalisée à
EmojiCompat.init
. La configuration par défaut du système peut être uneDefaultEmojiCompatConfig.create(context)
récupérée pour une configuration ultérieure avant de la transmettre àEmojiCompat.init
.