Table of Contents

模块开发

模块是 Crystal.Avalonia 应用的核心构建块，可将代码组织为独立、可复用的单元。

什么是模块？

模块是实现 IModule 的类，封装：

  • Services — 模块提供的服务依赖
  • Views — 模块专属的 UI 组件
  • ViewModels — 模块视图的业务逻辑
  • Initialization Logic — 应用启动时执行的初始化

创建模块

步骤 1：定义模块类

using Crystal.Avalonia;
using Microsoft.Extensions.DependencyInjection;
using System;

namespace MyApp.Modules.UserManagement;

public class UserManagementModule : IModule
{
    public void RegisterServices(IServiceCollection services)
    {
        // Register View/ViewModel pairs
        services.AddMvvmTransient<UserListView, UserListViewModel>();
        services.AddMvvmTransient<UserDetailView, UserDetailViewModel>();

        // Register other services
        services.AddSingleton<IUserRepository, UserRepository>();
        services.AddTransient<UserService>();
    }

    public void InitializeModule(IServiceProvider serviceProvider)
    {
        // Perform initialization tasks
        var userService = serviceProvider.GetRequiredService<UserService>();
        userService.LoadUsers();
    }
}

步骤 2：注册模块

在 App.axaml.cs 中：

public override void RegisterModules(IModuleRegistrar moduleRegistrar)
{
    moduleRegistrar.RegisterModule<UserManagementModule>();
}

模块项目结构

对于较大应用，可将每个模块放在独立项目中：

MySolution/
├── MyApp/                    # Main application
│   └── App.axaml.cs
├── MyApp.Modules.UserManagement/  # Module in separate project
│   ├── UserManagementModule.cs
│   ├── Views/
│   ├── ViewModels/
│   └── Services/
└── MyApp.Modules.Settings/   # Another module
    └── ...

在应用间共享模块

模块可轻松在不同应用间共享：

  1. 为模块创建独立项目
  2. 在主应用中引用该模块项目
  3. 在应用中注册模块

模块项目文件（.csproj）

<Project Sdk="Microsoft.NET.Sdk">

    <PropertyGroup>
        <TargetFramework>net10.0</TargetFramework>
    </PropertyGroup>

    <ItemGroup>
        <PackageReference Include="Crystal.Avalonia" />
    </ItemGroup>

</Project>

在主应用中引用

// In App.axaml.cs of the main application
public override void RegisterModules(IModuleRegistrar moduleRegistrar)
{
    // Register modules from referenced projects
    moduleRegistrar.RegisterModule<MyApp.Modules.UserManagement.UserManagementModule>();
    moduleRegistrar.RegisterModule<MyApp.Modules.Settings.SettingsModule>();
}

条件注册

库会在启动时构造所有已注册模块。要跳过某功能，不要调用 RegisterModule —— 由应用自己决定：

public override void RegisterModules(IModuleRegistrar moduleRegistrar)
{
    if (User.IsAdmin)
        moduleRegistrar.RegisterModule<AdminModule>();

    moduleRegistrar.RegisterModule<CommonModule>();
}

没有内置延迟加载、模块 DependsOn、导航服务或事件聚合器。跨模块共享数据请自行注册普通 DI 服务。

最佳实践

实践 原因
保持模块聚焦 每个模块应代表单一功能域
定义模块契约 跨模块通信用接口
最小化模块依赖 模块应尽可能独立
显式注册 无程序集扫描 — 每个模块都写在 RegisterModules 里

下一步

延伸阅读

工作原理： 架构原理 — 模块系统 — RegisterModule → InitService → InitModules 流水线，以及为何无程序集扫描。

Edit this page