Xamarin中ConvertFormsToNative无法返回真实原生元素致Spotlight功能异常

问题1：引导动画从页面左上角触发的解决方案 #

该问题是因为你的ConvertFormsToNative方法创建了全新的原生View实例，并非页面上实际渲染的按钮对应的原生控件，同时未将控件相对父容器的坐标转换为屏幕绝对坐标，导致Spotlight库无法获取正确的目标位置。
修改ConvertFormsToNative方法如下：

public View ConvertFormsToNative(Xamarin.Forms.View view)
{
    // 获取页面上已经渲染的原生控件实例，不要新建实例
    var renderer = Platform.GetRenderer(view);
    if (renderer == null)
    {
        renderer = Platform.CreateRendererWithContext(view, MainActivity.Instance);
        Platform.SetRenderer(view, renderer);
    }
    var nativeView = renderer.View;
    // 计算控件在屏幕上的绝对坐标
    int[] location = new int[2];
    nativeView.GetLocationOnScreen(location);
    return nativeView;
}

问题2：聚光灯引导未按顺序触发的解决方案 #

该问题是因为你将三个引导的触发方法都绑定到了LayoutChanged事件，页面布局完成时三个方法会几乎同时执行，且没有监听前一个引导的消失事件，无法实现顺序触发。

第一步：修改ISpotLight接口，添加消失回调参数 #

public interface ISpotLight
{
    void ShowSpotLight_FirstButton(Xamarin.Forms.View view, string usageId, Action onDismiss = null);
    void ShowSpotLight_SecondButton(Xamarin.Forms.View view, string usageId, Action onDismiss = null);
    void ShowSpotLight_ThirdButton(Xamarin.Forms.View view, string usageId, Action onDismiss = null);
}

第二步：修改SpotLightService的Show方法，添加消失监听 #

以ShowSpotLight_FirstButton为例，其余两个方法做相同修改：

public void ShowSpotLight_FirstButton(Xamarin.Forms.View view, string usageId, Action onDismiss = null)
{
    FirstButton_SpotLight = new SpotlightView.Builder(MainActivity.Instance)
        // 原有配置项保持不变
        .ShowTargetArc(true)
        .Show();
    // 监听引导消失事件，触发回调
    FirstButton_SpotLight.SpotlightDismissListener += (s, e) =>
    {
        onDismiss?.Invoke();
    };
}

第三步：修改MainPage.xaml.cs逻辑，实现顺序触发 #

public partial class MainPage : ContentPage
{
    bool isGuideStarted = false;
    public MainPage()
    {
        InitializeComponent();
        LayoutChanged += OnLayoutCompleted;
    }

    private void OnLayoutCompleted(object sender, EventArgs e)
    {
        if (!isGuideStarted)
        {
            isGuideStarted = true;
            // 先显示第一个引导
            DependencyService.Get<ISpotLight>().ShowSpotLight_FirstButton(FirstButton, "FirstButton", () =>
            {
                // 第一个引导消失后显示第二个
                DependencyService.Get<ISpotLight>().ShowSpotLight_SecondButton(SecondButton, "SecondButton", () =>
                {
                    // 第二个引导消失后显示第三个
                    DependencyService.Get<ISpotLight>().ShowSpotLight_ThirdButton(ThirdButton, "ThirdButton");
                });
            });
            // 解绑事件避免重复触发
            LayoutChanged -= OnLayoutCompleted;
        }
    }
}

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