Appium Server and Inspector in Desktop GUIs for Mac, Windows, and Linux - appium/appium-desktop.
- Appium Server Download
- Download Appium Desktop Client
- Appium Download Free
- Appium Desktop For Windows
- Appium Desktop App
- Download Appium For Windows
Appium Desktop is an app for Mac, Windows, and Linux which gives you the power of the Appium automation server in a beautiful and flexible UI. It is a combination of a few Appium-related tools:
- A graphical interface for the Appium Server. You can set options, start/stop the server, see logs, etc. You also don't need to use Node/NPM to install Appium, as the Node runtime comes bundled with Appium Desktop.
- An Inspector that you can use to look at your app's elements (Safari/Chrome browser, native or hybrid app), get basic information about them, and perform basic interactions with them. This is useful as a way to learn about Appium or as a way to learn about your app so you can write tests for it.
- How to Download And Install Appium Desktop Client. 1) Visit the Appium Download page to install the Appium Desktop client. Click on Appium.exe for Windows to download the ‘.exe‘ file for Appium. 2) Go with the latest version of Appium. Note: As of 6th June’15, the latest version is 1.4 3) The File Download dialog box appears prompting you to Save the Zip file.
- Appium Server and Inspector in Desktop GUIs for Mac, Windows, and Linux - appium/appium-desktop Inspector for Web(view) improvements: Add Web(View) notification in Selected Element: #1438 Add Web(View) inspector to inspect the HTML-tree: #1443 Add new locators for iOS: #1452 Get Timings bu.
- Appium Server and Inspector in Desktop GUIs for Mac, Windows, and Linux - appium/appium-desktop. Appium Server and Inspector in Desktop GUIs for Mac, Windows, and Linux - appium/appium-desktop. Skip to content. Automatically download the correct version of ChromeDriver when using a Web or Hybrid app for Android.
Download Appium Desktop
You can always pick up the latest release at ourRelease page onGitHub.
If you're on Windows or macOS, Appium Desktop will automatically provide youwith updated versions of the app when they are released. If you encountera problem updating, simply delete or uninstall the app and re-download thelatest from the link above.
Note that Appium Desktop is not the same thing as Appium. Appium Desktop isa graphical frontend to Appium with additional tools. Appium Desktop isreleased on its own cadence and has its own versioning system. If you arereporting an issue with Appium Desktop, always be sure to include both theversion of Appium Desktop and the version of the Appium Server which is in use(see below). https://unityyellow185.weebly.com/ambigram-generator-free-download-mac.html.
If you're on macOS, you will need to install Appium Desktop by copying the appfrom the downloaded DMG file to your own file system (the best place is the'Applications' folder). Running Appium from in side the attached DMG itself isnot supported, and will not work.
Known Issues
- Some Windows 10 Users experience a
PathTooLongException
when installing the EXE. The workaround for this is to update the setting on Windows to enable long paths
Usage Instructions
These instructions assume you are already familiar with Appium andAppium-related concepts. If you are new to Appium, please visitappium.io and read our introductory material.
This app provides a convenient way to download and run the Appium automationserver, as well as a tool for inspecting elements in Chrome/Safari browser and your Android or iOS application. Itsvarious capabilities are described in the following sections.
The server start window
Starting a simple server
When you open Appium Desktop, you are greeted with the server start window. Thebasic option is to start an Appium server with all its defaults and the abilityto modify the host and port. The start button will also let you know whichversion of the Appium server you are running, which can be useful whenreporting issues to the Appium team.
Starting a server with advanced options
By clicking on the 'Advanced' tab, you have the ability to set all the serverflags that are available in Appium. This is for advanced users and should onlybe modified after consulting the Appium documentation.
Server presets
If you use the advanced server options, you have the ability to savea configuration for later use. Simply save the preset on the 'Advanced' tab,and you will subsequently be able to recall and start the server with thatconfiguration from the 'Preset' tab.
The server console output window
Appium Server Download
Once you start the server, it will launch on the host and port you specified,and open a new window displaying the server log output.
Yosemite mac os download apple. This is fairly straightforward and no real interaction is possible, beyondusing the button to stop the server. You can also copy-and-paste the logs fromthis window which is useful in reporting Appium issues.
One other button is available: 'Start New Session'. Clicking this will open upthe New Session window enabling you to start an Inspector session on thecurrently-running server.
The New Session window
The New Session window allows you to construct a set of Appium desiredcapabilities used to launch an Appium session. You can launch a session againstthe currently-running Appium Desktop server (which is the default), or you canlaunch a session against a variety of other endpoints.
Since it's not required to run against Appium Desktop's own server, you can getto the New Session window without starting an Appium Desktop server. Simply goto 'File' (Windows/Linux) or 'Appium' (Mac) and choose 'New Session.', whichwill open the New Session window without having to start a local server. Inthis case, attaching to the local server will be disabled.
You can add available cloud providers as new tabs.When you select Select Cloud Providers tab on the view,Select Cloud Providers dialog appears.You can select some of them and click Done, they will appear onthe New session window as tabs.
Appium Endpoints
These are the options for launching a session against a non-local Appium server:
Endpoint | Description |
---|---|
Automatic server | Automatically utilizes the currently-running Appium server |
Custom Server | Launch a session on an Appium server running on another machine over the network |
Sauce Labs | Launch a session on the Sauce Labs cloud. Documentation |
TestObject | Launch a session on the TestObject cloud. Documentation |
Headspin | Launch a session on the Headspin cloud. Documentation |
BrowserStack | Launch a session on the Browserstack cloud. Documentation |
Bitbar | Launch a session on the Bitbar cloud. Documentation |
Kobiton | Launch a session on the Kobiton cloud. Documentation |
Perfecto | Launch a session on the Perfecto cloud. Documentation |
Pcloudy | Launch a session on the Pcloudy cloud. Documentation |
TestingBot | Launch a session on the TestingBot cloud. Documentation |
Experitest | Launch a session on the Experitest cloud. Documentation |
It should be straightforward to get set up with any of these options. Simplyenter your details in the input fields provided.
Desired Capabilities
Desired capabilities are how you configure your Appium session. They tell theAppium server what kind of platform and app you want to automate. If you areunfamiliar with the concept of desired capabilities, or which desiredcapabilities are required to launch Appium sessions of various types, youshould consult the Appium documentation. Additionally, if you're using one ofthe cloud providers, consult their documentation for possible vendor-specificdetails.
Appium Desktop does not restrict your creation of desired capabilities in anyway, nor will it validate them for you. It simply provides a nice UI forentering them in, and saving them for later use. Under the 'DesiredCapabilities' tab, you can use the form fields and '+' button to enter as manydesired capabilities as you need. You will also see a representation of theresulting JSON, which is what is actually sent to the Appium server. This canbe useful for verifying your capabilities, or for copy-and-pasting whenreporting issues.
Once you have set your desired capabilities, you might wish to save them so youcan run the same type of session later. Simply click the 'Save As.' button togive your capability set a name. You can then access it under the 'SavedCapability Sets' tab, for later editing or session launching.
Once your server type and capabilities are set, click 'Start Session' to launchthe Appium Desktop Inspector.
Attach to an Existing Session
If you click on the 'Attach to Session.' tab, you can select an existingsession from a list of currently running sessions on your selected server, or youcan input a session ID of a currently-running session. That session should berunning on the server details you specified in the server type section above.Attaching to an existing session is possible because the Inspector is just anAppium client. This could be useful if you want to debug the middle of a runningtest. When you quit the Inspector window of an existing session, Appium Desktopwill not quit the session as it does normally.
The Inspector
The Inspector is a visual representation of the state of your application alongwith the ability to perform certain interactions in your application throughAppium.
Appium sessions can take some time to load, especially on cloud services, soplease be patient. When the session loads, a screenshot of your app will appearon the left. You can mouse over various UI elements in your application, andsee them highlighted.
In the middle of the Inspector window is your app's hierarchy, represented asXML. You can navigate this tree by clicking through it, or by clicking onelements in the screenshot view. They will then be highlighted.
When an element is highlighted, its information will appear in the detail viewon the right side of the Inspector. This detail view consists of potentialactions to take against the element, and a table of the element's properties.These properties are valuable in determining how the element might accessedusing a particular Appium locator strategy. With an element selected, you canalso 'Tap' the element, or 'Send Keys' to the element (if it is a text field).
When you take such an action with an element, the Inspector will send thecommand to Appium, which will execute it. If the action is successful, a newscreenshot will be generated and you should see the updated state and XML ofyour app. If it's not successful, you'll have an opportunity to see the errormessage.
The top of the Inspector window contains a small toolbar with iconsrepresenting the ability to take certain actions in the Inspector:
- Back (call
driver.back
) - Refresh (refresh the source and screenshot)
- Start Recording (open the recorder, see the next section for more information on the recorder)
- Quit the session (call
driver.quit
and close the Inspector)
The inspector for Hybrid or Web apps
Appium Desktop can also inspect the Webview of your Hybrid app or inspect elements in the Chrome of Safari browser.It will automatically determine for Android or iOS if a webview is detected and will notify you about this in the right part of the screen. Smart notebook 14 download for mac.
A select box of all found contexts will be shown and after selecting a context the source will be updated and show the source.The below screenshot shows the HTML source of the Appium Desktop documentation website
.
As of Appium Desktop version
1.18.0
it will automatically enable showing the HTML-source if a Chrome or Safari session is started.More selector options
XML is not a native programming language for iOS as it is with Android. Appium will automatically translate the iOS-UIHierarchy into XML, but this is a time-consuming process.The XML will be used to provide a XPATH that can be used to find elements. When you use that XPATH selector with iOS during automation, Appium always needs to do the translation which will slow down the test execution (for more info see Appium Pro newsletter 8).
As of Appium Desktop version
1.18.0
it will, if possible, also provide the:selector options together with a Get Timing button.
.
When you select an iOS element in Appium Desktop and press the Get Timing-button it will provide you the time in millisecondsit will take per selector to find the element and will automatically sort them from fast to the slowest.In most cases you will see that XPATH is the slowest locator strategy in comparison to the other options.
.
The Recorder
Appium Desktop comes with a very basic action recorder, that watches foractions taken using Appium Desktop and displays language-and-framework-specificcode that represents those actions. Reason 10 download crack mac. The code can then be copied-and-pasted intothe appropriate Appium client code and used for tests.
NB: the goal of the Recorder is not to produce production-ready test code.It is designed as a tool to help explore the Appium API, and demonstrate howcertain automation behaviors correspond to method calls in a particularlanguage and Appium library. In sum, it is a learning tool, not a robust codegeneration feature, and should be used as such.
When you start recording, the Inspector will show an additional window: How to download access database on mac.
At first, the Recorder will show no code. You will first have to take someaction, like finding an element in the hierarchy and tapping on it, or sendingkeystrokes to it. When you do this, code will appear in the recorder window,corresponding to the particular language and framework you have chosen (whichcan be adjusted in the drop-down menu at the top right of the Recorder):
This code can be copied to your clipboard using the appropriate button at thetop right of the Recorder pane. Note that by default what is shown are simplylines of code corresponding to the specific actions you have taken whilerecording---in general you cannot paste these lines into an empty text file andrun the code. To run Appium test scripts in code requires that variousdependencies (like the Appium client libraries) be installed, and that scriptboilerplate (like instantiating a driver and initializing a session) bepresent. To show this additional code, you can click the 'Show Boilerplate'button. With boilerplate code shown, it is possible to copy and paste the codeinto a new file and run it.
The power of the Recorder will continue to grow as we add more languages,frameworks, and actions to Appium Desktop.
Conclusion
This is everything you need to know to use Appium Desktop successfully!Remember, Appium Desktop is not a replacement for understanding Appiumitself---it is simply a convenient tool for working with Appium on yourdesktop, and an Inspector for exploring your app. Have fun!
Reporting Issues and Requesting Features
Appium Desktop is open source, and we use GitHub for issue tracking. Pleasesimply report issues at our issuetracker. https://ameblo.jp/onloconco1974/entry-12639612990.html. We will endeavor todetermine whether the issue you are reporting is related to Appium Desktop orAppium Server. If it's not related to Appium Desktop specifically, we willclose the issue and ask you to open a general Appium issue at Appium's mainissue tracker. Please, saveyourselves and us valuable time by getting clear on whether the issue you'reexperiencing is related to Appium Desktop specifically or instead is a generalAppium issue. You can do this by seeing whether the issue reproduces with theAppium command line server as well. If it does, direct your report to Appium'sissue tracker.
Have a feature request? Follow the same process and submit an issue to theappropriate tracker! (Either here in this repo if the request is specificallyfor Appium Desktop, or Appium's main tracker if the request is for Appium moregenerally.)
Advanced Topics and Troubleshooting
Connect to local Appium server
Appium Desktop has own Appium CLI. You can launch it via Starting a simple server.But sometimes you need another Appium version which is bundled in the desktop.For example, when you want to use Appium beta.
Then, please follow below steps.
- Build Appium CLI environment: Getting Started
- e.g.,
$ npm install -g [email protected]
- e.g.,
- Launch the Appium
$ appium
- Launch Appium Desktop and open The New Session window
- Connect to the running Appium server as
Custom Server
as below (by default)- Remote Host:
localhost
- Remote Port:
4723
- Remote Path:
/wd/hub
- Remote Host:
- Start session
Appium can't detect environment variables on Mac
Appium uses environment variables like
ANDROID_HOME
as well as relying onvarious binaries in your PATH
and so on. When running from the command linein an environment where you have set these variables appropriately, Appium hasno problem in picking them up. However, Appium Desktop does not run in a shellor a command-line environment, and so by default it does not have access toenvironment variables you have set in your shell startup script or profile. Towork around this, we use theshell-env package to pick upenvironment variables defined in your shell. This package only looks in certaincommon init scripts, however, like ~/.bashrc
, ~/.bash_profile
, and~/.zshrc
. If you set your Appium environment variables in some other way, youwill need to create one of these default init scripts and set your environmentvariables there as well, so that Appium Desktop will successfully pick them up.Warnings about being on a read-only file system
This probably means you tried to launch Appium Desktop from the downloaded diskimage (
.dmg
file). This is not a supported mode of running Appium Desktop. Tocorrectly install Appium Desktop, copy the application from the disk image toyour local filesystem, to somewhere like /Applications
. Then, run the appfrom that new location.Download Appium Desktop Client
Developer Instructions
Want to hack on Appium Desktop? Awesome! Head on over to our ContributingDoc for information on how to get a dev environment set upand submit changes back to the project.
If you have been working on Appium or have been actively following Appium updates, then you might be aware that a newer version of Appium was released in October 2016 (Appium v 1.6.0). This latest release was an important milestone because it added support for new iOS and Android frameworks and it also introduced support for Windows desktop applications and You.i TV. In this article, we will provide detailed step by step guide for Appium installation using which you will be able to download and install Appium’s latest version (version 1.7.2 in this case).
The latest version of Appium is Appium 1.7.2 (which was released on 04 Jan 2018). However, you can use this article for previous versions of Appium as well. The steps would remain the same (the content in the screenshots might be bit different based on what version you are using)
Are you looking for complete Appium setup from scratch? Use our step by step Appium Tutorial to setup all the tools, inspect elements on your mobile app and write your first test script.
Update [04 Jan, 2018]: Appium 1.7 is now available in GUI form as well. Check out our Appium Desktop app article for details
Before we begin, please note that this article doesn’t cover the entire Appium setup from scratch, using which you can start automation of your test scripts (the entire setup is covered in our Appium tutorial series, as mentioned in the yellow box above). This article just covers the download and setup of Appium 1.6/Appium 1.7 on a Windows machine.
Why download or upgrade to Appium 1.7?
Appium Download Free
If you are new to Appium and downloading it for the first time, or if you are already working on some previous versions of Appium, then you would be wondering why you should switch to the latest version of Appium rather than sticking with older versions some of which come with GUIs as well. Well, the most important reason to use the latest version of Appium is that it supports newer versions of iOS and Android. Appium 1.6.5 fixes multiple issues with the previous versions of Appium & supports iOS 11 and Android 7.1 (Nougat). So if your device or emulator uses any of these latest versions, then you have to switch to Appium 1.7’s latest version. Other than this, the newer version of Appium provides –
- XCUITest support for iOS 9.3 and iOS 10
- UI Automator 2 support for Android
- support for Windows desktop applications and You.i TV
- … and many other improvements and bug fixes
Different ways in which you can download and setup Appium
A very important thing to keep in mind about Appium versions is that they come in 2 different flavors – some Appium versions are GUI based and some are non-GUI based (ie operated from command prompt). If you have worked with Appium 1.6.3 or the versions before that, then you would have observed that all the Appium versions were not GUI based. Only few Appium server versions were GUI based, and to work with the rest of them, you would have had to use command prompt or Node js.
Fortunately, this is not the case any more. Starting from Appium 1.6.4 beta, all the Appium versions have had a GUI version well.
Installing Appium 1.7.2 or any Non-GUI version of Appium
Installation of non-GUI version of Appium is a 2 step process. The first step is to install Node.JS. The second step is to use Node.JS to install Appium.
Let’s have a look at each of these steps in detail.
Step 1 – Download and Install Node.JS
Follow the steps given below to download and install Node.JS. Pubg mobile download pc mac. If you have already installed Node.JS, then you can skip this and move to the next section.
1. Open Node.JS website using this link – https://nodejs.org/
2. Click on the LTS version’s link to download the latest version.
Note: The screenshots are shown for the latest version (v8.9.4, as on 9 Jan 2018). If you see a different latest version, please go ahead and download it. The steps given below would remain the same, even though the screenshot content might change a bit.
3. Click on Save File to save the msi file on your machine
4. Open the msi file to start the installation process
5. Click on Next button, accept the License Agreement, select default values in all the screens to install Node.JS.
6. The installation would proceed as shown below. Once its complete, click on Finish button
7. To verify that the installation was successful, open Start menu. You will see a folder for Node.js. Expand the folder and check that it shows Node.js and Node.js command prompt among other things. This shows that your installation is successful
This completes the process of download and installation of Node.js. Let’s now check the steps on how to install Appium.
Step 2 – Install Appium using Node.js
Unlike Node.js, we don’t have to download Appium first to install it. We will just run the command in Node.js, and it will automatically download and install Appium. Let’s see how this is done –
1. Go to Start menu > My Programs > Node.js folder and open Node.js command prompt.
2. Once you have opened the command prompt, you have to just provide the command to install Appium. There are 2 different variations in which you can provide this command –
- Variation 1 : Install the latest version of Appium – With this approach, Node.js will always install the latest version. The command that you can use for this is – npm install -g appium
- Variation 2 : Install a specific Appium version – Here, you can install any version of Appium. To do this you will have to provide the version number of Appium together with the command we mentioned above. Suppose, you want to install version 1.7.1, then the command that you will use is – npm install -g [email protected]
![Mac Mac](/uploads/1/2/6/8/126866634/551964911.png)
Since we will be installing the latest version of Appium, we will use variation 1
3. In Node.js command prompt, type this command – npm install -g appium and hit Enter
4. Once you hit Enter, you will see that Node will start installing Appium (you might have to wait a few seconds to see the actual installation happening). Some screenshots of the installation steps are given below –
NPM adding few dependencies for Appium…
5. Once the installation is complete, you will see that command prompt screen as shown in the below screenshot Game sim theme park pc.
6. As a last step, to check that Appium (and that too it’s latest version) has been installed, run this command : appium -v
In the above image, you can see that running Appium -v command shows the version number as 1.7.2. This confirms that the latest version of Appium has been successfully installed on your machine.
Appium Desktop For Windows
Starting Appium server from Command Prompt
Since you have downloaded a non-GUI version of Appium, the only way you can start the server is through command prompt. You can either use the default windows command prompt or the Node.js command prompt, which we used in the previous section to install Appium.
Once you open command prompt, you can simply run command – Appium, which will start the Appium server as shown in the below image. Please note that this command starts Appium on the default address and port which is 0.0.0.0:4723
If you want to run Appium on a specific server and port of your choice, then you can provide it with the command like this – appium -a 127.0.0.1 -p 4723. This command starts appium server on address 127.0.0.1
Stopping the Appium server
Stopping of the Appium server is a two step process as mentioned below –
1. In the command prompt window, press the keys Ctrl and C. This will show the Terminate batch job(Y/N) message as shown below
Appium Desktop App
2. Press ‘Y’ and then hit enter. This would stop the Appium server
This completes the article on downloading and installing non GUI version of Appium 1.7.x. Let us know if you found this article helpful and the steps easy to understand. Your feedback would help us improve our content and make it more useful for all our readers.
Related: If you use the non-GUI version of Appium, then you would also be interested in learning how you can start and stop Appium server from Java. Have a look at this article for complete details – Start and Stop Appium server from Java
Download Appium For Windows
If you enjoyed this article, like us on Facebook. We share lot of additional information on our Facebook page. See you there!!