Emoji Uyumluluğu

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

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

İlk kullanıma hazırlama işleyicileri ekleme

EmojiCompat ve EmojiCompat sınıfları, bir ilk başlatma geri çağırma işlevi kaydetme registerInitCallback() ve unregisterInitCallback() yöntemleri sağlar. Bu yöntemleri kullanmak için EmojiCompat.InitCallback sınıfının bir örneğini oluşturun. Bu yöntemleri çağırın ve EmojiCompat.InitCallback sınıfının örneğini iletin. EmojiCompat destek kitaplığının ilk kullanıma hazırlanması başarılı olduğunda EmojiCompat sınıfı onInitialized() yöntemini çağırır. Kitaplık başlatılamazsa EmojiCompat sınıfı onFailed() yöntemini çağırır.

İstediğiniz zaman başlatma durumunu kontrol etmek için getLoadState() yöntemini çağırın. Aşağıdaki değerlerden birini döndürür: LOAD_STATE_LOADING, LOAD_STATE_SUCCEEDED veya LOAD_STATE_FAILED.

EmojiCompat'i AppCompat widget'larıyla kullanma

AppCompat widgets kullanıyorsanız AppCompat widgets'den gelen EmojiCompat widget'larını kullanabilirsiniz.

1. Destek kitaplığını bağımlılıklar bölümüne ekleyin.

   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. EmojiCompat AppCompat Widget widget'larını yerleşim XML'lerinde kullanın.

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

Paketlenmiş yazı tipi yapılandırması

EmojiCompat destek kitaplığı, paketlenmiş yazı tipi sürümünde de mevcuttur. Bu paket, yerleştirilmiş meta verileri içeren yazı tipini içerir. Pakette, meta verileri ve yazı tiplerini yüklemek için AssetManager kullanan bir BundledEmojiCompatConfig de bulunur.

Not: Yazı tipi boyutu megabayt cinsindendir.

Destek kitaplığı bağımlılığı ekleme

EmojiCompat destek kitaplığını paketlenmiş yazı tipi yapılandırmasıyla kullanmak için uygulama projenizin geliştirme ortamınızdaki sınıf yolu bağımlılıklarını değiştirmeniz gerekir.

Uygulama projenize destek kitaplığı eklemek için:

1. Uygulamanızın build.gradle dosyasını açın.
2. Destek kitaplığını dependencies bölümüne ekleyin.

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

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

EmojiCompat'i yapılandırmak için paketlenmiş yazı tiplerini kullanma

EmojiCompat'ü yapılandırmak için paketlenmiş yazı tiplerini kullanmak isterseniz aşağıdaki adımları uygulayın:

1. EmojiCompat örneği oluşturmak ve Context örneği sağlamak için BundledEmojiCompatConfig'ü kullanın.
2. EmojiCompat sınıfını başlatmak ve BundledEmojiCompatConfig sınıfının örneğini iletmek için init() sınıfının yöntemini çağırın.

class MyApplication : Application() {

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

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

EmojiCompat'i widget'lar olmadan kullanma

EmojiCompat, doğru resimleri oluşturmak için EmojiSpan kullanır. Bu nedenle, belirli bir CharSequence değerini EmojiSpans ile Spanned örneklerine dönüştürmesi gerekir. EmojiCompat sınıfı, EmojiSpans ile CharSequences öğelerini Spanned örneklerine dönüştürmek için bir yöntem sağlar. Bu yöntemi kullanarak, işlenmemiş dize yerine işlenen örnekleri işleyebilir ve önbelleğe alabilirsiniz. Bu da uygulamanızın performansını artırır.

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

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

IME'ler için EmojiCompat'i kullanma

Klavyeler, EmojiCompat destek kitaplığını kullanarak etkileşimde bulundukları uygulama tarafından desteklenen emojileri oluşturabilir. IME'ler, EmojiCompat'un emoji oluşturma yeteneği olup olmadığını kontrol etmek için hasEmojiGlyph() yöntemini kullanabilir. Bu yöntem, bir emojinin CharSequence değerini alır ve EmojiCompat emojiyi algılayıp oluşturabiliyorsa true değerini döndürür.

Klavye, palette hangi emojinin oluşturulacağını belirlemek için EmojiCompat destek kitaplığının uygulama tarafından desteklenen sürümünü de kontrol edebilir. Klavyenin, sürümünü kontrol etmek için (varsa) EditorInfo.extras paketinde aşağıdaki anahtarların bulunup bulunmadığını kontrol etmesi gerekir:

• EDITOR_INFO_METAVERSION_KEY

Anahtar pakette mevcutsa değer, uygulamanın kullandığı emoji meta verilerinin sürümünü temsil eder. Bu anahtar yoksa uygulama EmojiCompat kullanmıyor demektir.

• EDITOR_INFO_REPLACE_ALL_KEY

Anahtar varsa ve true değerine ayarlanmışsa bu, uygulamanın SetReplaceAll() yöntemini çağırdığını gösterir. EmojiCompat yapılandırması hakkında daha fazla bilgi için Yapılandırma seçenekleri bölümüne bakın.

Klavye, EditorInfo.extras paketindeki anahtarları aldıktan sonra, uygulamanın belirli bir emojiyi oluşturup oluşturamayacağını kontrol etmek için hasEmojiGlyph() yöntemini kullanabilir. Bu yöntemde metadataVersion, EDITOR_INFO_METAVERSION_KEY değerini temsil eder.

EmojiCompat'i özel widget'larla kullanma

Uygulamanızdaki CharSequence öğesini ön işleme almak ve Spanned örneklerini oluşturabilen herhangi bir widget'a (ör. TextView) eklemek için dilediğiniz zaman process() yöntemini kullanabilirsiniz. Ayrıca, EmojiCompat, özel widget'larınızı en az çabayla emoji desteğiyle zenginleştirmenize olanak tanıyan aşağıdaki widget yardımcı sınıflarını sağlar.

• EmojiTextViewHelper
• EmojiEditTextHelper

Örnek 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() {
       ...
   }
}

Örnek 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() {
       ...
   }
}

Sık sorulan sorular

• Yazı tipi indirme işlemini nasıl başlatırım?

Emoji yazı tipleri, cihazda yoksa ilk istek üzerine indirilir. İndirme planlaması uygulama için şeffaftır.

• İlk kullanıma hazırlama işlemi ne kadar sürer?

Yazı tipi indirildikten sonra EmojiCompat'ün başlatılması yaklaşık 150 milisaniye sürer.

• EmojiCompat destek kitaplığı ne kadar bellek kullanır?

Şu anda, emojiyi bulmak için kullanılan veri yapısı uygulamanın belleğine yüklenir ve yaklaşık 200 KB kullanır.

• Özel TextView için EmojiCompat'i kullanabilir miyim?

Evet. EmojiCompat, özel widget'lar için yardımcı sınıflar sağlar. Belirli bir dizeyi önceden işlemek ve Spanned olarak dönüştürmek de mümkündür. Widget yardımcı sınıfları hakkında daha fazla bilgi için EmojiCompat'i özel widget'larla kullanma bölümüne bakın.

• Android 4.4 (API düzeyi 19) veya daha eski sürümleri çalıştıran cihazlarda düzen XML'lerine widget eklersem ne olur?

EmojiCompat destek kitaplığını veya widget'larını, Android 4.4 (API düzeyi 19) veya daha eski sürümleri çalıştıran cihazları destekleyen uygulamalarınıza dahil edebilirsiniz. Ancak bir cihaz API düzeyi 19'dan önceki bir Android sürümünü çalıştırıyorsa EmojiCompat ve widget'ları "işlem yok" durumundaysa Bu, EmojiTextView'ün tam olarak normal bir TextView gibi davrandığı anlamına gelir. EmojiCompat örneği; init() yöntemini çağırdığınızda hemen LOAD_STATE_SUCCEEDED durumuna geçer.

Ek kaynaklar

Kitaplığı kullanma hakkında daha fazla bilgi edinmek için EmojiCompat EmojiCompat videosunu izleyin.