# Debian/Ubuntu
sudo apt install libgtk-3-0      # Binary package
sudo apt install libgtk-3-dev    # Development package

# Arch
sudo apt install gtk3

# Fedora
sudo apt install gtk3            # Binary package
sudo apt install gtk3-devel      # Development package

# From MSYS2:
pacman -S mingw-w64-ucrt-x86_64-gtk3

# Check GTK environment (requires pkg-config):
pkg-config --cflags --libs gtk+-3.0
# Find GTK installation package directory:
ldconfig -p | grep gtk

## Install .NET Environment on Linux
To install .NET on Linux, refer to the official Microsoft guide:  
[Microsoft .NET Install Guide for Linux](https://learn.microsoft.com/dotnet/core/install/linux-scripted-manual)

---

## Visual Studio Plugin Installation

### Tool 1: NuGet Installation
Install the `GTKSystem.Windows.FormsDesigner` library from NuGet.  
This library helps fix form designers during project compilation.

### Tool 2: VSIX Plugin Installation
Download the plugin tool, close Visual Studio, and double-click the `GTKWinformVSIXProject.vsix` file to install it.  
*(Required if no Form template is available for projects in this framework.)*

The plugin installs two functionalities:
1. **Form Templates**: Adds templates for Forms and User Controls to "New Item" options.
2. **Right-Click Menu**: Adds a context menu to projects for specific GTKWinForms tasks.

![Visual Studio Plugin Screenshot](pic/vs_vsix.jpeg)

## Development Instructions

### Configuration Steps

1. **Create `System.Resources.ResourceManager` Class**
   - Create a `System.Resources.ResourceManager` class in your project.
   - Inherit from `GTKSystem.Resources.ResourceManager` to override the native `System.Resources.ResourceManager`.
   - This is used for reading project resource files and images.  
   *(If your project does not use resource files or images, this step is unnecessary.)*

2. **Create `System.ComponentModel.ComponentResourceManager` Class**
   - Create a `System.ComponentModel.ComponentResourceManager` class in your project.
   - Inherit from `GTKSystem.ComponentResourceManager` to override the native `System.ComponentModel.ComponentResourceManager`.
   - This class enables reading project resources and images (calls `GTKSystem.Resources.ResourceManager`).  
   *(If your project does not use resource files or images, this step is unnecessary.)*

3. **Modify `GTKWinFormsApp.csproj`**
   - Configure the project file by setting `UseWindowsForms` to `false`.  
   - Example configuration:
     ```xml
     <Project Sdk="Microsoft.NET.Sdk.WindowsDesktop">
       <PropertyGroup>
         <OutputType>WinExe</OutputType>
         <TargetFramework>net8.0</TargetFramework>
         <UseWindowsForms>false</UseWindowsForms>
     ```

4. **Add References**
   - Add the following references to your project:
     - `GTKSystem.Windows.Forms` (mandatory)
     - `System.Resources.Extensions` (optional, used only for specific design-time exceptions in Visual Studio).

5. **Configure Runtime Files**
   - Ensure the runtime configuration files include the following changes for Visual Studio form designers:  
     Example `GTKWinFormsApp.designer.runtimeconfig.json`:
     ```json
     {
       "runtimeOptions": {
         "tfm": "net8.0",
         "framework": {
           "name": "Microsoft.WindowsDesktop.App",
           "version": "8.0.0"
         }
       }
     }
     ```

---

## Support and Resources

**Enterprise Services**: [https://www.gtkapp.com/vipservice](https://www.gtkapp.com/vipservice)  

![Support GTKSystem](pic/love_reward_qrcode_.png)  
![Contact GTKSystem](pic/contact_weixin.png)

---

## Common Issues

**Why can't I open the Form Designer?**  
Follow these steps to resolve the issue:
1. Compile the project.
2. Open the Form Designer.
3. If it still doesn't open:
   - Close the Form Designer.
   - Recompile the project.
   - Restart Visual Studio.
   - Open the Form Designer again.

---

## Contribution
You can contribute to the development of this framework:

- [Gitee Repository](https://gitee.com/easywebfactory)  
- [GitHub Repository](https://github.com/easywebfactory)  
- [CSDN Blog](https://blog.csdn.net/auto_toyota)  

---

## Update History
For detailed updates, check: [Update History >>](UpdateHistory.md)