Alessandro Anjos alessandroanjos

Getting Started with a library project in Android Studio

So we're working on creating Android Material Awesome, a library which will hopefully incorperate the benefits of Material Design, Twitter's Bootstrap, and FontAwesome. What we really wanted is a project other people can easily include into their projects using gradle dependencies. To do this we needed to create a standalone library project so we could make it as lightweight as possible for including as a dependency, and a sample app that would use it for testing. These are the steps we took to get started in Android Studio (version 1.1).

Create Projects

The first thing we needed to do was to create two new projects, with all the default settings (Blank Activity etc). One for our sample app, and one for our library. We added both of ours into the same GitHub repo, however you can save them wherever you like.

Fix Up Library Project

Android Studio Shortcuts (Mac)

Notes:

Two of the most useful shortcuts utilize the Fn (function) keys. It is therefore recommended that you enable the "Use all F1, F2, etc. keys as standard function keys" option [System Preferences > Keyboard].
Be sure to enable the Mac OS X 10.5+ keymap in Android Studio [Preferences > Keymap].
A fairly complete shortcut list can be found here.

Useful symbols:

Simple RecyclerView Divider

Simple Horizontal Divider Item Decoration for RecyclerView

    mRecyclerView.addItemDecoration(new SimpleDividerItemDecoration(
            getApplicationContext()
    	));

NOTE: Add item decoration prior to setting the adapter

RecyclerView item onClick

RecyclerView does not have an OnItemClickListener like it's predecessor, ListView. However, detecting item clicks is pretty simple.

Set an OnClickListener in your ViewHolder creation:

private class MyAdapter extends RecyclerView.Adapter<MyAdapter.ViewHolder>  {

    public static class ViewHolder extends RecyclerView.ViewHolder

	package org.wta.util;

	import java.text.ParseException;
	import java.text.SimpleDateFormat;
	import java.util.Date;
	import java.util.Locale;
	import java.util.TimeZone;

	public final class DateUtils {

	/**
	* Helper class for handling ISO 8601 strings of the following format:
	* "2008-03-01T13:00:00+01:00". It also supports parsing the "Z" timezone.
	*/
	public final class Iso8601 {
	/** Transform Calendar to ISO 8601 string. */
	public static String fromCalendar(final Calendar calendar) {
	Date date = calendar.getTime();
	String formatted = new SimpleDateFormat("yyyy-MM-dd'T'HH:mm:ssZ")
	.format(date);

	# <type>: (If applied, this commit will...) <subject> (Max 50 char)
	# \|<---- Using a Maximum Of 50 Characters ---->\|


	# Explain why this change is being made
	# \|<---- Try To Limit Each Line to a Maximum Of 72 Characters ---->\|

	# Provide links or keys to any relevant tickets, articles or other resources
	# Example: Github issue #23

	Replace this line with imperative summary

	An awesome description of WHY you did this work, not HOW/WHAT it does.
	The diff attached to commit should describe implementation (HOW)
	well-enough.

	# [TICKET-12]

	#------------------------------------------------^---------------------^
	# 50^ 72^