[mapguide-commits] r10176 - in branches/4.0/MgDev: Bindings/src/Managed/DotNet/OSGeo.MapGuide.Portable Portable/OSGeo.MapGuide.Viewer Portable/OSGeo.MapGuide.Viewer/Properties Portable/OSGeo.MapGuide.Viewer.Portable Portable/OSGeo.MapGuide.Viewer.Portable/Properties

svn_mapguide at osgeo.org svn_mapguide at osgeo.org
Thu Aug 21 09:07:02 PDT 2025


Author: jng
Date: 2025-08-21 09:07:01 -0700 (Thu, 21 Aug 2025)
New Revision: 10176

Added:
   branches/4.0/MgDev/Bindings/src/Managed/DotNet/OSGeo.MapGuide.Portable/README.md
   branches/4.0/MgDev/Portable/OSGeo.MapGuide.Viewer.Portable/README.md
   branches/4.0/MgDev/Portable/OSGeo.MapGuide.Viewer/README.md
Modified:
   branches/4.0/MgDev/Bindings/src/Managed/DotNet/OSGeo.MapGuide.Portable/OSGeo.MapGuide.Portable.csproj
   branches/4.0/MgDev/Portable/OSGeo.MapGuide.Viewer.Portable/OSGeo.MapGuide.Viewer.Portable.csproj
   branches/4.0/MgDev/Portable/OSGeo.MapGuide.Viewer.Portable/Properties/AssemblyInfo.cs
   branches/4.0/MgDev/Portable/OSGeo.MapGuide.Viewer/OSGeo.MapGuide.Viewer.csproj
   branches/4.0/MgDev/Portable/OSGeo.MapGuide.Viewer/Properties/AssemblyInfo.cs
Log:
Add README.md files for MgPortable and viewer packages. Also remove strong naming on viewer assemblies

Modified: branches/4.0/MgDev/Bindings/src/Managed/DotNet/OSGeo.MapGuide.Portable/OSGeo.MapGuide.Portable.csproj
===================================================================
--- branches/4.0/MgDev/Bindings/src/Managed/DotNet/OSGeo.MapGuide.Portable/OSGeo.MapGuide.Portable.csproj	2025-08-21 13:39:07 UTC (rev 10175)
+++ branches/4.0/MgDev/Bindings/src/Managed/DotNet/OSGeo.MapGuide.Portable/OSGeo.MapGuide.Portable.csproj	2025-08-21 16:07:01 UTC (rev 10176)
@@ -16,6 +16,8 @@
     <PackageLicenseExpression></PackageLicenseExpression>
     <PackageLicenseFile>License.txt</PackageLicenseFile>
     <Description>A portable implementation of the MapGuide platform and APIs for use in console/desktop applications.</Description>
+    <Title>MapGuide Portable</Title>
+    <PackageReadmeFile>README.md</PackageReadmeFile>
   </PropertyGroup>
 
   <PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Release|AnyCPU'">
@@ -41,37 +43,28 @@
   Visual Studio
   -->
   <ItemGroup>
-    <None Update="contentFiles\Platform.ini" 
-          Pack="true" 
-          PackagePath="contentFiles\any\any\Platform.ini">
+    <None Update="contentFiles\Platform.ini" Pack="true" PackagePath="contentFiles\any\any\Platform.ini">
       <PackageCopyToOutput>true</PackageCopyToOutput>
       <CopyToOutputDirectory>Always</CopyToOutputDirectory>
       <CopyToPublishDirectory>Always</CopyToPublishDirectory>
     </None>
-	<None Update="Dictionaries\*" 
-          Pack="true" 
-          PackagePath="contentFiles\any\any">
+    <None Include="README.md" Pack="true" PackagePath="" />
+	<None Update="Dictionaries\*" Pack="true" PackagePath="contentFiles\any\any">
       <PackageCopyToOutput>true</PackageCopyToOutput>
       <CopyToOutputDirectory>Always</CopyToOutputDirectory>
       <CopyToPublishDirectory>Always</CopyToPublishDirectory>
     </None>
-	<None Update="FDO\**\*" 
-          Pack="true" 
-          PackagePath="contentFiles\any\any">
+	<None Update="FDO\**\*" Pack="true" PackagePath="contentFiles\any\any">
       <PackageCopyToOutput>true</PackageCopyToOutput>
       <CopyToOutputDirectory>Always</CopyToOutputDirectory>
       <CopyToPublishDirectory>Always</CopyToPublishDirectory>
     </None>
-	<None Update="Resources\*" 
-          Pack="true" 
-          PackagePath="contentFiles\any\any">
+	<None Update="Resources\*" Pack="true" PackagePath="contentFiles\any\any">
       <PackageCopyToOutput>true</PackageCopyToOutput>
       <CopyToOutputDirectory>Always</CopyToOutputDirectory>
       <CopyToPublishDirectory>Always</CopyToPublishDirectory>
     </None>
-	<None Update="Schema\*" 
-          Pack="true" 
-          PackagePath="contentFiles\any\any">
+	<None Update="Schema\*" Pack="true" PackagePath="contentFiles\any\any">
       <PackageCopyToOutput>true</PackageCopyToOutput>
       <CopyToOutputDirectory>Always</CopyToOutputDirectory>
       <CopyToPublishDirectory>Always</CopyToPublishDirectory>

Added: branches/4.0/MgDev/Bindings/src/Managed/DotNet/OSGeo.MapGuide.Portable/README.md
===================================================================
--- branches/4.0/MgDev/Bindings/src/Managed/DotNet/OSGeo.MapGuide.Portable/README.md	                        (rev 0)
+++ branches/4.0/MgDev/Bindings/src/Managed/DotNet/OSGeo.MapGuide.Portable/README.md	2025-08-21 16:07:01 UTC (rev 10176)
@@ -0,0 +1,17 @@
+# MapGuide Portable
+
+MapGuide Portable (formerly known as `mg-desktop`) is a portable implementation of the MapGuide Platform that has no dependencies on a MapGuide Server or Web Tier.
+
+All the necessary components and services for building geospatial applications such as feature data access and map rendering/stylization are contained in the MapGuide Portable library itself.
+
+As such, MapGuide Portable is geared for building self-contained console/desktop geospatial applications.
+
+## Migrating your application from `mg-desktop`
+
+After removing `mg-desktop` and replacing it with this nuget package, the code migration process is simply renaming a bunch of classes and namespaces.
+
+ * The namespace is now `OSGeo.MapGuide.Portable` instead of `OSGeo.MapGuide.Desktop`
+ * Classes starting with `Mgd` now start with `MgPortable`
+	* eg. `MgPortableMap` instead of `MgdMap`
+
+After doing these code changes, your application should now build and run as before.
\ No newline at end of file

Modified: branches/4.0/MgDev/Portable/OSGeo.MapGuide.Viewer/OSGeo.MapGuide.Viewer.csproj
===================================================================
--- branches/4.0/MgDev/Portable/OSGeo.MapGuide.Viewer/OSGeo.MapGuide.Viewer.csproj	2025-08-21 13:39:07 UTC (rev 10175)
+++ branches/4.0/MgDev/Portable/OSGeo.MapGuide.Viewer/OSGeo.MapGuide.Viewer.csproj	2025-08-21 16:07:01 UTC (rev 10176)
@@ -16,6 +16,7 @@
 	<PackageLicenseExpression></PackageLicenseExpression>
     <PackageLicenseFile>License.txt</PackageLicenseFile>
     <Description>Base WinForms viewer component package for MapGuide</Description>
+    <PackageReadmeFile>README.md</PackageReadmeFile>
   </PropertyGroup>
 
   <PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|AnyCPU'">
@@ -41,6 +42,7 @@
   </ItemGroup>
 	
   <ItemGroup>
+	<None Include="README.md" Pack="true" PackagePath="" />
     <None Include="..\..\License.txt">
       <Pack>True</Pack>
       <PackagePath></PackagePath>
@@ -53,4 +55,11 @@
     <ProjectReference Include="..\..\Bindings\src\Managed\DotNet\OSGeo.MapGuide.PlatformBase\OSGeo.MapGuide.PlatformBase.csproj" />
   </ItemGroup>
 
+  <ItemGroup>
+    <None Update="README.md">
+      <Pack>True</Pack>
+      <PackagePath>\</PackagePath>
+    </None>
+  </ItemGroup>
+
 </Project>

Modified: branches/4.0/MgDev/Portable/OSGeo.MapGuide.Viewer/Properties/AssemblyInfo.cs
===================================================================
--- branches/4.0/MgDev/Portable/OSGeo.MapGuide.Viewer/Properties/AssemblyInfo.cs	2025-08-21 13:39:07 UTC (rev 10175)
+++ branches/4.0/MgDev/Portable/OSGeo.MapGuide.Viewer/Properties/AssemblyInfo.cs	2025-08-21 16:07:01 UTC (rev 10176)
@@ -33,6 +33,4 @@
 // by using the '*' as shown below:
 // [assembly: AssemblyVersion("4.0.0.0")]
 [assembly: AssemblyVersion("4.0.0.0")]
-[assembly: AssemblyFileVersion("4.0.0.0")]
-
-[assembly: AssemblyKeyFile("..\\PortableUnmanagedApi\\DotNet\\MgPortable.snk")]
+[assembly: AssemblyFileVersion("4.0.0.0")]
\ No newline at end of file

Added: branches/4.0/MgDev/Portable/OSGeo.MapGuide.Viewer/README.md
===================================================================
--- branches/4.0/MgDev/Portable/OSGeo.MapGuide.Viewer/README.md	                        (rev 0)
+++ branches/4.0/MgDev/Portable/OSGeo.MapGuide.Viewer/README.md	2025-08-21 16:07:01 UTC (rev 10176)
@@ -0,0 +1,15 @@
+# MapGuide Viewer Component Library
+
+This library provides the base Windows Forms viewer components 
+for building an interactive desktop map viewer application on the
+MapGuide Platform.
+
+By itself this library does nothing without a platform provider. You 
+require a platform provider package in addition to this package that 
+connects your map viewer components to the underlying MapGuide Platform
+that will provide the necessary services for rendering, feature querying, etc.
+
+Currently, there is only one platform provider package:
+
+ * `OSGeo.MapGuide.Viewer.Portable`
+	* Connects these map viewer components to the MapGuide Portable implementation of the MapGuide Platform.
\ No newline at end of file

Modified: branches/4.0/MgDev/Portable/OSGeo.MapGuide.Viewer.Portable/OSGeo.MapGuide.Viewer.Portable.csproj
===================================================================
--- branches/4.0/MgDev/Portable/OSGeo.MapGuide.Viewer.Portable/OSGeo.MapGuide.Viewer.Portable.csproj	2025-08-21 13:39:07 UTC (rev 10175)
+++ branches/4.0/MgDev/Portable/OSGeo.MapGuide.Viewer.Portable/OSGeo.MapGuide.Viewer.Portable.csproj	2025-08-21 16:07:01 UTC (rev 10176)
@@ -15,9 +15,11 @@
 	<PackageLicenseExpression></PackageLicenseExpression>
     <PackageLicenseFile>License.txt</PackageLicenseFile>
     <Description>Integrates the WinForms viewer package with MapGuide Portable</Description>
+    <PackageReadmeFile>README.md</PackageReadmeFile>
   </PropertyGroup>
 
   <ItemGroup>
+	<None Include="README.md" Pack="true" PackagePath="" />
     <None Include="..\..\License.txt">
       <Pack>True</Pack>
       <PackagePath></PackagePath>
@@ -37,5 +39,12 @@
     <ProjectReference Include="..\..\Bindings\src\Managed\DotNet\OSGeo.MapGuide.Portable\OSGeo.MapGuide.Portable.csproj" />
     <ProjectReference Include="..\OSGeo.MapGuide.Viewer\OSGeo.MapGuide.Viewer.csproj" />
   </ItemGroup>
+	
+  <ItemGroup>
+    <None Update="README.md">
+      <Pack>True</Pack>
+      <PackagePath>\</PackagePath>
+    </None>
+  </ItemGroup>
 
 </Project>

Modified: branches/4.0/MgDev/Portable/OSGeo.MapGuide.Viewer.Portable/Properties/AssemblyInfo.cs
===================================================================
--- branches/4.0/MgDev/Portable/OSGeo.MapGuide.Viewer.Portable/Properties/AssemblyInfo.cs	2025-08-21 13:39:07 UTC (rev 10175)
+++ branches/4.0/MgDev/Portable/OSGeo.MapGuide.Viewer.Portable/Properties/AssemblyInfo.cs	2025-08-21 16:07:01 UTC (rev 10176)
@@ -34,5 +34,3 @@
 // [assembly: AssemblyVersion("4.0.0.0")]
 [assembly: AssemblyVersion("4.0.0.0")]
 [assembly: AssemblyFileVersion("4.0.0.0")]
-
-[assembly: AssemblyKeyFile("..\\PortableUnmanagedApi\\DotNet\\MgPortable.snk")]

Added: branches/4.0/MgDev/Portable/OSGeo.MapGuide.Viewer.Portable/README.md
===================================================================
--- branches/4.0/MgDev/Portable/OSGeo.MapGuide.Viewer.Portable/README.md	                        (rev 0)
+++ branches/4.0/MgDev/Portable/OSGeo.MapGuide.Viewer.Portable/README.md	2025-08-21 16:07:01 UTC (rev 10176)
@@ -0,0 +1,4 @@
+# MapGuide Portable Platform Provider for the MapGuide Viewer Component Library
+
+This package is the platform provider for the MapGuide Viewer Component Library 
+that connects it to the services provided by MapGuide Portable.
\ No newline at end of file



More information about the mapguide-commits mailing list