Emoji2

Affichez des emoji sur les appareils actuels et plus anciens.
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.

Signaler un nouveau problème

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 fonction setEmojiGridColumns().
  • Les lignes de la grille du sélecteur d'emoji peuvent être définies via l'attribut XML emojiGridRows ou la fonction setEmojiGridRows().
  • 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. Le recentEmojiProvider 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 comportement EmojiSpan 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 par getEmojiMatch. (Ie693d)

Correction de bugs

  • Emoji2 n'encapsule pas les instances de NumberKeyListener. Les paramètres régionaux peuvent donc être configurés par TextView.
  • Appcompat n'encapsulera pas les instances de NumberKeyListener transmises à setKeyListener, ce qui permet à TextView de configurer correctement les paramètres régionaux sur NumberKeyListeners. (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 de NumberKeyListener, ce qui permet de configurer les paramètres régionaux via TextView.
  • Appcompat n'encapsulera pas les instances de NumberKeyListener transmises à setKeyListener, ce qui permet à TextView de configurer correctement les paramètres régionaux sur NumberKeyListeners. (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 de setHandler. Cette API permet aux applications de configurer FontRequestEmojiCompatConfig 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)

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.

  1. 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.
  2. 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 depuis androidx.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érations Application.onCreate et Activity.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é en androidx.emoji2.viewsintegration. Il s'agit d'une modification destructive pour AppCompat 1.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 avec androidx.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 vers androidx.emoji2.
  • Division d'EmojiTextView et des vues associées dans un artefact emoji2-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 si EmojiCompat 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 utiliser EmojiTextView 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-forme TextView, 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-classes TextView ou EditText 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 une DefaultEmojiCompatConfig.create(context) récupérée pour une configuration ultérieure avant de la transmettre à EmojiCompat.init.