Cognizant ITSを使ったモバイルアプリUIテストの自動化(3) - クイックスタート ~ BRILLIANTSERVICE TECHNICAL BLOG

この記事では、新規プロジェクト作成から簡単なテストデザイン、テスト実行、レポートまでの操作方法を説明していきたいと思います。

連載目次

第1回 Cognizant Intelligent Test Scripterとは
第2回 Cognizant ITSのインストール
第3回クイックスタート（本記事）
第4回アクション一覧
第5回テストケース1 反復テスト
第6回テストケース2 ビジュアルリグレッションテスト（7/31公開予定）

免責事項 - 本記の掲載内容について
本記事に掲載されている内容について一部非公式な情報を含んでおります。
そのため弊社側では記事内容を用いたことによる損害や責任等については負いかねますので、あらかじめ了承ください。
© Copyright 2018, Cognizant. All rights reserved. Cognizant、Cognizant のロゴ、Cognizant Intelligent Test Scripterは、米国Cognizant Technology Solutions Corporationの登録商標または商標です。株式会社ブリリアントサービスは、コグニザントジャパン株式会社の子会社です。本文書に記載されている内容は、予告なく変更される場合があります。また、本書に記載されている会社名、製品名、サービス名などは、各社の商標または登録商標です。

動作している所を見て頂いたほうが分かりやすいと思いますので、本記事で行う一通りの流れを動画にいたしました。まずは御覧頂ければと思います（約11分）。

前準備

実際に操作する前に下記をご準備下さい。

Android端末

Android端末の開発者向けオプションをONにします。
Android端末の[設定]→[開発者オプション]から[USBデバッグ]をONにしておいてください。
USBケーブルでパソコンと接続してください。
パソコン側のターミナルアプリもしくはコマンドプロンプトで
```
adb devices
```
と入力しEnter(return)キーを押します。
List of devices attachedの下の行にxxxxxxxxxx　deviceと出たら接続が成功しています。
Windowsの場合、端末ごとに別途adbドライバをインストールする必要がある場合があります。この場合、それぞれの端末のメーカーのサイトからダウンロードしインストールして下さい。

アプリ

今回はAppiumのデモ用apkを使用します。
下記ページより [Download]をクリックしApiDemos-debug.apkをダウンロードして下さい。
https://github.com/appium/sample-code/blob/master/sample-code/apps/ApiDemos/bin/ApiDemos-debug.apk（外部サイト）
上記apkをAndroid端末にインストールしておきます。
アプリのパッケージ名と、メインアクティビティ名を確認しておきます。
ApiDemos-debug.apkの場合は下記のとおりです。

パッケージ名 io.appium.android.apis

メインアクティビティ名 ApiDemos

アプリの起動

Appiumを起動しておきます。
Appiumの[Start Server]ボタンをクリックしてサーバーを起動します。
次にcognizant-intelligent-test-scripter-xx.xx直下にある、Run.commandファイル（macOS）もしくはRun.batファイル（Windows）をダブルクリックしてCognizant ITSを起動します。
Cognizant ITSが起動するとスタート画面が表示されますので、[New]をクリックし新規プロジェクトを作成します。
任意のプロジェクト名（例：NewProject）と、プロジェクトファイルを置く場所を指定し、[Create Project]ボタンをクリックすると、新しいプロジェクトが開きます。

プロジェクトの設定

まずはテストで利用するAndroid端末の登録を行います。
[Browser Configuration]をクリックします。
[Manage Browsers]タブをクリックします。
[Browser / Emulator]にテストを行う端末名（例：Android Device 1）を入力し、すぐ右の[＋]ボタンをクリックすると端末が追加されます。
今回はネイティブアプリの試験なので[Remote URL/Appium]にチェックを入れ[Save]をクリックします。

そのまま[Capabilities]タブを開きます。
下の方の[+]をクリックし、Property、Valueを入力していきます。
※macOSの場合、コピー＆ペーストのショートカットがcommand+C、command+Vではなく、control+C、control+Vとなっていますのでご注意下さい。

サンプルは下記の通り。

Property	Value
deviceName	Android Device 1
platformName	Android
platformVersion	7.0
appPackage	io.appium.android.apis （アプリのパッケージ名）
appActivity	ApiDemos （アプリのメインアクティビティ名）

下記サイトに詳しい説明が記載されています。
https://appium.io/docs/en/writing-running-appium/caps/（外部サイト）

入力が完了したら、[Save]をクリックし、このウィンドウも閉じます。
[Run]のボタンを右クリックし、先ほど作成した[Android Device 1]を選択します。
これによりテストのレビューの際に、先ほど登録した端末が使われるようになります。

テストケースの作成

ApiDemos-debug.apkアプリのAccessibilityをタップし、Accessibility Node Providerをタップすると、アクションバーのタイトルがAccessibility / Accessibility Node Providerとなっているかどうかをチェックするというようなテストケースを作成します。

実機側でテストを行うアプリ（ApiDemos-debug.apk）を立ち上げます。
Cognizant ITSの[Mobile Spy]をクリックし、Mobile Object Grabberウィンドウを出します。
Mobile Object Grabberは、アプリの要素情報を取得することができます。
Mobile Object Grabberウィンドウの[Road from Device]をクリックすると、スマートフォンの画面が読み込まれます。
Accessibilityにマウスオーバーし赤枠がついた状態でを右クリックします。
実機側で、Accessibilityをタップし、Accessibilityの画面を表示します。
再度Mobile Object Grabberウィンドウの[Road from Device]をクリックして画面を読み込みます。
Accessibility Node Providerにマウスオーバーし赤枠がついた状態でを右クリックします。
実機側でAccessibility Node Providerをタップします。
再度Mobile Object Grabberウィンドウの[Road from Device]をクリックして画面を読み込みます。
アクションバーのテキスト部分Accessibility / Accessibility Node Providerにマウスオーバーし赤枠がついた状態でを右クリックします。
右側のフォルダを開き、さらにio.appium.android.apisも開きます。
中に入っている項目をそれぞれクリックし、下に表示される項目のxpath以外を削除します。 ※このアプリの場合、画面において一意となっているのがxpathの値のため、他の値を削除しています。
Cognizant ITS本体のウィンドウに戻り、右上のObject Repositoryにある[Mobile]をクリックします。
Object Repository内のフォルダをクリックして開けていくと、先ほど右クリックして追加したAccessibilityなどのオブジェクトが入っています。
※もし更新されていない場合は、Object Repositoryのフォルダ（ここではNewProject）を右クリックし、Sortをクリックすると更新されます。
[＋]をクリックしてシナリオの行を追加します。
Accessibilityを中央のObjectNameへドラッグ＆ドロップします。
ActionにClickと入力します。
再度[＋]をクリックしてシナリオの行を追加します。
同じようにAccessibility Node ProviderをObjectNameへドラッグ＆ドロップします。
ActionにClickと入力します。
再度[＋]をクリックしてシナリオの行を追加します。
Accessibility / Accessibility Node ProviderをObjectNameへドラッグ＆ドロップします。
ActionにassertElementTextEqualsと入力します。
※assertElementTextEqualsは、テキストを検証するアクションです。
Inputに@Accessibility/Accessibility Node Providerと入力します。
※文字列を入力する場合は先頭に”＠”を付けます。
実機がスリープに入っていたら解除しておきます。
※Appiumでも同様なのですが、テストを実行する際にスリープの状態ですと、正しくアプリを起動することが出来ない場合があります。
Runをクリックするとテストをレビューすることが出来ます。
テストが完了すると、自動的にブラウザでレポートが表示されます。
※テストが正常に終わらなかった場合は、レポート右下のログをクリックして確認してみて下さい。