Emoji-Kompatibilität

Achtung:Seit Ende 2021 wird die androidx.emoji:emoji-Bibliothek zugunsten von androidx.emoji2:emoji2 eingestellt, die eine Einbindung in androidx.appcompat ermöglicht.

Um moderne Emojis zu unterstützen und die Abwärtskompatibilität mit niedrigeren Android-Versionen zu vereinfachen, empfehlen wir Ihnen, zur androidx.emoji2:emoji2-Bibliothek zu migrieren. Weitere Informationen zur Implementierung finden Sie unter Moderne Emojis unterstützen.

Mit der EmojiCompat-Supportbibliothek sollen Android-Geräte immer mit den neuesten Emojis auf dem neuesten Stand gehalten werden. So wird verhindert, dass in Ihrer App fehlende Emoji-Zeichen in Form von ☐ angezeigt werden, was darauf hinweist, dass auf Ihrem Gerät keine Schriftart für die Anzeige des Texts vorhanden ist. Wenn Sie die EmojiCompat-Supportbibliothek verwenden, müssen Ihre App-Nutzer nicht auf Android-Betriebssystemupdates warten, um die neuesten Emojis zu erhalten.

Abbildung 1: Emoji-Vergleich

Weitere Informationen finden Sie unter den folgenden Links:

• Beispiel-App für die Emoji-Kompatibilität Java | Kotlin

Wie funktioniert EmojiCompat?

Die EmojiCompat-Supportbibliothek bietet Klassen zur Implementierung einer abwärtskompatiblen Emoji-Unterstützung auf Geräten mit Android 4.4 (API-Level 19) und höher. Sie können EmojiCompat entweder mit im Lieferumfang enthaltenen oder herunterladbaren Schriftarten konfigurieren. Weitere Informationen zur Konfiguration finden Sie in den folgenden Abschnitten:

• Konfiguration für herunterladbare Schriftarten
• Konfiguration der bereitgestellten Schriftarten

EmojiCompat identifiziert ein Emoji für eine bestimmte CharSequence, ersetzt sie gegebenenfalls durch EmojiSpans und rendert schließlich die Emoji-Glyphen. Abbildung 2 veranschaulicht den Vorgang.

Abbildung 2: EmojiCompat-Prozess

Konfiguration der herunterladbaren Schriftarten

Bei der Konfiguration der herunterladbaren Schriftarten wird die Bibliotheksfunktion „Herunterladbare Schriftarten“ verwendet, um eine Emoji-Schriftart herunterzuladen. Außerdem werden die erforderlichen Emoji-Metadaten aktualisiert, die die EmojiCompat-Unterstützungsbibliothek benötigt, um mit den neuesten Versionen der Unicode-Spezifikation Schritt zu halten.

Abhängigkeit von Supportbibliothek hinzufügen

Wenn Sie die EmojiCompat-Unterstützungsbibliothek verwenden möchten, müssen Sie die ClassPath-Abhängigkeiten Ihres App-Projekts in Ihrer Entwicklungsumgebung ändern.

So fügen Sie Ihrem Anwendungsprojekt eine Supportbibliothek hinzu:

1. Öffnen Sie die Datei build.gradle Ihrer Anwendung.
2. Fügen Sie die Supportbibliothek dem Abschnitt dependencies hinzu.

Groovy

dependencies {
    ...
    implementation "androidx.emoji:emoji:28.0.0"
}

Kotlin

dependencies {
    ...
    implementation("androidx.emoji:emoji:28.0.0")
}

Konfiguration der herunterladbaren Schriftart initialisieren

Sie müssen EmojiCompat initialisieren, um die Metadaten und das Schriftbild zu laden. Da die Initialisierung einige Zeit dauern kann, wird sie in einem Hintergrund-Thread ausgeführt.

Führe die folgenden Schritte aus, um EmojiCompat mit der herunterladbaren Schriftartkonfiguration zu initialisieren:

1. Erstellen Sie eine Instanz der Klasse FontRequest und geben Sie die Autorität des Schriftanbieters, das Paket des Schriftanbieters, die Schriftabfrage und eine Liste von Hash-Sätzen für das Zertifikat an. Weitere Informationen zu FontRequest finden Sie im Abschnitt Herunterladbare Schriftarten programmatisch verwenden der Dokumentation zu Herunterladbare Schriftarten.
2. Erstellen Sie eine Instanz von FontRequestEmojiCompatConfig und geben Sie Instanzen von Context und FontRequest an.
3. Initialisieren Sie EmojiCompat, indem Sie die Methode init() aufrufen und die Instanz von FontRequestEmojiCompatConfig übergeben.

Kotlin

class MyApplication : Application() {

    override fun onCreate() {
        super.onCreate()
        val fontRequest = FontRequest(
                "com.example.fontprovider",
                "com.example",
                "emoji compat Font Query",
                CERTIFICATES
        )
        val config = FontRequestEmojiCompatConfig(this, fontRequest)
        EmojiCompat.init(config)
    }
}

Java

public class MyApplication extends Application {
  @Override
   public void onCreate() {
     super.onCreate();
     FontRequest fontRequest = new FontRequest(
       "com.example.fontprovider",
       "com.example",
       "emoji compat Font Query",
       CERTIFICATES);
     EmojiCompat.Config config = new FontRequestEmojiCompatConfig(this, fontRequest);
     EmojiCompat.init(config);
   }
}

4. Verwenden Sie EmojiCompat-Widgets in Layout-XMLs. Wenn Sie AppCompat verwenden, lesen Sie den Abschnitt EmojiCompat-Widgets mit AppCompat verwenden.

<android.support.text.emoji.widget.EmojiTextView
   android:layout_width="wrap_content"
   android:layout_height="wrap_content"/>

<android.support.text.emoji.widget.EmojiEditText
   android:layout_width="wrap_content"
   android:layout_height="wrap_content"/>

<android.support.text.emoji.widget.EmojiButton
   android:layout_width="wrap_content"
   android:layout_height="wrap_content"/>

Weitere Informationen zum Konfigurieren von EmojiCompat mit der herunterladbaren Schriftkonfiguration finden Sie in der Beispiel-App zur Emoji-Kompatibilität Java | Kotlin.

Bibliothekskomponenten

Abbildung 3 Bibliothekskomponenten im EmojiCompat-Prozess

Widgets: EmojiEditText, EmojiTextView, EmojiButton

Standard-Widget-Implementierungen, um EmojiCompat mit TextView, EditText und Button zu verwenden.

EmojiCompat

Öffentliche Hauptoberfläche der Supportbibliothek. Er führt alle externen Aufrufe aus und koordiniert sich mit den anderen Teilen des Systems.

EmojiCompat.Config

Konfiguriert die zu erstellende Singleton-Instanz.

EmojiSpan

 Eine ReplacementSpan-Unterklasse, die das Zeichen (die Zeichensequenz) ersetzt und das Schriftzeichen rendert.

EmojiCompat Schriftart

EmojiCompat verwendet eine Schriftart, um Emojis anzuzeigen. Diese Schriftart ist eine modifizierte Version der Android-Schriftart für Emojis. Die Schriftart wird so geändert:

• Um die Abwärtskompatibilität für das Rendern von Emojis sicherzustellen, werden alle Emoji-Zeichen mit einem einzigen Unicode-Codepunkt in der ergänzenden privaten Nutzungsbereich-A von Unicode dargestellt, die mit U+F0001 beginnt.
• Zusätzliche Emoji-Metadaten werden in Binärformat in die Schriftart eingefügt und bei der Laufzeit von EmojiCompat geparst. Die Daten sind in der meta-Tabelle der Schriftart mit dem privaten Tag Emji eingebettet.

Konfigurationsoptionen

Mit der EmojiCompat-Instanz können Sie das Verhalten von EmojiCompat ändern. Sie können die folgenden Methoden aus der Basisklasse verwenden, um die Konfiguration festzulegen:

• setReplaceAll(): Bestimmt, ob EmojiCompat alle gefundenen Emojis durch EmojiSpans ersetzen soll. Standardmäßig versucht EmojiCompat, herauszufinden, ob das System ein Emoji darstellen kann, und ersetzt diese Emojis nicht. Wenn true festgelegt ist, ersetzt EmojiCompat alle gefundenen Emojis durch EmojiSpans.
• setEmojiSpanIndicatorEnabled(): Gibt an, ob EmojiCompat ein Emoji durch ein EmojiSpan ersetzt hat. Wenn dieser Parameter auf true gesetzt ist, zeichnet EmojiCompat einen Hintergrund für die EmojiSpan. Diese Methode wird hauptsächlich zum Debugging verwendet.
• setEmojiSpanIndicatorColor(): Legt die Farbe für EmojiSpan fest. Der Standardwert ist GREEN.
• registerInitCallback: Informiert die App über den Status der EmojiCompat-Initialisierung.

Kotlin

val config = FontRequestEmojiCompatConfig(...)
        .setReplaceAll(true)
        .setEmojiSpanIndicatorEnabled(true)
        .setEmojiSpanIndicatorColor(Color.GREEN)
        .registerInitCallback(object: EmojiCompat.InitCallback() {
            ...
        })

Java

EmojiCompat.Config config = new FontRequestEmojiCompatConfig(...)
       .setReplaceAll(true)
       .setEmojiSpanIndicatorEnabled(true)
       .setEmojiSpanIndicatorColor(Color.GREEN)
       .registerInitCallback(new InitCallback() {...})

Initialisierungs-Listener hinzufügen

Die Klassen EmojiCompat und EmojiCompat bieten die Methoden registerInitCallback() und unregisterInitCallback(), um einen Initialisierungs-Callback zu registrieren. Wenn Sie diese Methoden verwenden möchten, erstellen Sie eine Instanz der Klasse EmojiCompat.InitCallback. Rufen Sie diese Methoden auf und übergeben Sie die Instanz der EmojiCompat.InitCallback-Klasse. Wenn die Initialisierung der EmojiCompat-Unterstützungsbibliothek erfolgreich war, ruft die EmojiCompat-Klasse die Methode onInitialized() auf. Wenn die Bibliothek nicht initialisiert werden kann, ruft die EmojiCompat-Klasse die Methode onFailed() auf.

Wenn Sie den Initialisierungsstatus jederzeit prüfen möchten, rufen Sie die Methode getLoadState() auf. Es wird einer der folgenden Werte zurückgegeben: LOAD_STATE_LOADING, LOAD_STATE_SUCCEEDED oder LOAD_STATE_FAILED.

EmojiCompat mit AppCompat-Widgets verwenden

Wenn du AppCompat widgets verwendest, kannst du EmojiCompat-Widgets verwenden, die von AppCompat widgets reichen.

1. Fügen Sie die Supportbibliothek dem Abschnitt „Abhängigkeiten“ hinzu.

   Groovy

   dependencies {
       ...
       implementation "androidx.emoji:emoji-bundled:$version"
   }

   Kotlin

         dependencies {
             implementation("androidx.emoji:emoji-appcompat:$version")
         }
         

   Groovy

         dependencies {
             implementation "androidx.emoji:emoji-appcompat:$version"
         }
         

2. Verwende EmojiCompat AppCompat Widget-Widgets in Layout-XMLs.

<android.support.text.emoji.widget.EmojiAppCompatTextView
   android:layout_width="wrap_content"
   android:layout_height="wrap_content"/>

<android.support.text.emoji.widget.EmojiAppCompatEditText
   android:layout_width="wrap_content"
   android:layout_height="wrap_content"/>

<android.support.text.emoji.widget.EmojiAppCompatButton
   android:layout_width="wrap_content"
   android:layout_height="wrap_content"/>

Gebündelte Schriftarten konfigurieren

Die EmojiCompat-Unterstützungsbibliothek ist auch als Paket mit Fonts verfügbar. Dieses Paket enthält die Schriftart mit den eingebetteten Metadaten. Das Paket enthält außerdem eine BundledEmojiCompatConfig, mit der die Metadaten und Schriftarten über die AssetManager geladen werden.

Hinweis:Die Größe der Schrift wird in mehreren Megabyte angegeben.

Abhängigkeit von Supportbibliothek hinzufügen

Wenn Sie die EmojiCompat-Supportbibliothek mit gebündelter Schriftartkonfiguration verwenden möchten, müssen Sie die Klassenpfadabhängigkeiten Ihres Anwendungsprojekts innerhalb Ihrer Entwicklungsumgebung ändern.

So fügen Sie Ihrem Anwendungsprojekt eine Supportbibliothek hinzu:

1. Öffnen Sie die Datei build.gradle Ihrer Anwendung.
2. Fügen Sie die Supportbibliothek dem Abschnitt dependencies hinzu.

Groovy

dependencies {
    ...
    implementation "androidx.emoji:emoji:28.0.0"
}

Kotlin

dependencies {
    ...
    implementation("androidx.emoji:emoji:28.0.0")
}

Mithilfe von bereitgestellten Schriftarten EmojiCompat konfigurieren

So konfigurierst du EmojiCompat mithilfe von bereitgestellten Schriftarten:

1. Verwenden Sie BundledEmojiCompatConfig, um eine Instanz von EmojiCompat zu erstellen, und geben Sie eine Instanz von Context an.
2. Rufen Sie die Methode init() auf, um EmojiCompat zu initialisieren und die Instanz von BundledEmojiCompatConfig zu übergeben.

Kotlin

class MyApplication : Application() {

    override fun onCreate() {
        super.onCreate()
        val config = BundledEmojiCompatConfig(this)
        EmojiCompat.init(config)
    }
}

Java

public class MyApplication extends Application {
    @Override
    public void onCreate() {
        super.onCreate();
        EmojiCompat.Config config = new BundledEmojiCompatConfig(this);
        EmojiCompat.init(config);
        ...
    }
}

EmojiCompat ohne Widgets verwenden

EmojiCompat verwendet EmojiSpan, um korrekte Bilder zu rendern. Daher muss er eine gegebene CharSequence-Instanz mit EmojiSpans in Spanned-Instanzen konvertieren. Die Klasse EmojiCompat bietet eine Methode, mit der CharSequences-Objekte mit EmojiSpans in Spanned-Instanzen umgewandelt werden können. Mit dieser Methode können Sie die verarbeiteten Instanzen anstelle des Rohstrings verarbeiten und im Cache speichern, was die Leistung Ihrer Anwendung verbessert.

Kotlin

val processed = EmojiCompat.get().process("neutral face \uD83D\uDE10")

Java

CharSequence processed = EmojiCompat.get().process("neutral face \uD83D\uDE10");

EmojiCompat für Eingabemethoden verwenden

Mithilfe der EmojiCompat-Unterstützungsbibliothek können Tastaturen die Emojis rendern, die von der Anwendung unterstützt werden, mit der sie interagieren. Mit der Methode hasEmojiGlyph() können IMEs prüfen, ob EmojiCompat ein Emoji rendern kann. Diese Methode nimmt eine CharSequence eines Emojis an und gibt true zurück, wenn EmojiCompat das Emoji erkennen und rendern kann.

Die Tastatur kann auch die Version der EmojiCompat-Unterstützungsbibliothek prüfen, die von der App unterstützt wird, um zu bestimmen, welche Emojis in der Palette gerendert werden sollen. Um die Version zu prüfen, muss die Tastatur prüfen, ob die folgenden Tasten im EditorInfo.extras-Bundle vorhanden sind:

• EDITOR_INFO_METAVERSION_KEY

Wenn der Schlüssel im Bundle vorhanden ist, entspricht der Wert der Version der Emoji-Metadaten, die von der App verwendet wird. Wenn dieser Schlüssel nicht vorhanden ist, verwendet die App EmojiCompat nicht.

• EDITOR_INFO_REPLACE_ALL_KEY

Wenn der Schlüssel vorhanden ist und auf true gesetzt ist, hat die App die Methode SetReplaceAll() aufgerufen. Weitere Informationen zur EmojiCompat-Konfiguration finden Sie im Abschnitt Konfigurationsoptionen.

Nachdem die Tastatur die Schlüssel im EditorInfo.extras-Bundle erhalten hat, kann sie die Methode hasEmojiGlyph() verwenden, wobei metadataVersion der Wert für EDITOR_INFO_METAVERSION_KEY ist, um zu prüfen, ob die App ein bestimmtes Emoji rendern kann.

EmojiCompat mit benutzerdefinierten Widgets verwenden

Sie können die process()-Methode verwenden, um die CharSequence in Ihrer App vorzuverarbeiten und sie jedem Widget hinzuzufügen, das Spanned-Instanzen rendern kann, z. B. TextView. Außerdem bietet EmojiCompat die folgenden Widget-Hilfsklassen, mit denen Sie Ihre benutzerdefinierten Widgets mit minimalem Aufwand um Emoji-Unterstützung ergänzen können.

• EmojiTextViewHelper
• EmojiEditTextHelper

Beispiel für TextView

Kotlin

class MyTextView(context: Context) : AppCompatTextView(context) {

    private val emojiTextViewHelper: EmojiTextViewHelper by lazy(LazyThreadSafetyMode.NONE) {
        EmojiTextViewHelper(this).apply {
            updateTransformationMethod()
        }
    }

    override fun setFilters(filters: Array<InputFilter>) {
        super.setFilters(emojiTextViewHelper.getFilters(filters))
    }

    override fun setAllCaps(allCaps: Boolean) {
        super.setAllCaps(allCaps)
        emojiTextViewHelper.setAllCaps(allCaps)
    }
}

Java

public class MyTextView extends AppCompatTextView {
   ...
   public MyTextView(Context context) {
       super(context);
       init();
   }
   ...
   private void init() {
       getEmojiTextViewHelper().updateTransformationMethod();
   }

   @Override
   public void setFilters(InputFilter[] filters) {
       super.setFilters(getEmojiTextViewHelper().getFilters(filters));
   }

   @Override
   public void setAllCaps(boolean allCaps) {
       super.setAllCaps(allCaps);
       getEmojiTextViewHelper().setAllCaps(allCaps);
   }

   private EmojiTextViewHelper getEmojiTextViewHelper() {
       ...
   }
}

Beispiel für EditText

Kotlin

class MyEditText(context: Context) : AppCompatEditText(context) {

    private val emojiEditTextHelper: EmojiEditTextHelper by lazy(LazyThreadSafetyMode.NONE) {
        EmojiEditTextHelper(this).also {
            super.setKeyListener(it.getKeyListener(keyListener))
        }
    }

    override fun setKeyListener(input: KeyListener?) {
        input?.also {
            super.setKeyListener(emojiEditTextHelper.getKeyListener(it))
        }
    }

    override fun onCreateInputConnection(outAttrs: EditorInfo): InputConnection {
        val inputConnection: InputConnection = super.onCreateInputConnection(outAttrs)
        return emojiEditTextHelper.onCreateInputConnection(
                inputConnection,
                outAttrs
        ) as InputConnection
    }
}

Java

public class MyEditText extends AppCompatEditText {
   ...
   public MyEditText(Context context) {
       super(context);
       init();
   }
   ...
   private void init() {
       super.setKeyListener(getEmojiEditTextHelper().getKeyListener(getKeyListener()));
   }

   @Override
   public void setKeyListener(android.text.method.KeyListener keyListener) {
       super.setKeyListener(getEmojiEditTextHelper().getKeyListener(keyListener));
   }

   @Override
   public InputConnection onCreateInputConnection(EditorInfo outAttrs) {
       InputConnection inputConnection = super.onCreateInputConnection(outAttrs);
       return getEmojiEditTextHelper().onCreateInputConnection(inputConnection, outAttrs);
   }

   private EmojiEditTextHelper getEmojiEditTextHelper() {
       ...
   }
}

Häufig gestellte Fragen

• Wie starte ich den Schriftartendownload?

Die Emoji-Schriftarten werden bei der ersten Anfrage heruntergeladen, wenn sie nicht auf dem Gerät vorhanden sind. Die Planung des Downloads ist für die App transparent.

• Wie lange dauert die Initialisierung?

Nach dem Herunterladen der Schriftart dauert es etwa 150 Millisekunden, bis EmojiCompat initialisiert wird.

• Wie viel Arbeitsspeicher belegt die EmojiCompat-Unterstützungsbibliothek?

Derzeit wird die Datenstruktur zum Finden des Emojis in den Arbeitsspeicher der App geladen und belegt etwa 200 KB.

• Kann ich EmojiCompat für eine benutzerdefinierte TextView verwenden?

Ja. EmojiCompat bietet Hilfsklassen für benutzerdefinierte Widgets. Es ist auch möglich, einen bestimmten String vorzuverarbeiten und in Spanned umzuwandeln. Weitere Informationen zu Widget-Hilfsklassen finden Sie im Abschnitt EmojiCompat mit benutzerdefinierten Widgets verwenden.

• Was passiert, wenn ich Widgets in Layout-XML-Dateien auf Geräten hinzufüge, auf denen Android 4.4 (API-Level 19) oder niedriger ausgeführt wird?

Sie können die EmojiCompat Supportbibliothek oder ihre Widgets in Ihre Anwendungen einbinden, die Geräte mit Android 4.4 (API-Level 19) oder niedriger unterstützen. Wenn auf einem Gerät jedoch eine Android-Version vor API-Level 19 ausgeführt wird, befinden sich EmojiCompat und seine Widgets im Status „Kein Betrieb“. Das bedeutet, dass sich EmojiTextView genau wie ein reguläres TextView verhält. EmojiCompat-Instanz; sie wechselt sofort in den Status LOAD_STATE_SUCCEEDED, wenn Sie die Methode init() aufrufen.

Weitere Informationen

Weitere Informationen zur Verwendung der EmojiCompat-Mediathek findest du unter EmojiCompat.