Rosalina：Unity UI 代码生成工具的下载与安装教程

一、项目介绍

Rosalina 是一个为 Unity 的 UI 文档生成 C# 代码的工具。它基于 UXML 模板自动生成 C# UI 绑定脚本，使得开发者可以更高效地开发 Unity UI。Rosalina 支持自定义组件，并提供 EditorWindow 支持。

二、项目下载位置

Rosalina 的开源代码托管在 GitHub 上，您可以通过以下地址访问项目：

https://github.com/Eastrall/Rosalina.git

三、项目安装环境配置

在安装 Rosalina 之前，请确保您的计算机上已经安装了 Unity 编辑器。以下是环境配置的步骤，以及对应的屏幕截图示例。

1. 打开 Unity 编辑器，确保版本与 Rosalina 兼容。
2. 检查 Unity 编辑器是否已经安装了 UI Toolkit。

四、项目安装方式

Rosalina 可以通过两种方式安装：

1. 使用 OpenUPM 安装

在 Unity 编辑器中，打开 OpenUPM：

Window -> Package Manager -> Add package from git URL

输入以下 URL 安装 Rosalina：

https://github.com/Eastrall/Rosalina.git

2. 使用 Git 仓库安装

在 Unity 编辑器中，执行以下步骤：

Window -> Package Manager -> Add package from git URL

输入以下 URL 安装 Rosalina：

https://github.com/Eastrall/Rosalina.git

安装完成后，您可以在 Unity 编辑器中看到 Rosalina。

五、项目处理脚本

安装完成后，Rosalina 会监视项目中的所有 .uxml 文件，并生成对应的 C# UI 绑定代码。以下是一个示例：

假设您有一个 UXML 文件如下：

<ui:UXML xmlns:ui="UnityEngine/UIElements" ...>
  <ui:VisualElement>
    <ui:Label text="Label" name="TitleLabel"/>
    <ui:Button text="Button" name="Button"/>
  </ui:VisualElement>
</ui:UXML>

Rosalina 会自动生成以下 C# 代码：

using UnityEngine;
using UnityEngine.UIElements;

public partial class SampleDocument : MonoBehaviour
{
    [SerializeField] private UIDocument _document;

    public Label TitleLabel { get; private set; }
    public Button Button { get; private set; }

    public VisualElement Root => _document.rootVisualElement;

    public void InitializeDocument()
    {
        TitleLabel = Root.Q<Label>("TitleLabel");
        Button = Root.Q<Button>("Button");
    }
}

请注意，所有自动生成的代码都位于 Assets/Rosalina/AutoGenerated/ 文件夹下，且不要手动修改这些文件，因为每次更新 UXML 模板时，它们都会被覆盖。