작성 패널 구성
#
워크스페이스에서 시나리오를 추가하면 아래와 같이 Step을 관리하는 화면이 나타납니다.

Step을 관리하는 영역이 활성화되지 않을 경우에는 시나리오 이름을 클릭하면 활성화됩니다.
작성 패널 구성
① 시나리오에 저장되지 않은 변경사항이 있을 경우 표시됩니다. 변경된 시나리오를 저장한 경우에는 표시되지 않습니다.
② 기본 스텝을 신규 생성합니다.
③ 자식 스텝을 포함한 스텝이 있을 경우 스텝 목록이 자식 스텝까지 모두 펼쳐서 출력됩니다.
④ 자식 스텝을 모두 접어서 최상위 스텝들만 목록에 출력됩니다.
⑤ 시나리오 속성을 확인, 추가, 수정, 삭제할 수 있습니다. 자세한 사항은 “시나리오 속성 설정” 부분을 참고해 주세요.
⑥ 해당 시나리오를 로컬에 zip 파일로 저장합니다. 로컬에 저장된 시나리오 공유하여 다른 PC에서 불러와 작업하는 것이 가능합니다.
⑦ 해당 시나리오를 저장합니다.
⑧ 시나리오를 처음부터 끝까지 실행합니다.
⑨ 시나리오의 스텝 목록이 출력되는 부분입니다.
⑩ 스텝 속성(Attributes)창을 최소화 합니다. 최소화 버튼을 클릭하면 하단의 탭으로 최소화 됩니다. 하단의 탭을 클릭하면 큰 화면으로 복원 됩니다.
⑪ 선택된 스텝의 속성(Attributes)을 보여줍니다.
스텝의 속성은 선택된 액션에 따라 항목이 달라집니다. 자세한 설명은 “액션 목록”에서 확인해 주세요.
작성하기 #
시나리오는 다음과 같은 순서대로 작성됩니다.
- 스텝 생성하기
- 스마트폰 화면 분석하기
- 화면 요소 선택하여 스텝에 추가하기
- 작성된 스텝 테스트하기
- 시나리오 저장하기
1번 부터 3번까지 진행하면 하나의 스텝이 만들어지고 이렇게 만들어진 스텝들이 쌓여서 하나의 시나리오가 완성됩니다.
1. 스텝 생성하기 #
스텝은 기본 스텝과 하위 스텝(Child) 두 종류로 나뉩니다.
① 기본 스텝 생성
시나리오 작성 패널의 상단 툴바에 있는 ‘+’버튼을 클릭해서 생성할 수 있습니다. 신규로 작성된 스텝은 스텝 목록 최하단에 추가되며, 기본으로 설정되어 있는 액션은 Touch입니다.
스텝에서 선택 가능한 액션 목록 및 각 기능은 “액션 목록” 을 참고 하시기 바랍니다.
상단 툴바를 이용하는 방법 이외에 스텝에서 마우스 오른쪽 버튼을 클릭해서 뜨는 Context 메뉴를 이용해서 스텝을 만들수도 있습니다.
이미 스텝이 존재하는 경우에 스텝의 바로 앞에 스텝을 만들고 싶으면 “Insert above”를 클릭하고, 바로 뒤에 스텝을 만들고 싶을 때는 “Insert below”를 클릭하면 됩니다.
② 하위 스텝(Child) 생성
액션 중 Control 항목(Loop Wait For제외)은 하단에 하위 스텝(Child Step)을 생성할 수 있습니다.
③ 스텝 순서 변경하기
스텝의 왼쪽 끝에 있는 아이콘을 위아래로 드래그&드롭하는 방식으로 Step의 순서를 변경할 수 있습니다. (하위 스텝 추가가 가능한 액션의 경우 특정 스텝을 드래그&드롭 하여 하위 스텝으로 넣을 수도 있습니다.)
④ 스텝 이름 수정하기
스텝을 생성하면 처음에 설정되어 있는 스텝의 이름은 “Unnamed” 입니다.
처음 설정된 값을 수정하지 않고 스텝을 작성해 나가도 당장 시나리오를 작성하고 실행하는데는 아무런 문제가 없지만, 스텝이 쌓일수록 스텝간 구분이 어려워져 시나리오 유지보수가 어려워 집니다. 되도록 의미 있는 이름으로 스텝 이름을 설정해 주세요.
스텝 이름 필드를 클릭하면 커서가 활성화 되어 이름을 변경 할 수 있습니다.

2. 스마트 폰 화면 분석하기 #
스텝에서 액션을 수행할 앱의 화면에 대한 분석을 실행합니다. 화면 분석은 디바이스 패널 오른쪽 상단에 있는 ‘화면분석 아이콘’을 클릭하면 실행됩니다.

최적의 시나리오 작성을 위해 다양한 화면 분석 도구를 제공하고 있으며, 처음 화면 분석을 실행하면 기본적으로 OD(Object Detection) 방식으로 분석한 결과를 보여줍니다.
다양한 화면 분석 도구에 대한 자세한 설명은 “화면 분석 도구”를 참고해 주세요.
3. 화면 요소 선택하여 스텝에 추가하기 #

화면 분석 결과 중에서 액션이 실행될 화면 요소를 선택하여 스텝에 추가합니다.
스마트폰 화면 분석에서 분석한 결과에서 조작하고자 하는 화면 요소를 스텝의 액션 우측 공란에 드래그&드롭하면 스텝에 해당 화면 요소가 추가됩니다. 시나리오를 실행하면 스텝에 추가된 화면 요소를 대상으로 액션을 진행하게 됩니다.
만약, 화면 분석 도구로 찾아지지 않는 요소를 선택해야 한다면 ” Crop Image ” 분석도구를 이용해서 직접 화면 요소를 지정해서 가져올 수도 있습니다.
#
4. 작성된 스텝 테스트하기 #
작성이 끝난 시나리오를 실행하여 스텝이 원하는대로 잘 동작 하는지 확인할 수 있습니다.
시나리오를 실행하는 방법은 스텝의 Context 메뉴에서 “Play only” 또는 “Play until the end”를 선택하시면 됩니다.
(1) Play only
특정 스텝만 한번 실행하고 싶을 때 사용합니다. 선택한 스텝 실행을 마치면 다음 스텝으로 넘어가지 않고 테스트가 중단됩니다.
(2) Play until the end
특정 스텝부터 마지막 스텝까지 실행하고 싶을 때 사용합니다. 선택한 스텝부터 시나리오의 마지막 스텝까지 순서대로 실행됩니다.

하나의 스텝이 완성되면 다음 스텝을 작성하세요. 스텝들을 하나씩 완성해 나가다 보면 하나의 시나리오가 완성됩니다.
#
5. 시나리오 저장하기 #
시나리오가 수정되어 저장이 필요한 경우에는 작성 패널 상단 시나리오 이름 옆에 노란색 동그라미 아이콘이 출력됩니다.
예시
저장하기 위해서는 작성 패널 상단 툴바에 있는 저장 아이콘( ) 을 클릭하거나 ⌘+S 단축키를 입력하면 현재 상태가 저장됩니다.
주의) 시나리오는 자동저장되지 않습니다. 작성 중 틈틈이 시나리오를 저장해 주세요.
실행하기 #
작성한 시나리오를 실행하는 다양한 방법에 대해 소개합니다.
처음부터 끝까지 실행하기 #
작성 패널 상단 툴바에서 실행하기 아이콘( ) 을 클릭하거나, 단축키 ⌘+D를 입력하면 첫 스텝부터 마지막 스텝까지 순서대로 실행됩니다.
한 스텝만 실행하기 #
시나리오를 작성하는 도중 작성한 스텝만 실행시키고 싶을 경우에는 해당 스텝을 마우스 오른쪽 버튼으로 클릭하여 Context 메뉴에서 “Play only”를 클릭하세요.
중간부터 끝까지 실행하기 #
시나리오 중간에 있는 스텝부터 마지막 스텝까지 실행하고 싶을 때는 중간에 있는 스텝을 마우스 오른쪽 버튼으로 클릭하여 Context 메뉴에서 “Play until the end”를 클릭하세요.

실행 중지하기 #
시나리오가 실행중일 때는 작성 패널 툴바에 있는 아이콘들이 사라지고 실행 중지 아이콘이 생깁니다. 만약 실행중인 시나리오를 중지하고 싶을 때는 중지 아이콘 ( ) 을 클릭해 주세요.
#
실행결과 확인하기 #
Output에서는 실행한 테스트의 결과를 확인하고 그 로그를 내보낼 수 있습니다.
① 도움말 : 최신 100개의 테스트 결과를 확인할 수 있습니다.
② 테스트 결과 내보내기: 실행한 테스트의 결과를 로그와 스크린샷으로 내보낼 수 있습니다.
③ 창 최소화 : 창을 최소화합니다. 하단의 Output 버튼으로 다시 띄울 수 있습니다.
테스트 결과 목록 내보내기 #
Step 1.‘테스트 결과 내보내기’ 버튼을 클릭해서 결과를 내보냅니다.
Step 2. 내보낸 파일은 .zip 파일로 압축되어있습니다. 압축된 파일에는 log 파일과 result 폴더가 있으며, result 폴더에는 개별 스탭의 상세 정보가 담겨있는 json file과 스크린샷이 스탭 실행 순서대로 나열되어 있습니다.
내보내기 #


작성한 시나리오를 다른 사람과 공유해야 하거나, 백업하고 싶을 때는 내보내기 기능을 이용하세요.
내보내기는 작성 패널 툴바의 내보내기 ( 상단의 붉은색 박스 참고) 아이콘을 클릭해서 할 수 있습니다.
시나리오 내보내기를 하면 하드디스크에 zip 파일 형태로 저장됩니다. 저장된 zip파일을 다른 컴퓨터에 공유하면 공유 받은 컴퓨터에 설치된 Stego에서 불러오기 기능을 통해 해당 zip 파일을 열수 있습니다.
불러오기 기능에 대한 자세한 설명은 “시나리오 불러오기” 를 참고하세요.
시나리오 속성 설정 #

작성 패널 툴바 중 톱니 아이콘( )을 클릭하면 아래와 같은 시나리오 속성창이 표시됩니다.

User Variable : 사용자 설정 변수 #
사용자 설정 변수 기능은 시나리오에서 자주 사용될 것으로 예상되는 값을 미리 저장해 두고 사용하기 위한 값입니다.
액션 중 “Store Value“가 비슷한 기능을 하는데, 다른 점은 “Store Value”를 사용한 스텝 이후에 실행되는 스텝에서만 설정한 값을 사용할 수 있는 반면, 사용자 설정 변수로 만들어둔 값은 시나리오가 실행되는 동안 어떤 스텝에서든 사용할 수 있습니다.
사용자 설정 변수 만들기 #
시나리오 속성창에서 ‘Add’ 버튼을 클릭하면 새로운 key와 value를 입력할 수 있는 입력란이 출력됩니다.
출력된 입력란에 key와 value를 입력한 다음, ‘Save’를 클릭하면 사용자 설정 변수가 만들어 집니다.

사용자 설정 변수 수정 / 삭제 하기 #
사용자 설정 변수는 수정 가능한 입력란 형태로 출력이 되기 때문에 key나 value 값을 수정한 다음, ‘Save’를 클릭하면 수정 사항이 저장됩니다.
삭제는 변수 오른쪽에 있는 ( ) 버튼을 클릭한 다음, ‘Save’ 를 클릭하면 해당 사용자 설정 변수가 삭제됩니다.
주의 ) 사용자 설정 변수를 생성, 수정, 삭제한 다음 반드시 ‘Save’ 버튼을 클릭해서 저장해야 작업한 내용이 적용됩니다.
사용자 설정 변수 사용하기 #
만들어둔 변수를 사용해야 하는 곳에 변수의 key값을 입력하면 사용할 수 있습니다.
여기서 주의할 점은 key값을 입력할 때는 ${key값}형태로 입력하셔야 합니다. 이는 작성자가 입력하고자 하는 값이 일반 문자인지 변수인지를 구분하기 위한 규칙입니다.
예를들어 위에서 만들어둔 변수인 age를 사용하기 위해서는 ${age}를 입력하시면 됩니다.(값은 age 변수를 설정할 때 value로 저장한 34가 됩니다.)
주의) 변수를 사용할 경우에는 반드시 변수의 key값을 ${key값}형태로 입력해주세요.

공유 시나리오의 사용자 설정 변수 #
공유 시나리오를 불러와 사용하고 있는 시나리오는 사용자 설정 변수 목록에 공유 시나리오에 설정된 사용자 설정 변수도 함께 출력됩니다.
다만, 목록에 보인다고 해서 출력된 모든 변수를 사용할 수 있는 것은 아닙니다.
실제로 공유 시나리오의 사용자 설정 변수를 사용하기 위해서는 공유 시나리오에서 “Export Variable” 액션으로 사용할 사용자 설정 변수를 설정해 줘야 이 공유 시나리오를 불러온 부모 시나리오에서 변수를 사용할 수 있습니다.


“Export Variable”에 대한 자세한 설명은 “Export Variable” 를 참고해 주세요.
스텝 속성 설정 #
스텝은 크게 액션과 화면 요소로 구성되며, 각 구성 요소에 대한 세부 설정을 통해 보다 정교한 시나리오 작성이 가능합니다.
액션속성 수정하기 #
① 스텝의 빈공간을 클릭하면 스텝에 설정된 액션의 속성을 변경할 수 있는 Attributes 패널이 하단에 활성화 됩니다.

② 속성 목록은 액션의 종류에 따라 다릅니다.
자세한 설명은 액션 목록의 각 액션 항목을 참고해 주세요.
-> 액션 목록
화면 요소 속성 확인 및 수정하기 #
스텝의 화면 요소를 클릭하면 화면 요소에 대한 세세한 설정을 할 수 있는 UIObject Field 창이 뜹니다.

UIObject Field
#

① 화면 요소 목록
스텝 목록에서는 하나의 화면 요소만 보이지만 UIObject Field 창을 통해서 여러개의 화면 요소를 추가할 수 있습니다. 테스트가 수행될 때 화면 요소들 중 하나라도 현재 디바이스 화면과 매칭된 것이 있으면 해당 요소를 대상으로 액션을 수행합니다.
예를 들어, 디바이스의 언어 설정에 따라 Youtube 아이콘은 동일한데 앱이름이 다를 경우(영어/한글) 화면 요소에 영어 버전 Youtube 아이콘과 한글 버전 Youtube 아이콘을 함께 등록해두면 디바이스 언어와 상관없이 해당 스텝이 실행 가능하게 됩니다.
② 화면 요소 속성 패널
처음에는 가장 먼저 추가 되었던 화면 요소의 속성이 출력됩니다. 화면 요소 목록에서 특정 요소를 클릭하면 해당 요소의 속성이 출력됩니다.
이 패널에서 세세한 속성값 조정을 통해 보다 더 견고하고 세밀한 시나리오 작성이 가능합니다. 화면 요소의 속성값들은 화면 요소를 생성할 때 사용했던 화면 분석 도구에 따라 다릅니다.
각 속성에 대한 자세한 설명은 “화면 분석 도구”에서 확인하세요.
③ 화면 요소 추가 드롭 공간
스텝에 새로운 화면 요소를 추가할 때 사용합니다. 화면 분석 패널에서 새로운 화면 요소를 선택해서 이 공간에 드래그&드롭하면 현재 스텝에 새로운 화면 요소가 추가됩니다.
화면 요소 테스트하기 #
화면 요소 목록에서 선택된 화면 요소와 연결된 디바이스의 화면으로 테스트하는 버튼입니다. 테스트를 하면 UIObject Field 창이 테스트 모드로 변경됩니다.
테스트 모드를 종료하려면 “Quit Test Mode” 버튼을 클릭하세요.

화면 요소 삭제하기 #
여러개의 화면 요소 중 필요없는 요소를 삭제할 수 있습니다. 다만 스텝에 추가된 화면 요소가 한 개일 때는 삭제가 되지 않습니다.