Включение закодированных тестов пользовательского интерфейса для элементов управления

Статья
06/08/2015

Элемент управления проще тестировать при реализации поддержки среды обработки закодированных тестов пользовательского интерфейса.Вы можете последовательно добавлять повышение уровней поддержки.Начать можно с поддержки проверки записи, воспроизведения и свойств.Это можно использовать, чтобы разрешить построителю закодированных тестов пользовательского интерфейса распознавать пользовательские свойства элемента управления, а также давать пользовательским классам возможность получить доступ к этим свойствам из созданного кода.Вы также можете помочь построителю закодированных тестов пользовательского интерфейса захватывать действия способом, который в большей степени соответствует цели записываемого действия.

Содержание раздела

CUIT_Full

Поддержка записи, воспроизведения и проверки свойства путем реализации специальных возможностей

Построитель закодированных тестов пользовательского интерфейса собирает сведения об элементах управления, которые он обнаруживает во время записи, а затем создает код для повторения этого сеанса.Если элемент управления не поддерживает специальные возможности, построитель закодированных тестов пользовательского интерфейса захватывает действия (например, щелчки мышью) с помощью координат экрана.Созданный код выводит эти щелчки мышью в тех же экранных координатах при воспроизведении теста.Если во время воспроизведения теста элемент управления отображается в другом месте на экране, созданный код не сможет выполнить это действие на элементе управления.Это может привести к сбоям, если тест воспроизводится при различных конфигурациях экрана, в разных средах или после внесения изменений в макет пользовательского интерфейса.

CUIT_RecordNoSupport

Однако при реализации специальных возможностей построитель закодированных тестов пользовательского интерфейса будет использовать их для того, чтобы получить сведения об элементе управления во время записи теста и создания кода.Затем, при выполнении теста, созданный код повторит эти события для элемента управления, даже если он находится где-либо еще в интерфейсе пользователя.Авторы теста могут также создавать утверждения благодаря использованию основных свойств элемента управления.

CUIT_Record

Поддержка записи, воспроизведения, проверки свойств и навигации для элемента управления Windows Forms

Реализуйте специальные возможности для элемента управления согласно описанной ниже процедуре. Подробные пояснения см. в разделе AccessibleObject.

CUIT_Accessible

Реализуйте производный от ControlAccessibleObject класс и переопределите свойство AccessibilityObject для возврата объекта класса.

public partial class ChartControl : UserControl
{
    // Overridden to return the custom AccessibleObject for the control.
    protected override AccessibleObject CreateAccessibilityInstance()
    {
        return new ChartControlAccessibleObject(this);
    }

    // Inner class ChartControlAccessibleObject represents accessible information
    // associated with the ChartControl and is used when recording tests.
    public class ChartControlAccessibleObject : ControlAccessibleObject
    {
        ChartControl myControl;
        public ChartControlAccessibleObject(ChartControl ctrl)
            : base(ctrl)
        {
            myControl = ctrl;
        }
    }
}

Переопределите свойства, методы и Role, State, GetChild GetChildCount объекта специальных возможностей.
Реализуйте другой объект специальных возможностей для дочернего элемента управления и переопределите свойство дочернего элемента управления AccessibilityObject для получения этого объекта специальных возможностей.
Переопределите свойства, методы и Bounds, Name, Parent, Role, State, Navigate, Select объекта специальных возможностей дочернего элемента управления.

Примечание
Этот раздел начинается с примера специальных возможностей в AccessibleObject в этой процедуре, а затем берется в основу остальных процедур.Если вам требуется создать рабочую версию образца специальных возможностей, создайте консольное приложение, а затем замените код в файле Program.cs на пример кода.Необходимо добавить ссылки на Accessibility, System.Drawing и System.Windows.Forms.Вы должны изменить Внедрить типы взаимодействия для Accessibility на значение False, чтобы исключить предупреждение сборки.Можно изменить тип выходных данных проекта из консольного приложения на приложение Windows, чтобы окно консоли не отображалось при запуске приложения.

Этот раздел начинается с примера специальных возможностей в AccessibleObject в этой процедуре, а затем берется в основу остальных процедур.Если вам требуется создать рабочую версию образца специальных возможностей, создайте консольное приложение, а затем замените код в файле Program.cs на пример кода.Необходимо добавить ссылки на Accessibility, System.Drawing и System.Windows.Forms.Вы должны изменить Внедрить типы взаимодействия для Accessibility на значение False, чтобы исключить предупреждение сборки.Можно изменить тип выходных данных проекта из консольного приложения на приложение Windows, чтобы окно консоли не отображалось при запуске приложения.

Поддержка проверки пользовательского свойства путем реализации поставщика свойства

После реализации базовой поддержки проверки записи, воспроизведения и свойств вы можете сделать пользовательские свойства элемента управления доступными закодированным тестам пользовательского интерфейса путем реализации подключаемого модуля UITestPropertyProvider.Например, в следующей процедуре создается поставщик свойства, позволяющий закодированным тестам пользовательского интерфейса получать доступ к свойству состояния дочерних элементов управления CurveLegend элемента управления диаграммы.

CUIT_CustomProps

Поддержка проверки пользовательского свойства

CUIT_Props

Переопределите свойство Description объекта специальных возможностей легенды кривой, чтобы передать форматируемые значения свойств в строку описания, отделенную точкой с запятой (;) от основного описания (или друг от друга, если реализуются несколько свойств).
```
public class CurveLegendAccessibleObject : AccessibleObject
{
    // add the state property value to the description
    public override string Description
    {
        get
        {
            // Add “;” and the state value to the end
            // of the curve legend’s description
            return "CurveLegend; " + State.ToString();
        }
    }
}
```
Создайте пакет расширений тестов пользовательского интерфейса для пользовательского элемента управления, создав проект библиотеки классов, и добавьте ссылки на Accessibility, Microsoft.VisualStudio.TestTools.UITesting, Microsoft.VisualStudio.TestTools.UITest.Common и Microsoft.VisualStudio.TestTools.Extension.Измените Внедрить типы взаимодействия для Accessibility на значение False.

Добавьте класс поставщика свойства, который является производным от UITestPropertyProvider.

using System;
using System.Collections.Generic;
using Accessibility;
using Microsoft.VisualStudio.TestTools.UITesting;
using Microsoft.VisualStudio.TestTools.UITest.Extension;
using Microsoft.VisualStudio.TestTools.UITesting.WinControls;
using Microsoft.VisualStudio.TestTools.UITest.Common;

namespace ChartControlExtensionPackage
{
    public class ChartControlPropertyProvider : UITestPropertyProvider
    {
    }
}

Реализуйте поставщик свойства, установив имена свойств и дескрипторы свойств в Dictionary.

// Define a map of property descriptors for CurveLegend
private static Dictionary<string, UITestPropertyDescriptor> curveLegendPropertiesMap = null;
private static Dictionary<string, UITestPropertyDescriptor> CurveLegendPropertiesMap
{
    get
    {
        if (curveLegendPropertiesMap == null)
        {
            UITestPropertyAttributes read =
                UITestPropertyAttributes.Readable |
                UITestPropertyAttributes.DoNotGenerateProperties;
            curveLegendPropertiesMap =
                new Dictionary<string, UITestPropertyDescriptor>
                    (StringComparer.OrdinalIgnoreCase);
            curveLegendPropertiesMap.Add("State",
                new UITestPropertyDescriptor(typeof(string), read));
        }
        return curveLegendPropertiesMap;
    }
}

// return the property descriptor
public override UITestPropertyDescriptor GetPropertyDescriptor(UITestControl uiTestControl, string propertyName)
{
    return CurveLegendPropertiesMap[propertyName];
}

// return the property names
public override ICollection<string> GetPropertyNames(UITestControl uiTestControl)
{
    if (uiTestControl.ControlType.NameEquals("Chart") || uiTestControl.ControlType.NameEquals("Text"))
    {
        // the keys of the property map are the collection of property names
        return CurveLegendPropertiesMap.Keys;
    }

    // this is not my control
    throw new NotSupportedException();
}

// Get the property value by parsing the accessible description
public override object GetPropertyValue(UITestControl uiTestControl, string propertyName)
{
    if (String.Equals(propertyName, "State", StringComparison.OrdinalIgnoreCase))
    {
        object[] native = uiTestControl.NativeElement as object[];
        IAccessible acc = native[0] as IAccessible;

        string[] descriptionTokens = acc.accDescription.Split(new char[] { ';' });
        return descriptionTokens[1];
    }

    // this is not my control
    throw new NotSupportedException();
}

Переопределите UITestPropertyProvider.GetControlSupportLevel, чтобы указать, что сборка обеспечивает поддержку отдельного элемента управления для элемента управления и его дочерних элементов.

public override int GetControlSupportLevel(UITestControl uiTestControl)
{
    // For MSAA, check the control type
    if (string.Equals(uiTestControl.TechnologyName, "MSAA",
        StringComparison.OrdinalIgnoreCase) &&
        (uiTestControl.ControlType == "Chart"||uiTestControl.ControlType == "Text"))
    {
        return (int)ControlSupport.ControlSpecificSupport;
    }

    // This is not my control, so return NoSupport
    return (int)ControlSupport.NoSupport;
}

Переопределите оставшиеся абстрактные методы UITestPropertyProvider.

public override string[] GetPredefinedSearchProperties(Type specializedClass)
{
    throw new NotImplementedException();
}

public override Type GetSpecializedClass(UITestControl uiTestControl)
{
    throw new NotImplementedException();
}

public override Type GetPropertyNamesClassType(UITestControl uiTestControl)
{
    throw new NotImplementedException();
}

public override void SetPropertyValue(UITestControl uiTestControl, string propertyName, object value)
{
    throw new NotImplementedException();
}

public override string GetPropertyForAction(UITestControl uiTestControl, UITestAction action)
{
    throw new NotImplementedException();
}

public override string[] GetPropertyForControlState(UITestControl uiTestControl, ControlStates uiState, out bool[] stateValues)
{
    throw new NotImplementedException();
}

Добавьте класс пакета расширений, который является производным от UITestExtensionPackage.

using System;
using Microsoft.VisualStudio.TestTools.UITesting;
using Microsoft.VisualStudio.TestTools.UITest.Extension;
using Microsoft.VisualStudio.TestTools.UITest.Common;

namespace ChartControlExtensionPackage
{
    internal class ChartControlExtensionPackage : UITestExtensionPackage
    {
    }
}

Задайте атрибут UITestExtensionPackage для сборки.

[assembly: Microsoft.VisualStudio.TestTools.UITest.Extension.UITestExtensionPackage(
                "ChartControlExtensionPackage",
                typeof(ChartControlExtensionPackage.ChartControlExtensionPackage))]
namespace ChartControlExtensionPackage
{
   …

В классе пакета расширений переопределите UITestExtensionPackage.GetService, чтобы возвратить класс поставщика свойства, когда будет запрошен поставщик свойства.

internal class ChartControlExtensionPackage : UITestExtensionPackage
{
    public override object GetService(Type serviceType)
    {
        if (serviceType == typeof(UITestPropertyProvider))
        {
            if (propertyProvider == null)
            {
                propertyProvider = new ChartControlPropertyProvider();
            }
            return propertyProvider;
        }
        return null;
    }

    private UITestPropertyProvider propertyProvider = null;
}

Переопределите оставшиеся абстрактные методы и свойства UITestExtensionPackage.

public override void Dispose() { }

public override string PackageDescription
{
    get { return "Supports coded UI testing of ChartControl"; }
}

public override string PackageName
{
    get { return "ChartControl Test Extension"; }
}

public override string PackageVendor
{
    get { return "Microsoft (sample)"; }
}

public override Version PackageVersion
{
    get { return new Version(1, 0); }
}

public override Version VSVersion
{
    get { return new Version(10, 0); }
}

Выполните сборку двоичных файлов и скопируйте их в %ProgramFiles%\Common Files\Microsoft Shared\VSTT\10.0\UITestExtensionPackages.

Примечание
Этот пакет расширений будет применяться к любому элементу управления типа "Текст".Если вы тестируете несколько элементов управления одного типа, то необходимо тестировать их поодиночке, указывая во время записи тестов, какие пакеты расширений развертывать.

Этот пакет расширений будет применяться к любому элементу управления типа "Текст".Если вы тестируете несколько элементов управления одного типа, то необходимо тестировать их поодиночке, указывая во время записи тестов, какие пакеты расширений развертывать.

Поддержка создания кода путем реализации класса для доступа к пользовательским свойствам

Когда построитель закодированных тестов пользовательского интерфейса создает код из записи сеанса, он использует класс UITestControl для получения доступа к элементам управления.

UITestControl uIAText = this.UIItemWindow.UIChartControlWindow.UIAText;
Assert.AreEqual(this.AssertMethod3ExpectedValues.UIATextState, uIAText.GetProperty("State").ToString());

При реализации поставщика свойства для предоставления доступа к пользовательским свойствам элемента управления можно добавить специализированный класс, используемый для доступа к этим свойствам, что упростит создаваемый код.

ControlLegend uIAText = this.UIItemWindow.UIChartControlWindow.UIAText;
Assert.AreEqual(this.AssertMethod3ExpectedValues.UIATextState, uIAText.State);

Добавление специализированного класса для доступа к элементу управления

CUIT_CodeGen

Реализуйте класс, производный от WinControl, и добавьте тип элемента управления к коллекции свойств поиска в конструкторе.

public class CurveLegend:WinControl 
{
   public CurveLegend(UITestControl c) : base(c) 
   {
      // The curve legend control is a “text” type of control
      SearchProperties.Add(
         UITestControl.PropertyNames.ControlType, "Text");
   }
}

Реализуйте пользовательские свойства элемента управления как свойства класса.
```
public virtual string State
{
    get
    {
        return (string)GetProperty("State");
    }
}
```

Переопределите метод UITestPropertyProvider.GetSpecializedClass поставщика свойства для возврата типа нового класса для дочерних элементов управления легенды кривой.

public override Type GetSpecializedClass(UITestControl uiTestControl) 
{ 
   if (uiTestControl.ControlType.NameEquals("Text")) 
   { 
      // This is text type of control. For my control,
      // that means it’s a curve legend control.
      return typeof(CurveLegend); 
   } 

   // this is not a curve legend control
   return null;
}

Переопределите метод GetPropertyNamesClassType поставщика свойства, чтобы возвратить тип метода PropertyNames новых классов.

public override Type GetPropertyNamesClassType(UITestControl uiTestControl)
{
    if (uiTestControl.ControlType.NameEquals("Text"))
    {
      // This is text type of control. For my control,
      // that means it’s a curve legend control.
        return typeof(CurveLegend.PropertyNames);
    }

    // this is not a curve legend control
    return null;
}

Поддержка действий, учитывающих намерение, путем реализации фильтра действий

В то время, как Visual Studio записывает тест, записываются все события мыши и клавиатуры.Однако в некоторых случаях цель действия может быть потеряна в ряде событий мыши и клавиатуры.Например, если элемент управления поддерживает автозаполнение, то один и тот же набор событий мыши и клавиатуры может возникать в разных значениях во время воспроизведения теста в другой среде.Вы можете добавить подключаемый модуль фильтра действий, который заменяет ряд событий клавиатуры и мыши на одно действие.Таким образом, можно заменить ряд событий мыши и клавиатуры для выделения значения на одно действие, которое задает значение.Это защитит закодированные тесты пользовательского интерфейса от различий в автозаполнении в различных средах.

Поддержка действий, учитывающих намерение

CUIT_Actions

Реализуйте класс фильтра действий, который является производным от UITestActionFilter, переопределив свойства ApplyTimeout, Category, Enabled, FilterType, Group и Name.

internal class MyActionFilter : UITestActionFilter
{
   // If the user actions we are aggregating exceeds the time allowed,
   // this filter is not applied. (The timeout is configured when the
   // test is run.)
   public override bool ApplyTimeout
   {
      get { return true; }
   }

   // Gets the category of this filter. Categories of filters
   // are applied in priority order.
   public override UITestActionFilterCategory Category
   {
      get { return UITestActionFilterCategory.PostSimpleToCompoundActionConversion; }
   }

   public override bool Enabled
   {
      get { return true; }
   }


   public override UITestActionFilterType FilterType
   {
      // This action filter operates on a single action
      get { return UITestActionFilterType.Unary; }
   }

   // Gets the name of the group to which this filter belongs.
   // A group can be enabled/disabled using configuration file.
   public override string Group
   {
      get { return "ChartControlActionFilters"; }
   }

   // Gets the name of this filter.
   public override string Name
   {
      get { return "Convert Double-Click to Single-Click"; }
   }

Переопределите метод ProcessRule.Ниже приведен пример замены действия двойного щелчка на действие одним щелчком.

public override bool ProcessRule(IUITestActionStack actionStack)
{
    if (actionStack.Count > 0)
    {
        MouseAction lastAction = actionStack.Peek() as MouseAction;
        if (lastAction != null)
        {
            if (lastAction.UIElement.ControlTypeName.Equals(
                 ControlType.Text.ToString(),
                 StringComparison.OrdinalIgnoreCase))
            {
                if(lastAction.ActionType == MouseActionType.DoubleClick)
                {
                    // Convert to single click
                    lastAction.ActionType = MouseActionType.Click;
                }
            }
        }
    }
    // Do not stop aggregation
    return false;
}

Добавьте фильтр действий в метод GetService данного пакета расширений.

public override object GetService(Type serviceType) 
{ 
   if (serviceType == typeof(UITestPropertyProvider)) 
   { 
      if (propertyProvider == null)
      {
         propertyProvider = new PropertyProvider();
      } 
      return propertyProvider;
   } 
   else if (serviceType == typeof(UITestActionFilter)) 
   { 
      if (actionFilter == null)
      {
         actionFilter = new RadGridViewActionFilter();
      }
      return actionFilter; 
   } 
   return null;
}

Выполните сборку двоичных файлов и скопируйте их в %ProgramFiles%\Common Files\Microsoft Shared\VSTT\10.0\UITestExtensionPackages.

Примечание
Фильтр действий не зависит от реализации специальных возможностей или от поставщика свойств.

Отладка поставщика свойств или фильтра действий

Поставщик свойств и фильтр действий реализованы в пакете расширений, который загружается и выполняется построителем закодированных тестов пользовательского интерфейса в процессе, независимым от приложения.

Отладка поставщика свойств или фильтра действий

Выполните сборку отладочной версии пакета расширений и скопируйте dll-файлы и pdb-файлы в %ProgramFiles%\Common Files\Microsoft Shared\VSTT\10.0\UITestExtensionPackages.
Запустите приложение (не в отладчике).
Запустите построитель закодированного теста пользовательского интерфейса.

codedUITestBuilder.exe /standalone
Присоедините отладчик к процессу codedUITestBuilder.
Задайте точки останова в коде.
В построителе закодированных тестов пользовательского интерфейса создайте утверждения для работы поставщика свойств и запишите действия для использования фильтров действий.

Внешние ресурсы

Руководство

Тестирование непрерывной доставки с Visual Studio 2012, глава 2, "Модульное тестирование. Внутреннее тестирование"

См. также

Ссылки

AccessibleObject

Основные понятия

Проверка кода с помощью модели автоматизации пользовательского интерфейса

Поделиться через

Включение закодированных тестов пользовательского интерфейса для элементов управления

Поддержка записи, воспроизведения и проверки свойства путем реализации специальных возможностей

Поддержка записи, воспроизведения, проверки свойств и навигации для элемента управления Windows Forms

Поддержка проверки пользовательского свойства путем реализации поставщика свойства

Поддержка проверки пользовательского свойства

Поддержка создания кода путем реализации класса для доступа к пользовательским свойствам

Добавление специализированного класса для доступа к элементу управления

Поддержка действий, учитывающих намерение, путем реализации фильтра действий

Поддержка действий, учитывающих намерение

Отладка поставщика свойств или фильтра действий

Отладка поставщика свойств или фильтра действий

Внешние ресурсы

Руководство

См. также

Ссылки

Основные понятия

Дополнительные ресурсы