.NET MAUI设置VisualState.Setters修改Label.Text致安卓页面崩溃

在.NET MAUI的XAML页面中，尝试通过Switch控件的VisualState.Setters修改同级Label的Text值，该功能在模拟器和调试模式下可正常运行，但安卓发布版安装后打开页面直接崩溃。注释掉针对Label的Setter代码后，页面恢复正常。

复现代码片段：

<HorizontalStackLayout Grid.Row="2" Grid.Column="0" Margin="5" Spacing="7" BackgroundColor="White" HeightRequest="50">
    <!-- Automatic-Manual -->
    <VerticalStackLayout Margin="2" >
        <Label x:Name="LblAutoMan" Text="Automatic" VerticalOptions="Start" HorizontalOptions="Center" HeightRequest="20" WidthRequest="65"/>
        <Switch IsToggled="True" HorizontalOptions="Start" VerticalOptions="Center" HeightRequest="10">
            <VisualStateManager.VisualStateGroups>
                <VisualStateGroup Name="CommonStates">
                    <VisualState Name="On">
                        <VisualState.Setters>
                            <Setter Property="ThumbColor" Value="Green" />
                            <Setter TargetName="LblAutoMan" Property="Label.Text" Value="Automatic" /> 
                        </VisualState.Setters>
                    </VisualState>
                    <VisualState Name="Off">
                        <VisualState.Setters>
                            <Setter Property="ThumbColor" Value="Red" />
                            <Setter TargetName="LblAutoMan" Property="Label.Text" Value="Manual" /> 
                        </VisualState.Setters>
                    </VisualState>
                </VisualStateGroup>
            </VisualStateManager.VisualStateGroups>
        </Switch>
    </VerticalStackLayout>
</HorizontalStackLayout>

解决方法 #

方法1：将VisualStateGroup移至父容器 #

把VisualStateManager.VisualStateGroups从Switch移到父级VerticalStackLayout上，通过Switch的IsToggled状态作为触发器，避免跨控件引用在发布版被链接器误删：

<VerticalStackLayout Margin="2">
    <VisualStateManager.VisualStateGroups>
        <VisualStateGroup Name="ToggleStates">
            <VisualState Name="Auto">
                <VisualState.StateTriggers>
                    <StateTrigger IsActive="{Binding Source={x:Reference SwitchAutoMan}, Path=IsToggled}" />
                </VisualState.StateTriggers>
                <VisualState.Setters>
                    <Setter TargetName="SwitchAutoMan" Property="ThumbColor" Value="Green" />
                    <Setter TargetName="LblAutoMan" Property="Text" Value="Automatic" />
                </VisualState.Setters>
            </VisualState>
            <VisualState Name="Manual">
                <VisualState.StateTriggers>
                    <StateTrigger IsActive="{Binding Source={x:Reference SwitchAutoMan}, Path=IsToggled, Converter={StaticResource InverseBoolConverter}}" />
                </VisualState.StateTriggers>
                <VisualState.Setters>
                    <Setter TargetName="SwitchAutoMan" Property="ThumbColor" Value="Red" />
                    <Setter TargetName="LblAutoMan" Property="Text" Value="Manual" />
                </VisualState.Setters>
            </VisualState>
        </VisualStateGroup>
    </VisualStateManager.VisualStateGroups>
    <Label x:Name="LblAutoMan" Text="Automatic" VerticalOptions="Start" HorizontalOptions="Center" HeightRequest="20" WidthRequest="65"/>
    <Switch x:Name="SwitchAutoMan" IsToggled="True" HorizontalOptions="Start" VerticalOptions="Center" HeightRequest="10"/>
</VerticalStackLayout>

需要先定义布尔反转转换器并注册：

public class InverseBoolConverter : IValueConverter
{
    public object Convert(object value, Type targetType, object parameter, CultureInfo culture)
    {
        return !(bool)value;
    }

    public object ConvertBack(object value, Type targetType, object parameter, CultureInfo culture)
    {
        return !(bool)value;
    }
}

在页面资源中注册转换器：

<ContentPage.Resources>
    <local:InverseBoolConverter x:Key="InverseBoolConverter" />
</ContentPage.Resources>

方法2：通过代码处理Toggled事件 #

直接在后台代码中绑定Switch的Toggled事件，这种方式在发布版中稳定性更高：

XAML部分：

<VerticalStackLayout Margin="2">
    <Label x:Name="LblAutoMan" Text="Automatic" VerticalOptions="Start" HorizontalOptions="Center" HeightRequest="20" WidthRequest="65"/>
    <Switch x:Name="SwitchAutoMan" IsToggled="True" HorizontalOptions="Start" VerticalOptions="Center" HeightRequest="10" Toggled="SwitchAutoMan_Toggled"/>
</VerticalStackLayout>

后台代码：

private void SwitchAutoMan_Toggled(object sender, ToggledEventArgs e)
{
    if (e.Value)
    {
        LblAutoMan.Text = "Automatic";
        SwitchAutoMan.ThumbColor = Colors.Green;
    }
    else
    {
        LblAutoMan.Text = "Manual";
        SwitchAutoMan.ThumbColor = Colors.Red;
    }
}

问题原因 #

安卓发布版默认启用了链接器（Linker），它会移除识别为“未使用”的代码或控件引用。Switch的VisualState中跨控件引用Label时，链接器无法识别这种依赖关系，导致运行时找不到目标控件LblAutoMan，最终引发崩溃。调试模式下链接器未启用，因此功能正常。

内容的提问来源于stack exchange，提问作者jay mack