Installation and Getting Started
Installation and Getting Started
This article will introduce how to install and start using ClassIsland.
Check System Requirements
First, ensure your device meets the following recommended requirements:
- Windows 10 or later, x86_64 architecture
- Installed .NET 8.0 Desktop Runtime
- 4GB or more RAM
Installing ClassIsland on Windows 7
Caution
Using ClassIsland on Windows 7 is not recommended. If you insist on using ClassIsland on Windows 7, be sure to follow the steps below to complete the environment setup, otherwise, you may encounter serious memory leak issues. (ClassIsland#91)
Additionally, Microsoft support for Windows 7 ended on 2020/1/14 [1]. If you encounter system-related issues on Windows 7, the developers may not address them. Some features may also be unavailable on systems below Windows 10. If you accept these limitations, please continue reading.
Install Dependencies
You need to install additional dependencies according to your OS version as guided here.
For Windows 7, the following additional dependencies are required:
Address Memory Leak Issues
.NET 7 and above runtimes cause serious memory leak issues on Windows 7. You need to run the following commands in the command prompt as an administrator to fix this:
setx DOTNET_GCName clrgc.dll setx DOTNET_EnableWriteXorExecute 0The above commands set the following environment variables. If the commands fail, you can manually set the following variables.
Environment Variable Value DOTNET_GCNameclrgc.dllDOTNET_EnableWriteXorExecute0
Download the Application
For regular users, you can download the software from the following channels. Please choose the appropriate channel based on your network environment.
Warning
The beta version includes the latest features but may also contain incomplete and unstable features. Please use with caution.
| Download Channel/Version | 🚀Stable Version  | 🚧Beta Version |
|---|---|---|
| GitHub | GitHub Download | GitHub Download |
| AppCenter | AppCenter Download | AppCenter Download |
Other Download Channels
If your network environment does not support downloading from the above channels, you can download from the following unofficial mirrors and then upgrade to the latest version through the built-in application update.
| Download Link | Password | Source |
|---|---|---|
| https://wwz.lanzouv.com/b00tao8lwb | 0556 | MC_Sky |
| https://pan.quark.cn/s/40d1dca97c3d |
Thanks to the above contributors for providing the mirrors.
Advanced
If you want to experience the latest features, you can download the latest builds from GitHub Actions. If you want to build ClassIsland yourself, please refer to the development documentation.
Full Version vs Trimmed Version
If you download from GitHub, you can choose to download the full version or the trimmed version of ClassIsland. The build named ClassIsland.zip is the full version; the build named ClassIsland_AssetsTrimmed.zip is the trimmed version of ClassIsland, which removes unnecessary resource files (fonts, documents, etc.) to reduce the application size while keeping the functionality unchanged.
Note
The AppCenter download channel only provides the full version.
Extract the Software
After downloading, extract the software package to an independent folder (the path cannot contain Chinese characters [2]) and run the software to start using it.
Do not extract to a cloud sync folder or the [Downloads] folder, as this may cause file read/write issues or file loss.
Tips
This software will store all configurations in this folder. After configuration, you can directly take this folder to school for use.
Encountering Issues?
If you encounter issues during installation, please refer to the FAQ article. If the issue cannot be resolved, you can seek help in the community.
Getting Started
On the first launch, there will be a short welcome guide to help you complete the basic setup of the software and demonstrate some basic operations.
You can also watch the getting started tutorial video to quickly get started with the software. If you want to learn more about the software, you can continue reading this document.
Windows 7 lifecycle policy: https://learn.microsoft.com/en-us/lifecycle/products/windows-7. Windows 7 ESU support ended on 2023/1/10. ↩︎
May cause the application to get stuck during updates. ↩︎