Android Studio: часто используемые шаблоны и их настройка

1. Шаблоны структуры проекта

В Android Studio при создании проекта не создаются все необходимые папки для разработки Android-приложений. Например, по умолчанию создаётся только папка drawable, а такие папки, как drawable-hdpi и другие, необходимо создавать самостоятельно. Также в папке values нет файла dimens.xml, а в папке res — папки anim. Если всё это делать вручную, то можно потратить много времени, к тому же легко ошибиться с названиями папок, что приведёт к ошибкам компиляции. Поэтому для повышения эффективности и безопасности необходимо настроить шаблоны структуры проекта так, чтобы при создании нового проекта автоматически генерировалась полная структура папок без необходимости ручного создания.

1. Создание файла dimens.xml при создании модуля.

Способ настройки: перейдите в каталог установки Android Studio, затем последовательно в каталоги plugins, android, lib, templates, gradle-projects, NewAndroidModule, root, res, values. В папке values создайте файл dimens.xml и заполните его следующим содержимым:

<?xml version="1.0" encoding="utf-8"?>
<resources>

</resources>

2. Здесь есть три момента, которые необходимо изменить.

(1) При создании модуля автоматически добавлять зависимость v4 и указывать версию пакетов v4 и v7.

(2) Автоматически создавать папки с ресурсами для разных разрешений экрана.

(3) Указать путь к файлу dimens.xml.

Способ настройки: Перейдите в каталог установки Android Studio, последовательно в каталоги plugins, android, lib, templates, gradle-projects, NewAndroidModule. Откройте файл recipe.xml.ftl с помощью редактора и добавьте следующие настройки, как показано на рисунке:

Примечание:

• (1) dependency — это конфигурация URL библиотеки зависимостей, по умолчанию есть только библиотека v7, здесь добавлена библиотека v4.

• (2) После v7 или v4 указывается номер версии, например, если вы хотите использовать версию 24, вы можете заменить её на номер версии из вашего SDK (если вы не знаете номер версии SDK, вы можете посмотреть Android Studio: общие настройки и сочетания клавиш).

• (3) mkdir означает создание папки.

• (4) Объяснение следующей строки кода:

     <instantiate from="root/res/values/dimens.xml"
               to="${escapeXmlAttribute(resOut)}/values/dimens.xml" />

означает копирование файла dimens.xml из пути root/res/values в папку values в созданном каталоге ресурсов проекта.

3. При создании модуля вы хотите, чтобы в файле build.gradle модуля была указана определённая версия компиляции. Например, желаемый результат выглядит следующим образом:

android {
    compileSdkVersion 25
    buildToolsVersion "25.0.3"
    defaultConfig {
        minSdkVersion 25
        targetSdkVersion 25
        ...
    }
    ...
}

Здесь необходимо установить четыре параметра: compileSdkVersion, buildToolsVersion, minSdkVersion и targetSdkVersion. Ниже описан способ настройки:

Способ настройки: Перейдите в каталог установки Android Studio, последовательно в каталоги plugins, android, lib, templates, gradle-projects, NewAndroidModule, root. Затем откройте файл build.gradle.ftl с помощью редактора и измените конфигурацию, как показано на рисунке:

Примечание. Сначала сделайте резервную копию этого файла, а затем внесите изменения. Если возникнут проблемы, вы сможете восстановить исходный файл.

4. Создайте новый проект и проверьте результаты:

2. Live Templates (активные шаблоны)

(Один) способ открытия: нажмите File → Settings → Editor → Code Style → Live Templates, где вы найдёте часто используемый код, такой как log, System.out.println и цикл for.

Поскольку их слишком много, ниже приведены только некоторые часто используемые: (далее «//Изменено имя сочетания клавиш» означает, что имя сочетания клавиш было изменено, и оно больше не использует значение по умолчанию, а «не изменено» означает использование значения по умолчанию)

(1) Связанные с Android

const — константа fbc — findViewById fore — создать цикл foreach //Изменено имя сочетания клавиш gone — установить View как gone //Изменено имя сочетания клавиш IntentView — использовать ACTION_VIEW для создания Intent key — результат: private static final String KEY_$value$ = "$value$"; newInstance — использовать параметры для создания нового экземпляра Fragment co — сгенерировать конструктор //Изменено имя сочетания клавиш cop — приватный конструктор //Изменено имя сочетания клавиш rgS — получить строку из ресурса (R.string.XXX) rouiT — сгенерировать runOnUIThread sbc — генерировать комментарии в виде блоков Sfmt — форматировать строку String.format(XXX) starter — создать статический метод start(...), чтобы запустить Activity toal — создать длинный Toast //Новый toas — создать Toast //Изменено имя сочетания клавиш vi — установить View как видимый //Изменено имя сочетания клавиш

(2) AndroidComments (компоненты Android)

fix — добавить // FIXME //Изменено имя сочетания клавиш do — добавить // TODO //Изменено имя сочетания клавиш

(3) AndroidLog (связанные с журналом Android)

logd — Log.d(TAG, String) loge — Log.e(TAG, String) logi — Log.i(TAG, String) logm — вывести имя метода и его параметры, Log.d(TAG,XXX) logr — вывести результат метода tag — создать статическую переменную logtag на основе текущего класса //Изменено содержание и описание, теперь это «создать TAG на основе текущего класса» private static final String TAG = $className$.class.getSimpleName(); logw — Log.w(TAG,String,Exception) logf — Log.wtf(TAG, String, (2) Второй способ — настройка через меню Settings → Editor → Live Templates, как показано на рисунке:

Рисунок: «Настройка пользовательских шаблонов для комментариев к классам способом 2».

Что касается $DATE$ здесь, то нужно нажать Edit variables справа и настроить атрибут как date().

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

(Б) Метод комментирования

В принципе, перед каждым методом члена (включая пользовательские методы членов, переопределённые методы и методы свойств) должен быть комментарий метода.

Введите /** и нажмите Enter или настройте сочетание клавиш Fix doc comment (Settings → Keymap → Fix doc comment), и AS поможет вам создать шаблон. Нам нужно только заполнить параметры.

4. Пользовательские шаблоны UI. При создании нового проекта или модуля можно быстро создать шаблоны. Например, при создании Activity можно выбрать EmptyActivity и т. д.

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

Соответствующий адрес GitHub статьи: AndroidStudioTemplate.