Xamarin Forms项目如何通过FFImageLoading.Svg.Forms引用外部程序集SVG资源

嘿，我帮你梳理一下从外部类库加载SVG资源的关键步骤和常见踩坑点，应该能解决你的问题：

一、先确认基础配置是否到位 #

• 检查SVG文件的嵌入资源设置：
  打开你的.NET Standard类库，选中每个SVG文件右键查看「属性」，确保生成操作设置为Embedded resource。另外要注意资源的命名规则：如果SVG放在类库的Resources/Svgs文件夹下，类库名为MySvgLib，那么资源的完整名称是MySvgLib.Resources.Svgs.your-icon.svg（用点分隔文件夹层级，不是斜杠）。

• 对齐FFImageLoading的NuGet引用：
  你的Xamarin Forms主项目需要安装FFImageLoading.Forms和FFImageLoading.Svg.Forms，而外部类库也得装FFImageLoading.Svg（用来解析SVG），所有相关包的版本必须完全一致，不然容易出兼容性问题。

二、正确构造资源URI #

按照文档的格式，URI的结构是：

resource://[完整资源名称]?assembly=[类库的完整程序集名称]

举个实际例子：
如果你的类库完整程序集名称是MySvgLib, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null（可以通过代码typeof(MySvgLib.SomeClass).Assembly.FullName获取），SVG的完整资源名是MySvgLib.Resources.logo.svg，那么最终的URI就是：

resource://MySvgLib.Resources.logo.svg?assembly=MySvgLib, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null

如果你的类库没有强签名，也可以简化成assembly=MySvgLib，但用完整名称能避免程序集冲突。

三、XAML中使用示例 #

先在XAML头部引入FFImageLoading的命名空间：

xmlns:ffsvg="clr-namespace:FFImageLoading.Svg.Forms;assembly=FFImageLoading.Svg.Forms"

然后用SvgCachedImage控件加载：

<ffsvg:SvgCachedImage 
    Source="resource://MySvgLib.Resources.logo.svg?assembly=MySvgLib"
    WidthRequest="120"
    HeightRequest="120"
    Aspect="AspectFit" />

四、常见问题排查 #

如果还是加载失败，可以从这几个方向检查：

• 资源名称大小写问题：iOS和Android是大小写敏感的，确保URI里的资源名和实际文件的大小写完全一致。
• 程序集名称错误：直接在主项目里写一行代码打印程序集全名，比如在App.xaml.cs的OnStart里加：

  System.Diagnostics.Debug.WriteLine(typeof(MySvgLib.Class1).Assembly.FullName);
  

  然后看输出窗口的内容，把这个完整名称放到URI的assembly=后面。
• 初始化缺失：别忘了在平台项目里初始化FFImageLoading：
  • Android：在MainActivity.cs的OnCreate方法里加FFImageLoading.Forms.Platform.CachedImageRenderer.Init(true);和FFImageLoading.Svg.Forms.SvgCachedImage.Init();
  • iOS：在AppDelegate.cs的FinishedLaunching方法里加FFImageLoading.Forms.Platform.CachedImageRenderer.Init();和FFImageLoading.Svg.Forms.SvgCachedImage.Init();
  • 主项目的App.xaml.cs里也可以加一遍初始化代码，确保万无一失。

内容的提问来源于stack exchange，提问作者Spook Kruger