Emoji2

Mostrare le emoji sui dispositivi attuali e meno recenti.
Ultimo aggiornamento Release stabile Candidato per la release Versione beta Versione alpha
4 settembre 2024 1.5.0 - - -

Dichiarazione delle dipendenze

Per aggiungere una dipendenza da Emoji2, devi aggiungere il repository Maven di Google al tuo progetto. Per ulteriori informazioni, consulta il repository Maven di Google.

Aggiungi le dipendenze per gli elementi necessari nel file build.gradle per la tua app o il tuo modulo:

Alla moda

dependencies {
    def emoji2_version = "1.5.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.5.0"

    implementation("androidx.emoji2:emoji2:$emoji2_version")
    implementation("androidx.emoji2:emoji2-views:$emoji2_version")
    implementation("androidx.emoji2:emoji2-views-helper:$emoji2_version")
}

Per ulteriori informazioni sulle dipendenze, consulta Aggiungere dipendenze di compilazione.

Feedback

Il tuo feedback ci aiuta a migliorare Jetpack. Facci sapere se riscontri nuovi problemi o hai idee per migliorare questa raccolta. Prima di crearne uno nuovo, dai un'occhiata ai problemi esistenti in questa raccolta. Puoi aggiungere il tuo voto a un problema esistente facendo clic sul pulsante a forma di stella.

Creare un nuovo problema

Per ulteriori informazioni, consulta la documentazione del Monitoraggio problemi.

Emojipicker Emoji2 versione 1.0

Versione 1.5.0

4 settembre 2024

Viene rilasciato androidx.emoji2:emoji2-*:1.5.0. La versione 1.5.0 contiene questi commit.

Modifiche importanti dalla versione 1.4.0

  • Supporto dell'interfaccia utente del selettore di emoji 15.1 e bidirezionale. Un semplice clic sul selettore bidirezionale consente agli utenti di passare dalle versioni delle emoji rivolte verso sinistra a quelle rivolte verso destra e viceversa.
  • Supporto del selettore di emoji con più tonalità della pelle. Se premi a lungo le emoji di coppia, viene visualizzato un selettore di emoji per più persone per lo stato zero. Quando l'utente tocca la metà sinistra di un'emoji, l'anteprima dell'emoji in basso a destra viene aggiornata di conseguenza. Quando l'utente seleziona entrambe le metà di un'emoji, l'anteprima dell'emoji in basso a destra mostra l'intera emoji, che l'utente può quindi inserire.

Versione 1.0.0-alpha03

8 marzo 2023

androidx.emoji2:emoji2-emojipicker:1.0.0-alpha03 viene rilasciato. La versione 1.0.0-alpha03 contiene questi commit.

Correzioni di bug

  • Sono state rimosse risorse non necessarie e le dimensioni della raccolta sono state ridotte di circa 0,3 M.

Versione 1.0.0-alpha02

22 febbraio 2023

androidx.emoji2:emoji2-emojipicker:1.0.0-alpha02 viene rilasciato. La versione 1.0.0-alpha02 contiene questi commit.

Modifiche alle API

  • È stata aggiunta una nuova API per consentire ai client Java di fornire emoji recenti. (I39d10)

Correzioni di bug

  • Aggiorna le risorse relative alle emoji per supportare le emoji 15.0 (Ib4eb3)
  • Quando selezioni un'emoji dalla finestra popup, aggiorna tutte le emoji identiche con quella appena selezionata (tranne la riga di emoji recenti). Annuncia anche l'emoji quando fai clic. (I892c6)
  • Attendi il caricamento di emojicompat prima di visualizzare EmojiPickerView. (I29e03)

Versione 1.0.0-alpha01

25 gennaio 2023

androidx.emoji2:emoji2-emojipicker:1.0.0-alpha01 viene rilasciato. La versione 1.0.0-alpha01 contiene questi commit.

Nuove funzionalità

  • È stato introdotto un selettore di emoji che offre un'esperienza utente coerente con le emoji più recenti su app e dispositivi OEM con sistema operativo Android. Fornisce il supporto delle emoji più recenti e l'interfaccia utente del selettore di emoji, incluse le varianti di tonalità della pelle e il supporto della compatibilità delle emoji.

Modifiche all'API

  • È stato introdotto il tipo EmojiPickerView che fornisce emoji aggiornate in una visualizzazione scorrevole verticale con un'intestazione orizzontale cliccabile.
  • Le colonne della griglia del selettore di emoji possono essere impostate tramite l'attributo XML emojiGridColumns o la funzione setEmojiGridColumns().
  • Le righe della griglia del selettore di emoji possono essere impostate tramite l'attributo XML emojiGridRows o la funzione setEmojiGridRows().
  • L'ascoltatore dell'emoji scelta può essere impostato tramite setOnEmojiPickedListener() e riceverà una notifica ogni volta che l'utente fa clic su un'emoji.
  • Il fornitore di emoji recente può essere fornito con setRecentEmojiProvider(). Questa è una funzione facoltativa. Se il fornitore di emoji recente non è impostato, nella raccolta verrà utilizzato un fornitore di emoji recente predefinito. Il comportamento predefinito è definito come segue: 1) tutti gli emoji selezionati verranno salvati a livello di app nelle preferenze condivise. 2) il selettore mostrerà al massimo 3 righe di emoji selezionate, deduplicate, in ordine cronologico inverso.
  • È stata introdotta la classe EmojiViewItem che contiene l'emoji visualizzata e le relative varianti.
  • È stata introdotta l'interfaccia di RecentEmojiProvider che può essere implementata per fornire un elenco recente di emoji. recentEmojiProvider è responsabile della fornitura delle emoji nella categoria "Utilizzate di recente".

Versione 1.5

Versione 1.5.0

4 settembre 2024

Viene rilasciato androidx.emoji2:emoji2-*:1.5.0. La versione 1.5.0 contiene questi commit.

Modifiche importanti dalla versione 1.4.0

  • Supporto dell'interfaccia utente del selettore di emoji 15.1 e bidirezionale. Un semplice clic sul selettore bidirezionale consente agli utenti di passare dalle versioni delle emoji rivolte verso sinistra a quelle rivolte verso destra e viceversa.
  • Supporto del selettore di emoji con più tonalità della pelle. Se premi a lungo le emoji di coppia, viene visualizzato un selettore di emoji per più persone per lo stato zero. Quando l'utente tocca la metà sinistra di un'emoji, l'anteprima dell'emoji in basso a destra viene aggiornata di conseguenza. Quando l'utente seleziona entrambe le metà di un'emoji, l'anteprima dell'emoji in basso a destra mostra l'intera emoji, che l'utente può quindi inserire.

Versione 1.5.0-rc01

21 agosto 2024

Viene rilasciato androidx.emoji2:emoji2-*:1.5.0-rc01. La versione 1.5.0-rc01 contiene questi commit.

Nuove funzionalità

  • Supporto dell'interfaccia utente del selettore di emoji 15.1 e bidirezionale. Un semplice clic sul selettore bidirezionale consente agli utenti di passare dalle versioni rivolte verso sinistra a quelle rivolte verso destra delle emoji.
  • Supporto del selettore di emoji con più tonalità della pelle. Se premi a lungo le emoji di coppia, viene visualizzato un selettore di emoji per più persone per lo stato zero. Quando l'utente tocca la metà sinistra di un'emoji, l'anteprima dell'emoji in basso a destra viene aggiornata di conseguenza. Quando l'utente seleziona entrambe le metà di un'emoji, l'anteprima mostra l'intera emoji e l'utente può inserirla.

Correzioni di bug

  • È stato rimosso il riepilogo manuale dell'accesso alle nuove API di piattaforma, poiché questo avviene automaticamente tramite la definizione del modello API quando si utilizza R8 con AGP 7.3 o versioni successive (ad es. R8 versione 3.3) e per tutte le build quando si utilizza AGP 8.1 o versioni successive (ad es. D8 versione 8.1). Agli utenti che non utilizzano AGP è consigliato di eseguire l'aggiornamento alla versione 8.1 o successive di D8. Consulta questo articolo per ulteriori dettagli. (If6b4c, b/345472586)
  • La selezione della scheda e l'indicatore di EmojiPickerView vengono aggiornati un clic dopo. (146b02, b/288261054)
  • La selezione e l'indicatore della scheda di EmojiPickerView non funzionano. (5e1f14, b/273883688)

Versione 1.5.0-beta01

10 luglio 2024

androidx.emoji2:emoji2-*:1.5.0-beta01 viene rilasciato. La versione 1.5.0-beta01 contiene questi commit.

Nuove funzionalità

  • Supporto dell'interfaccia utente di selezione delle emoji 15.1 e bidirezionale.
  • Supporto per il nuovo design della selezione di più tonalità della pelle.

Correzioni di bug

  • La selezione della scheda e l'indicatore di EmojiPickerView vengono aggiornati un clic dopo. (146b02, b/288261054)
  • La selezione e l'indicatore della scheda di EmojiPickerView non funzionano. (5e1f14, b/273883688)

Versione 1.5.0-alpha01

13 dicembre 2023

androidx.emoji2:emoji2-*:1.5.0-alpha01 viene rilasciato. La versione 1.5.0-alpha01 contiene questi commit.

Nuove funzionalità

  • emoji2-bundled contiene un carattere emoji aggiornato per supportare Emoji 15.1.

Modifiche all'API

  • Aggiungi gli esecutori per controllare il thread di callback per InitCallback. (I32b67)
  • BundledEmojiCompatConfig ora richiede un'esecuzione per controllare i thread di caricamento. (I00e81)

Versione 1.4

Versione 1.4.0

9 agosto 2023

androidx.emoji2:emoji2-*:1.4.0 viene rilasciato. La versione 1.4.0 contiene questi commit.

Modifiche importanti dalla versione 1.3.0

Versione 1.4.0-rc01

26 luglio 2023

Viene rilasciato androidx.emoji2:emoji2-*:1.4.0-rc01. La versione 1.4.0-rc01 contiene questi commit.

Modifiche all'API

  • Introduzione dell'elenco registerSource (Iae92f)
  • Feedback del Consiglio API: TransitionManager.seekTo() è stato rinominato in createSeekController(). Modifica il commento precedente sull'aggiunta di TransitionManager.seekTo() a TransitionManager.createSeekController(). (Idbeb1)
  • È stato aggiunto ExerciseRouteResult, che non è la superclasse di Data, NoData e ConsentRequiredStates. È stata aggiunta ExerciseRoute come classe autonoma, che contiene i dati sulla posizione del percorso. (I22eed)
  • PagerLayoutInfo introdotto con informazioni raccolte dopo il superamento della misura in Pager. È stato introdotto anche PageInfo, le informazioni su una singola pagina misurata in Pager. (Iad003, b/283098900)

Correzioni di bug

  • Abbiamo aggiornato i colori di Button, IconButton e TextButton in linea con il design di Material3. Il ruolo semantico per Button, IconButton e TextButton ora può essere sostituito utilizzando Modifier.semantics. (Ib2495)
  • È stato corretto un problema relativo all'aggiornamento della selezione della scheda e dell'indicatore di EmojiPickerView con un clic in ritardo. (I4db04)
  • FileNotFoundException sulla visualizzazione del selettore di emoji (I353e4)
  • Catturare il WindowManager.BadTokenException quando si utilizza EmojiPickerView (I0a144)

Versione 1.4.0-beta05

7 giugno 2023

androidx.emoji2:emoji2-*:1.4.0-beta05 viene rilasciato. La versione 1.4.0-beta05 contiene questi commit.

Correzioni di bug

  • È stato risolto un bug introdotto nella versione 1.3 che causava l'applicazione di MetricsAffectingSpans, ad esempio RelativeSizeSpan, due volte. Una volta durante il layout del testo e di nuovo all'interno di EmojiSpan.draw. Il risultato è stato un disegno con dimensioni errate, visibile se uno dei parametri delle dimensioni del testo è stato modificato dall'elemento span. (b/283208650)

Versione 1.4.0-beta04

24 maggio 2023

androidx.emoji2:emoji2-*:1.4.0-beta04 viene rilasciato. La versione 1.4.0-beta04 contiene questi commit.

In questa release è stato corretto un bug presente nella versione 1.0 per cui le visualizzazioni con un gestore non principale generavano un'eccezione quando si tentava di aggiornare gli intervalli delle emoji al termine del caricamento del carattere. Non esiste una soluzione alternativa. Se il bug ti riguarda, esegui l'upgrade a questa versione o a una successiva.

Correzioni di bug

  • I callback di inizializzazione di EmojiCompat ora utilizzeranno il gestore di ogni visualizzazione, rispettando le visualizzazioni non presenti nel thread principale. (Iccbcf)

Versione 1.4.0-beta03

10 maggio 2023

androidx.emoji2:emoji2-*:1.4.0-beta03 viene rilasciato. La versione 1.4.0-beta03 contiene questi commit.

Correzioni di bug

  • Correzione dell'arresto anomalo della visualizzazione popup nidificata del selettore di emoji. (0acc8e)
  • Lanciano eccezioni anticipate in EmojiCompat getEmojiStart/getEmojiEnd. (26177f)

Versione 1.4.0-beta02

19 aprile 2023

Viene rilasciato androidx.emoji2:emoji2-*:1.4.0-beta02. La versione 1.4.0-beta02 contiene questi commit.

Correzioni di bug

  • Aggiorna i file di riferimento di lint (Iaa212)

Versione 1.4.0-beta01

5 aprile 2023

androidx.emoji2:emoji2-*:1.4.0-beta01 viene rilasciato. La versione 1.4.0-beta01 contiene questi commit.

Nuove funzionalità

androidx.emoji2:emoji2-emojipicker

Il selettore di emoji è una soluzione UI che offre un aspetto moderno, emoji aggiornate e facilità d'uso. Gli utenti possono sfogliare e selezionare le emoji e le relative varianti o scegliere tra quelle utilizzate di recente. Con questa raccolta, le app di diversi OEM possono fornire agli utenti un'esperienza di emoji inclusiva e unificata senza che gli sviluppatori debbano creare e gestire il proprio selettore di emoji da zero.

Emoji aggiornate

Ogni anno vengono rilasciate nuove emoji e le includeremo selettivamente nel selettore di emoji. Per garantire la compatibilità con le versioni precedenti, eseguiamo internamente un controllo accurato della possibilità di visualizzare le emoji per eliminare il tofu. In questo modo, la raccolta sarà compatibile con più versioni e dispositivi Android.

Varianti fisse

Se premi a lungo un'emoji, viene visualizzato un menu di varianti, ad esempio generi o tonalità della pelle diversi. La variante scelta verrà salvata nel selettore di emoji e l'ultima selezionata verrà utilizzata nel riquadro principale. Con questa funzionalità, gli utenti possono inviare le varianti di emoji preferite con un solo tocco.

Emoji recenti

L'RecentEmojiProvider è tenuta a fornire le emoji nella categoria "Utilizzate di recente". La raccolta dispone di un fornitore recente di emoji predefinito che soddisfa il caso d'uso più comune:

  • Tutte le emoji selezionate vengono salvate per livello di app nelle preferenze condivise.
  • Il selettore mostra al massimo tre righe di emoji selezionate, deduplicati, in ordine cronologico inverso.

Se questo comportamento predefinito è sufficiente, non è necessario impostare il metodo setRecentEmojiProvider().

Lavorare con EmojiCompat

Se l'app ha un'istanza EmojiCompat, verrà utilizzata nel selettore di emoji per visualizzare il maggior numero possibile di emoji. Se EmojiCompat è disattivato, il selettore di emoji continuerà a funzionare correttamente.

Come utilizzare la libreria

Per utilizzare la libreria, uno sviluppatore di app deve

  1. Importa androidx.emoji2:emojipicker:$version in build.gradle. 

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

  2. Aumenta la visualizzazione del selettore di emoji e, facoltativamente, imposta emojiGridRows e emojiGridColumns in base alle dimensioni desiderate di ogni cella dell'emoji

    • Puoi lasciarli non impostati, il valore predefinito è 9 emojiGridColumns, le righe verranno calcolate in base all'altezza della vista principale e a emojiGridColumns
    • Puoi impostare emojiGridRows come valore float per indicare che ci sono altri emoji se scorri verso il basso nel file XML
     <androidx.emoji2.emojipicker.EmojiPickerView
  android:id="@+id/emoji_picker"
  android:layout_width="match_parent"
  android:layout_height="match_parent"
  app:emojiGridColumns="9" />

nel codice

    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. Supponendo che tu voglia accodare le emoji selezionate a un EditText, utilizza setOnEmojiPickedListener()

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

  2. Se vuoi, imposta RecentEmojiProvider. Per un esempio di implementazione, consulta l'app di esempio.

  3. (Facoltativo) Personalizza gli stili. Crea il tuo stile per sostituire gli attributi del tema comuni e applicarlo a EmojiPickerView. Ad esempio, se esegui l'override di colorControlNormal verrà modificato il colore dell'icona della categoria. 

      <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" />

Per un esempio di implementazione, consulta l'app di esempio.

Puoi trovare una versione completa dell'API qui.

App di esempio

Questa app di esempio mostra casi d'uso di base, oltre ai seguenti scenari aggiuntivi:

  • La visualizzazione è stata ridisegnata perché emojiGridRows e emojiGridColumns sono stati reimpostati.
  • Il provider di emoji recente viene ignorato per l'ordinamento in base alla frequenza.
  • Personalizzazione dello stile.

Modifiche all'API

La libreria Emoji Picker è stata aggiornata con le seguenti nuove API:

  • La classe EmojiPickerView, che fornisce emoji aggiornate in una visualizzazione scorrevole verticale con un'intestazione orizzontale cliccabile.
  • La possibilità di impostare il numero di colonne e righe nella griglia del selettore di emoji tramite gli attributi XML emojiGridColumns e emojiGridRows o i metodi setEmojiGridColumns() e setEmojiGridRows().
  • La possibilità di impostare un ascoltatore che ha scelto un'emoji tramite il metodo setOnEmojiPickedListener(). L'ascoltatore riceverà una notifica ogni volta che l'utente fa clic su un'emoji.
  • La possibilità di fornire un fornitore di emoji recente tramite il metodo setRecentEmojiProvider(). Questa è una funzione facoltativa. Se il fornitore di emoji recente non è impostato, nella raccolta verrà utilizzato un fornitore di emoji recente predefinito. Il comportamento predefinito è definito come segue:
    • Tutte le emoji selezionate verranno salvate per livello di app nelle preferenze condivise.
    • Il selettore mostrerà al massimo tre righe di emoji selezionate, deduplicati, in ordine cronologico inverso.
  • La classe EmojiViewItem, che contiene l'emoji visualizzata e le sue varianti.
  • L'interfaccia RecentEmojiProvider, che può essere implementata per fornire un elenco di emoji recenti. recentEmojiProvider è responsabile della fornitura delle emoji nella categoria "Utilizzate di recente".
  • L'interfaccia RecentEmojiAsyncProvider, che può essere implementata per fornire un elenco di emoji recenti. RecentEmojiAsyncProvider è responsabile della fornitura delle emoji nella categoria "Utilizzate di recente". Questa interfaccia è equivalente a RecentEmojiProvider e consente ai client di sostituire il metodo getRecentEmojiListAsync() per fornire emoji recenti.
  • La classe RecentEmojiProviderAdapter, che è un adattatore per RecentEmojiAsyncProvider e implementa RecentEmojiProvider.

Versione 1.4.0-alpha01

22 marzo 2023

androidx.emoji2:emoji2-*:1.4.0-alpha01 viene rilasciato. La versione 1.4.0-alpha01 contiene questi commit.

Correzioni di bug

  • Correggi i test, disattiva i test di instabilità e le operazioni di pulizia.

Versione 1.3

Versione 1.3.0

22 marzo 2023

androidx.emoji2:emoji2-*:1.3.0 viene rilasciato. La versione 1.3.0 contiene questi commit.

Modifiche importanti dalla versione 1.2.0

  • Questa release consente a Compose Foundation 1.4.0 e versioni successive di attivare l'integrazione di emoji2.
  • Consente inoltre funzionalità per la sostituzione di EmojiSpans con codice di disegno personalizzato, nonché il supporto delle esclusioni di emoji definite su Android.

Versione 1.3.0-rc01

8 marzo 2023

androidx.emoji2:emoji2-*:1.3.0-rc01 viene rilasciato. La versione 1.3.0-rc01 contiene questi commit.

Nuove funzionalità

  • Questa versione supporta l'integrazione di emoji2 nella composizione.

Modifiche all'API

  • Sostituisci gli intervalli per un codice di disegno personalizzato.
  • Eseguire query sulle esclusioni di sistema.

Correzioni di bug

  • Inoltre, è stato corretto un bug per cui gli spazi di sfondo non venivano applicati correttamente dietro EmojiSopans.

Versione 1.3.0-beta03

23 febbraio 2023

androidx.emoji2:emoji2-bundled:1.3.0-beta03, androidx.emoji2:emoji2-views:1.3.0-beta03 e androidx.emoji2:emoji2-views-helper:1.3.0-beta03 vengono rilasciati.

22 febbraio 2023

androidx.emoji2:emoji2:1.3.0-beta03 viene rilasciato. La versione 1.3.0-beta03 contiene questi commit.

Nuove funzionalità

  • Nessuna modifica. Questa release è finalizzata alla preparazione dell'integrazione di Componi.

Versione 1.3.0-beta02

8 febbraio 2023

androidx.emoji2:emoji2-*:1.3.0-beta02 viene rilasciato. La versione 1.3.0-beta02 contiene questi commit.

Nuove funzionalità

  • Questa release è una versione stabile che supporta l'integrazione di Componi.

Versione 1.3.0-beta01

25 gennaio 2023

androidx.emoji2:emoji2-*:1.3.0-beta01 viene rilasciato. La versione 1.3.0-beta01 contiene questi commit.

Nuove funzionalità

  • Esecuzione di query sulle esclusioni di sistema.
  • Sostituzione degli intervalli per il codice del disegno personalizzato.
  • Inoltre, è stato corretto un bug per cui gli spazi di sfondo non venivano applicati correttamente dietro EmojiSopans.
  • Questa release aggiunge le API necessarie per supportare EmojiCompat in Compose. Prevediamo di supportare la compatibilità con le emoji nella composizione in una release futura.

Versione 1.3.0-alpha01

11 gennaio 2023

Viene rilasciato androidx.emoji2:emoji2-*:1.3.0-alpha01. La versione 1.3.0-alpha01 contiene questi commit.

Nuove API per interazioni a basso livello

  • Eseguire query sulle esclusioni di sistema
  • Sostituzione degli intervalli per il codice di disegno personalizzato
  • Inoltre, è stato corretto un bug per cui gli spazi di sfondo non venivano applicati correttamente dietro EmojiSopans.
  • Questa release aggiunge le API necessarie per supportare EmojiCompat in Compose. Il supporto della scrittura per le emoji sarà supportato a breve.

Modifiche all'API

  • Aggiunta la possibilità di eseguire query sulle esclusioni di sistema per TypefaceEmojiRasterizer. (I5653e)
  • È stata aggiunta la nuova API EmojiCompat.SpanFactory per sostituire il comportamento predefinito di EmojiSpan con un codice di disegno e dimensionamento personalizzato. (Ib69d9)
  • È stato aggiunto EmojiCompat a Scrivi (I96f37, b/139326806)

Correzioni di bug

Versione 1.2

Versione 1.2.0

10 agosto 2022

androidx.emoji2:emoji2-*:1.2.0 viene rilasciato. La versione 1.2.0 contiene questi commit.

Modifiche importanti dalla versione 1.1.0

Questa è una release di correzione di bug. Nessuna nuova funzionalità o API è stata aggiunta dalla versione 1.1.0.

Tuttavia, le app che utilizzano PrecomputedText o TextView.setText(char[]) dovrebbero dare la priorità all'upgrade a questa versione.

Sono stati risolti i bug riportati di seguito:

  • Emoji2 aggiungerà emoji a PrecomputedText ignorando il layout di testo precalcolato precedente. (I47d06, b/211231958)
  • Correzione del bug dell'editor di backport da Android P a EditText configurato per l'utilizzo di emoji2. (Ifd709, b/216891011)
  • È stato corretto un arresto anomalo quando emoji2 carica il carattere e viene utilizzato TextView.setText(char[]). (Id511e, b/206859724)

Versione 1.2.0-rc01

27 luglio 2022

androidx.emoji2:emoji2-*:1.2.0-rc01 viene rilasciato. La versione 1.2.0-rc01 contiene questi commit.

  • Nessuna modifica dall'ultima versione beta.

Versione 1.2.0-beta01

13 luglio 2022

androidx.emoji2:emoji2-*:1.2.0-beta01 viene rilasciato. La versione 1.2.0-beta01 contiene questi commit.

Nuove funzionalità

  • Nessuna modifica rispetto all'ultima versione (questa release è destinata a supportare la release AppCompat).

Versione 1.2.0-alpha04

20 aprile 2022

androidx.emoji2:emoji2-*:1.2.0-alpha04 viene rilasciato. La versione 1.2.0-alpha04 contiene questi commit.

Nuove funzionalità

  • Nessuna modifica in questa release.

Versione 1.2.0-alpha03

6 aprile 2022

androidx.emoji2:emoji2-*:1.2.0-alpha03 viene rilasciato. La versione 1.2.0-alpha03 contiene questi commit.

Nuove funzionalità

  • Nessuna modifica rispetto all'ultima versione (questa release è destinata a supportare la release appcompat).

Versione 1.2.0-alpha02

23 marzo 2022

androidx.emoji2:emoji2-*:1.2.0-alpha02 viene rilasciato. La versione 1.2.0-alpha02 contiene questi commit.

Correzioni di bug

  • Emoji2 aggiungerà le emoji a PrecomputedText ignorando il layout di testo precalcolato precedente. (I47d06, b/211231958)
  • Correzione del crash dell'editor di backport da Android P a EditText configurato per l'utilizzo di emoji2. (Ifd709, b/216891011)
  • È stato risolto un arresto anomalo quando emoji2 carica il carattere e viene utilizzato TextView.setText(char[]). (Id511e, b/206859724)

Versione 1.2.0-alpha01

23 febbraio 2022

Viene rilasciato androidx.emoji2:emoji2-*:1.2.0-alpha01. La versione 1.2.0-alpha01 contiene questi commit.

Nessuna modifica dalla versione 1.1.0.

1,1

Versione 1.1.0

23 febbraio 2022

androidx.emoji2:emoji2-*:1.1.0 viene rilasciato. La versione 1.1.0 contiene questi commit.

Modifiche importanti dalla versione 1.0.0

  • emoji2-bundled contiene il carattere emoji 14
  • La nuova API getEmojiMatch restituisce informazioni accurate per consentire alle tastiere di decidere come verrà visualizzata un'emoji in presenza di un carattere emojicompat che si trova dietro il carattere di sistema
  • Correzione di bug per NumberKeyListener che consente di filtrare correttamente i caratteri inseriti con le cifre.

Versione 1.1.0-rc01

9 febbraio 2022

androidx.emoji2:emoji2-*:1.1.0-rc01 viene rilasciato. La versione 1.1.0-rc01 contiene questi commit.

Nuove funzionalità

Nessuna modifica rispetto alla versione beta.

Nuove funzionalità rispetto a emoji2 1.0.0:

  • emoji2-bundled contiene il carattere emoji 14
  • La nuova API getEmojiMatch restituisce informazioni accurate per consentire alle tastiere di decidere come verrà visualizzata un'emoji in presenza di un carattere emojicompat che si trova dietro il carattere di sistema
  • Correzione di bug per NumberKeyListener che consente di filtrare correttamente i caratteri inseriti

Versione 1.1.0-beta01

26 gennaio 2022

androidx.emoji2:emoji2-*:1.1.0-beta01 viene rilasciato. La versione 1.1.0-beta01 contiene questi commit.

Correzioni di bug

  • Release androidx-emoji2 beta01. Nessuna modifica rispetto ad alpha01 (Ic61d9)

Versione 1.1.0-alpha01

15 dicembre 2021

Viene rilasciato androidx.emoji2:emoji2-*:1.1.0-alpha01. La versione 1.1.0-alpha01 contiene questi commit.

Nuove funzionalità

  • emoji2-bundled contiene il carattere emoji 14
  • La nuova API getEmojiMatch restituisce informazioni accurate per consentire alle tastiere di decidere come verrà visualizzata un'emoji in presenza di un carattere emojicompat che si trova dietro il carattere di sistema
  • Correzione di bug per NumberKeyListener che consente di filtrare correttamente i caratteri inseriti

Modifiche all'API

  • Aggiungere una nuova API getEmojiMatch per consentire alle tastiere di cercare con maggiore precisione il comportamento di corrispondenza delle emoji in emojicompat.
  • È stata ritirata la funzionalità hasEmojiGlyph, in quanto il relativo valore restituito booleano non è preciso quando viene eseguito il test su un carattere precedente a quello della piattaforma emoji. Sostituisci con getEmojiMatch. (Ie693d)

Correzioni di bug

  • Emoji2 non eseguirà il wrapping delle istanze di NumberKeyListener, consentendo la configurazione della lingua tramite TextView.
  • Appcompat non eseguirà il wrapping delle istanze di NumberKeyListener passate a setKeyListener, consentendo a TextView di configurare correttamente le impostazioni internazionali su NumberKeyListeners. (Ibf113, b/207119921)

1.0

Versione 1.0.1

15 dicembre 2021

androidx.emoji2:emoji2-*:1.0.1 viene rilasciato. La versione 1.0.1 contiene questi commit.

Correzioni di bug

  • Emoji2 non eseguirà il wrapping delle istanze di NumberKeyListener, consentendo la configurazione delle impostazioni internazionali da parte di TextView.
  • AppCompat non eseguirà il wrapping delle istanze di NumberKeyListener passate a setKeyListener, consentendo a TextView di configurare correttamente le impostazioni internazionali su NumberKeyListeners. (Ibf113, b/207119921)

Versione 1.0.0

17 novembre 2021

Viene rilasciato androidx.emoji2:emoji2-*:1.0.0. La versione 1.0.0 contiene questi commit.

Funzionalità principali di 1.0.0

androidx.emoji2 sostituisce androidx.emoji con funzionalità aggiuntive:

  • Riduzione delle dimensioni dell'APK rispetto ad androidx.emoji
  • Configurazione automatica
  • Aggiunta come dipendenza ad appcompat 1.4

Per ulteriori informazioni su androidx.emoji2, consulta Supporto di emoji moderne e la nostra conferenza Android Dev Summit Visualizzazione di TUTTE le emoji nell'app Android Dev.

Versione 1.0.0-rc01

27 ottobre 2021

androidx.emoji2:emoji2-*:1.0.0-rc01 viene rilasciato. La versione 1.0.0-rc01 contiene questi commit.

  • Nessuna modifica dalla versione beta02.

Emoji2 versione 1.0.0-beta01

15 settembre 2021

androidx.emoji2:emoji2-*:1.0.0-beta01 viene rilasciato. La versione 1.0.0-beta01 contiene questi commit.

Modifiche alle API

  • È stato aggiunto setLoadingExecutor a FontRequestEmojiCompatConfig, che sostituisce l'API precedente di setHandler. Questa API consente alle app di configurare FontRequestEmojiCompatConfig in modo che utilizzi qualsiasi esecutore in background.

    Questa modifica comporta una rottura rispetto a androidx.emoji:emoji, pertanto setHandler viene mantenuto come API deprecata senza operazioni per facilitare la migrazione. (I6cd48)

  • EmojiCompat imposta correttamente EditorInfo.extras su Android 11

    • I widget personalizzati che utilizzano IME che non eseguono sottoclassi di EditText possono chiamare EmojiCompat.updateEditorInfo per comunicare all'IME che supporta l'elaborazione di EmojiCompat. (I1ea9b).

Correzioni di bug

  • Correggi DefaultEmojiCompatConfig per cercare correttamente il provider di caratteri emoji sull'API 19 e 28. Questo corregge un bug introdotto in emoji2 1.0.0-alpha01. (Ib33d8, b/197906329)

Versione 1.0.0-alpha03

30 giugno 2021

androidx.emoji2:emoji2-*:1.0.0-alpha03 viene rilasciato. La versione 1.0.0-alpha03 contiene questi commit.

Nuove funzionalità

Questa release è una release di correzione di bug e stabilizzazione.

  1. EmojiEditTextHelper ora consente di passare null come KeyListener. In questo modo, la piattaforma consente di applicare valori null alle emoji che supportano le implementazioni di EditText.
  2. Quando si utilizza EmojiCompatInitializer, il ritardo all'avvio iniziale è migliorato in modo che si attivi dopo la ripresa della prima attività. In questo modo, l'avvio dell'app avviene senza concorrenza ed evita di caricare il carattere per gli avvii dell'app che non mostrano mai un'interfaccia utente. Dopo un breve ritardo, EmojiCompat creerà un thread per caricare il carattere dell'emoji.
  • Per implementare il ritardo, viene aggiunta una nuova dipendenza da androidx.lifecycle:lifecycle-process da androidx.emoji2:emoji2. Ciò avrà un impatto trascurabile sulle dimensioni dell'APK per le app che includono già il ciclo di vita (ad esempio le app con appcompat).

Modifiche all'API

  • Consenti KeyListener null in AppCompatEditText. Questa operazione inverte l'annotazione non nullo aggiunta ad AppCompatEditText nella versione 1.4.0-alpha01 e ripristina il comportamento precedente quando viene passato un valore nullo. (I21482, b/189559345)

Correzioni di bug

  • Modifica EmojiCompatInitializer in modo da ritardare il caricamento dei caratteri fino a 500 ms dopo la prima Activity.onResume. In questo modo, un'attività può eseguire Application.onCreate e Activity.onCreate senza concorrenza, garantendo al contempo che il carattere emoji venga caricato poco dopo l'avvio dell'app. (I4bff7)

Versione 1.0.0-alpha02

2 giugno 2021

androidx.emoji2:emoji2:1.0.0-alpha02, androidx.emoji2:emoji2-views:1.0.0-alpha02 e androidx.emoji2:emoji2-views-helper:1.0.0-alpha02 vengono rilasciati. La versione 1.0.0-alpha02 contiene questi commit.

Modifiche all'API

  • Il pacchetto in emoji2-views-helper è stato rinominato in androidx.emoji2.viewsintegration. Si tratta di una modifica che comporta una interruzione del servizio per AppCompat 1.4.0-alpha01 e le app devono assicurarsi che la dipendenza da AppCompat sia aggiornata per poter utilizzare la nuova versione di emoji2. (Ie8397)

Versione 1.0.0-alpha01

18 maggio 2021

Vengono rilasciate le funzionalità androidx.emoji2:emoji2:1.0.0-alpha01, androidx.emoji2:emoji2-views:1.0.0-alpha01 e androidx.emoji2:emoji2-views-helper:1.0.0-alpha01. La versione 1.0.0-alpha01 contiene questi commit.

Funzionalità di questa release iniziale

L'integrazione di emojicompat è consigliata per tutte le app per supportare le emoji moderne dall'API 19. Tutti i contenuti generati dagli utenti nella tua app contengono 🎉.

EmojiCompat è passato dagli elementi androidx.emoji al nuovo androidx.emoji2, ora in alpha01. I nuovi elementi sostituiscono la versione precedente.

emoji2 viene aggiunta come dipendenza ad AppCompat a partire da AppCompat 1.4.0-alpha01 ed è abilitata per impostazione predefinita per le viste AppCompat.

L'elemento emoji2 introduce una nuova configurazione automatica che utilizza la libreria androidx.startup. Non è più necessario scrivere codice 👨🏽‍💻 per visualizzare 🐻‍❄️.

Modifiche in emoji2 rispetto a emoji

  • È stata aggiunta una nuova configurazione automatica EmojiCompatInitializer utilizzando androidx.startup.
  • È stata aggiunta una nuova configurazione predefinita che utilizza la posizione del servizio per trovare un provider di caratteri scaricabili in DefaultEmojiCompatConfiguration.
  • I corsi sono stati spostati dal pacchetto androidx.emoji a androidx.emoji2.
  • Dividi EmojiTextView e le visualizzazioni correlate in un elemento emoji2-views separato. Questo valore deve essere utilizzato solo se la tua app non utilizza appcompat.
  • Sono stati estratti gli aiuti per l'integrazione di emojicompat nelle visualizzazioni personalizzate in un artefatto separato emoji2-views-helper.
  • Sono state aggiunte annotazioni sulla nullabilità.
  • Ora è possibile utilizzare gli aiutanti in emoji2-views-helper anche se EmojiCompat non viene inizializzato (in precedenza veniva generata un'eccezione).

Quale dipendenza devi aggiungere?

  • Le app con AppCompat devono eseguire l'upgrade alla versione AppCompat 1.4.0-alpha01 o successiva.
  • Le app senza AppCompat che utilizzano TextView/EditText della piattaforma devono utilizzare EmojiTextView e le classi correlate di emoji2-views.

Come fornire assistenza nelle visualizzazioni personalizzate

  • Le app con AppCompat devono estendere AppCompatTextView, AppCompatButton e così via anziché la piattaforma TextView e così via.
  • Le app senza AppCompat devono aggiungere la dipendenza androidx.emoji2:emoji2-views-helper e utilizzare gli aiuti per l'integrazione con sottoclassi TextView o EditText personalizzate.

Configurazione dell'inizializzazione automatica

  • Le app possono disattivare l'inizializzazione automatica aggiungendo quanto segue al file manifest:

     <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 configurazione automatica viene disattivata e puoi passare una configurazione personalizzata a EmojiCompat.init. La configurazione predefinita per il sistema può essere recuperata DefaultEmojiCompatConfig.create(context) per ulteriori configurazioni prima di passare a EmojiCompat.init.