1. Configure SuiteConfig.json

This file restores global environment variables for the server. The file is located at /$(YOUR_PROJECT_ROOT)/SuiteConfig.json

The properties highlight in red below need to be configured according to your server platform.

{
"Framework_Version": "1.0",

"Test_Suite_Properties": {

"Suite_Name": "H+_Test_Suite",

"Suite_ID": "H_Plus_001",

"Suite_Version": "1.0",

"Requirment_File_Name": "Requirement_file",

"Thread_Pool_Size": 1,
"Android_Platform_Version": "4.4.2",

"Android_Package_Name": "com.honeywell.hch.airtouch",

"Android_Activity_Name": "com.honeywell.hch.airtouch.library.app.splash.StartActivity",

"Android_Activity_To_Wait": "",

"Local_APK_Path": "/Users/e573227/E/Automation/Tools/yingyongbao-debug.apk",

"IOS_Platform_Version": "8.0",

"Local_IPA_Path": "/Users/lyricsecuritymac2/Documents/Lyric/Lyric.app",

"Local_APP_Path": "/Users/lyricsecuritymac2/Documents/Lyric/Lyric.app",

"IOS_Bundle_ID": "com.honeywell.acs.lyric.enterprise",

"HUB_URL": "http://159.99.248.223:4723/wd/hub",      // Ip address is local address of your computer as server, port comes from Appium server

"Global_Test_TimeOut_In_Minutes": 45,

  ... ...

"TestNG_Listener_Classes": ["com.honeywell.commons.coreframework.TestNGListernerClass"]
}
}

2. Configure Requirement_file.csv

This file restores test data and global variables for the test device. The file is located at /$(YOUR_PROJECT_ROOT)/Requirement_file.csv

After editing, save the file as Requirement_file.txt. The program will read the txt file and parse the properties.

Other properties such as Android Medium Emulator Required, IOS Medium Emulator Required, Emulators Local or SauceLabs also need to be configured

so that the program will know which platform (device or cloud, emulator or real device, Android or IOS) need to be tested.

Test Data is all data from user input with JSON format. If you want to add new data, need to change the code first. 

(1).Add methods in InputTestDataParser.java

(2).Define the Excel related variables in com.honeywell.commons.coreframework.GlobalVariables

    for example,

publicstaticfinal String EXCEL_TEST_DATA_LOGIN_TITLE = "Login";

publicstaticfinal String EXCEL_TEST_DATA_USER_ID = "UserID";

publicstaticfinal String EXCEL_TEST_DATA_PASSWORD = "Password";

3. Create a new test case class

Here is an example for adding a new test case LAECOSYS_ATC_1032_add_home.

3.1 Create a MobileTestCase subclass

/$(YOUR_PROJECT_ROOT)/src/test/java/com/honeywell/testcases/LAECOSYS_ATC_1032_add_home.java

Override @Factory(), @BeforeMethod(), @Test(), @AfterMethod().

Use Keyword.execute() to run a test.

3.2 Create a Keyword subclass 

/$(YOUR_PROJECT_ROOT)/src/test/java/com/honeywell/keywords/AddHome.java

Override @BeforeKeyword(), @KeywordStep(), @AfterKeyword().

3.3 Create a ObjectiveDefinition JSON file

/$(YOUR_PROJECT_ROOT)/src/test/resources/objects_definition/ObjectDefinition/AddHomePage.json

This file is to define IDs of View objects. The IDs can be found by the Tool Uiautomatorviewer.

{
"MeIcon": {
"Android_Medium": {
"Locator_Type": "ID",
"Locator_Value": "ds_four_bottom_btn_id"
},
... ...
"IOS_Medium": {
"Locator_Type": "XPATH",
"Locator_Value": "//*[@name='login_username_textfield']"
},
... ...
}
},

... ...

}

3.4 Add the test case into the test group

/$(YOUR_PROJECT_ROOT)/src/test/java/com/honeywell/suiteExecutor/SuiteExecutor.java

public static void main(String[] groups) {

 groups=new String[]{"LAECOSYS_ATC_1032_add_home", ... ...};

}

3.5 Code style

Strongly recommend a good code style so that the code is easy to read and reuse.

For example, write the code like below, the detailed process is encapsulated in private method.

@KeywordStep

public boolean keywordSteps() {

if (goToMeScreen()) {

  if (goToManageHomeScreen()) { 

    if (goToAddHomeScreen()) {

       selectCityName();

setHomeName();

       MobileUtils.hideKeyboard(mTestCase);

       tapToConfirmButton();

       if (hasAddHomeButton()) {

          checkIfHasHomeName();

}

private boolean goToMeScreen {

   .... ...

}

4. Run the test case

Run /$(YOUR_PROJECT_ROOT)/src/test/java/com/honeywell/suiteExecutor/SuiteExecutor.java

Appium server has been launched.