Get Started with Appium for C++ Apps

You.i C++ includes a Gemfile and a Brewfile to install all necessary components to your machine. Prior to running either file, ensure you have the following tools installed:

• Ruby (version 2.2 or above)
• Brew dependencies (run brew bundle)
• Bundler (run gem install bundler)
• Gem dependencies (run bundle install)

Download and Install Appium

Downloading Appium Desktop

Download Appium Desktop from the Appium website.

Downloading the Appium Server

Download Appium from the Appium website and enter the following command:

npm install -g appium

Install Dependencies

Brewfile Dependencies

The brewfile installs the following dependencies:

Gemfile Dependencies

The gemfile installs the following components:

Dev Dependencies

The gemfile installs the following components:

Running the Test Scripts

Do the following steps:

1. Connect your target device to the machine with Appium installed.
2. Run the Appium server and tests in your Terminal window using:yarn appiumtest

3. Open another Terminal window and run the scripts by executing ./runTests.sh -a <appname>

   Warning

   If you haven’t created the appium.txt file, you can create it now by entering:yi_appium_caps_util -c <platformName> in the Terminal window. You need to add the app path manually.

4. Type ./runTests.sh -h for more options.

Working With the Configuration File

The wdio.conf.js file holds all of the important information regarding your test session. This is where all your capabilities are defined that configures the Appium server session.

You must create the wdio.conf.js file and configure the capabilities as you require. Store it in the same directory as all other Appium files.

Capabilities

For more information on capabilities, see Desired Capabilities.

Enabling an Application for Appium Use

Now that you have your environment set up, you must ensure that each application you want to test with Appium is able to communicate with the Appium server.

To enable an application for Appium use, open a socket for server communication.

Opening a Socket in the Target App

Do the following steps:

1. Open the {appname].cpp file for the target app. The following example is based on the VideoPlayer sample.

2. Add a start method to the CYIWebDriver object:

   #include <automation/YiWebDriverLocator.h>
   bool VideoPlayerApp::UserInit()
   {
   CYIWebDriver *pWebDriver = CYIWebDriverLocator::GetWebDriver();
   if (pWebDriver)
   {
       pWebDriver->Start();
   }
     // other (normal) application specific initialization code
   }
   

Linking the Appium library to your application

The Appium CYIWebDriver code is not included in the default C++ libraries linked to a You.i application. This ensures that this code can be removed in production builds.

To link the Appium library to your application:

1. Open the CMakeLists.txt or TargetList.cmake file in your application.

2. In CMakeLists.txt after the call to yi_add_executable, or anywhere in TargetList.cmake add:

   find_package(YouiEngine
       ${YI_YOUI_ENGINE_VERSION}
       COMPONENTS appium_server
       HINTS ${YouiEngine_DIR}
       REQUIRED
    )
   target_link_libraries(${YI_PROJECT_NAME}
       PRIVATE youi::appium_server
   )
   

Testing With Appium

Shared scripts can be found within your You.i Platform package: <package>/Test/appium

Supported Commands

A complete list of supported commands is on the appium-youi-driver GitHub page.