Add Visual Studio extension for Linux platform support
VSIX extension that adds: - "OpenMaui Linux App" project template in File → New → Project - Pre-configured launch profiles for Linux debugging - WSL integration for Windows developers - x64 and ARM64 build configurations Launch Profiles included: - Linux (Local) - Direct execution - Linux (WSL) - Run via WSL - Linux (x64 Release) - Release build for x64 - Linux (ARM64 Release) - Release build for ARM64 - Publish Linux x64/ARM64 - Self-contained publishing Build with: msbuild /p:Configuration=Release Output: OpenMaui.VisualStudio.vsix
This commit is contained in:
logikonline
parent
d238dde5a4
commit
ae5c9ab738
|
|
@ -0,0 +1,23 @@
|
|||
MIT License
|
||||
|
||||
Copyright (c) 2025 MarketAlly LLC
|
||||
|
||||
Lead Architect: David H. Friedel Jr.
|
||||
|
||||
Permission is hereby granted, free of charge, to any person obtaining a copy
|
||||
of this software and associated documentation files (the "Software"), to deal
|
||||
in the Software without restriction, including without limitation the rights
|
||||
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
||||
copies of the Software, and to permit persons to whom the Software is
|
||||
furnished to do so, subject to the following conditions:
|
||||
|
||||
The above copyright notice and this permission notice shall be included in all
|
||||
copies or substantial portions of the Software.
|
||||
|
||||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
||||
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
||||
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
||||
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
||||
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
||||
SOFTWARE.
|
||||
|
|
@ -0,0 +1,44 @@
|
|||
<Project Sdk="Microsoft.NET.Sdk">
|
||||
|
||||
<PropertyGroup>
|
||||
<TargetFramework>net48</TargetFramework>
|
||||
<LangVersion>latest</LangVersion>
|
||||
<Nullable>enable</Nullable>
|
||||
|
||||
<!-- VSIX Properties -->
|
||||
<GeneratePkgDefFile>true</GeneratePkgDefFile>
|
||||
<IncludeAssemblyInVSIXContainer>true</IncludeAssemblyInVSIXContainer>
|
||||
<IncludeDebugSymbolsInVSIXContainer>false</IncludeDebugSymbolsInVSIXContainer>
|
||||
<IncludeDebugSymbolsInLocalVSIXDeployment>false</IncludeDebugSymbolsInLocalVSIXDeployment>
|
||||
<CopyBuildOutputToOutputDirectory>true</CopyBuildOutputToOutputDirectory>
|
||||
<CopyOutputSymbolsToOutputDirectory>false</CopyOutputSymbolsToOutputDirectory>
|
||||
<UseCodebase>true</UseCodebase>
|
||||
|
||||
<!-- Extension Info -->
|
||||
<ExtensionInstallationRoot>Extensions</ExtensionInstallationRoot>
|
||||
<ExtensionInstallationFolder>MarketAlly\OpenMaui</ExtensionInstallationFolder>
|
||||
</PropertyGroup>
|
||||
|
||||
<ItemGroup>
|
||||
<PackageReference Include="Microsoft.VSSDK.BuildTools" Version="17.8.2365" />
|
||||
<PackageReference Include="Microsoft.VisualStudio.SDK" Version="17.8.37221" />
|
||||
</ItemGroup>
|
||||
|
||||
<ItemGroup>
|
||||
<None Include="source.extension.vsixmanifest">
|
||||
<SubType>Designer</SubType>
|
||||
</None>
|
||||
</ItemGroup>
|
||||
|
||||
<ItemGroup>
|
||||
<Content Include="ProjectTemplates\**\*">
|
||||
<IncludeInVSIX>true</IncludeInVSIX>
|
||||
<CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
|
||||
</Content>
|
||||
<Content Include="Resources\**\*">
|
||||
<IncludeInVSIX>true</IncludeInVSIX>
|
||||
<CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
|
||||
</Content>
|
||||
</ItemGroup>
|
||||
|
||||
</Project>
|
||||
|
|
@ -0,0 +1,17 @@
|
|||
namespace $safeprojectname$;
|
||||
|
||||
/// <summary>
|
||||
/// Application configuration and lifecycle management.
|
||||
/// </summary>
|
||||
public partial class App
|
||||
{
|
||||
public App()
|
||||
{
|
||||
InitializeComponent();
|
||||
}
|
||||
|
||||
private void InitializeComponent()
|
||||
{
|
||||
// Initialize application resources here
|
||||
}
|
||||
}
|
||||
|
|
@ -0,0 +1,76 @@
|
|||
using Microsoft.Maui.Controls;
|
||||
|
||||
namespace $safeprojectname$;
|
||||
|
||||
/// <summary>
|
||||
/// The main page of the application.
|
||||
/// </summary>
|
||||
public partial class MainPage : ContentPage
|
||||
{
|
||||
private int _count = 0;
|
||||
|
||||
public MainPage()
|
||||
{
|
||||
InitializeComponent();
|
||||
}
|
||||
|
||||
private void InitializeComponent()
|
||||
{
|
||||
Title = "Home";
|
||||
|
||||
var layout = new VerticalStackLayout
|
||||
{
|
||||
Spacing = 25,
|
||||
Padding = new Thickness(30, 0),
|
||||
VerticalOptions = LayoutOptions.Center
|
||||
};
|
||||
|
||||
var welcomeLabel = new Label
|
||||
{
|
||||
Text = "Hello, OpenMaui!",
|
||||
FontSize = 32,
|
||||
HorizontalOptions = LayoutOptions.Center
|
||||
};
|
||||
|
||||
var instructionLabel = new Label
|
||||
{
|
||||
Text = "Welcome to .NET MAUI on Linux",
|
||||
FontSize = 18,
|
||||
HorizontalOptions = LayoutOptions.Center
|
||||
};
|
||||
|
||||
var counterButton = new Button
|
||||
{
|
||||
Text = "Click me",
|
||||
HorizontalOptions = LayoutOptions.Center
|
||||
};
|
||||
|
||||
counterButton.Clicked += OnCounterClicked;
|
||||
|
||||
var image = new Image
|
||||
{
|
||||
Source = "dotnet_bot.png",
|
||||
HeightRequest = 185,
|
||||
HorizontalOptions = LayoutOptions.Center
|
||||
};
|
||||
|
||||
layout.Children.Add(welcomeLabel);
|
||||
layout.Children.Add(instructionLabel);
|
||||
layout.Children.Add(counterButton);
|
||||
layout.Children.Add(image);
|
||||
|
||||
Content = new ScrollView { Content = layout };
|
||||
}
|
||||
|
||||
private void OnCounterClicked(object? sender, EventArgs e)
|
||||
{
|
||||
_count++;
|
||||
|
||||
if (sender is Button button)
|
||||
{
|
||||
button.Text = _count == 1
|
||||
? $"Clicked {_count} time"
|
||||
: $"Clicked {_count} times";
|
||||
}
|
||||
}
|
||||
}
|
||||
|
|
@ -0,0 +1,41 @@
|
|||
<?xml version="1.0" encoding="utf-8" ?>
|
||||
<!--
|
||||
Note: OpenMaui currently uses code-based UI (MainPage.cs).
|
||||
This XAML file is provided for future XAML support compatibility.
|
||||
The code-behind in MainPage.cs takes precedence.
|
||||
-->
|
||||
<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
|
||||
xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
|
||||
x:Class="$safeprojectname$.MainPage">
|
||||
|
||||
<ScrollView>
|
||||
<VerticalStackLayout
|
||||
Padding="30,0"
|
||||
Spacing="25">
|
||||
|
||||
<Label
|
||||
Text="Hello, OpenMaui!"
|
||||
Style="{StaticResource Headline}"
|
||||
SemanticProperties.HeadingLevel="Level1" />
|
||||
|
||||
<Label
|
||||
Text="Welcome to .NET MAUI on Linux"
|
||||
Style="{StaticResource SubHeadline}"
|
||||
SemanticProperties.Description="Welcome message" />
|
||||
|
||||
<Button
|
||||
x:Name="CounterBtn"
|
||||
Text="Click me"
|
||||
Clicked="OnCounterClicked"
|
||||
HorizontalOptions="Fill" />
|
||||
|
||||
<Image
|
||||
Source="dotnet_bot.png"
|
||||
HeightRequest="185"
|
||||
Aspect="AspectFit"
|
||||
SemanticProperties.Description="dot net bot waving" />
|
||||
|
||||
</VerticalStackLayout>
|
||||
</ScrollView>
|
||||
|
||||
</ContentPage>
|
||||
|
|
@ -0,0 +1,39 @@
|
|||
<Project Sdk="Microsoft.NET.Sdk">
|
||||
|
||||
<PropertyGroup>
|
||||
<OutputType>Exe</OutputType>
|
||||
<TargetFramework>net9.0</TargetFramework>
|
||||
<ImplicitUsings>enable</ImplicitUsings>
|
||||
<Nullable>enable</Nullable>
|
||||
<RootNamespace>$safeprojectname$</RootNamespace>
|
||||
<AssemblyName>$safeprojectname$</AssemblyName>
|
||||
<ApplicationTitle>$projectname$</ApplicationTitle>
|
||||
|
||||
<!-- Linux Runtime -->
|
||||
<RuntimeIdentifiers>linux-x64;linux-arm64</RuntimeIdentifiers>
|
||||
</PropertyGroup>
|
||||
|
||||
<PropertyGroup Condition="'$(Configuration)' == 'Debug'">
|
||||
<DefineConstants>$(DefineConstants);DEBUG</DefineConstants>
|
||||
</PropertyGroup>
|
||||
|
||||
<PropertyGroup Condition="'$(Configuration)' == 'Release'">
|
||||
<PublishSingleFile>true</PublishSingleFile>
|
||||
<SelfContained>true</SelfContained>
|
||||
<PublishTrimmed>false</PublishTrimmed>
|
||||
</PropertyGroup>
|
||||
|
||||
<ItemGroup>
|
||||
<!-- OpenMaui Linux Platform -->
|
||||
<PackageReference Include="OpenMaui.Controls.Linux" Version="1.0.0-preview.*" />
|
||||
|
||||
<!-- Core MAUI packages -->
|
||||
<PackageReference Include="Microsoft.Maui.Controls" Version="9.0.*" />
|
||||
<PackageReference Include="Microsoft.Maui.Graphics" Version="9.0.*" />
|
||||
</ItemGroup>
|
||||
|
||||
<ItemGroup>
|
||||
<EmbeddedResource Include="Resources\**\*" />
|
||||
</ItemGroup>
|
||||
|
||||
</Project>
|
||||
|
|
@ -0,0 +1,43 @@
|
|||
<VSTemplate Version="3.0.0" Type="Project" xmlns="http://schemas.microsoft.com/developer/vstemplate/2005">
|
||||
<TemplateData>
|
||||
<Name>OpenMaui Linux App</Name>
|
||||
<Description>A .NET MAUI application targeting Linux desktop using OpenMaui and SkiaSharp rendering.</Description>
|
||||
<Icon>__TemplateIcon.ico</Icon>
|
||||
<PreviewImage>__PreviewImage.png</PreviewImage>
|
||||
<ProjectType>CSharp</ProjectType>
|
||||
<ProjectSubType></ProjectSubType>
|
||||
<LanguageTag>csharp</LanguageTag>
|
||||
<PlatformTag>linux</PlatformTag>
|
||||
<ProjectTypeTag>desktop</ProjectTypeTag>
|
||||
<ProjectTypeTag>maui</ProjectTypeTag>
|
||||
<RequiredFrameworkVersion>4.8</RequiredFrameworkVersion>
|
||||
<SortOrder>1000</SortOrder>
|
||||
<TemplateID>OpenMaui.Linux.App.CSharp</TemplateID>
|
||||
<CreateNewFolder>true</CreateNewFolder>
|
||||
<DefaultName>OpenMauiLinuxApp</DefaultName>
|
||||
<ProvideDefaultName>true</ProvideDefaultName>
|
||||
<LocationField>Enabled</LocationField>
|
||||
<EnableLocationBrowseButton>true</EnableLocationBrowseButton>
|
||||
<CreateInPlace>true</CreateInPlace>
|
||||
</TemplateData>
|
||||
<TemplateContent>
|
||||
<Project File="OpenMauiLinuxApp.csproj" ReplaceParameters="true">
|
||||
<ProjectItem ReplaceParameters="true" TargetFileName="Program.cs">Program.cs</ProjectItem>
|
||||
<ProjectItem ReplaceParameters="true" TargetFileName="App.cs">App.cs</ProjectItem>
|
||||
<ProjectItem ReplaceParameters="true" TargetFileName="MainPage.cs">MainPage.cs</ProjectItem>
|
||||
<ProjectItem ReplaceParameters="true" TargetFileName="MainPage.xaml">MainPage.xaml</ProjectItem>
|
||||
<Folder Name="Properties" TargetFolderName="Properties">
|
||||
<ProjectItem ReplaceParameters="true" TargetFileName="launchSettings.json">launchSettings.json</ProjectItem>
|
||||
</Folder>
|
||||
<Folder Name="Resources" TargetFolderName="Resources">
|
||||
<Folder Name="Images" TargetFolderName="Images">
|
||||
<ProjectItem TargetFileName="dotnet_bot.png">dotnet_bot.png</ProjectItem>
|
||||
</Folder>
|
||||
</Folder>
|
||||
</Project>
|
||||
</TemplateContent>
|
||||
<WizardExtension>
|
||||
<Assembly>Microsoft.VisualStudio.TemplateEngine.Wizard, Version=1.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a</Assembly>
|
||||
<FullClassName>Microsoft.VisualStudio.TemplateEngine.Wizard.TemplateEngineWizard</FullClassName>
|
||||
</WizardExtension>
|
||||
</VSTemplate>
|
||||
|
|
@ -0,0 +1,20 @@
|
|||
using OpenMaui.Platform.Linux;
|
||||
|
||||
namespace $safeprojectname$;
|
||||
|
||||
public class Program
|
||||
{
|
||||
public static void Main(string[] args)
|
||||
{
|
||||
var app = new LinuxApplication();
|
||||
|
||||
// Configure the application
|
||||
app.Title = "$projectname$";
|
||||
|
||||
// Set the main page
|
||||
app.MainPage = new MainPage();
|
||||
|
||||
// Run the application
|
||||
app.Run();
|
||||
}
|
||||
}
|
||||
|
|
@ -0,0 +1,49 @@
|
|||
{
|
||||
"profiles": {
|
||||
"Linux (Local)": {
|
||||
"commandName": "Project",
|
||||
"commandLineArgs": "",
|
||||
"environmentVariables": {
|
||||
"DISPLAY": ":0",
|
||||
"DOTNET_ENVIRONMENT": "Development"
|
||||
}
|
||||
},
|
||||
"Linux (WSL)": {
|
||||
"commandName": "Executable",
|
||||
"executablePath": "wsl.exe",
|
||||
"commandLineArgs": "-e dotnet run --project .",
|
||||
"workingDirectory": "${workspaceFolder}",
|
||||
"environmentVariables": {
|
||||
"DISPLAY": ":0",
|
||||
"WAYLAND_DISPLAY": "",
|
||||
"DOTNET_ENVIRONMENT": "Development"
|
||||
}
|
||||
},
|
||||
"Linux (x64 Release)": {
|
||||
"commandName": "Executable",
|
||||
"executablePath": "dotnet",
|
||||
"commandLineArgs": "run -c Release -r linux-x64",
|
||||
"environmentVariables": {
|
||||
"DOTNET_ENVIRONMENT": "Production"
|
||||
}
|
||||
},
|
||||
"Linux (ARM64 Release)": {
|
||||
"commandName": "Executable",
|
||||
"executablePath": "dotnet",
|
||||
"commandLineArgs": "run -c Release -r linux-arm64",
|
||||
"environmentVariables": {
|
||||
"DOTNET_ENVIRONMENT": "Production"
|
||||
}
|
||||
},
|
||||
"Publish Linux x64": {
|
||||
"commandName": "Executable",
|
||||
"executablePath": "dotnet",
|
||||
"commandLineArgs": "publish -c Release -r linux-x64 --self-contained -o ./publish/linux-x64"
|
||||
},
|
||||
"Publish Linux ARM64": {
|
||||
"commandName": "Executable",
|
||||
"executablePath": "dotnet",
|
||||
"commandLineArgs": "publish -c Release -r linux-arm64 --self-contained -o ./publish/linux-arm64"
|
||||
}
|
||||
}
|
||||
}
|
||||
|
|
@ -0,0 +1,3 @@
|
|||
# Placeholder for dotnet_bot.png
|
||||
# Download from: https://raw.githubusercontent.com/dotnet/brand/main/dotnet-bot/dotnet-bot_waving.png
|
||||
# Rename to: dotnet_bot.png
|
||||
|
|
@ -0,0 +1,3 @@
|
|||
# Add the following images:
|
||||
# - Icon.png (128x128) - Extension icon
|
||||
# - Preview.png (200x200) - Preview image for marketplace
|
||||
|
|
@ -0,0 +1,48 @@
|
|||
<?xml version="1.0" encoding="utf-8"?>
|
||||
<PackageManifest Version="2.0.0" xmlns="http://schemas.microsoft.com/developer/vsx-schema/2011" xmlns:d="http://schemas.microsoft.com/developer/vsx-schema-design/2011">
|
||||
<Metadata>
|
||||
<Identity Id="OpenMaui.VisualStudio.a1b2c3d4-e5f6-7890-abcd-ef1234567890" Version="1.0.0" Language="en-US" Publisher="MarketAlly LLC" />
|
||||
<DisplayName>OpenMaui - Linux Platform for .NET MAUI</DisplayName>
|
||||
<Description xml:space="preserve">Adds Linux platform support to .NET MAUI projects in Visual Studio. Build and deploy MAUI applications to Linux desktops with full SkiaSharp rendering support.
|
||||
|
||||
Features:
|
||||
• Linux project templates
|
||||
• Linux build configurations
|
||||
• WSL debugging integration
|
||||
• Remote Linux debugging
|
||||
• Linux-specific launch profiles
|
||||
|
||||
Developed by MarketAlly LLC
|
||||
Lead Architect: David H. Friedel Jr.</Description>
|
||||
<MoreInfo>https://github.com/open-maui/maui-linux</MoreInfo>
|
||||
<License>LICENSE.txt</License>
|
||||
<GettingStartedGuide>https://github.com/open-maui/maui-linux/blob/main/docs/GETTING_STARTED.md</GettingStartedGuide>
|
||||
<ReleaseNotes>https://github.com/open-maui/maui-linux/releases</ReleaseNotes>
|
||||
<Icon>Resources\Icon.png</Icon>
|
||||
<PreviewImage>Resources\Preview.png</PreviewImage>
|
||||
<Tags>maui, linux, desktop, cross-platform, skia, openmaui, dotnet</Tags>
|
||||
</Metadata>
|
||||
<Installation>
|
||||
<InstallationTarget Id="Microsoft.VisualStudio.Community" Version="[17.0,18.0)">
|
||||
<ProductArchitecture>amd64</ProductArchitecture>
|
||||
</InstallationTarget>
|
||||
<InstallationTarget Id="Microsoft.VisualStudio.Pro" Version="[17.0,18.0)">
|
||||
<ProductArchitecture>amd64</ProductArchitecture>
|
||||
</InstallationTarget>
|
||||
<InstallationTarget Id="Microsoft.VisualStudio.Enterprise" Version="[17.0,18.0)">
|
||||
<ProductArchitecture>amd64</ProductArchitecture>
|
||||
</InstallationTarget>
|
||||
</Installation>
|
||||
<Dependencies>
|
||||
<Dependency Id="Microsoft.Framework.NDP" DisplayName="Microsoft .NET Framework" d:Source="Manual" Version="[4.8,)" />
|
||||
<Dependency Id="Microsoft.VisualStudio.Component.CoreEditor" DisplayName="Visual Studio core editor" d:Source="Installed" Version="[17.0,18.0)" />
|
||||
<Dependency Id="Microsoft.VisualStudio.Workload.NetCrossPlat" DisplayName=".NET MAUI Workload" d:Source="Installed" Version="[17.0,18.0)" />
|
||||
</Dependencies>
|
||||
<Prerequisites>
|
||||
<Prerequisite Id="Microsoft.VisualStudio.Component.CoreEditor" Version="[17.0,18.0)" DisplayName="Visual Studio core editor" />
|
||||
</Prerequisites>
|
||||
<Assets>
|
||||
<Asset Type="Microsoft.VisualStudio.ProjectTemplate" d:Source="File" Path="ProjectTemplates" d:TargetPath="ProjectTemplates" />
|
||||
<Asset Type="Microsoft.VisualStudio.VsPackage" d:Source="Project" d:ProjectName="%CurrentProject%" Path="|%CurrentProject%;PkgdefProjectOutputGroup|" />
|
||||
</Assets>
|
||||
</PackageManifest>
|
||||
|
|
@ -0,0 +1,143 @@
|
|||
# OpenMaui Visual Studio Extension
|
||||
|
||||
This Visual Studio extension adds Linux platform support for .NET MAUI applications.
|
||||
|
||||
## Features
|
||||
|
||||
### Project Templates
|
||||
When installed, you'll see **"OpenMaui Linux App"** in Visual Studio's New Project dialog:
|
||||
|
||||
```
|
||||
File → New → Project → Search "OpenMaui"
|
||||
```
|
||||
|
||||
### Launch Profiles
|
||||
The template includes pre-configured launch profiles:
|
||||
|
||||
| Profile | Description |
|
||||
|---------|-------------|
|
||||
| **Linux (Local)** | Run directly (requires Linux or WSL with GUI) |
|
||||
| **Linux (WSL)** | Run via Windows Subsystem for Linux |
|
||||
| **Linux (x64 Release)** | Build and run release for x64 |
|
||||
| **Linux (ARM64 Release)** | Build and run release for ARM64 |
|
||||
| **Publish Linux x64** | Create self-contained x64 package |
|
||||
| **Publish Linux ARM64** | Create self-contained ARM64 package |
|
||||
|
||||
### How It Works
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────┐
|
||||
│ Visual Studio │
|
||||
├─────────────────────────────────────────────────────────┤
|
||||
│ File → New → Project │
|
||||
│ └── OpenMaui Linux App ← This extension adds this │
|
||||
├─────────────────────────────────────────────────────────┤
|
||||
│ Debug Dropdown │
|
||||
│ ├── Linux (Local) │
|
||||
│ ├── Linux (WSL) ← Launch profiles │
|
||||
│ ├── Linux (x64 Release) │
|
||||
│ └── Publish Linux... │
|
||||
└─────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
## Installation
|
||||
|
||||
### From Visual Studio Marketplace
|
||||
1. Open Visual Studio 2022
|
||||
2. Extensions → Manage Extensions
|
||||
3. Search for "OpenMaui"
|
||||
4. Click Download and restart VS
|
||||
|
||||
### From VSIX File
|
||||
1. Download `OpenMaui.VisualStudio.vsix`
|
||||
2. Double-click to install
|
||||
3. Restart Visual Studio
|
||||
|
||||
## Building the Extension
|
||||
|
||||
### Prerequisites
|
||||
- Visual Studio 2022 with "Visual Studio extension development" workload
|
||||
- .NET Framework 4.8 Developer Pack
|
||||
|
||||
### Build Steps
|
||||
```bash
|
||||
cd vsix/OpenMaui.VisualStudio
|
||||
dotnet restore
|
||||
msbuild /p:Configuration=Release
|
||||
```
|
||||
|
||||
The VSIX will be in `bin/Release/OpenMaui.VisualStudio.vsix`
|
||||
|
||||
## Project Structure
|
||||
|
||||
```
|
||||
vsix/
|
||||
└── OpenMaui.VisualStudio/
|
||||
├── OpenMaui.VisualStudio.csproj # Extension project
|
||||
├── source.extension.vsixmanifest # VSIX metadata
|
||||
├── ProjectTemplates/ # VS project templates
|
||||
│ └── OpenMauiLinuxApp/
|
||||
│ ├── OpenMauiLinuxApp.vstemplate
|
||||
│ ├── OpenMauiLinuxApp.csproj
|
||||
│ ├── Program.cs
|
||||
│ ├── App.cs
|
||||
│ ├── MainPage.cs
|
||||
│ ├── MainPage.xaml
|
||||
│ └── Properties/
|
||||
│ └── launchSettings.json
|
||||
└── Resources/
|
||||
├── Icon.png
|
||||
└── Preview.png
|
||||
```
|
||||
|
||||
## Adding Linux to Existing MAUI Projects
|
||||
|
||||
If you have an existing MAUI project and want to add Linux support:
|
||||
|
||||
### Option 1: Add Platform Folder
|
||||
1. Add `Platforms/Linux/Program.cs` to your project
|
||||
2. Add `OpenMaui.Controls.Linux` NuGet package
|
||||
3. Copy `launchSettings.json` from template to `Properties/`
|
||||
|
||||
### Option 2: Create Companion Project
|
||||
1. Create new "OpenMaui Linux App" project
|
||||
2. Reference your shared MAUI library
|
||||
3. Build Linux version separately
|
||||
|
||||
## Debugging on Linux
|
||||
|
||||
### Via WSL (Recommended)
|
||||
1. Install WSL 2 with Ubuntu
|
||||
2. Install .NET SDK in WSL: `sudo apt install dotnet-sdk-9.0`
|
||||
3. Install X11 libs: `sudo apt install libx11-6`
|
||||
4. Select "Linux (WSL)" profile and press F5
|
||||
|
||||
### Via Remote Machine
|
||||
1. Set up SSH access to Linux machine
|
||||
2. Install `vsdbg` on remote machine
|
||||
3. Configure remote debugging in VS
|
||||
|
||||
### Via Virtual Machine
|
||||
1. Set up Linux VM (VMware, VirtualBox, Hyper-V)
|
||||
2. Share project folder with VM
|
||||
3. Build and run inside VM
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
### "Cannot find 'wsl.exe'"
|
||||
Install WSL: `wsl --install` in PowerShell (Admin)
|
||||
|
||||
### "Display not found"
|
||||
Ensure WSLg is enabled (Windows 11) or configure X server (Windows 10)
|
||||
|
||||
### Template not appearing
|
||||
1. Clear template cache: `devenv /updateconfiguration`
|
||||
2. Restart Visual Studio
|
||||
|
||||
## License
|
||||
|
||||
MIT License - Copyright (c) 2025 MarketAlly LLC
|
||||
|
||||
---
|
||||
|
||||
*Developed by MarketAlly LLC • Lead Architect: David H. Friedel Jr.*
|
||||
Loading…
Reference in New Issue