You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
-**Platform Support**: This project now has **excellent cross-platform support** with proper setup. Windows has full support; Linux/macOS have comprehensive support for core libraries, Android, and MAUI development.
@@ -19,7 +21,7 @@ Always reference these instructions first and fallback to search or bash command
19
21
```
20
22
If you've already done a shallow clone, deepen it with:
21
23
```bash
22
-
bashgit fetch --unshallow
24
+
git fetch --unshallow
23
25
```
24
26
This prevents exceptions like "Shallow clone lacks the objects required to calculate version height."
25
27
### Windows Development (Full Support)
@@ -36,8 +38,14 @@ Always reference these instructions first and fallback to search or bash command
36
38
Build time: **15-25 minutes**. NEVER CANCEL - set timeout to 45+ minutes.
37
39
38
40
### Linux/macOS Development (Comprehensive Support)
39
-
-**CRITICAL**: Install .NET 9.0 SDK first, then install required workloads:
41
+
-**CRITICAL**: Install .NET 10, 9, and 8 SDKs first, then install required workloads:
# Install Android and MAUI workloads (recommended for cross-platform development)
42
50
dotnet workload install android maui-android
43
51
@@ -63,7 +71,7 @@ Always reference these instructions first and fallback to search or bash command
63
71
-**Important**: **DO NOT** attempt to build Windows-specific projects or the full solution on Linux - it will fail with clear framework targeting errors.
64
72
65
73
### Testing
66
-
-**CRITICAL**: Test execution requires platform-specific configuration and .NET 9.0 SDK.
74
+
-**CRITICAL**: Test execution requires platform-specific configuration and .NET SDKs (10, 9, and 8).
67
75
-**Windows**: Full test suite runs successfully:
68
76
```bash
69
77
cd src
@@ -79,15 +87,6 @@ Always reference these instructions first and fallback to search or bash command
79
87
80
88
## Validation and Quality Assurance
81
89
82
-
### Code Style and Analysis Enforcement
83
-
-**EditorConfig Compliance**: Repository uses comprehensive `.editorconfig` with detailed rules for C# formatting, naming conventions, and code analysis
84
-
-**StyleCop Analyzers**: Enforces consistent C# code style with `stylecop.analyzers`
85
-
-**Roslynator Analyzers**: Additional code quality rules with `Roslynator.Analyzers`
86
-
-**Analysis Level**: Set to `latest` with enhanced .NET analyzers enabled
87
-
-**CRITICAL**: All code must comply with **ReactiveUI contribution guidelines**: https://www.reactiveui.net/contribute/index.html
88
-
89
-
## Validation and Quality Assurance
90
-
91
90
### Code Style and Analysis Enforcement
92
91
-**EditorConfig Compliance**: Repository uses a comprehensive `.editorconfig` with detailed rules for C# formatting, naming conventions, and code analysis.
93
92
-**StyleCop Analyzers**: Enforces consistent C# code style with `stylecop.analyzers`.
@@ -224,10 +223,12 @@ Always reference these instructions first and fallback to search or bash command
224
223
## Common Development Tasks
225
224
226
225
### Making Changes to Core Libraries
227
-
1.**Always** start with .NET 9.0 SDK installation and required workloads:
226
+
1.**Always** start with .NET SDK installation (10, 9, and 8) and required workloads:
228
227
```bash
229
-
# Essential first steps for any platform
228
+
# Essential first steps for any platform - install all .NET versions fresh
dotnet workload install android maui-android # For cross-platform development
233
234
```
@@ -315,15 +316,15 @@ Always reference these instructions first and fallback to search or bash command
315
316
## Troubleshooting
316
317
317
318
### Common Issues
318
-
1.**"The current .NET SDK does not support targeting .NET 9.0"**: Install .NET 9.0 SDK first
319
+
1.**"The current .NET SDK does not support targeting .NET X.0"**: Install .NET 10, 9, and 8 SDKs
319
320
2.**"Invalid framework identifier" errors**: Use explicit `-p:TargetFramework=net9.0`
320
321
3.**"Workload not supported" errors**: Install required workloads with `dotnet workload install android maui-android`
321
322
4.**"To build a project targeting Windows on this operating system, set the EnableWindowsTargeting property to true"**: Expected on Linux/macOS for Windows-specific projects
322
323
5.**Build hangs**: Normal for large builds - wait up to 45 minutes
323
324
6.**Test failures**: May be platform-specific - verify on Windows
324
325
325
326
### Quick Fixes
326
-
-**Setup issues**: Ensure .NET 9.0 SDK is installed first, then install workloads
327
+
-**Setup issues**: Install .NET 10, 9, and 8 SDKs fresh, then install workloads
327
328
-**Format issues**: Run `dotnet format whitespace` and `dotnet format style`
328
329
-**StyleCop violations**: Check `.editorconfig` rules and `src/stylecop.json` configuration
329
330
-**Analyzer warnings**: Build with `--verbosity normal` to see detailed analyzer messages
0 commit comments