基本用法

Semi Avalonia 的基本用法非常简单，您只要按照 安装使用 的步骤安装并引用 Semi Avalonia 的样式文件，即可实现 Avalonia 全局样式升级。

此外，您还可以通过以下方式做一些非常简单的配置

主题变量

Semi Avalonia 内置了亮色（Light）及暗色（Dark）两种主题配色，您可以通过设置 Application 的 RequestedThemeVariant 来选择应用的默认主题。其中 Light 表示亮色，Dark 表示暗色，Default 表示跟随系统颜色。

<Application
    x:Class="Semi.Avalonia.Demo.App"
    xmlns="https://github.com/avaloniaui"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    xmlns:semi="https://irihi.tech/semi"
    RequestedThemeVariant="Light"
    >
    <Application.Styles>
        <semi:SemiTheme />
    </Application.Styles>

</Application>

本地化

Avalonia 的内置控件中包含一部分文本信息（如 TextBox 默认右键菜单等）。您可以通过设置 SemiTheme 的 Locale 来选择这些文本的语言。Semi Avalonia 默认使用中文，如果您需要使用英文，可以进行如下设置：

<Application
    x:Class="Semi.Avalonia.Demo.App"
    xmlns="https://github.com/avaloniaui"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    xmlns:semi="https://irihi.tech/semi"
    >
    <Application.Styles>
        <semi:SemiTheme Locale="en-US"/>
    </Application.Styles>

</Application>

在不支持本地化的平台引用样式

在一些特殊的情况下，Globalization相关的功能会导致程序运行失败（例如在项目中定义<InvariantGlobalization>true</InvariantGlobalization>，或某些不支持此功能的操作系统）。此时您可以分别引用Semi Avalonia的样式资源和本地化相关的资源。

<Application.Resources>
    <ResourceDictionary>
        <ResourceDictionary.MergedDictionaries>
            <locale:en_us/> <!-- 导入本地化相关资源 -->
        </ResourceDictionary.MergedDictionaries>
    </ResourceDictionary>
</Application.Resources>
<Application.Styles>
    <StyleInclude Source="avares://Semi.Avalonia/Themes/Index.axaml" />
</Application.Styles>