Calligraphy开源项目使用教程

Calligraphy开源项目使用教程

CalligraphyCustom fonts in Android the easy way...项目地址:https://gitcode.com/gh_mirrors/ca/Calligraphy

1. 项目目录结构及介绍

Calligraphy是一个用于Android的库，旨在简化字体在应用中应用的过程。尽管提供的GitHub链接没有详细列出最新的目录结构，但根据常规Android库的结构和以往的开源实践，我们可以推测一个典型的结构如下：

- Calligraphy/
    ├── app/                    # 示例应用程序目录
        ├── src/
            └── main/             # 主要源代码，含示例用法
                ├── java/          # Java源码，存放库的主要实现或示例App的代码
                │   └── com.chrisjenx.calligraphy.sample...  
                ├── res/           # 资源文件夹，包括布局文件和样式定义
                ├── AndroidManifest.xml # 应用程序清单文件
    ├── library/               # 核心库源码，通常以Java或Kotlin编写的包
        ├── src/
            └── main/             
                ├── java/          # 包含Calligraphy的核心类和接口
                └── resources/     # 可能包含库所需的资源如默认字体等
    ├── build.gradle            # 库的构建脚本
    ├── README.md               # 项目说明文件，包含快速入门指南和使用说明
    └── .gitignore              # Git忽略文件列表

2. 项目的启动文件介绍

虽然Calligraphy库本身不直接有一个“启动文件”，它的集成通常发生在你的Android应用的Application类或是特定活动（Activity）中。以下是如何集成Calligraphy的一个简要示例，这一般会在你的自定义Application类中完成:

import uk.co.chrisjenx.calligraphy.CalligraphyConfig;
import uk.co.chrisjenx.calligraphy.CalligraphyContextWrapper;

public class MyApplication extends Application {
    @Override
    public void onCreate() {
        super.onCreate();
        // 初始化CalligraphyConfig
        CalligraphyConfig.initDefault(new CalligraphyConfig.Builder()
                .setDefaultFontPath("fonts/my_font.ttf") // 字体路径
                .setFontAttrId(R.attr.fontPath) // 自定义属性ID
                .build());
    }

    @Override
    protected void attachBaseContext(Context base) {
        super.attachBaseContext(CalligraphyContextWrapper.wrap(base)); // 使用Calligraphy的ContextWrapper
    }
}

3. 项目的配置文件介绍

build.gradle中的配置

在你的app模块的build.gradle文件里，你需要添加Calligraphy的依赖。由于具体版本号可能变化，查找最新版本可在项目的README.md或Maven仓库确认：

dependencies {
    implementation 'uk.co.chrisjenx:calligraphy:<latest_version>'
}

res/values/strings.xml 或 特定属性配置

除了上述代码中的CalligraphyConfig设置，你还可以在XML布局文件中通过指定android:fontFamily或自定义属性(R.attr.fontPath)来指定字体，从而无需每次都手动设置：

<TextView
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:text="@string/hello_world"
    android:fontFamily="@string/font_path" /> <!-- 或者使用自定义属性 -->

请注意，实际的目录结构和配置细节可能会随项目的更新而有所变动，务必参考项目最新文档或源码进行相应的调整。

CalligraphyCustom fonts in Android the easy way...项目地址:https://gitcode.com/gh_mirrors/ca/Calligraphy