配置 ClassIsland 本体开发环境
配置 ClassIsland 本体开发环境
开发环境
首先确保您的系统满足以下要求:
- Windows 10 1803 及以上的操作系统,x86_64 或 ARM 架构
- 最低系统要求 macOS 12 Monterey ,推荐 macOS 14 Sonoma 及更高的系统版本
对于 Windows PC ,要在本地进行开发,您需要安装以下负载和工具:
- .NET 8.0 SDK
- Visual Studio 2022,包括【.NET 桌面开发】工作负载
- Git
- Powershell Core
对于 Mac ,要在本地进行开发,您需要安装以下负载和工具:
- .NET 8.0 SDK
- Visual Studio Code 或 JetBrains Rider
- Xcode 及命令行工具
- .NET macOS 工作负荷
- Git
拉取代码
您可以在 Fork 了本仓库后,通过 Git 将代码克隆到本地,然后开始开发。
要克隆仓库,您可以直接在 Visual Studio 中克隆,也可以通过命令行克隆。
注意
仓库名仅供参考,具体的仓库名请以您的 Fork 为准。
仓库中包含了子模块。要正常编译 ClassIsland,还需要在克隆后和每次更新代码后在仓库根目录运行以下命令初始化子模块:
git submodule update --init --recursive编译与运行
对于 Windows PC ,在首次编译运行时,需要先手动构建一次。
警告
在 Windows PC 上,请务必使用 Powershell Core(pwsh.exe)运行相关脚本,而不是使用系统内置的 Powershell(powershell.exe)。一般情况下 Windows 不会预装前者,所以您还需要手动安装 Powershell Core。
在 Powershell Core 运行以下脚本:
./tools/plugin/build.ps1以上操作只用进行一次。在执行完上述操作后,可以按照下述步骤在 Visual Studio 里正常编译和运行 ClassIsland 了。
- 在 Visual Studio 中打开解决方案
ClassIsland.sln - 将项目
ClassIsland设置为启动项目 - 点击【启动】即可编译项目,并开始调试。
对于 Mac ,可以通过脚本配置开发环境。
提示
在较新版本的 macOS 上,运行脚本可能需要授予访问权限。
导航到/ClassIsland/tools/plugin,运行build_macos.command
脚本配置安装所需的环境。
安装环境配置完成后,可以在 Visual Studio Code 或 JetBrains Rider 中正常编译和运行 ClassIsland。
在 Visual Studio Code 或 JetBrains Rider 中打开解决方案
ClassIsland.Filter.MacOs.slnf修改、编译与运行代码