Androidのログ出力をいい感じにする #potatotips 9

Transcript

1. "OESPJEͷϩάग़ྗΛ
   ͍͍ײ͡ʹ͢Δ
   QPUBUPUJQT
   

   View Slide

2. @cutmail
   • Fablic, Inc.
   • iOS / Android App Developer.
   

   View Slide

3. Agenda
   • AndroidΞϓϦ։ൃʹ͓͚ΔLog
   • Α͋͘Δ໰୊
   • Timber
   • Timberͷ࢖͍ํ
   • ·ͱΊ
   

   View Slide

4. Log
   • Debug Log
   • Crash Log
   • Event Tracking Log
   

   View Slide

5. Build Variants
   • Build Types
   • ϏϧυઃఆΛ੾Γସ͑Δ࢓૊Έ
   • debug, release
   • Product Flavours
   • ΞϓϦʹผ໊Λ෇͚ͨΓɺҰ෦Λมߋͨ͠ΓͰ͖Δ࢓૊Έ
   • FlavorຖʹAndroidManifest΍ϦιʔεΛ࣋ͯΔ
   • Free, Normal
   • Staging, Production
   

   View Slide

6. #VJME7BSJBOUTͰ։ൃ൛"OESPJEΞϓϦΛ෼͚Δ
   IUUQOJOKJOLVOIBUFOBCMPHDPNFOUSZ
   
   

   View Slide

7. Ϗϧυ؀ڥʹΑΔ৔߹෼͚
   EFCVH SFMFBTF
   ϩάग़ྗ ̋ ✕
   $SBTIMZUJDT ✕ ̋
   Πϕϯτϩά ✕ ̋
   

   View Slide

8. σόοάϩάͬͯ
   Ͳ͏ͯ͠·͔͢ʁ
   

   View Slide

9. Log.d(“MainActivity”, "Activity Created”);
   

   View Slide

10. ΈΜͳେ޷͖
    LogΫϥε
    

    View Slide

11. public class MainActivity extends Activity {
    private static final String TAG = MainActivity.class.getSimpleName();
    @Override
    public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    Log.d(TAG, "MainActivity created!");
    }
    }
    Α͋͘Δ࣮૷
    

    View Slide

12. Α͋͘Δ࣮૷
    public class Util {
    public static void log(String message) {
    if (BuildConfig.DEBUG) {
    Log.d("DemoAppLog", message);
    }
    }
    }
    

    View Slide

13. Α͋͘Δ࣮૷2
    public class Logger {
    public static final void d(String tag, String msg) {
    if (BuildConfig.DEBUG) {
    Log.d(tag, msg);
    }
    }
    public static final void e(String tag, String msg) {
    if (BuildConfig.DEBUG) {
    Log.e(tag, msg);
    }
    }
    public static final void i(String tag, String msg) {
    if (BuildConfig.DEBUG) {
    Log.i(tag, msg);
    }
    }
    }
    

    View Slide

14. ى͜Γ͕ͪͳ͜ͱ
    • releaseϏϧυͳͷʹσόοάϩάग़ྗ
    • debugϏϧυͳͷʹCrashlyticsʹૹ৴͞ΕͯΔ
    

    View Slide

15. AndroidͷLogϥΠϒϥϦ
    • android-logging-log4j
    • SLF4J
    • hugo
    

    View Slide

16. View Slide

17. • https://github.com/JakeWharton/timber
    • ҆৺ͷSquareɺJakeWharton࡞
    • AndroidͷLogΫϥεͷϥούʔ
    • ࣮ଶ͸1ͭͷϑΝΠϧ
    • ʮ໦ࡐʯ
    

    View Slide

18. Tree
    public interface Tree {
    void v(String message, Object... args);
    void v(Throwable t, String message, Object... args);
    void d(String message, Object... args);
    void d(Throwable t, String message, Object... args);
    void i(String message, Object... args);
    void i(Throwable t, String message, Object... args);
    void w(String message, Object... args);
    void w(Throwable t, String message, Object... args);
    void e(String message, Object... args);
    void e(Throwable t, String message, Object... args);
    }
    

    View Slide

19. ࢖͍ํ
    • ApplicationΫϥεͷonCreate಺ͰTreeΫϥεͷΠϯ
    ελϯεΛ࡞ͬͯTimberʹplant͢Δ
    public class ExampleApp extends Application {
    @Override
    public void onCreate() {
    super.onCreate();
    if (BuildConfig.DEBUG) {
    Timber.plant(new DebugTree());
    } else {
    Timber.plant(new CrashReportingTree());
    }
    }
    }
    

    View Slide

20. HollowTree
    5SFFΠϯλϑΣʔεΛ࣮૷ͨ͠ςϯϓϨʔτΫϥε
    public static class HollowTree implements Tree {
    @Override public void v(String message, Object... args) {
    }
    @Override public void v(Throwable t, String message, Object... args) {
    }
    @Override public void d(String message, Object... args) {
    }
    @Override public void d(Throwable t, String message, Object... args) {
    }
    }
    

    View Slide

21. ಠࣗͷTreeΛ࡞Δ
    private static class CrashReportingTree extends Timber.HollowTree {
    @Override public void i(String message, Object... args) {
    i(message, args);
    Crashlytics.log(String.format(message, args));
    }
    @Override public void i(Throwable t, String message, Object... args) {
    i(message, args);
    }
    @Override public void e(String message, Object... args) {
    e("ERROR: " + message, args);
    }
    @Override public void e(Throwable t, String message, Object... args) {
    e(message, args);
    Crashlytics.logException(t);
    }
    }
    

    View Slide

22. ࢖͍ํ2 (ϩάͷग़ྗ)
    • ΞϓϦ಺͔ΒTimberͷstaticϝιουΛݺͼग़͢
    @Override
    protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.demo_activity);
    Timber.d("Activity Created”);
    }
    

    View Slide

23. @OnClick({ R.id.hello, R.id.hey, R.id.hi })
    public void greetingClicked(Button button) {
    Timber.i("A button with ID %s was clicked to say ‘%s'.",
    button.getId(), button.getText());
    }
    

    View Slide

24. Timberͷ͓࡞๏
    • Behavior͸TreeΛ௨ͯ͠ఆٛ͢Δ
    • Timber.plantͰ೚ҙͷTreeΠϯελϯε͕Πϯε
    τʔϧͰ͖Δ
    • ෳ਺ͷTreeΛplantͰ͖Δ
    • ༻ҙ͞Ε͍ͯΔDebugTreeΛ࢖͏ͱɺݺͼग़͞Εͨ
    Ϋϥε͔ΒࣗಈͰTAGΛઃఆͯ͘͠ΕΔ
    

    View Slide

25. Treeͱ͍͏֓೦ͱ
    ͦͷΠϯλϑΣʔε͕؊
    

    View Slide

26. ͭ·Γ
    

    View Slide

27. TreeΠϯλϑΣʔεΛ
    ௨ͯ͠
    

    View Slide

28. ࣗ෼͚ͩͷTreeΛ࡞Ε
    

    View Slide

29. ͱ͍͏͜ͱ
    

    View Slide

30. Timber.plant
    public static void plant(Tree tree) {
    if (tree instanceof TaggedTree) {
    TAGGED_TREES.append(FOREST.size(), true);
    }
    FOREST.add(tree);
    }
    

    View Slide

31. Timber.uproot
    /** Remove a planted tree. */
    public static void uproot(Tree tree) {
    for (int i = 0, size = FOREST.size(); i < size; i++) {
    if (FOREST.get(i) == tree) {
    TAGGED_TREES.delete(i);
    FOREST.remove(i);
    return;
    }
    }
    throw new IllegalArgumentException(
    "Cannot uproot tree which is not planted: " + tree);
    }
    

    View Slide

32. Timberͷྑ͍ͱ͜Ζ
    • LogΫϥεͷϥούʔͳͷͰϥΠϒϥϦࣗମ͕ബ͘ɺ
    ಋೖ͕؆୯
    • TreeͷΠϯλϑΣʔε͕༻ҙ͞Ε͍ͯͯɺॻ͖΍͍͢
    • LogΛ࢖͏ͱ͖ʹඞਢͩͬͨɺTAGΛॻ͘ඞཁ͕ͳ͍
    • Ҿ਺ʹϑΥʔϚοτจͱΦϒδΣΫτΛ౉ͤΔ
    • JakeWharton੡ͳͷͰ҆৺
    

    View Slide

33. ·ͱΊ
    • Timber͸LogΫϥεͷബ͍ϥούʔ
    • LogΫϥεΛͦͷ··࢖͏ͳΒɺTimber࢖͍·͠ΐ
    ͏
    

    View Slide

34. ΤϯδχΞืूத
    

    View Slide