VS2019中Xamarin.Android布局渲染自定义TextView异常问题求解

问题产生原因 #

• 核心问题是Visual Studio的Android布局设计器在预览自定义控件时，不会执行App的全局初始化逻辑，仅会单独实例化自定义控件本身，导致以下依赖未初始化触发空引用异常：
  1. 全局外观管理类AppearanceManager的LoadDefaultAppearance()方法通常是在Application或MainActivity的启动生命周期中调用，预览阶段未执行，所有颜色、字体相关的静态属性没有被赋值，或其依赖的LocalResourceProvider无法在设计时环境中获取到App资源上下文，调用GetFont()、GetDimension()、GetColor()等方法时抛出空引用。
  2. 自定义控件TextViewCustom的Initialize()方法中直接访问了未初始化的AppearanceManager相关属性，没有做设计时场景的兼容。

解决方案 #

方案1：添加设计时判断（最简便，优先推荐） #

在TextViewCustom的Initialize()方法最开头加入设计时状态判断，预览阶段直接使用默认TextView样式，不调用自定义外观逻辑：

private void Initialize(Context context, IAttributeSet attrs = null)
{
    // 设计器预览场景直接返回，使用默认样式避免报错
    if (IsInEditMode)
    {
        SetTextColor(Color.Black);
        SetTextSize(ComplexUnitType.Sp, 14);
        return;
    }

    // 原有逻辑保持不变
    color = AppearanceManager.ColorPrimary;
    customFont = AppearanceManager.Typeface;
    // ... 其余原有代码
}

方案2：兼容全局管理类的设计时场景 #

如果需要在设计器中也能预览自定义样式，可以给AppearanceManager添加设计时兼容逻辑，避免调用资源相关方法：

1. 首先给AppearanceManager添加静态构造函数，在设计时环境下直接赋值默认值，不读取App资源：

static AppearanceManager()
{
    // 判断是否处于设计时环境，提前赋值默认值
    if (Environment.StackTrace.Contains("Xamarin.Designer"))
    {
        ColorPrimary = Color.Black;
        ColorPrimaryDark = Color.DarkGray;
        ColorSecundary = Color.Gray;
        // 其余属性赋值默认值
        _customAppearance = null;
        return;
    }
}

2. 给LocalResourceProvider的所有资源读取方法加空校验，拿不到资源时返回默认值，避免抛出空引用异常。

验证方式 #

修改完成后重新生成整个项目，再打开布局设计器即可正常预览，运行时不会影响原有自定义外观的逻辑效果。

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