Migrating from SkiaSharp.Extended.Svg to Svg.Skia

Overview

SkiaSharp.Extended.Svg has been deprecated and is no longer maintained. Due to breaking changes in SkiaSharp (specifically the removal of SKMatrix.MakeTranslation method), the old library is incompatible with .NET 9 and recent versions of SkiaSharp.

The recommended migration path is to use the Svg.Skia library, which is actively maintained and fully compatible with modern SkiaSharp versions.

Why Migrate?

⚠️ SkiaSharp.Extended.Svg is no longer maintained
❌ Incompatible with .NET 9 and recent SkiaSharp versions
🚫 Causes runtime errors: MissingMethodException: Method not found: SkiaSharp.SKMatrix.MakeTranslation
✅ Svg.Skia is actively maintained with regular updates
✅ Full SVG specification support
✅ Compatible with latest SkiaSharp releases

Migration Steps

1. Update NuGet Packages

Remove the old package and install Svg.Skia:

# Remove the old package
dotnet remove package SkiaSharp.Extended.Svg

# Add Svg.Skia
dotnet add package Svg.Skia

2. Update Using Statements

Replace the old namespace with the new one:

// OLD - Remove this
using SkiaSharp.Extended.Svg;

// NEW - Add this
using Svg.Skia;

3. Update Code Usage

The good news is that Svg.Skia provides a very similar API, so most code will work with minimal changes:

Loading SVG from Stream

// Both old and new code look the same!
var svg = new SKSvg();

using (var stream = GetType().Assembly.GetManifestResourceStream(resourceId))
{
    if (stream != null)
    {
        svg.Load(stream);
    }
}

Drawing SVG on Canvas

// Drawing the SVG picture
if (svg?.Picture != null)
{
    canvas.Clear(SKColors.White);
    
    // Calculate scaling to fit canvas
    var canvasMin = Math.Min(width, height);
    var svgMax = Math.Max(svg.Picture.CullRect.Width, svg.Picture.CullRect.Height);
    var scale = canvasMin / svgMax;
    var matrix = SKMatrix.CreateScale(scale, scale);
    
    canvas.DrawPicture(svg.Picture, matrix);
}

Common Issues and Solutions

Issue: MissingMethodException for MakeTranslation

Error:

System.MissingMethodException: Method not found: 
SkiaSharp.SKMatrix SkiaSharp.SKMatrix.MakeTranslation(single,single)

Solution: This error occurs when using SkiaSharp.Extended.Svg with modern SkiaSharp versions. Migrate to Svg.Skia as described above.

Issue: Package Version Conflicts

If you're experiencing package conflicts, ensure all SkiaSharp-related packages are aligned to compatible versions:

<PackageReference Include="SkiaSharp" Version="3.119.0" />
<PackageReference Include="SkiaSharp.Views.Maui.Controls" Version="3.119.0" />
<PackageReference Include="Svg.Skia" Version="3.4.1" />

Example: Complete Migration

Before (SkiaSharp.Extended.Svg)

using SkiaSharp;
using SkiaSharp.Extended.Svg;
using SkiaSharp.Views.Maui;
using SkiaSharp.Views.Maui.Controls;

namespace MyApp
{
    public partial class MyPage : ContentPage
    {
        private SKSvg? svg;

        private void LoadSvg()
        {
            svg = new SKSvg();
            using var stream = FileSystem.OpenAppPackageFileAsync("image.svg").Result;
            svg.Load(stream);
        }

        private void OnPaintSurface(object sender, SKPaintSurfaceEventArgs e)
        {
            var canvas = e.Surface.Canvas;
            canvas.Clear(SKColors.White);
            
            if (svg?.Picture != null)
            {
                canvas.DrawPicture(svg.Picture);
            }
        }
    }
}

After (Svg.Skia)

using SkiaSharp;
using Svg.Skia;  // Changed this line
using SkiaSharp.Views.Maui;
using SkiaSharp.Views.Maui.Controls;

namespace MyApp
{
    public partial class MyPage : ContentPage
    {
        private SKSvg? svg;

        private void LoadSvg()
        {
            svg = new SKSvg();
            using var stream = FileSystem.OpenAppPackageFileAsync("image.svg").Result;
            svg.Load(stream);  // Same API!
        }

        private void OnPaintSurface(object sender, SKPaintSurfaceEventArgs e)
        {
            var canvas = e.Surface.Canvas;
            canvas.Clear(SKColors.White);
            
            if (svg?.Picture != null)
            {
                canvas.DrawPicture(svg.Picture);  // Same API!
            }
        }
    }
}

Additional Resources

Need Help?

If you encounter issues during migration:

Check that all SkiaSharp packages are using compatible versions
Review the Svg.Skia examples
Open an issue on the Svg.Skia repository for library-specific questions
Open an issue on the SkiaSharp.Extended repository for general guidance

Table of Contents