@MOLSJEROEN THE ART OF ORGANIZING RESOURCES

@MOLSJEROEN @MOLSJEROEN

DO YOU HAVE A STRATEGY TO ORGANISE RESOURCES? Jeroen Mols

@MOLSJEROEN SETTING UP A NEW PROJECT ▸ Architecture ▸ Unit tests ▸ Build flavours ▸ Code style ▸ Continuous integration & deployment ▸ …

@MOLSJEROEN SETTING UP A NEW PROJECT ▸ Architecture ▸ Unit tests ▸ Build flavours ▸ Code style ▸ Continuous integration & deployment ▸ … ▸ What about resources?

@MOLSJEROEN IMPORTANCE OF RESOURCES Facebook Twitter Hangouts Layouts 3167 1128 372 Strings 7995 3243 2982 Drawables 4907 2136 1703 Ids 7258 2276 1039 Dimensions 4842 1470 636

@MOLSJEROEN CHALLENGES ORGANISING RESOURCES ▸ No XML name spaces ▸ Huge amount of resources ▸ A lot of types: layouts, strings, drawables, ids,… ▸ Reuse across screens ▸ Tooling support

IF SOMETHING IS WORTH KEEPING, ITS WORTH KEEPING WHERE YOU CAN FIND IT. David Allen

@MOLSJEROEN GOALS ▸ Logical, predictable names ▸ Clean ordering, even in folders ▸ Leverage Android Studio autocomplete ▸ Strongly typed resources

@MOLSJEROEN • • • • GENERAL RULE fixed set of options per resource, often Android view class custom part Android view subclass or “all” differentiate multiple elements in one screen precise “xdpi" or bucket “small”, optional ___ ___

@MOLSJEROEN • • • • GENERAL RULE fixed set of options per resource, often Android view class custom part Android view subclass or “all” differentiate multiple elements in one screen precise “xdpi" or bucket “small”, optional ___ ___

@MOLSJEROEN • • • • GENERAL RULE fixed set of options per resource, often Android view class custom part Android view subclass or “all” differentiate multiple elements in one screen precise “xdpi" or bucket “small”, optional ___ ___

@MOLSJEROEN • • • • GENERAL RULE fixed set of options per resource, often Android view class custom part Android view subclass or “all” differentiate multiple elements in one screen precise “xdpi" or bucket “small”, optional ___ ___

@MOLSJEROEN • • • • GENERAL RULE fixed set of options per resource, often Android view class custom part Android view subclass or “all” differentiate multiple elements in one screen precise “xdpi" or bucket “small”, optional ___ ___

@MOLSJEROEN ADVANTAGES 1. Easy to use

@MOLSJEROEN • Examples STRINGS - articledetail_title - feedback_explanation - feedback_namehint - all_done _

@MOLSJEROEN STRINGS _ @MOLSJEROEN

@MOLSJEROEN ADVANTAGES 1. Easy to use 2. Ordering by screen

@MOLSJEROEN • Examples DRAWABLES - articledetail_placeholder - all_infoicon - all_infoicon_large - all_infoicon_24dp __

@MOLSJEROEN DRAWABLES __ @MOLSJEROEN

@MOLSJEROEN ADVANTAGES 1. Easy to use 2. Ordering by screen 3. Folder organisation

@MOLSJEROEN • • Examples LAYOUTS activity, fragment, view, item or layout - activity_main.xml - fragment_articledetail.xml - view_menu.xml - layout_actionbar.xml _.XML

@MOLSJEROEN LAYOUTS _.XML @MOLSJEROEN

@MOLSJEROEN ADVANTAGES 1. Easy to use 2. Ordering by screen 3. Folder organisation 4. Autocomplete - based on where and what - camel casing

@MOLSJEROEN • • Examples IDS name of Android/Custom view class - tablayout_main - imageview_menu_profile - textview_articledetail_title __

@MOLSJEROEN IDS __ @MOLSJEROEN

@MOLSJEROEN ADVANTAGES 1. Easy to use 2. Ordering by screen 3. Folder organisation 4. Autocomplete - based on where and what - camel casing 5. Strong typing

@MOLSJEROEN • 
 • Examples DIMENSIONS width, height, size, margin, padding, elevation, keyline or textsize - height_all_toolbar - keyline_all_listtext - textsize_all_medium - size_menu_icon ___

@MOLSJEROEN DIMENSIONS ___ @MOLSJEROEN

@MOLSJEROEN ADVANTAGES 1. Easy to use 2. Ordering by screen 3. Folder organisation 4. Autocomplete - based on where and what - camel casing 5. Strong typing 6. Can be supported by tools

@MOLSJEROEN CHEAT SHEET ANDROID RESOURCE NAMING CHEAT SHEET ___ LAYOUTS STRINGS DRAWABLES DIMENSIONS _.XML is activity, fragment, view, item or layout _ ___ __ “all” if reused in ≠ screens is width, height, size, margin, padding, elevation, keyline or textsize IDS __ is name of Android/Custom view class custom part Android view subclass fixed set of options differentiate multiple elements in one screen always optional e.g. activity_main.xml all_done e.g. main_intro [xdp] or bucket [small] main_background e.g. all_infoicon_small e.g. linearlayout_main_fragmentcontainer e.g. keyline_all_text choose the right one below @MOLSJEROEN

@MOLSJEROEN 1. Easy to use 2. Ordering by screen 3. Folder organisation 4. Autocomplete 5. Strong typing 6. Can be supported by tools CONCLUSION ___

@MOLSJEROEN REFERENCES AND IMAGE CREDITS • Blogpost http://jeroenmols.com/blog/2016/03/07/resourcenaming • Source code https://github.com/JeroenMols/ResourceNamingExample • Welcome image credit https://pixabay.com/p-642689/

@MOLSJEROEN MANY THANKS ▸ Jeroen Mols (Belgium) ▸ @MolsJeroen ▸ http://jeroenmols.com/blog