Calligraphy3 یک کتابخانه‌ی Android است که برای اعمال فونت به طور گسترده در برنامه‌های Android استفاده می‌شود. با استفاده از این کتابخانه، شما می‌توانید فونت‌های دلخواه خود را به صورت گلوبال یا برای بخش‌های خاص از برنامه تنظیم کنید.

برای استفاده از Calligraphy3 در یک پروژه Kotlin، مراحل زیر را دنبال کنید:

افزودن وابستگی‌ها:

 به فایل build.gradle ماژول شما این خطوط را اضافه کنید:

implementation 'uk.co.chrisjenx:calligraphy:3.1.1'

تنظیمات در فایل assets:

 در داخل فولدر assets پروژه، یک فولدر به نام fonts ایجاد کنید و فونت‌های مورد نظر خود را درون این فولدر قرار دهید.

 تنظیم Application: 

اگر کلاس Application در پروژه‌ی شما وجود ندارد، آن را ایجاد کنید. سپس، تنظیمات Calligraphy را به آن اضافه کنید:

import android.app.Application
import uk.co.chrisjenx.calligraphy.CalligraphyConfig

class MyApplication : Application() {
    override fun onCreate() {
        super.onCreate()

        // تنظیمات Calligraphy
        CalligraphyConfig.initDefault(CalligraphyConfig.Builder()
            .setDefaultFontPath("fonts/your_default_font.ttf")
            .setFontAttrId(R.attr.fontPath)
            .build()
        )
    }
}

در اینجا، مسیر fonts/your_default_font.ttf باید به نام و مسیر فونت پیش‌فرض شما تغییر یابد. 

استفاده در Activity یا Fragment: 

در هر Activity یا Fragment که می‌خواهید از Calligraphy استفاده کنید، این کار را انجام دهید:

import uk.co.chrisjenx.calligraphy.CalligraphyContextWrapper

class MyActivity : AppCompatActivity() {
    override fun attachBaseContext(newBase: Context) {
        super.attachBaseContext(CalligraphyContextWrapper.wrap(newBase))
    }

    // ...
}

این کار باعث می‌شود Calligraphy فونت‌های مربوط به هر Activity یا Fragment را به درستی بخواند و اعمال کند.