1"use strict";(self.webpackChunkKatalon_Docs=self.webpackChunkKatalon_Docs||[]).push([[9173],{18919:(t,e,i)=>{i.r(e),i.d(e,{assets:()=>r,contentTitle:()=>l,default:()=>p,frontMatter:()=>a,metadata:()=>s,toc:()=>c});const s=JSON.parse('{"id":"troubleshooting/troubleshoot-windows-automated-testing/unable-to-start-the-windows-application","title":"Unable to start the Windows application","description":"When you encounter the following error{\\"\\\\n\\"}java.util.concurrent.ExecutionException Expected condition failed","source":"@site/docs/katalon-studio/troubleshooting/troubleshoot-windows-automated-testing/unable-to-start-the-windows-application.md","sourceDirName":"troubleshooting/troubleshoot-windows-automated-testing","slug":"/troubleshooting/troubleshoot-windows-automated-testing/unable-to-start-the-windows-application","permalink":"/katalon-studio/troubleshooting/troubleshoot-windows-automated-testing/unable-to-start-the-windows-application","draft":false,"unlisted":false,"tags":[],"version":"current","lastUpdatedAt":1758935351000,"frontMatter":{"title":"Unable to start the Windows application"},"sidebar":"katalon-studio","previous":{"title":"Timeout when launching Windows application","permalink":"/katalon-studio/troubleshooting/troubleshoot-windows-automated-testing/timeout-when-launching-windows-application"},"next":{"title":"Unable to start FlaUI automatically for Windows Recorder","permalink":"/katalon-studio/troubleshooting/troubleshoot-windows-automated-testing/unable-to-start-windows-recorder-due-to-flaui-status-check-failure"}}');var n=i(74848),o=i(28453);const a={title:"Unable to start the Windows application"},l=void 0,r={},c=[];function d(t){return(0,n.jsxs)(n.Fragment,{children:[(0,n.jsxs)("section",{xmlns:"http://www.w3.org/1999/xhtml",className:"section condition",children:[(0,n.jsxs)("div",{className:"p",children:["When you encounter the following error: ",(0,n.jsx)("pre",{className:"pre codeblock",children:(0,n.jsxs)("code",{children:["Unable to start application:","\n","java.util.concurrent.ExecutionException: org.openqa.selenium.TimeoutException: Expected condition failed: waiting for com.kms.katalon.core.windows.driver.WindowsDriverFactory"]})})]}),(0,n.jsx)("p",{className:"p",children:"There are two possible causes as follows:"})]}),"\n",(0,n.jsxs)("div",{xmlns:"http://www.w3.org/1999/xhtml",className:"bodydiv troubleSolution",children:[(0,n.jsx)("section",{className:"section cause",children:(0,n.jsx)("div",{className:"p",children:(0,n.jsx)("ul",{className:"ul",children:(0,n.jsx)("li",{className:"li",children:(0,n.jsx)("p",{className:"p",children:"If your application has splash screens at the application launch, it might take longer for the app to load. The WinAppDriver hangs on and eventually time out. This can be resolved by telling WinAppDriver to wait for a defined amount of time after an app launch. Do as follows:"})})})})}),(0,n.jsx)("section",{className:"section remedy",children:(0,n.jsxs)("ol",{className:"ol steps",children:[(0,n.jsx)("li",{className:"li step stepexpand",children:(0,n.jsxs)("span",{className:"ph cmd",children:["Install WinAppDriver version 1.2 onwards. You can download the latest WinAppDriver version from the WinAppDriver GitHub project here: ",(0,n.jsx)("a",{className:"xref j-external-link",href:"https://github.com/microsoft/WinAppDriver",target:"_blank",children:"WinAppDriver"}),"."]})}),(0,n.jsx)("li",{className:"li step stepexpand",children:(0,n.jsxs)("span",{className:"ph cmd",children:["Install Appium version 1.16.0 onwards. Follow the instruction in the Appium document to install the latest Appium version: ",(0,n.jsx)("a",{className:"xref j-external-link",href:"http://appium.io/docs/en/about-appium/getting-started/#installing-appium",target:"_blank",children:"Getting started"}),"."]})}),(0,n.jsxs)("li",{className:"li step stepexpand",children:[(0,n.jsxs)("span",{className:"ph cmd",children:["In Katalon Studio, go to ",(0,n.jsx)("strong",{className:"ph b",children:"Project Settings > Desired capabilities > Windows"})," and add this desired capability: ",(0,n.jsxs)("code",{className:"ph codeph",children:['"ms',":waitForAppLaunch",'": "25"']}),"."]}),(0,n.jsxs)("div",{className:"itemgroup info",children:["You can consider using ",(0,n.jsx)("strong",{className:"ph b",children:"Native Windows Recorder "}),"to record your actions more easily."]})]})]})})]}),"\n",(0,n.jsxs)("div",{xmlns:"http://www.w3.org/1999/xhtml",className:"bodydiv troubleSolution",children:[(0,n.jsx)("section",{className:"section cause",children:(0,n.jsx)("div",{className:"p",children:(0,n.jsx)("ul",{className:"ul",children:(0,n.jsx)("li",{className:"li",children:(0,n.jsx)("p",{className:"p",children:"If your app does not have splash screens, you can try adding the application title at the application launch. After the application starts, if WinAppDriver cannot detect the main application window correctly, Katalon Studio will use the given window title parameter to find the opened application to continue working. You can add the application title in one of the following ways:"})})})})}),(0,n.jsx)("section",{className:"section remedy",children:(0,n.jsxs)("div",{className:"li step p",children:[(0,n.jsxs)("span",{className:"ph cmd",children:["When using Windows Spy/Record Utility, in the ",(0,n.jsx)("span",{className:"ph uicontrol",children:"Application Title"})," field, add the application title and start again."]}),(0,n.jsx)("div",{className:"itemgroup info",children:"OR"}),(0,n.jsxs)("div",{className:"itemgroup info",children:["Use this keyword to start the application: ",(0,n.jsx)("a",{className:"xref",href:"/katalon-studio/keywords/keyword-description-in-katalon-studio/windows-keywords/windows-switch-to-window-title",children:"[Windows] Start Application with Title"}),"."]})]})})]})]})}function p(t={}){const{wrapper:e}={...(0,o.R)(),...t.components};return e?(0,n.jsx)(e,{...t,children:(0,n.jsx)(d,{...t})}):d()}},28453:(t,e,i)=>{i.d(e,{R:()=>a,x:()=>l});var s=i(96540);const n={},o=s.createContext(n);function a(t){const e=s.useContext(o);return s.useMemo((function(){return"function"==typeof t?t(e):{...e,...t}}),[e,t])}function l(t){let e;return e=t.disableParentContext?"function"==typeof t.components?t.components(n):t.components||n:a(t.components),s.createElement(o.Provider,{value:e},t.children)}}}]);
Line numbers count LF bytes from the start of the resource, as the search results do. Vendor segments are library code the classifier recognised; they are stored but not indexed. Bytes are shown as Latin1 characters, one per byte.