# # API 基本配置

> 这里介绍了 `YukiReflection` 的基本配置方法。

`YukiReflection` 无需一些复杂的配置即可直接开始使用，且不会与 `Java` 原生的反射 API 冲突。

你可以在使用之前对 `YukiReflection` 进行一些功能配置。

## # 获取 API 版本

你可以通过如下方式获取当前 `YukiReflection` 的 API 版本。

> 示例如下

    // 获取版本名称
    val versionName = YukiReflection.API_VERSION_NAME
    // 获取版本号
    val versionCode = YukiReflection.API_VERSION_CODE

你可以通过获取版本进行一些不同版本差异的判断或用于显示在关于信息中。

小提示

更多功能请参考 YukiReflection。

## # 配置 API 相关功能

你可以通过 `YukiReflection.configs { ... }` 方法或 `YukiReflection.Configs` 来配置相关功能。

### # 自定义调试日志标签

你可以使用如下方式来自定义调试日志的标签。

API 内部的日志将会使用此标签进行打印。

> 示例如下

    // 通过 configs 方法
    YukiReflection.configs {
        debugTag = "YourCustomTag"
    }
    // 直接设置
    YukiReflection.Configs.debugTag = "YourCustomTag"

### # 启用或禁用 Debug 模式

你可以使用如下方式来启用或禁用 Debug 模式。

Debug 模式默认是关闭的，启用后将会打印详细日志 (例如反射查找功能的耗时) 到控制台。

> 示例如下

    // 通过 configs 方法
    YukiReflection.configs {
        isDebug = true
    }
    // 直接设置
    YukiReflection.Configs.isDebug = true

### # 启用或禁用调试日志的输出功能

你可以使用如下方式来启用或禁用调试日志的输出功能。

此功能默认启用，关闭后将会停用 `YukiReflection` 对全部日志的输出。

> 示例如下

    // 通过 configs 方法
    YukiReflection.configs {
        isAllowPrintingLogs = true
    }
    // 直接设置
    YukiReflection.Configs.isAllowPrintingLogs = true

### # 启用或禁用 Member 缓存

你可以使用如下方式来启用或禁用 `Member` 缓存。

为防止 `Member` 复用过高造成的系统 GC 问题，此功能默认启用。

> 示例如下

    // 通过 configs 方法
    YukiReflection.configs {
        isEnableMemberCache = true
    }
    // 直接设置
    YukiReflection.Configs.isEnableMemberCache = true

### # 使用 configs 方法配置

为了一次性配置多个功能，你可以直接使用 `YukiReflection.configs { ... }` 方法进行配置。

> 示例如下

    YukiReflection.configs {
        debugTag = "YourCustomTag"
        isDebug = true
        isAllowPrintingLogs = true
        isEnableMemberCache = true
    }

小提示

更多功能请参考 YukiReflection.configs 方法、YukiReflection.Configs。