.NET MAUI安卓应用发布版GIF动画失效问题求助

问题描述 #

基于.NET MAUI开发的安卓图片转换应用，Debug模式下所有功能正常，GIF动画可在自定义查看器播放；但发布到Google Play内部测试渠道后，自定义图片查看器显示空白，GIF无法播放。直接进入应用文件目录选择生成的GIF文件却能正常播放。

可能原因 #

1. 发布模式链接器优化：默认发布模式下的链接器会裁剪未被直接引用的代码，可能导致MAUI处理GIF的相关组件被移除，影响Image控件加载和播放GIF。
2. 动画触发逻辑依赖不稳定：原ViewModel中在IsAnimationGif的getter里通过DispatcherTimer延迟触发动画，发布模式下getter的调用时机或Timer执行可能被优化，导致动画未正确激活。
3. 文件路径解析差异：Debug和发布模式下应用的文件访问路径、权限处理存在差异，可能导致Image控件无法正确解析绑定的PathImage路径。

解决方案 #

1. 调整链接器设置，保留必要组件 #

在Android项目的发布配置中，修改链接器行为避免裁剪MAUI图片处理相关代码：

• 打开Android项目属性 → 发布 → 链接器行为，选择Sdk Only（而非Sdk and User Assemblies）。
• 如果问题仍存在，创建Linker.xml文件添加保留规则：

<linker>
  <assembly fullname="Microsoft.Maui.Controls" />
  <assembly fullname="Microsoft.Maui.Graphics" />
</linker>

2. 优化GIF动画触发逻辑 #

移除原ViewModel中依赖DispatcherTimer的延迟触发逻辑，改为在ViewModel初始化时直接判断并激活动画，避免依赖getter调用时机：

public class ViewImageModel : BasePageImageModel, INotifyPropertyChanged
{
    public event PropertyChangedEventHandler PropertyChanged;

    void OnPropertyChanged([CallerMemberName] string propertyName = null) 
        => PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(propertyName));

    private bool _isAnimationGif = false;

    public bool IsAnimationGif
    {
        get => _isAnimationGif;
        set
        {
            _isAnimationGif = value;
            OnPropertyChanged(nameof(IsAnimationGif));
        }
    }

    public ViewImageModel()
    {
        // 确保PathImage已完成赋值后判断
        if (!string.IsNullOrEmpty(PathImage?.ToString()) && PathImage.PegaExtensao().Contains("gif"))
        {
            IsAnimationGif = true;
        }
    }
}

3. 修正Image控件绑定配置 #

调整XAML中Image控件的IsAnimationPlaying绑定模式为OneWay（无需双向绑定），并确保Source绑定正确解析本地文件：

<Image Grid.Row="0" 
       Source="{Binding PathImage}" 
       IsAnimationPlaying="{Binding IsAnimationGif, Mode=OneWay}"  
       Aspect="AspectFit" 
       Margin="2,3,2,3"/>

4. 验证文件路径与权限 #

• 确认PathImage使用绝对文件路径或正确的文件URI格式（如file:///storage/emulated/0/...）。
• 检查AndroidManifest.xml中是否添加了必要的文件访问权限：

<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" android:maxSdkVersion="32" />

内容的提问来源于stack exchange，提问作者Leonardo Silva