消費者介面自動化測試程式庫

消費者介面自動化測試程式庫 (UIA 測試程式庫) 是自動化測試案例中驅動程式應用程式呼叫的 API。 驅動程式是應用程式，可從需要驗證的控制項) 取得IUIAutomationElement物件 (自動化元素，並將它提供給消費者介面自動化測試程式庫。 然後，測試程式庫會檢查並驗證消費者介面自動化實作。 若要深入瞭解消費者介面自動化和自動化元素，請參閱消費者介面自動化基本概念。

• 消費者介面自動化測試程式庫工作流程
• 使用 消費者介面自動化 測試程式庫進行記錄
  • XML 記錄
  • 主控台記錄
  • 記錄的程式碼需求
  • 記錄範例

消費者介面自動化測試程式庫工作流程

下圖顯示一個測試工作流程，其中包含使用主控台應用程式作為驅動程式的 消費者介面自動化 測試程式庫。 在此情況下，驅動程式會啟動 Notepad.exe 實例，並從編輯控制項取得 IUIAutomationElement 物件) (。 接下來，驅動程式會根據所測試的 UI 平臺建立消費者介面自動化測試程式庫物件，然後將自動化元素當做參數傳入。 消費者介面自動化測試程式庫會判斷自動化專案是檔控制項類型，然後執行檔控制項測試、文字和捲動控制項模式測試，以及一般自動化元素測試。

使用 消費者介面自動化 測試程式庫進行記錄

消費者介面自動化測試程式庫會使用外部 DLL 來記錄測試回合的結果。 它支援以 XML 身分記錄和記錄到主控台。

XML 記錄

XML 記錄通常是由 Visual 消費者介面自動化 Verify 使用，但也可以併入命令列工作流程中。

如果指定了 XML 記錄，驅動程式應用程式必須藉由建立 XmlWriter 物件並將它傳遞至 XmlLog.GetTestRunXml 方法來序列化輸出。 驅動程式接著可以在內部使用序列化 XML，或將它寫入檔案。

XML 記錄需要下列 DLL。

• WUIALogging.dll
• WUIALoggerXml.dll

主控台記錄

根據預設，消費者介面自動化測試程式庫會使用主控台記錄，其中所有記錄輸出都會以純文字傳送至主控台視窗。 主控台記錄需要WUIALogging.dll。

記錄的程式碼需求

驅動程式應用程式必須包含下列程式碼片段，才能使用消費者介面自動化測試程式庫記錄。

\\ Include logging functionality.
using Microsoft.Test.UIAutomation.Logging;

...

\\ Select a logger.
UIAVerifyLogger.SetLoggerType(LogTypes.DefaultLogger | 
                              LogTypes.ConsoleLogger | 
                              LogTypes.XmlLogger);

...

\\ Output comment to selected logger.
UIAVerifyLogger.LogComment("...");

記錄範例

下列範例示範基本的記錄功能，並示範如何在基本測試自動化驅動程式應用程式中使用 消費者介面自動化 測試程式庫 API。

//---------------------------------------------------------------------------
//
// Description: Sample logger.
//
//---------------------------------------------------------------------------
using System;

namespace WUITest
{
    using Microsoft.Test.UIAutomation.Logging;

    public sealed class TestMain
    {
        private TestMain() { }

        /// -----------------------------------------------------------------
        /// <summary>
        /// Entry point
        /// </summary>
        /// -----------------------------------------------------------------
        [STAThread]
        static void Main(string[] args)
        {
            // Call SetLogger() if you don't want to use the default logger.
            // To set the logger type, call SetLogger(<string>).
            // <string> can be specified from the command line or from the 
            // the UI Automation Test Library enumeration:
            //  
            //     Logger.SetLogger(LogTypes.ConsoleLogger);
            //     Logger.SetLogger(LogTypes.DefaultLogger);

            Logger.SetLogger(LogTypes.DefaultLogger);

            Logger.StartTest("Test 1");
            Logger.LogComment("This is a comment");
            Logger.LogError(new Exception("My error"), false);
            Logger.EndTest();

            Logger.StartTest("Test 2");
            Logger.LogComment("This is a second comment");
            Logger.LogPass();
            Logger.EndTest();

            Logger.ReportResults();

        }
    }
}

//---------------------------------------------------------------------------
//
// Description: Sample test automation.
//
//---------------------------------------------------------------------------

using System;
using System.Windows;

namespace WUITest
{
    using System.Diagnostics;
    using System.Threading;
    using System.Windows.Automation;
    using Microsoft.Test.UIAutomation;
    using Microsoft.Test.UIAutomation.Core;
    using Microsoft.Test.UIAutomation.TestManager;
    using Microsoft.Test.UIAutomation.Tests.Controls;
    using Microsoft.Test.UIAutomation.Tests.Patterns;
    using Microsoft.Test.UIAutomation.Tests.Scenarios;
    using Microsoft.Test.UIAutomation.Logging;

    public sealed class TestMain
    {

        // Time in milliseconds to wait for the application to start.
        static int MAXTIME = 5000;
        // Time in milliseconds to wait before trying to find the application.
        static int TIMEWAIT = 100; 

        /// -------------------------------------------------------------------
        /// <summary>
        /// Start Notepad, obtain an AutomationElement object, and run tests.
        /// </summary>
        /// -------------------------------------------------------------------
        [STAThread]
        static void Main(string[] args)
        {
            // Dump the information to the console window.  
            // Use a different LogTypes value if you need to dump to another logger, 
            // or create your own logger that complies with the interface.
            UIAVerifyLogger.SetLoggerType(LogTypes.ConsoleLogger);

            // Get the automation element.
            AutomationElement element = StartApplication("NOTEPAD.EXE", null);

            // Call the UI Automation Test Library tests.
            TestRuns.RunAllTests(element, true, TestPriorities.Pri0, 
                    TestCaseType.Generic, false, true, null);

            // Clean up.
            ((WindowPattern)element.GetCurrentPattern(WindowPattern.Pattern)).Close();

            // Dump the summary of results.
            UIAVerifyLogger.ReportResults();
        }

        /// -------------------------------------------------------------------------
        /// <summary>
        /// Start the application and retrieve its AutomationElement. 
        /// </summary>
        /// -------------------------------------------------------------------------
        static public AutomationElement StartApplication(string appPath, 
                string arguments)
        {
            Process process;

            Library.ValidateArgumentNonNull(appPath, "appPath");

            ProcessStartInfo psi = new ProcessStartInfo();

            process = new Process();
            psi.FileName = appPath;

            if (arguments != null)
            {
                psi.Arguments = arguments;
            }

            UIAVerifyLogger.LogComment("Starting({0})", appPath);
            process.StartInfo = psi;

            process.Start();

            int runningTime = 0;
            while (process.MainWindowHandle.Equals(IntPtr.Zero))
            {
                if (runningTime > MAXTIME)
                    throw new Exception("Could not find " + appPath);

                Thread.Sleep(TIMEWAIT);
                runningTime += TIMEWAIT;

                process.Refresh();
            }

            UIAVerifyLogger.LogComment("{0} started", appPath);

            UIAVerifyLogger.LogComment("Obtained an AutomationElement for {0}", appPath);
            return AutomationElement.FromHandle(process.MainWindowHandle);

        }
    }
}