Share
Embed
もしもの時にも安心なuiautomatorのwatcher機能
android.casual.test #02 のLT資料です。
AndroidのUIテストフレームワークuiautomatorを使った試験中に、アプリ強制終了などの想定外の事象が発生したときの保険として使うことのできるUiWatcher APIについて説明しています。
TOYAMA Sumio
April 03, 2014
Transcript
22 slides
-
ࣗݾհ • ࢯ໊: ֎ࢁ७ੜ(TOYAMA Sumio) @sumio_tym (twitter), @sumio (github)
http://sumio.hatenablog.com/ (blog) • ॴଐ: NTTιϑτΣΞגࣜձࣾ • ۀ༰: – ࣾAndroid™ؔ࿈ϓϩδΣΫτٕज़ࢧԉ – Androidؔ࿈ࣾݚमߨࢣ • ϓϥΠϕʔτ: – Androidͷࣗಈςετ༻ͷIMEΛެ։ͯ͠·͢ https://github.com/sumio/uiautomator-‐unicode-‐input-‐helper ( ) Android is a trademark of Google Inc. 2 -
• uiautomator: AndroidͷUIςετπʔϧ • UiWatcher: uiautomatorͷAPI 3
͓͢͠Δ͜ͱ uiautomatorΛͬͨࣗಈςετΛ ΑΓrobustʹ͢ΔAPI ʮUiWatcherʯػೳʹ͍ͭͯઆ໌͠·͢ -
ΞδΣϯμ • uiautomator͓͞Β͍ • UiWatcherΛΘͳ͍ͱى͖Δ͜ͱ • UiWatcherͱ
– ֓ཁ – ͍ํ – Tips 1: UiWatcherൃಈλΠϛϯά – Tips 2: checkCondition()ͷΓ • ·ͱΊ 4 -
uiautomator͓͞Β͍ ֓ཁ • ػೳɾUIςετࣗಈԽπʔϧ(Googleۘ) – http://developer.android.com/tools/testing/ testing_ui.html
• ಛ – ΞϓϦʹ·͕ͨͬͨૢ࡞γφϦΦ͕ॻ͚Δ – ୈࡾऀ͕࡞ͬͨΞϓϦૢ࡞Մೳ – ઈର࠲ඪࢦఆ͕ෆཁ • ཹҙ – JellyBean (API Level 16)Ҏ্ͷΈରԠ – ൺֱతγφϦΦ͕ෳࡶʹͳΓ͕ͪ cf. Robotium, Espresso 6 -
uiautomator͓͞Β͍ ςετίʔυྫ(2/2) 8 public void test_dialogA() throws Exception
{ // ʮμΠΞϩάදࣔAʯϘλϯΛԡ͠ɺμΠΞϩά͕දࣔ͞ΕΔ·Ͱͭɻ UiObject button = new UiObject(new UiSelector().text("μΠΞϩάදࣔA")); button.clickAndWaitForNewWindow(); // ʮμΠΞϩάදࣔAʯͱදࣔ͞Ε͍ͯΔTextViewͷଘࡏΛ֬ೝ͢Δɻ UiObject dialogMessage = new UiObject(new UiSelector() .className(TextView.class).text("μΠΞϩάදࣔA")); assertTrue("Dialog not found", dialogMessage.exists()); // ʮCloseʯϘλϯΛԡͯ͠μΠΞϩά͕ফ͑Δ·Ͱͭɻ UiObject dialogOk = new UiObject(new UiSelector() .className(Button.class).text("Close")); dialogOk.click(); assertTrue("μΠΞϩά͕ফ͑·ͤΜͰͨ͠", dialogMessage.waitUntilGone(10000L)); } UI෦ͷݕࡧ݅ -
UiWatcherͱ ֓ཁ(1/2) • ૢ࡞ର͕ݟ͔Βͳ͔ͬͨΒൃಈ͢ΔϦεφ • Ϧεφͷ۩ମྫ –
ʮڧ੍ऴྃμΠΞϩάͷ[OK]Λԡ͢ʯ – ʮANRμΠΞϩάͷ[OK]Λԡ͢ʯ – etc. 13 ςετγφϦΦʹͱͬͯఆ֎ͷ͜ͱ͕ى͖͍ͯΔ -
UiWatcherͱ ͍ํ 1. UiWatcherͷ࣮ΫϥεΛ࡞Δ – public boolean checkCondition();
2. ্هΛΠϯελϯεԽͯ͠ొ͢Δ – setUp()ʹॻ͍͓ͯ͘ͷ͕Φεεϝ 3. tearDown()࣌ʹొΛղআ͢Δ 15 -
• UiWatcherͷ࣮Ϋϥεྫ 16 private final UiWatcher crashWatcher =
new UiWatcher() { @Override public boolean checkForCondition() { UiObject dialogContent = new UiObject(new UiSelector() .text("͕ൃੜͨͨ͠ΊɺDialogSampleΛऴྃ͠·͢ɻ")); if (!dialogContent.exists()) { return false; } UiObject okButton = new UiObject(new UiSelector() .className(Button.class).text("OK")); try { okButton.click(); } catch (UiObjectNotFoundException e) { return false; } dialogContent.waitUntilGone(10000L); return true; } }; ڧ੍ऴྃμΠΞϩάఆ [OK]ϘλϯΛԡͯ͠μΠΞϩάΛফ͢ ࣗͷग़൪͡Όͳ͔ͬͨ࣌falseΛฦ͢ɻ -
• setUp()ͱtearDown()ͷྫ 17 private final UiWatcher crashWatcher =
...; // લεϥΠυࢀর private static final String CRASH_WATCHER_STRING = "Crash"; protected void setUp() throws Exception { super.setUp(); getUiDevice() .registerWatcher(CRASH_WATCHER_STRING, crashWatcher); // (ޙུ) } protected void tearDown() throws Exception { getUiDevice().resetWatcherTriggers(); getUiDevice().removeWatcher(CRASH_WATCHER_STRING); // (தུ) super.tearDown(); } UiWatcherʹϢχʔΫͳ໊લΛ͚ͯొ ొ࣌ʹ໊͚ͨલΛࢦఆͯ͠ొղআ -
UiWatcherͱ Tips 1: UiWatcherൃಈλΠϛϯά(1/2) • UI෦ʹର͢Δૢ࡞໋ྩΛड͚ͨͱ͖ͷಈ࡞ 1. ૢ࡞ର෦Λ୳͢
2. ݟ͔ͬͨ߹: ෦Λૢ࡞ͯ͠ൈ͚Δ 3. ݟ͔Βͳ͔ͬͨ߹: • UiWatcherΛൃಈ͢Δ • 1ඵεϦʔϓ͔ͯ͠Βretry͢Δ • λΠϜΞτ͢ΔͱUiObjectNotFoundException 18 ૢ࡞ର͕ݟ͔Βͳ͔ͬͨͱ͖ ૢ࡞ର͕ݟ͔Βͳ͍͔Εͳ͍ͱ͖ retryͷʹൃಈ͢Δ • ಉҰUI෦ʹରͯ͠ෳճൃಈ͢Δ͜ͱ͕͋Δ • UI෦͕༗Δ(retryޙʹݟ͔ͬͨ)ͷʹൃಈ͢Δ͜ͱ͕͋Δ -
UiWatcherͱ Tips 1: UiWatcherൃಈλΠϛϯά(2/2) • ޡര͠ͳ͍Α͏ʹҙͯ͠checkCondition()Λ࣮ ͢Δ͜ͱ͕େࣄ –
ࠓճͷྫͰʮڧ੍ऴྃμΠΞϩάʯ͕දࣔ͞Εͯ ͍ͳ͍ͱ͖ʹؒҧͬͯOKΛԡ͞ͳ͍Α͏ʹ͢Δ 19 @Override public boolean checkForCondition() { UiObject dialogContent = new UiObject(new UiSelector() .text("͕ൃੜͨͨ͠ΊɺDialogSampleΛऴྃ͠·͢ɻ")); if (!dialogContent.exists()) { return false; } // (ޙུ) } }; ಉҰͷςΩετ͕ɺ ΞϓϦʹग़ݱ͢Δͱޡര͢ΔͷͰҙ -
UiWatcherͱ Tips 2: checkCondition()ͷΓ(1/2) • UiWatcher͝ͱʹʮτϦΨʔঢ়ଶʯ͕͋Δ • checkCondition()͕trueΛฦ͢ͱτϦΨʔঢ়ଶtrueʹ
• ҰtrueʹͳͬͨτϦΨʔঢ়ଶ໌ࣔతʹreset͢Δ· Ͱtrueͷ·· • ఆ͞ΕΔϢʔεέʔε – ڧ੍ऴྃ͞ΕͨճΛ͍͑ͨ – ڧ੍ऴྃ͞Ε͔ͨͲ͏͔ͰγφϦΦΛذ͍ͤͨ͞ – etc. 20 ʮτϦΨʔঢ়ଶΛtrueʹ͢Δ͔Ͳ͏͔ʯΛද͢ -
UiWatcherͱ Tips 2: checkCondition()ͷΓ(2/2) • τϦΨʔঢ়ଶؔ࿈ͷAPI (UiDeviceΫϥε) –
setWatcherTriggered(String watcherName) – hasWatcherTriggered(String watcherName) – resetWatcherTriggers() – hasAnyWatcherTriggered() • UiWatcherొղআͱͷؔ – ొղআͯ͠τϦΨʔঢ়ଶΫϦΞ͞Εͳ͍ – ొղআ࣌resetWatcherTriggers()ݺΜͰ͓͘ͱ٢ 21 -
·ͱΊ • uiautomatorͷUiWatcherʹ͍ͭͯઆ໌͠·ͨ͠ – UI෦͕ݟ͔Βͳ͔ͬͨ࣌ʹݺͼग़͞ΕΔϦεφ – ςετରΞϓϦʹࢥΘ͵ࣄଶ͕ൃੜͯ͠ςετ Λଓ͚ΒΕΔΑ͏ʹͳΓ·͢
• UiWatcherͷࡉ͔͍ৼΔ͍Λઆ໌͠·ͨ͠ – ൃಈλΠϛϯά – τϦΨʔঢ়ଶ 22 ׆༻ͯ͠ɺΑΓrobustͳςετΛࢦ͠·͠ΐ͏!