EspressoのUsageTrackerについて

「potatotips (iOS/Android開発Tips共有会) 第4回」の発表資料です。
AndroidのUIテストツールであるEspressoは、デフォルトで、解析データをGoogleに送信するようになっています。
この資料では、Espressoの解析データ送信機能(UsageTracker)で、実際に送信される情報やオプトアウトの方法などを解説しています。

Transcript

1. EspressoͷUsageTracker   ʹ͍ͭͯ
   2014.02.12   @sumio_tym  (TOYAMA  Sumio)
   potatotips  (iOS/Android։ൃTipsڞ༗ձ)  ୈ4ճ
   
2. ࣗݾ঺հ
   •  ࢯ໊:  ֎ࢁ
   ७ੜ
   (TOYAMA  Sumio)   @sumio_tym  (twitter),  @sumio  (github)   •  ॴଐ:  NTTιϑτ΢ΣΞגࣜձࣾ   •  ۀ຿಺༰:   – ࣾ಺Android™ؔ࿈ϓϩδΣΫτٕज़ࢧԉ   – Androidؔ࿈ࣾ಺ݚमߨࢣ   •  ϓϥΠϕʔτ:   – Androidͷࣗಈςετ༻ͷIMEΛެ։ͯ͠·͢   https://github.com/sumio/uiautomator-­‐unicode-­‐input-­‐helper   ( )  Android  is  a  trademark  of  Google  Inc.
   2  
3. ΞδΣϯμ
   •  Espressoʹ͍ͭͯ   •  UsageTrackerͷಈ࡞   – σʔλ஝ੵλΠϛϯά   – ૹ৴͞ΕΔ৘ใ   – ΦϓτΞ΢τํ๏   •  ·ͱΊ   3  
4. Espresso͓͞Β͍
   •  AndroidͷUIςετࣗಈԽπʔϧ(Googleۘ੡)   –  https://code.google.com/p/android-­‐test-­‐kit/   •  ܰྔɾߴ଎   •  ෯޿͍ରԠόʔδϣϯ     •  γϯϓϧͳςετίʔυ   4   // [say Hello]ͱදࣔ͞Ε͍ͯΔϘλϯΛԡͨ͠Β // TextViewʹHelloͱදࣔ͞ΕΔ͜ͱΛ֬ೝ͢Δ onView(withText("say Hello")).perform(click()); onView(withId(R.id.textview)) .check(matches(withText("Hello")));
5. EspressoͷUsageTracker
   EspressoͷυΩϡϝϯτʹؾʹͳΔهड़͕…   https://code.google.com/p/android-­‐test-­‐kit/wiki/Espresso#Analytics
   ΑΓ   5   Analytics   In  order  to  understand  Espresso  usage  patterns  and  inform   decisions  about  future  improvements,  we  have  instrumented   Espresso  to  collect  analytics.  The  following  data  may  be  collected:     •  usage  of  public  APIs     •  unusual  error  conditions     •  application  package  name    
   ʮղੳσʔλऩू͢ΔΑ!ʯ   public  interface  UsageTracker   Used  by  test  infrastructure  to  report  usage  stats  (optionally).  This  interface   should  only  be  used  by  test  infrastructure.   https://android-­‐test-­‐kit.googlecode.com/git/docs/javadocs/apidocs/com/google/ android/apps/common/testing/testrunner/UsageTracker.htmlΑΓ   UsageTracker͕ऩू୲౰  
6. UsageTrackerͷಈ࡞
   ؾʹͳͬͨͷͰ ௐ΂ͯΈ·ͨ͠!
   6   ɾσʔλ஝ੵλΠϛϯά   ɾૹ৴͞ΕΔ৘ใ   ɾΦϓτΞ΢τํ๏
   
7. ҎԼ͕ݺͼग़͞ΕͨλΠϛϯά   UsageTrackerͷಈ࡞   σʔλ஝ੵλΠϛϯά(1/2)
   7   UsageTrackerRegistry.getInstance().trackUsage(String desc) $  git  grep  trackUsage
   ˞஝ੵ͞Εͨσʔλ͸ςετऴྃ࣌ʹ·ͱΊͯૹ৴͞ΕΔ
   
8. •  ۩ମతʹ͸   1.  GraphHolder.graph()  (ॳճݺͼग़͠ͷΈ)   2.  GoogleInstrumentationTestRunner.onStart()   3.  λοϓૢ࡞ʹؔ͢Δҟৗൃੜ   UsageTrackerͷಈ࡞   σʔλ஝ੵλΠϛϯά(2/2)
   8   ࠷ॳʹEspresso.onView()ͳͲΛݺͼग़ͨ͠ͱ͖   ςετϥϯφʔىಈ࣌   λοϓ͢Δͭ΋Γͩͬͨͷʹ   ϩϯάΫϦοΫʹͳͬͯ͠·ͬͨ࣌   ʮςετىಈɾ։࢝λΠϛϯάʯ͕ऩू͞ΕΔ   ˠ͋Μ·Γ৺഑͠ͳͯ͘ྑͦ͞͏  
9. •  ςετର৅ΞϓϦͷύοέʔδ໊   •  τϥοΩϯάID  "UA-­‐36650409-­‐3"(ݻఆ஋)   •  trackUsage(String)ݺͼग़࣌͠ࠁ   •  ΫϥΠΞϯτID  (ANDROID_ID  or  randomUUID())   •  ը໘αΠζ   •  APIϨϕϧ   •  ୺຤Ϟσϧ໊   •  trackUsage(String)ݺͼग़࣌͠ͷҾ਺   UsageTrackerͷಈ࡞   ૹ৴͞ΕΔ৘ใ
   9   ্هʹൿີͷ಺༰ؚ͕·Ε͍ͯΔ৔߹͸஫ҙ͕ඞཁ   (ະެදαʔϏε໊ɺະൃച୺຤Ϟσϧɺetc)   ࢀߟ:   AnalyticsBasedUsageTracker.java
   
10. UsageTrackerͷಈ࡞   ΦϓτΞ΢τํ๏
    10   ςετର৅ΞϓϦʹ   INTERNETύʔϛογϣϯ?
    ৺഑ෆཁ!   (ૹ৴Ͱ͖ͳ͍)
    ͳ͠
    ࡞ۀඞཁ!   ༗Γ
    
11. UsageTrackerͷಈ࡞   ΦϓτΞ΢τํ๏
    11   •  ํ๏1(υΩϡϝϯτهࡌͷํ๏):   – CLIͷҾ਺ʹ'-­‐e  disableAnalytics  true'Λࢦఆ   •  ํ๏2:  ಠࣗInstrumentationTestRunnerΛ࡞Δ   – GoogleInstrumentationTestRunnerͷ୅ΘΓʹ࢖͏   public class AnalyticsDisabledInstrumentationTestRunner extends GoogleInstrumentationTestRunner { @Override public void onCreate(Bundle bundle) { bundle.putString("disableAnalytics","true"); super.onCreate(bundle); } } ςετϥϯφʔͷมߋ΋๨Εͣʹ!   ɾςετଆͷAndroidManifest.xml   ɾEclipseͷ[Run  Configuration]
    Eclipse͔Β   ઃఆෆՄ  
12. ·ͱΊ
    •  Espressoͷղੳσʔλૹ৴ػೳΛௐ΂ͯΈ·ͨ͠   –  ૹ৴͞ΕΔσʔλͰؾʹͳΔ৘ใ͕͋Δͱ͖͸ΦϓτΞ ΢τ͠·͠ΐ͏   –  ௨ৗ͸͋·Γਆܦ࣭ʹͳΒͳͯ͘΋ྑͦ͞͏   –  Eclipse͔Β΋࢖͏࣌͸GoogleInstrumentationTestRunner ͷࢠΫϥεΛ࡞ͬͯΦϓτΞ΢τ͢Δͷ͕͓͢͢Ί   12   ͝ਗ਼ௌ͋Γ͕ͱ͏͍͟͝·ͨ͠