android base

База Android

Введение

Этот проект направлен на:

• Пример приложения мобильного клиента для обсуждения настройки и разработки нативного Android.
• Основной шаблон для начала проектов с него.

Сводка спецификации:

• App Coterplate (пользователи, настройки, информация ...)
• Примеры примеров.
• MVP Чистая архитектура.
• Инверсия зависимости (кинжал 2 и баборт).
• Реактивное программирование (rxjava и rxandroid).
• RESTful Client с версией, языком и аутентификацией (модернизация).
• Полное покрытие для тестирования с полным модулем (эспрессо, макетовые и кинжал 2).
• Другие модели и хорошие практики.
• Система непрерывной интеграции.
• Сценарии для сброса проекта.

Вот его API сервера Counter

Быстрый старт

• Установите свою любимую IDE или только Android SDK (BuildTools 23.0.2 и компилированные данные 23 или определите свои собственные версии в dependencies.gradle ). Я использую Android Studio.

• Клонировать хранилище и войти внутрь:

 git clone git://github.com/jordifierro/android-base.git --origin android-base YourProjectName
cd YourProjectName

• Удалите все связанный код «примечание» (необязательно):

 ./bin/remove_notes

• Переименовать проект и название пакета:

 ./bin/rename_project YourProjectName your.package.name

• Подключите устройство (или запустите эмулятор) и запустите тесты:

 ./gradlew clean build cAT

• Как только сборка станет успешной, создайте новый удаленный репозиторий, а затем выполните его, чтобы сбросить репо и протолкнуть его:

 ./bin/reset_git https://github.com/yourusername/YourProjectName.git

Вот и все, теперь вы можете начать разработку собственного приложения!

Примечание. Чтобы запустить приложение (теперь вы можете запустить только тесты), не забудьте настроить сервер API (Rails-API-база уже разработана для обслуживания этого приложения, но вы также можете сделать свое собственное) и настроить RestApi для подключения к нему (просто изменить параметры restapi.java).

Документация

Само приложение почти пустое, оно только направлено на то, чтобы предоставить некоторые основные модули, реализовать структуры с некоторыми шаблонами и дать пример кода. Вот спецификации:

Приложение COILERPLATE

Основная цель этого приложения - избежать написания приложения базового кода шаблона, поэтому уже реализованы следующие функции:

• Пользовательский вход
• Пользовательский регистр
• Восстановление пароля пользователя
• Настройки экрана с выходом в систему, удалению учетной записи и информационными ссылками
• Экран условий и условий
• Экран политики конфиденциальности
• Постоянство сессии
• Навигация
• Спокойный клиент
• Приложение архитектура скелет
• Многочисленные примеры тестирования

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

Примечание пример кода

Чтобы предоставить больше примера кода, был разработан код для управления notes (например, с рукописным представлением бумажных заметок), составленное title и content . Таким образом, приложение имеет индекс примечаний, детализацию, создание и редактирование экранов.

Его уникальная цель - быть образцом кода, поэтому он будет удален при запуске ./bin/remove_notes Script.

MVP Чистая архитектура

Код был структурирован после подхода к чистой архитектуре и шаблона модели View-Presenter (MVP). Проверьте это и эти сообщения, а также этот проект, для получения дополнительной информации об этом.

Принцип инверсии зависимости

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

Реактивное программирование

Чистая архитектура заставляет вас создавать разные слои, и, чтобы избежать ада обратного вызова, парадигма реактивного программирования применяется с использованием библиотеки Reactivex.

Restful Client с версией, языком и аутентификацией

Как клиентское приложение, его главная цель - позволить пользователю взаимодействовать с данными из API сервера. Проект показывает, как легко справиться с этим. Модерная библиотека используется для реализации методов вызова API. Аутентификация, версия API и интернационализация включены в запросы.

Полное покрытие модульных испытаний

Одна из самых интересных вещей этого проекта заключается в том, что он имеет полное покрытие модульного тестирования, от модулей данных до видов Android, включая все промежуточные слои. Это результат использования чистой архитектуры, инверсии зависимости и хороших методов тестирования. Одним из примеров этого является тестирование представления, когда докладчик представления высмеивает Mockito и вводится тестированием компонента кинжала, предоставленного пользовательским бегуном Junit.

Здесь вы можете найти учебники, которые объясняют некоторые из этих тестов:

• Просмотреть единицу тестирования
• Httpinterceptor Testing

Шаблоны и хорошие практики

Другие модели и правильные практики используются в проекте, такие как реализация деятельности и фрагменты общее поведение с наследством, использование фрагментов и определение навигации в действиях, чтобы сделать ремоделирование экрана безболезненными, используйте интерфейсы для отделки компонентов ... специальные передовые практики, такие как интернационализация струн, использование листа стиля и другие маленькие методологии. Здесь один из использованных ресурсов -> лучшие практики Android.

Система непрерывной интеграции

Travis-Ci была добавлена ​​в качестве постоянной системы интеграции для запуска всего теста на каждом Push (как Java, так и Android-тестах).

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

 ./gradlew clean build cAT

Это проведет тесты как Java, так и Android.

Сценарии для сброса проекта

Есть несколько сценариев в папке /bin , чтобы сделать действительно простой запуск нового проекта с нуля, используя этот шаблон. Просто следуйте разделу «Быстрый старт», размещенную выше.

Все сценарии оболочки подтверждаются инструментом ShellCheck.

Список Тодо

• Добавьте образцы интеграционных тестирования.

Вот его API сервера Counterpart Server, откуда это приложение потребляет Data-> Rails-API-базу.

Способствовать

Все предложения и вклады более чем приветствуются!

• Вилка этого репо.
• Создайте филиал вашей функции (GIT Checkout -B -name).
• Разработайте свою функцию и протестируйте ее.
• Успешно запустить тесты:

 ./gradlew clean build cAT

• Сделайте свои изменения (GIT Commit -m 'реализовать новую функцию').
• Протолкните изменения (GIT Push Origin Prinise-Name).
• Создайте запрос на притяжение, и я объединю его с проектом.

Участники

К сожалению, участников пока нет.

---

http://jordifierro.com