This repository contains ATF scripts and data to run it.

For test script automation workstation should be able to build SDL and ATF, also python fabric should be installed. To install all dependencies please execute setup_env.sh. Note that it will ask sudo password to install missed software Note that internet access should be available.

./setup_env.sh

$ fab -H localhost prepare tests_run

This goals will build all required stuff (SDL, ATF) and execute all scripts. Note that this command will execute test scripts not from you local test_scripts directory but from github.

All parameters like an SDL commit, ATF commit, test scripts commit, work, build, source directories may be changed. For this purpose you can use you own config

fab -H localhost prepare:custom_config=develop_config.py

• Setup SDL.
• Later the SDL sources destination directory is referenced as <sdl_core>
• Setup ATF
• Later the ATF sources destination directory is referenced as <sdl_atf>
• Clone sdl_atf_test_scripts
• Later the atf test scripts destination directory is referenced as <sdl_atf_test_scripts>

git clone https://github.com/smartdevicelink/sdl_atf_test_scripts <sdl_atf_test_scripts>

• Copy all files from <sdl_atf_test_scripts> to <sdl_atf> :

cp -r <sdl_atf_test_scripts>/* <sdl_atf>/

• Place actual HMI_API.xml, MOBILE_API.xml from <sdl_core>/src/components/interfaces/ to <sdl_atf>/data/ :

cp <sdl_core>/src/components/interfaces/HMI_API.xml <sdl_atf>/data/
cp <sdl_core>/src/components/interfaces/MOBILE_API.xml <sdl_atf>/data/

• Run ATF.

Mandatory options:

• Pass path to sdl binary dir with --sdl-core command line parameter
• Pass path to test script as first command line parameter

cd <sdl_atf>/
./start.sh --sdl-core=<sdl_core>/build/bin  ./test_scripts/ATF_Speak.lua

Note, that path to SDL binary dir may be different

You can get additional help of usage ATF:

./start.sh --help

• Some test cases are failed due to known SDL issues. List of failed test cases available in KnownIssues.md
• For testing different application types (NAVI, MEDIA, etc...) you need to modify your <sdl_atf>/modules/config.lua after prepare step