#vimeoid

Содержание

Вступление

Про адаптеры списков (ListView) с подразделами (для группировки элементов в списках)

Про списки, содержащие какие-либо действия (элементы списка выполняют что-либо сложное или изменяют себя при выборе)

Про принудительную инвалидацию видов в списках

Про кэширование изображений для ListView (для списков с изображениями)

Про адаптеры, итерирующиеся по курсорам (для поддержки постраничного вывода в списках)

Про авторизацию через OAuth на Android

Про использование MediaPlayer и буфферринг видео полученного по HTTP

Про очереди из нескольких AsyncTask (для поочерёдного выполнения фоновых задач)

Про изменение подсветки выбранного элемента в ListView

Про добавление QuickActions в проект

Ещё три маленьких решения

1. Вступление

Летом прошлого (уже) года я загорелся желанием написать Android-клиент для веб-сервиса vimeo. Мне нравится этот сервис, и как по мне, было бы удобно следить за обновлениями в подписках на видео с коммуникатора.

Я задумывал этот проект для себя как учебный (в смысле, что учусь я), однако в результате получилось сделать вполне ощутимую часть (можно посмотреть скриншоты того, что готово), однако он пока что не закончен. Такой клиент делаю не я один, свою версию практически одновременно (он был первым) со мной начал делать makotosan и его версия пока что, похоже, тоже ещё делается).

В любом случае, в процессе написания проекта я получил некоторую базу знаний, которой и спешу поделиться. Не все темы экслюзивны, но некоторые рассматриваемые тонкости не раскрыты в интернете или закопаны довольно глубоко в его недрах. Я буду дополнительно приводить примеры из искходных кодов vimeoid, это позволит вам подcмотреть как рассматриваемая тема работает в реальном времени (NB: некоторые ссылки ведут на конкретные строки в коде).

2. Списки с подразделами

Кроме обычного использования ListView, часто требуется сделать список, в котором элементы сгруппированы по нескольким разделам в таком виде: заголовок раздела, пункт, пункт, пункт, ..., заголовок раздела, пункт, пункт, ..., заголовок раздела, пункт, пункт, ... и т.д. На картинке это разделы "Statistics" и "Information".

(здесь и далее я буду использовать слово пункт как аналог английскому item, чтобы отличать элемент списка, который может быть и заголовком раздела и пунктом, от пункта, обычного элемента, который не может быть заголовком)

Заголовки не должны реагировать на нажатия и выбор и должны иметь собственный вид. Этого можно достичь, переопределив кроме getView методы getItemViewType, getViewTypeCount и isEnabled адаптера этого списка и отнаследовав его, например, от BaseAdapter.

#!java public class SectionedItemsAdapter extends BaseAdapter

Пример из vimeoid: SectionedActionsAdapter

Прежде всего заводятся константы, которые однозначно идентифицируют тип элемента, одна для заголовка, вторая для пункта (то есть типов может быть и больше двух, однако в таком случае лучше использовать enum с набором идентификаторов):

#!java public static final int ITEM_VIEW_TYPE = 0; \\ пункт public static final int SECTION_VIEW_TYPE = 1; \\ раздел

Потом константа, содержащая количество типов элементов (в нашем случае - два):

#!java public static final int VIEW_TYPES_COUNT = SECTION_VIEW_TYPE + 1;

Адаптер будет содержать в себе информацию обо всех элементах, поэтому реализации getCount, getItem и getItemId зависят от вашей ситуации.

Метод getItemViewType должен возвращать константу соответствующую типу элемента по его позиции. Для неопределённого типа элемента в классе Adapter существует константа IGNORE_ITEM_VIEW_TYPE.

#!java public int getItemViewType(int position) { if (. . .) return ITEM_VIEW_TYPE; if (. . .) return SECTION_VIEW_TYPE; return IGNORE_ITEM_VIEW_TYPE; }

В моём случае я храню в адаптере список разделов, в которых содержатся им принадлежащие пункты. Таким образом у каждого раздела можно спросить сколько внутри него пунктов и засчёт этого узнать необходимый тип.

Этот метод теперь можно использовать в переопределении getView:

#!java public View getView(int position, View convertView, ViewGroup parent) { final int viewType = getItemViewType(position); if (viewType == IGNORE_ITEM_VIEW_TYPE) throw new IllegalStateException("Failed to get object at position " + position); if (viewType == SECTION_VIEW_TYPE) { convertView = . . . // здесь можно через LayoutInflater получить Layout для заголовка раздела } else if (viewType == ITEM_VIEW_TYPE) { convertView = . . . // здесь можно через LayoutInflater получить Layout для пункта } return convertView; }

Метод isEnabled должен возвращать false для элементов, на которые нельзя нажимать и на которые нельзя переходить курсором и true для остальных. Здесь снова поможет getItemViewType:

#!java public boolean isEnabled(int position) { return getItemViewType(position) != SECTION_VIEW_TYPE };

Метод getViewTypeCount возвращает ту самую константу, количество возможных типов элементов:

#!java public int getViewTypeCount() { return VIEW_TYPES_COUNT; }

Кстати, можно хранить ссылку на LayoutInflater в самом адаптере, а получать её от создавшей его активити через конструктор.

Это всё необходимое для реализации списка с разделами, если нужно - поглядывайте в пример, но прежде дам несколько пояснений.

В примере я использую структуры для хранения данных о разделах и пунктах. В структуре раздела хранится идентификатор раздела, его заголовок и структуры пунктов, содержащихся в нём. Структура пункта хранит указатель на родительскую структуру раздела, заголовок пункта, путь к иконке и обработчик нажатия на пункт (о нём в следующей главе). Конструкторы обоих структур доступны только в адаптерах:

Пример из vimeoid: LActionItem

Таким образом я упростил добавление групп и пунктов в список. Адаптер имеет методы:

#!java public int addSection(String title); public LActionItem addItem(int section, int icon, String title);

Метод addSection возвращает идентификатор группы, который затем можно использовать для добавления пунктов в эту группу:

#!java final int suitsSection = adapter.addSection("Suits"); adapter.addItem(suitsSection, R.drawable.heart, "Hearts"); adapter.addItem(suitsSection, R.drawable.diamond, "Diamonds"); adapter.addItem(suitsSection, R.drawable.spade, "Spades"); adapter.addItem(suitsSection, R.drawable.cross, "Crosses"); final int figuresSection = adapter.addSection("Figures"); adapter.addItem(figuresSection, R.drawable.king, "King"); adapter.addItem(figuresSection, R.drawable.queen, "Queen"); . . .

3. Списки с реагирующими элементами

Иногда нужно, чтобы при нажатии на элементе списка он изменил своё состояние и/или перешёл на другую активити. Например, элемент "зафолловить" в списке с действиями над аккаунтом в твиттере может содержать иконку с минусом, если вы ещё не фолловили этого человека и менять иконку на плюс после нажатия и пришедшего подтверждения о фолловинге. Можно обрабатывать выбранный элемент в текущей ListActivity и в зависимости от позиции предпринимать решение, но если список содержится где-то внутри обычной Activity, то возможно легче обрабатывать выбор в адаптере.

Пример из vimeoid: SectionedActionsAdapter

Использует: LActionItem

Используется в: SingleItemActivity_

Если вы согласны с этим, ваш адаптер может имплементировать интерфейс OnItemClickListener:

#!java public class ActionsAdapter extends . . . implements OnItemClickListener

А в использующей его активити можно сделать:

#!java final ListView actionsList = (ListView)findViewById(R.id.actionsList); final SectionedActionsAdapter actionsAdapter = new ActionsAdapter(. . .); . . . // заполнить адаптер значениями actionsList.setAdapter(actionsAdapter); actionsList.setOnItemClickListener(actionsAdapter);

В моём случае за пункты в каждом разделе выступают какие-то действия - переходы на активити либо изменения вида пункта после запроса к серверу. Поэтому я предпочёл сделать структуры с публично доступными свойствами для разделов и пунктов, при этом структуры пунктов содержат обработчик OnClick который принимает View на котором произошёл выбор, поэтому можно изменять View прямо из них. Благодаря этому в адаптере можно просто передать действие обработчику:

#!java public void onItemClick(AdapterView<?> parent, View view, int position, long id) { final LActionItem item = (LActionItem) getItem(position); if (item.onClick != null) item.onClick(view); }

Используя описанный выше метод addItem можно устанавливать обработчик:

#!java final LActionItem heartsItem = adapter.addItem(suitsSection, R.drawable.heart, "Hearts"); heartsItem.onClick = new OnClickListener() { public void onClick(View view) { . . . } };

4. Принудительная инвалидация видов в списках

ListView в Android, как известно, устроены с небольшой хитростью, эта хитрость - ListView Recycler. Приницип Recycler'а, если кратко, состоит в том, что если в списке элементов больше, чем вмещается на экран, при прокручивании списка виды новых элементы не создаются, а переиспользуются виды старых - на этом приниципе работают имплементации getView в адаптерах.

Если в какой-то момент требуется обновить (инвалидировать) конкретный известный вид элемента (или даже его дочерний вид) списка в то время, когда он видим на экране, можно вызвать ListView.invalidate() или Adapter.notifyDataSetChanged(), но иногда эти методы нерационально обновляют и соседние виды, а то и вообще все видимые (особенно если layout построен неправильно). Есть способ получить текущий вид элемента списка используя метод ListView.getChildAt(position). Однако position в данном случае это не индекс элемента в списке, как можно было бы ожидать, а индекс относительно видимых на экране видов. Поэтому полезными будут такие методы:

#!java public static View getItemViewIfVisible(AdapterView<?> holder, int itemPos) { int firstPosition = holder.getFirstVisiblePosition(); int wantedChild = itemPos - firstPosition; if (wantedChild < 0 || wantedChild >= holder.getChildCount()) return null; return holder.getChildAt(wantedChild); } public static void invalidateByPos(AdapterView<?> parent, int position) { final View itemView = getItemViewIfVisible(parent, position); if (itemView != null) itemView.invalidate(); }

invalidateByPos обновляет вид только если он видим на экране (насильно вызывая getView адаптера), а если элемент не видим - getView адаптера будет вызван автоматически когда этот вид появится в области видимости при прокрутке списка. Чтобы обновить некий дочерний вид элемента, вы можете использовать метод getViewIsVisible, он вернёт вид элемента из которого можно получить доступ к его дочерним видам и null, если вид не видим пользователю и в обновлении нет необходимости.

Методы описаны в классе: Utils

5. Про кэширование изображений для списков

Если вы создаёте список ListView, содержащий изображения загружаемые из сети, эта глава для вас. Неразумно бы было при каждом вызове getView в адаптере получать изображения по URL заново - естественно лучше бы было их а) кэшировать б) запрашивать только тогда, когда вид с изображением видим пользователю. На данный момент эта задача так часто вставала перед программистами на Android, что уже существует множество её решений.

Мой вариант оттуда же, это решение Фёдора Власова, исправленное под мои нужды. Во-первых, я сделал каталог для хранения кэшированных изображений статическим - то есть он создаётся единожды за время жизни приложения и стабильно очищается при вызове clearCache (этот метод полезно вызывать в onDestroy() у активити, использующей ImageLoader или в finalize() у использующего его адаптера), немного изменил способ создания этого каталога (см. Utils.createCacheDir()). Во-вторых, в конструктор можно передать идентификаторы изображений, которые будут показаны на месте картинки в процессе её загрузки и/или если загрузить её не удалось. В-третьих ещё пара мелких изменений. Вообще, этот класс можно было бы и сделать синглтоном, изменяя настройки перед использованием, но это уже на ваше усмотрение. В моём случае по одному его экземпляру создаётся для каждой запущенной ListActivity и передаётся адаптерам каждого нуждающегося ListView (или создаётся в самих адаптерах, если ListView находится внутри обычной Activity). Основной метод - displayImage(String url, ImageView view), его определение говорит само за себя.

Исходник из vimeoid: ImageLoader

Использует методы из: Utils

6. Адаптеры, итерирующиеся по курсорам

Эта глава касается постраничного вывода в ListView. То есть, пользователь видит первые n элементов, прокручивает список до n-ного элемента и только после этого выполняется запрос на следующие n элементов к базе данных или к серверу. Затем пользователь пролистывает список до элемента 2n и мы запрашиваем следующую пачку размером n и т.д. В vimeoid я делаю следующий запрос при клике по footerView с надписью "Загрузить ещё..." у списка: не автоматически, но техника примерно та же.

Загрузка по клику на footerView: ItemsListActivity_

Реализация для гостя: ItemsListActivity

Реализация для зарегистрированного пользователя: ItemsListActivity

Здесь более сложная иерархия классов, загрузка каждой страницы осуществляется через специальный AsyncTask, который после фонового вызова Vimeo API сообщает вызвавшему активити, остались ли ещё элементы и не последняя ли это страница, а активити обновляет свои виды в соответствии с этими данными.

Адаптер, содержащий набор курсоров: EasyCursorsAdapter

Для того, чтобы обеспечить постраничный вывод, можно просто хранить список из контейнеров для страниц (например, курсоров) в адаптере, а в getView(), если запрошен один из последних элементов, запускать запрос на следующую страницу (предпочтительно - AsyncTask), который при получении нового контейнера добавит его в адаптер и адаптер сможет вызвать notifyDataSetChanged(). Примерно так:

#!java private final Page[] pages = new Page[MAX_PAGES_COUNT]; public View getView(final int position, View convertView, ViewGroup parent) { if (!waitingNextPage && (pages.length < MAX_PAGES_COUNT) && (position >= ((pages.length * PER_PAGE) - 2))) { final AsyncTask<Integer, . . .> nextPageTask = . . .; nextPageTask.execute(pages.length); // nextPageTask вызывает addSource, когда получает новую страницу waitingNextPage = true; } . . . } public void addSource(Page page) { if (pages.length >= MAX_PAGES_COUNT) return; pages[pages.length] = page; waitingNextPage = false; notifyDataSetChanged(); }

EasyCursorsAdapter - хороший пример, где в качестве аналога Page выступает Cursor. Наверняка есть и альтернативные решения, буду рад если их упомянут в комментариях.

7. Авторизация через OAuth на Android

Если вы пишете клиент для какого-либо сложного веб-сервиса - вы сталкиваетесь с проблемой авторизации, в подавляющем количестве веб-сервисов для её реализации ныне используется OAuth и Vimeo как раз из числа таких.

Не стоит писать реализацию самому, это несколько неблагодарное дело, благо уже есть отличная библиотека signpost и лучших альтернатив, насколько я знаю, пока нет.

Пример из vimeoid: VimeoApi

Использует signpost через: JsonOverHttp

Активити, которое получает токен пользователя: ReceiveCredentials

Его описание в манифесте: AndroidManifest.xml

Для начала нужно получить уникальный ключ для вашего приложения от веб-сервиса и указать веб-сервису URL, на который будет возвращатся пользователя при успешной авторизации (напр., vimeoid://oauth.done) (но в случае Android его передают при запросе к /request_token). Обычно это делается через веб-интерфейс самого сервиса.

Алгоритм первой авторизации на Android следующий:

Указать signpost где у сервиса находятся точки входа в OAuth

Запросом к /request_token получить пару токен/секрет приложения для неавторизированных запросов по этому ключу (колбэк-URL vimeoid://oauth.done передают здесь): provider.retrieveRequestToken(Uri callbackUri). NB: retrieveRequestToken возвращает не токен, а сразу Uri, тот самый authUri по которому надо обратиться в следующем пункте

Запустить активити браузера, обратиться к /authorize, передав токен приложения и, если необходимо, добавив дополнительные параметры о необходимых правах: startActivity(new Intent(Intent.ACTION_VIEW, authUri + ...))

Пользователь увидит страницу в стиле "Разрешить этому приложению доступ к вашему аккаунту?" (если он разлогинен в сервисе, ему предложат залогиниться). Если он разрешает доступ, браузер перенаправляется по адресу колбэка vimeoid://oauth.done?..., но так как в вашем AndroidManifest.xml для перехвата таких URL описано специальное активити, Android возвращает пользователя к вашему приложению, открывая это самое активити - ReceiveCredentials

В активити ReceiveCredentials вы получаете токен пользователя в параметрах Uri uri = getIntent().getData(), теперь по этому токену нужно получить секрет через запрос к /access_token: provider.retrieveAccessToken(Uri uri)

Теперь можно сохранить токен и секрет пользователя, например, в приватных SharedPreferences: consumer.getToken(), consumer.getTokenSecret()

После этого вы можете подписывать каждый запрос к API веб-сервиса полученными токенами: consumer.sign(Object request). Если ваше приложение было перезапущено, перед всеми запросами можно проверить, нет ли токенов в SharedPreferences, если есть - напомнить о них signpost'у: consumer.setTokenWithSecret(String token, String secret), а если нет - запросить секрет пользователя заново (или обновить токены, если веб-сервис это позволяет).

Важное замечание: на Android signpost работает только с использованием CommonsHttpOAuthConsumer/CommonsHttpOAuthProvider. Классы DefaultOAuth* не работают.

8. Медиа-плеер и буфферинг видео по HTTP

MediaPlayer как оказалось, очень трудно заставить работать так, как хочется, в случае проигрывания видео. Чтобы получить видео мне нужно было выполнить необычный HTTP-запрос со специальными заголовками, поэтому получение потока и его буфферизирование пришлось писать вручную. Потоковое воспроизведение по аналогу примеров для аудио-файлов у меня не вышло, поэтому пока что я просто загружаю видео полностью и начинаю проигрывание, когда оно уже загрузилось (если на карте не хватит места, я предупреждаю пользователя). При закрытии плеера или неудачном проигрывании я очищаю кэш.

Ещё, поведение VideoView/SurfaceView при переключении видов в пределе одного лэйаута тоже работает очень неоднозначно (чёрный экран через раз), поэтому пришлось банально оставлять в лэйауте один-единственный VideoView и показывать ProgressDialog поверх него, пока видео загружается. Опять же, если вы знаете что-то про потоковое воспроизведение видео средствами MediaPlayer (или о получении чанков вручную), пишите в комментариях.

Поэтому, если в вашем случае вам хватит вызова MediaPlayer.setDataSource(Uri uri), можете пропустить следующий абзац, большего в ней не рассказывается.

Если же вам тоже пришлось получать поток вручную, я обращу ваше внимание на пару моментов, в остальном просто продемонстрирую код, он должен рассказать всё сам:

Пример из vimeoid: VimeoVideoPlayingTask

Вызывается из активити: Player

Лэйаут: player.xml

Загружать поток лучше используя AsyncTask. Я просто агрегирую MediaPlayer внутри ...PlayingTask для удобства, вы можете выбрать любой другой способ, но получать поток определённо лучше через AsyncTask. При этом, в методе onPreExecute можно подготовить плеер и настроить его, в doInBackground получить поток видео и вернуть этот поток в onPostExecute, в котором и запустить проигрывание. Опять же, удобно показывать процентный прогресс загрузки, потому что в doInBackground известно количество полученных данных.

Если при загрузке потока возникает исключение, сообщение о нём приходится показывать через runOnUiThread, потому что выполнение задачи было прервано.

Выполнение getWindow().setFormat(PixelFormat.TRANSPARENT); предназначено, чтобы отображённые поверх плеера виды не оставались поверх него после скрытия. Хотя если нужно использовать ViewSwitcher, это всё равно не помогает.

Код получения потока по URL примерно таков:

#!java public static InputStream getVideoStream(long videoId) throws FailedToGetVideoStreamException, VideoLinkRequestException { try { final HttpClient client = new DefaultHttpClient(); . . . HttpResponse response = client.execute(request); if ((response == null) || (response.getEntity() == null)) throw new FailedToGetVideoStreamException("Failed to get video stream"); lastContentLength = response.getEntity().getContentLength(); return response.getEntity().getContent(); } catch (URISyntaxException use) { throw new VideoLinkRequestException("URI creation failed : " + use.getLocalizedMessage()); } catch (ClientProtocolException cpe) { throw new VideoLinkRequestException("Client call failed : " + cpe.getLocalizedMessage()); } catch (IOException ioe) { throw new VideoLinkRequestException("Connection failed : " + ioe.getLocalizedMessage()); } }

9. Очереди из AsyncTask

Если вам часто приходится выполнять по нескольку фоновых задач поочерёдно (когда завершилось одно - запускать следующее), этот вольный паттерн, скрывающий в себе переходы по связанному списку, вам подойдёт. Например, вам может понадобиться выполнить при загрузке Activity сразу несколько поочерёдных запросов к API некоего веб-сервиса или к базе данных. Главное, чтобы типы параметров и результата у всех этих задач всегда были одинаковыми.

Вот интерфейс задачи, которая знает что у неё есть следующая задача:

#!java public interface HasNextTask<Params> { public int getId(); void setNextTask(HasNextTask<Params> task); public HasNextTask<Parames> getNextTask(); public AsyncTask<?, ?, ?> execute(Params... params); // совпадение с AsyncTask<Params, ...> }

Интерфейс, который следит за всеми моментами, когда задачи удачно или неудачно выполняются:

#!java public interface PerformHandler<Params, Result> { public void onPerfomed(int taskId, Result result, HasNextTask<Params> nextTask); public void onError(Exception e, String description); }

Реализация интерфейса HasNextTask. То что представлено многоточиями, можно вынести в дочерний класс или сделать сам класс абстрактным, чтобы методы doInBackground/onPostExecute реализовывались прямо в createTask очереди:

#!java public class TaskInQueue<Params, Result> extends AsyncTask<Params, Void, Result> implements HasNextTask<Params> { private final int taskId; private HasNextTask<Params> nextTask = null; private final PerformHandler<Params, Result> listener; public TaskInQueue(PerformHandler<Params, Result> listener, int taskId) { this.taskId = taskId; this.listener = listener; } @Override public Result doInBackground(Params... params) { . . . /* выполнение задачи */ } @Override protected void onPostExecute(Result result) { . . . // обработка результата, если нужно listener.onPerformed(taskId, result, nextTask); } @Override public int getId() { return taskId; } @Override public void setNextTask(HasNextTask<Params> nextTask) { if (this.nextTask != null) throw new IllegalStateException("Next task is already set"); this.nextTask = nextTask; } @Override public HasNextTask<Params> getNextTask() { return nextTask; }; }

Ну и самое главное, реализация очереди:

#!java public abstract class TasksQueue<Params, Result> implements PerformHandler<Params, Result>, Runnable { public static final String TAG = "TasksQueue"; private HasNextTask<Params> firstTask = null; private HasNextTask<Params> lastTask = null; private Map<Integer, Params> tasksParams = null; private int currentTask = -1; private boolean running = false; // сейчас выполняется одна из задач private boolean started = false; // очередь запущена private int size = 0; protected HasNextTask<Params> createTask(int taskId) { // можно переопределить return new TaskInQueue<Params, Result>(this, taskId); } @Override public HasNextTask<Params> add(int taskId, Params params) { Log.d(TAG, "Adding task " + taskId); final HasNextTask<Params> = createTask(taskId); if (isEmpty()) { firstTask = task; lastTask = task; tasksParams = new HashMap<Integer, Params>(); } else { lastTask.setNextTask(task); lastTask = task; } tasksParams.put(task.getId(), params); size += 1; return task; } @Override public void run() { Log.d(TAG, "Running first task"); if (!isEmpty()) try { started = true; execute(firstTask); } catch (Exception e) { onError(e, e.getLocalizedMessage()); finish(); } else throw new IllegalStateException("Queue is empty"); } @Override public void onPerfomed(int taskId, Result result, HasNextTask<Params> nextTask) { Log.d(TAG, "Task " + taskId + " performed"); if (taskId != currentTask) throw new IllegalStateException("Tasks queue desynchronized"); running = false; try { if (nextTask != null) { execute(nextTask); } else finish(); } catch (Exception e) { onError(e, "Error while executing task " + ((nextTask != null) ? nextTask.getId() : taskId)); finish(); } } protected void execute(HasNextTask<Result> task) throws Exception { Log.d(TAG, "Trying to run task " + task.getId()); if (running) throw new IllegalStateException("Tasks queue desynchronized"); currentTask = task.getId(); running = true; Log.d(TAG, "Running task " + task.getId()); task.execute(tasksParams.get(task.getId())).get(); // wait for result } protected void finish() { firstTask = null; lastTask = null; if (tasksParams != null) tasksParams.clear(); tasksParams = null; currentTask = -1; running = false; started = false; size = 0; } public boolean isEmpty() { return (firstTask == null); } public boolean started() { return started; } public boolean running() { return running; } public int size() { return size; } }

Теперь в ваших активити в любой момент можно с лёгкостью создать очередь фоновых задач:

#!java protected final TasksQueue secondaryTasks; private final int TASK_1 = 0; private final int TASK_2 = 1; private final int TASK_3 = 2; public ...Activity() { // конструктор secondaryTasks = new TasksQueue<..., ...>() { // здесь можно переопределить createTask @Override public void onPerfomed(int taskId, ... result) throws JSONException { super.onPerfomed(taskId, result); onSecondaryTaskPerfomed(taskId, result); } @Override public void onError(Exception e, String message) { Log.e(TAG, message + " / " + e.getLocalizedMessage()); Dialogs.makeExceptionToast(ItemsListActivity.this, message, e); } }; secondaryTasks.add(TASK_1, ...); secondaryTasks.add(TASK_2, ...); secondaryTasks.add(TASK_3, ...); } protected void someMethod() { . . . if (!secondaryTasks.isEmpty()) secondaryTasks.run(); . . . } protected void onSecondaryTaskPerfomed(int taskId, ... result) { switch (taskId) { case TASK_1: . . . case TASK_2: . . . case TASK_3: . . . . . . } }

Кстати, благодаря интерфейсу Runnable такие очереди можно запускать в отдельном потоке:

#!java new Thread(secondaryTasks, "Tasks Queue").start();

Очередь в vimeoid: ApiTasksQueue

Создаётся в: SingleItemActivity

Инициализируется задачами в: UserActivity

Обработка выполненных задач в: UserActivity

10. Подсветка выбора в ListView

На картинке видно синюю полосу, это кастомная подсветка выбранного элемента, она имеет четыре состояния - нажатая, имеющая фокус, запрещённая и анимация перехода от нажатой в зажатую для долгого тапа. Первые три и зажатое состояние - это так называемые 9-patch, вы наверняка о них слышали, анимация - xml-файл анимации.

Для того чтобы описать состояния для подсветки выбора, укажите в лэйауте android:listSelector="@drawable/selector_bg" для вашего ListView.

selector_bg.xml - это ещё один xml-файл, набор правил о том как изменяется подстветка в зависимости от состояний. Система проходит по каждому правилу и как только первое правило совпало, оно выполняется, а следующие игнорируются. Алгоритм прост, но выстроить правила в верном порядке не всегда выходит сразу. Смотрите примеры:

Описание: selector_bg.xml

Анимация: selector_bg_transition.xml

Объявлен в: generic_list.xml

С 9-patch тоже есть хитрости, чуть что не так в лэйауте - и они разъезжаются и весь список разъезжается тоже. Главное правило - проверить прежде описание ListView, убедитесь что layout_width и layout_height установлены в fill_parent и кроме того перепроверьте элементы выше по иерархии. Затем, если не помогло, можно исправлять 9-patch. Тонкие чёрные линии сверху и слева обозначают области картинки, которые будут растянуты если контент не влез в картинку. Тонкие чёрные линии (необязательные) справа и снизу обозначают области в которые сам контент будет вписан. Подобрать нужные позиции тоже получается не сразу, приходится экспериментировать. Даже не думайте создавать 9-patch без редактора из коробки, это лишний вынос мозга - в редакторе подсвечиваются области для контента и ошибки, и даже когда всё вроде верно, не всегда раскладка воспринимается инфлейтером как ожидалось.

11. Добавление QuickActions

QuickActions - небольшая библиотека для всплывающих диалогов с действиями, таких как на рисунке (и не только таких, потому что их дизайн можно менять свободно). Они стали новым популярным веянием при появлении официального твиттер-клиента. Должны быть и другие имплементации, в vimeoid я использую эту, и её тоже немного подправил для своих нужд.

Для того, чтобы отобразить такой диалог вместо контекстного меню при долгом тапе на элементе в списке, достаточно переопределить метод onCreateContextMenu в ListActivity таким образом:

#!java public void onCreateContextMenu(ContextMenu menu, View v, ContextMenuInfo menuInfo) { . . . final AdapterView.AdapterContextMenuInfo info = extractMenuInfo(menuInfo); final QuickAction quickAction = createQuickActions(info.position, getItem(info.position), info.targetView); if (quickAction != null) quickAction.show(); } protected QuickAction createQuickActions(final int position, final ... item, View view) { QuickAction qa = new QuickAction(view); qa.addActionItem(getString(R.string...), getResources().getDrawable(R.drawable...), new QActionClickListener() { @Override public void onClick(View v, QActionItem item) { . . . } }); . . . return qa; }

Каталог, содержащий модифицированную библиотеку lib-qactions

Используется в: VideosActivity

О добавлении внешней библиотеки в проект Eclipse рассказано в этой статье. Если кратко, достаточно создать для библиотеки отдельный Android-проект с исходниками, установить чекбокс isLibrary в разделе Android в свойствах этого проекта, а в основном проекте добавить проект с библиотекой пунктом Library -> Add из того же раздела. При этом R-файл из проекта с библиотекой будет добавлен в основной проект.

12. Ещё три маленьких решения

12а. Единое место для вызова различных активити

Если в вашем приложении много различных активити и они вызываются схожим образом, возможно будет удобно перенести их вызовы включая заполнение Extras в отдельный класс:

Пример из vimeoid: Invoke

12б. Про плэйсхолдеры в локализации

Возможно это очевидно, но в строках из strings.xml можно использовать плейсходеры для того, чтобы подставлять какие-то независимые от локали значения внутрь строк, например: <string name="image_info">Image size: {width}x{height}</string>. В этом поможет функция format, которую можно вызвать так: format(getString(R.string.image_info), "width", String.valueOf(600), "height", String.valueOf(800)):

#!java public static String format(String source, String... params) { String result = source; int pos = 0; while (pos < params.length) { result = result.replaceAll("\\{" + params[pos++] + "\\}", params[pos++]); } return result; }

Upd. Оказалось, как я и думал, это велосипед: Есть стандартная функция getString(int resId, Object... formatArgs). Спасибо zochek.

12в. Про некорректные лэйауты

Обязательно прочитайте эти статьи, инфлэйтер в андроиде действительно очень чувствителен к сложным структурам и если вы пишете сложное приложение, лэйауты рано или поздно придётся оптимизировать:

Layout Tricks #1

Layout Tricks #2

Layout Tricks #3

Layout Tricks #4

Speed up your Android UI

Contents

Introduction

About list adapters with sections (to group elements in the lists)

About lists containing some actions (list elements do something complex or change themselves when selected)

About list views manual invalidation

About caching images in ListView (for lists with remote images)

About adapters that iterate over cursors (to support pagination in lists)

About OAuth autorization in Android

About using MediaPlayer to play remote video received using HTTP

About queues containing several AsyncTasks (to execute background tasks sequentially)

About changing the list element selection style

About adding QuickActions to your project

Three more mini-solutions

1. Introduction

Last summer I had ignited the desire to write an Android client for vimeo web-service. I like this service and I think it would be cool to monitor updates on video subscriptions from your communicator.

I сonceived this project to be learning one (means I am learning), however as a result I've found that a valuable part was done (you can check out screenshots of the finished things), but it is still in progress. Almost simultaneously with me, being first, makotosan started to write his own version of client aimed at video upload and he is also has not finished it yet, but his version can do things that my version can not (and converse is also true, seems).

Anyway, through programming process I've got some knowledge base which I want to share. Not all the themes are exclusive but some tricks are hidden in the web or even not covered there. I will also give examples from vimeoid source code, so it will allow you to spy how the paragraph subject works in real-time (NB: some achors point to concrete lines in code).

2. Lists with subsections

Among with the regular ListView usage, it is frequently required to make a list with elements grouped in sections like this: section header, item, item, item, ..., section header, item, item, item, ..., section header, item, item, ..., section header, item, item, ... & s.o. See "Statistics" and "Information" sections at the image.

Headers must not react on selection or press and they must have their own layout. This may be accomplished extending the adapter of this list from BaseAdapter, for example, and by overriding its getItemViewType, getViewTypeCount and isEnabled methods, among with getView.

#!java public class SectionedItemsAdapter extends BaseAdapter { . . .

Example from vimeoid: SectionedActionsAdapter

The first step is creating a constants which identify element type, one for header, one for item (so there is a possibility to have more than two types, but it's better to use enum to store idenitifiers in cases like those):

#!java public static final int ITEM_VIEW_TYPE = 0; \\ item public static final int SECTION_VIEW_TYPE = 1; \\ section

Then a constant containing a number of element types (there's two in our case):

#!java public static final int VIEW_TYPES_COUNT = SECTION_VIEW_TYPE + 1;

Adapter must contain the information about all of the elements inside, so the getCount, getItem and getItemId realizations are depend on your situation.

getItemViewType method must return the constant that conforms with the element type in the passed position. There is a special constant named IGNORE_ITEM_VIEW_TYPE exist in Adapter class for the case when type is undefined.

#!java public int getItemViewType(int position) { if (. . .) return ITEM_VIEW_TYPE; if (. . .) return SECTION_VIEW_TYPE; return IGNORE_ITEM_VIEW_TYPE; }

I my case I store the list of sections inside the adapter and they contain their items inside. So I can ask any section to tell me how many items it holds inside and to determine the element type using this data.

This method can be used in overriden getView now:

#!java public View getView(int position, View convertView, ViewGroup parent) { final int viewType = getItemViewType(position); if (viewType == IGNORE_ITEM_VIEW_TYPE) throw new IllegalStateException("Failed to get object at position " + position); if (viewType == SECTION_VIEW_TYPE) { convertView = . . . // here you can get a header layout using LayoutInflater } else if (viewType == ITEM_VIEW_TYPE) { convertView = . . . // here you can get an item layout using LayoutInflater } return convertView; }

isEnabled must return false for elements that can not be pressed or selected and true for others. Here we can use getItemViewType again:

#!java public boolean isEnabled(int position) { return getItemViewType(position) != SECTION_VIEW_TYPE };

getViewTypeCount method returns the very constant determing a number of elements types:

#!java public int getViewTypeCount() { return VIEW_TYPES_COUNT; }

By the way, you can keep a pointer to LayoutInflater in your adapter and get it passed using constructor.

It is all the required things to make a list with sections, if you need to ensure in something - just look into example, but I'll make some notices before.

I use separate structures to store the data about sections and items. The section identifier, its title and child items structures are stored within the section structure. A pointer to parent section structure, item title, icon path and click handler (it will be covered in next paragraph) are stored within the item structure. Both structures' constructors are accessible only from adapters:

Example from vimeoid: LActionItem

I simplified adding sections and items to list using this way. Adapter has methods:

#!java public int addSection(String title); public LActionItem addItem(int section, int icon, String title);

Method addSection returns the section identifier so you can use it to add items in this section:

#!java final int suitsSection = adapter.addSection("Suits"); adapter.addItem(suitsSection, R.drawable.heart, "Hearts"); adapter.addItem(suitsSection, R.drawable.diamond, "Diamonds"); adapter.addItem(suitsSection, R.drawable.spade, "Spades"); adapter.addItem(suitsSection, R.drawable.cross, "Crosses"); final int figuresSection = adapter.addSection("Figures"); adapter.addItem(figuresSection, R.drawable.king, "King"); adapter.addItem(figuresSection, R.drawable.queen, "Queen"); . . .

3. Lists with elements that react on something

Sometimes it is required to change the list element content and/or switch activity when it is clicked. For example, the list of possible actions with some twitter account may contain "follow" element with minus icon, if you still do not follow this man and change its icon to plus when click happened and positive response (to following request) is received from twitter server. You can handle the selected element in current ListActivity and depending on position take a decision, but if your list is inside the general Activity, so may be it will be easier to handle selection inside the adapter.

Example from vimeoid: SectionedActionsAdapter

Uses: LActionItem

Used in: SingleItemActivity_

If you agree with that, your adapter can implement OnItemClickListener interface:

#!java public class ActionsAdapter extends . . . implements OnItemClickListener

And inside the activity that uses this adapter you can do:

#!java final ListView actionsList = (ListView)findViewById(R.id.actionsList); final SectionedActionsAdapter actionsAdapter = new ActionsAdapter(. . .); . . . // fill adapter with values actionsList.setAdapter(actionsAdapter); actionsList.setOnItemClickListener(actionsAdapter);

In my case some actions are responsible for each item in the section - they switch the activity or change the corresponding item content after server request. So I decided to create structures with public-access properties for sections and items, and the item structures contain a pointer to OnClick handler that gets View to change, so you it is possible to change the view just inside the handler. So it is just required to pass a click action to the appropriate handler inside the adapter:

#!java public void onItemClick(AdapterView<?> parent, View view, int position, long id) { final LActionItem item = (LActionItem) getItem(position); if (item.onClick != null) item.onClick(view); }

Using the addItem method described above you can set a handler directly from activity:

#!java final LActionItem heartsItem = adapter.addItem(suitsSection, R.drawable.heart, "Hearts"); heartsItem.onClick = new OnClickListener() { public void onClick(View view) { . . . } };

4. Manual invalidation of list views

As you may know, ListView in Android has a [little trick inside] named ListView Recycler. Its principle is in reusage of old elements views for elements that not fit the screen instead of creating new views while user scrolls the list like this, this principle is used in adapters' getView implementations.

If you need to update (invalidate) concrete known element view (or even its child view) at some moment, when it is visible to user, you may call ListView.invalidate() or Adapter.notifyDataSetChanged(), but sometimes these methods update not only the required view but also its neighbours or even all the visible elements (especially when layout is built incorrectly). There is a way to get the current view of list element using ListView.getChildAt(position) method. But position in this case is not index of the element in a list, as you may considered, but an index relative to visible views on the screen. So a methods like these would help:

#!java public static View getItemViewIfVisible(AdapterView<?> holder, int itemPos) { int firstPosition = holder.getFirstVisiblePosition(); int wantedChild = itemPos - firstPosition; if (wantedChild < 0 || wantedChild >= holder.getChildCount()) return null; return holder.getChildAt(wantedChild); } public static void invalidateByPos(AdapterView<?> parent, int position) { final View itemView = getItemViewIfVisible(parent, position); if (itemView != null) itemView.invalidate(); }

invalidateByPos updates view only if it is shown on the screen (forcing an adapter's getView method call), if this element is not visible - adapter's getView will be called automatically when this view will appear to user after scrolling. To update some child view of an element, you can use getViewIsVisible method, it will return the element view which gives access to its child views and it returns null if this element is not visible so update is not required.

Methods are defined in class: Utils

5. Caching remote images for lists

If you are creating ListView containing images taken from web, this chapter is for you. It would be unwise to get images by URL again each time getView is called in adapter - it is obvious that it would be better to a) cache them b) ask for them only when view with this image is visible. For the moment this task arose so recently for Android programmers, so there are a lot of solutions for it.

My variant is also from that list, it is Fedor Vlasov's solution, that is corrected for my needs. First, I changed a directory for cached images to be static, so it is created once for application cycle and surely cleaned when calling clearCache (it is good to call this method in onDestroy() of Activity using ImageLoader or in finalize() method of adapter using it), also I've changed a bit a way of this directory creation (see Utils.createCacheDir()). Secondly, you may pass the drawables IDs to constructor to determine what drawables to show in this place while loading an image and/or if loading image is failed. Thidly, some minor changes. Though, this class can be a singleton and you can just change its options before using it, but it is left for your decision. In my case the instance is created for each ListActivity started and is passed to adapters of inner ListViews that need it (or created directly in adapters if ListViews are inside a regular Activity). The main method id displayImage(String url, ImageView view), its definition speaks for itself.

Source from vimeoid: ImageLoader

Uses methods from: Utils

6. Adapters iterating over cursors

This chapter is about pagination in ListView. So, user gets first n elements, scrolls list to n-th element and only after that happen the response for n elements to DB or server is performed. Then the user scrolls the element 2n and we ask for next package with n size and so on. In vimeoid I make a resonse only after footerView with 'Load more...' label is clicked, it is not automatic way, but the technique is similar to subject.

Loading by click on footerView: ItemsListActivity_

Guest implementation: ItemsListActivity

Logged-in user implementation: ItemsListActivity

The classes hieararchy is a lit bit more complex, each page is loaded with special AsyncTask that calls Vimeo API in background and notifies the calling activity about are there any elements left or is it the last page, and the activity updates its views according to this data.

Adapter containing a set of cursors: EasyCursorsAdapter

To make a pagination possible, you may just keep a set of page containers (cursors, for example) in adapter and in getView(), if one of last elements is asked for, run the query for next page (AsyncTask is preferred), which will add new container to adapter when it will be received, so the adapter will have a possibility to call notifyDataSetChanged(). Like this:

#!java private final Page[] pages = new Page[MAX_PAGES_COUNT]; public View getView(final int position, View convertView, ViewGroup parent) { if (!waitingNextPage && (pages.length < MAX_PAGES_COUNT) && (position >= ((pages.length * PER_PAGE) - 2))) { final AsyncTask<Integer, . . .> nextPageTask = . . .; nextPageTask.execute(pages.length); // nextPageTask calls addSource, when next page is received waitingNextPage = true; } . . . } public void addSource(Page page) { if (pages.length >= MAX_PAGES_COUNT) return; pages[pages.length] = page; waitingNextPage = false; notifyDataSetChanged(); }

EasyCursorsAdapter is a good example for a case where Cursor is Page analogue. I am sure there are several alternative solution exists and I will be glad if someone will mention them in comments.

7. OAuth in Android

If you are writing a client for a complex web-service - you need to fight with authorization problem and in current moment most web-services use OAuth for its realization and Vimeo is one of those.

There is no need to write your own implementation of OAuth, there is very cool library named signpost exist, and I do not know any better alternatives for now.

Example from vimeoid: VimeoApi

Uses signpost through: JsonOverHttp

Activity that gets user token: ReceiveCredentials

Its definition at manifest: AndroidManifest.xml

To start, you need to get the exclusive key for your application from web-service and set a callback URL to return user there after successful authorization (i.e. vimeoid://oauth.done) (but in case of Android, tou can pass it with call to /request_token). Recently it is done using service web-interface for programmer.

The first authorization algorythm for Android is:

Point signpost to a service's OAuth entry-points

Send a request to /request_token, get a token/secret pair using this key for unauthorized requests of your applization (vimeoid://oauth.done callback URL is passed here): provider.retrieveRequestToken(Uri callbackUri). NB: retrieveRequestToken returns not token but Uri that you need to call in next step at once.

Launch browser activity, call /authorize with passing the application token and, optionally, appending additional parameters about required access rights: startActivity(new Intent(Intent.ACTION_VIEW, authUri + ...))

User will see a page in 'Allow this application to access your account?' style (if he is logged out of service, service will ask him to log in). If user grants access, browser will be redirected to callback URL vimeoid://oauth.done?..., but in case in your AndroidManifest.xml there is a special activity to handle URLs like this, Android will return a user to your application and open this very activity - ReceiveCredentials.

In ReceiveCredentials activity you get user token in parameters Uri uri = getIntent().getData(), now you need to get secret using this token by requesting /access_token: provider.retrieveAccessToken(Uri uri).

Now you can save user's token and secret in private SharedPreferences, for example: consumer.getToken(), consumer.getTokenSecret().

After all these things done you can just sign every request to web-service API with the token/secret you've got: consumer.sign(Object request). If your application was restarted, before doing any request you can check if you have saved tokens in SharedPreferences, if you are - just remember signpost with them: consumer.setTokenWithSecret(String token, String secret), in not - request access token again (or just refresh tokens, if web-service allows it).

Important notice: signpost in Android works only with CommonsHttpOAuthConsumer/CommonsHttpOAuthProvider. DefaultOAuth* classes do not work.

8. Getting video by HTTP and playing it in MediaPlayer

It is very hard to make MediaPlayer do the things you want in case of playing video, as I discovered. To get a video it was required for me to make an unusual HTTP request with special headers, so I had to implement getting stream and its buffering manually. I could not get stream playing using the audio-files-related examples as a pattern, so I download the full video file and start playing just when downloading is finished (if there will be not enough space to get video on SD card, I warn user about it). When player is closed or failed to play, I clear the cache.

Moreover, VideoView/SurfaceView behavior works ambiguously when switching views inside one single layout (black screen from time to time), so I had to just leave a single VideoView in layout and show ProgressDialog on the top of it, while video is loading. Again, if you know something about stream playing videos using MediaPlayer (or getting chunks manually), write to comments.

So, if there is enough to call MediaPlayer.setDataSource(Uri uri) in your case, you can skip some next paragraphs.

And if you also had to get a stream manually, I will notice a few moments and just demonstrate the code, it must speak for itself:

Example from vimeoid: VimeoVideoPlayingTask

Called from activity: Player

Layout: player.xml

It is better to get a stream using AsyncTask. I just aggregate MediaPlayer with ...PlayingTask for convenience, you may use any other way you want, but definitely it is better to get a stream using AsyncTask. In this case in onPreExecute method you may set up yout player, in doInBackground you can get a video stream and return it to onPostExecute and start playing from there. Also, it is handy to show percentage progress of downloading, because you know an amount of data received in doInBackground.

And if there is an exception was raised while getting a stream, it is required to show a message about in using runOnUiThread, because task execution was interrupted.

Calling getWindow().setFormat(PixelFormat.TRANSPARENT); is aimed to prevent views shown above the player to stay above even when they are closed/hidden. Anyway, when it is required to use ViewSwitcher, this stuff do not helps.

Code to get video stream by URL is similar to this one:

#!java public static InputStream getVideoStream(long videoId) throws FailedToGetVideoStreamException, VideoLinkRequestException { try { final HttpClient client = new DefaultHttpClient(); . . . HttpResponse response = client.execute(request); if ((response == null) || (response.getEntity() == null)) throw new FailedToGetVideoStreamException("Failed to get video stream"); lastContentLength = response.getEntity().getContentLength(); return response.getEntity().getContent(); } catch (URISyntaxException use) { throw new VideoLinkRequestException("URI creation failed : " + use.getLocalizedMessage()); } catch (ClientProtocolException cpe) { throw new VideoLinkRequestException("Client call failed : " + cpe.getLocalizedMessage()); } catch (IOException ioe) { throw new VideoLinkRequestException("Connection failed : " + ioe.getLocalizedMessage()); } }

9. AsyncTask Queues

If you need to execute several background tasks sequentially (when one finished - run next), this freestyle pattern (walking by linked list inside) will fir you. For example when your activity started you need to perform several successive calls to some web-server API or database. The main thing is that parameters and result types for all these tasks must be similar.

Here is a task-that-knows-it-has-next-task inteface:

#!java public interface HasNextTask<Params> { public int getId(); void setNextTask(HasNextTask<Params> task); public HasNextTask<Parames> getNextTask(); public AsyncTask<?, ?, ?> execute(Params... params); // must much with AsyncTask<Params, ...> }

Here is an interface that monitors when tasks are performed successfully or not:

#!java public interface PerformHandler<Params, Result> { public void onPerfomed(int taskId, Result result, HasNextTask<Params> nextTask); public void onError(Exception e, String description); }

HasNextTask interface implementation. The hollows given with three dots, you may move them into child class or make this class abstract to implement doInBackground/onPostExecute methods right in createTask method of queue:

#!java public class TaskInQueue<Params, Result> extends AsyncTask<Params, Void, Result> implements HasNextTask<Params> { private final int taskId; private HasNextTask<Params> nextTask = null; private final PerformHandler<Params, Result> listener; public TaskInQueue(PerformHandler<Params, Result> listener, int taskId) { this.taskId = taskId; this.listener = listener; } @Override public Result doInBackground(Params... params) { . . . /* task execution */ } @Override protected void onPostExecute(Result result) { . . . // handling a result, if required listener.onPerformed(taskId, result, nextTask); } @Override public int getId() { return taskId; } @Override public void setNextTask(HasNextTask<Params> nextTask) { if (this.nextTask != null) throw new IllegalStateException("Next task is already set"); this.nextTask = nextTask; } @Override public HasNextTask<Params> getNextTask() { return nextTask; }; }

And the main thing, the queue implementation:

#!java public abstract class TasksQueue<Params, Result> implements PerformHandler<Params, Result>, Runnable { public static final String TAG = "TasksQueue"; private HasNextTask<Params> firstTask = null; private HasNextTask<Params> lastTask = null; private Map<Integer, Params> tasksParams = null; private int currentTask = -1; private boolean running = false; // some task is running now private boolean started = false; // the whole queue is running now private int size = 0; protected HasNextTask<Params> createTask(int taskId) { // can be overriden return new TaskInQueue<Params, Result>(this, taskId); } @Override public HasNextTask<Params> add(int taskId, Params params) { Log.d(TAG, "Adding task " + taskId); final HasNextTask<Params> = createTask(taskId); if (isEmpty()) { firstTask = task; lastTask = task; tasksParams = new HashMap<Integer, Params>(); } else { lastTask.setNextTask(task); lastTask = task; } tasksParams.put(task.getId(), params); size += 1; return task; } @Override public void run() { Log.d(TAG, "Running first task"); if (!isEmpty()) try { started = true; execute(firstTask); } catch (Exception e) { onError(e, e.getLocalizedMessage()); finish(); } else throw new IllegalStateException("Queue is empty"); } @Override public void onPerfomed(int taskId, Result result, HasNextTask<Params> nextTask) { Log.d(TAG, "Task " + taskId + " performed"); if (taskId != currentTask) throw new IllegalStateException("Tasks queue desynchronized"); running = false; try { if (nextTask != null) { execute(nextTask); } else finish(); } catch (Exception e) { onError(e, "Error while executing task " + ((nextTask != null) ? nextTask.getId() : taskId)); finish(); } } protected void execute(HasNextTask<Result> task) throws Exception { Log.d(TAG, "Trying to run task " + task.getId()); if (running) throw new IllegalStateException("Tasks queue desynchronized"); currentTask = task.getId(); running = true; Log.d(TAG, "Running task " + task.getId()); task.execute(tasksParams.get(task.getId())).get(); // wait for result } protected void finish() { firstTask = null; lastTask = null; if (tasksParams != null) tasksParams.clear(); tasksParams = null; currentTask = -1; running = false; started = false; size = 0; } public boolean isEmpty() { return (firstTask == null); } public boolean started() { return started; } public boolean running() { return running; } public int size() { return size; } }

Now in your activities you can easily create a queue of background tasks:

#!java protected final TasksQueue secondaryTasks; private final int TASK_1 = 0; private final int TASK_2 = 1; private final int TASK_3 = 2; public ...Activity() { // constructor secondaryTasks = new TasksQueue<..., ...>() { // here you can override createTask @Override public void onPerfomed(int taskId, ... result) throws JSONException { super.onPerfomed(taskId, result); onSecondaryTaskPerfomed(taskId, result); } @Override public void onError(Exception e, String message) { Log.e(TAG, message + " / " + e.getLocalizedMessage()); Dialogs.makeExceptionToast(ItemsListActivity.this, message, e); } }; secondaryTasks.add(TASK_1, ...); secondaryTasks.add(TASK_2, ...); secondaryTasks.add(TASK_3, ...); } protected void someMethod() { . . . if (!secondaryTasks.isEmpty()) secondaryTasks.run(); . . . } protected void onSecondaryTaskPerfomed(int taskId, ... result) { switch (taskId) { case TASK_1: . . . case TASK_2: . . . case TASK_3: . . . . . . } }

By the way, thanks to Runnable interface you can run queues like this in separate thread:

#!java new Thread(secondaryTasks, "Tasks Queue").start();

Tasks queue in vimeoid: ApiTasksQueue

Created in: SingleItemActivity

Filled with tasks in: UserActivity

Handling completed tasks in: UserActivity

10. ListView selection highlight

You see a blue line on the image, it is a custom selected element highlight and it has four conditions - pressed, focused, disabled and transition animation from pressed to held condition for long tap. First three and held condition - it is so-called 9-patch, sure you heard something about them, animation is an xml-file.

To define the states for selection highlight, set android:listSelector="@drawable/selector_bg" for your ListView in layout. The algorythm is simple, but it to build rules in proper order in not an easy task sometimes. See examples:

Definition: selector_bg.xml

Animation: selector_bg_transition.xml

Declared at: generic_list.xml

There are also a tricks with 9-patch, each time when there is something wrong in layout, the whole list becomes a mess. Main rule is to check ListView declaration first of all, ensure that layout_width and layout_height are set to fill_parent and re-check the parent elements higher in the hierarchy. Then, if it has not helped, you may try to correct 9-patches. The thick black lines on top and to the left determine what image areas will be stretched if the content can't fill the image. The thick black lines (optional) on bottom and to the right determine in what image area the content will fit itself. It is also not so easy to get the correct positions at first time, have to experiment. Don't even think about creating 9-patches without editor, it is a brainfuck - content areas and errors are highlighted in editor, but even when everything seems ok, inflater understands a layout as you expect not every time.

11. Adding QuickActions

QuickActions - is small library for the popping out dialogs with actions like the one shown on the picture (and not just like this, because the design can be changed freely). They became a new trend when official twitter-client appeared. Sure there are another implemantations exists but in vimeoid I use this one and also changed it a bit for my needs.

To show a dialog like this instead of context menu when element in list is long-tapped, it is enough to override onCreateContextMenu method in ListActivity like this:

#!java public void onCreateContextMenu(ContextMenu menu, View v, ContextMenuInfo menuInfo) { . . . final AdapterView.AdapterContextMenuInfo info = extractMenuInfo(menuInfo); final QuickAction quickAction = createQuickActions(info.position, getItem(info.position), info.targetView); if (quickAction != null) quickAction.show(); } protected QuickAction createQuickActions(final int position, final ... item, View view) { QuickAction qa = new QuickAction(view); qa.addActionItem(getString(R.string...), getResources().getDrawable(R.drawable...), new QActionClickListener() { @Override public void onClick(View v, QActionItem item) { . . . } }); . . . return qa; }

Directory contating a modified version of a library lib-qactions

Used in: VideosActivity

Adding external library to Eclipse project is described in this article. To be short, it is enough to create the separate Android project with sources for a library, set isLibrary checkbox in Android section in project properties, and in the original project just add the library project using Library -> Add button from the same section. R-file from the library project will be added to the original project after rebuild.

12. Three additional mini-solutions

12a. One entry point to invoke different activities

If your application uses a lot of different activities that called similar way, may be it will be useful for you to move this calls to a separate class, including filling Extras with data:

Example from vimeoid: Invoke

12b. Placeholders in localization strings

My be it is obvious, but in strings from strings.xml you can use placeholders to insert some locale-independent values inside these strings, i.e.: <string name="image_info">Image size: {width}x{height}</string>. format function can help you like this: format(getString(R.string.image_info), "width", String.valueOf(600), "height", String.valueOf(800))

#!java public static String format(String source, String... params) { String result = source; int pos = 0; while (pos < params.length) { result = result.replaceAll("\\{" + params[pos++] + "\\}", params[pos++]); } return result; }

Upd. As I expected, I had missed this method in Android library: there is a standard function getString(int resId, Object... formatArgs). Thanks to zochek.

12c. About wrong layouts

Be sure to read these articles, inflater in Android is very sensitive to complicated structures and if you are writing a complex application, you'll have to fix your layouts sooner or later:

Layout Tricks #1

Layout Tricks #2

Layout Tricks #3

Layout Tricks #4

Speed up your Android UI